Chilkat Examples

ChilkatHOME.NET Core C#Android™AutoItCC#C++Chilkat2-PythonCkPythonClassic ASPDataFlexDelphi ActiveXDelphi DLLGoJavaLianjaMono C#Node.jsObjective-CPHP ActiveXPHP ExtensionPerlPowerBuilderPowerShellPureBasicRubySQL ServerSwift 2Swift 3,4,5...TclUnicode CUnicode C++VB.NETVBScriptVisual Basic 6.0Visual FoxProXojo Plugin

PureBasic Examples

Web API Categories

ASN.1
AWS KMS
AWS Misc
Amazon EC2
Amazon Glacier
Amazon S3
Amazon S3 (new)
Amazon SES
Amazon SNS
Amazon SQS
Async
Azure Cloud Storage
Azure Key Vault
Azure Service Bus
Azure Table Service
Base64
Bounced Email
Box
CAdES
CSR
CSV
Certificates
Code Signing
Compression
DKIM / DomainKey
DNS
DSA
Diffie-Hellman
Digital Signatures
Dropbox
Dynamics CRM
EBICS
ECC
Ed25519
Email Object
Encryption
FTP
FileAccess
Firebase
GMail REST API
GMail SMTP/IMAP/POP
Geolocation
Google APIs
Google Calendar
Google Cloud SQL
Google Cloud Storage
Google Drive
Google Photos
Google Sheets
Google Tasks
Gzip
HTML-to-XML/Text
HTTP

HTTP Misc
IMAP
JSON
JSON Web Encryption (JWE)
JSON Web Signatures (JWS)
JSON Web Token (JWT)
Java KeyStore (JKS)
MHT / HTML Email
MIME
MS Storage Providers
Microsoft Graph
Misc
NTLM
OAuth1
OAuth2
OIDC
Office365
OneDrive
OpenSSL
Outlook
Outlook Calendar
Outlook Contact
PDF Signatures
PEM
PFX/P12
PKCS11
POP3
PRNG
REST
REST Misc
RSA
SCP
SCard
SFTP
SMTP
SSH
SSH Key
SSH Tunnel
ScMinidriver
SharePoint
SharePoint Online
Signing in the Cloud
Socket/SSL/TLS
Spider
Stream
Tar Archive
ULID/UUID
Upload
WebSocket
XAdES
XML
XML Digital Signatures
XMP
Zip
curl

 

 

 

(PureBasic) Socket Select for Reading

Demonstrates how the Chilkat socket object can become a "socket set" that contains other connected socket objects, and this can be used to "select" on multiple sockets for reading. The SelectForReading method waits until one or more sockets in the set have incoming data ready and available to read.

Chilkat PureBasic Module Download

Chilkat PureBasic Module

IncludeFile "CkSocket.pb"
IncludeFile "CkStringArray.pb"

Procedure ChilkatExample()

    ; This example requires the Chilkat API to have been previously unlocked.
    ; See Global Unlock Sample for sample code.

    ; This will be the socket object that will contain other 
    ; connected sockets.
    socketSet.i = CkSocket::ckCreate()
    If socketSet.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    ; Before we begin, create a few StringArray objects holding
    ; domain names, URLs, and output filenames to be used
    ; in this example.
    saDomains.i = CkStringArray::ckCreate()
    If saDomains.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    saUrls.i = CkStringArray::ckCreate()
    If saUrls.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    saFilenames.i = CkStringArray::ckCreate()
    If saFilenames.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkStringArray::ckAppend(saDomains,"www.chilkatsoft.com")
    CkStringArray::ckAppend(saDomains,"www.cknotes.com")
    CkStringArray::ckAppend(saDomains,"www.google.com")
    CkStringArray::ckAppend(saDomains,"www.example-code.com")
    CkStringArray::ckAppend(saDomains,"www.yahoo.com")

    CkStringArray::ckAppend(saUrls,"http://www.chilkatsoft.com/")
    CkStringArray::ckAppend(saUrls,"http://www.cknotes.com/")
    CkStringArray::ckAppend(saUrls,"http://www.google.com/")
    CkStringArray::ckAppend(saUrls,"http://www.example-code.com/")
    CkStringArray::ckAppend(saUrls,"http://www.yahoo.com/")

    CkStringArray::ckAppend(saFilenames,"chilkatsoft.out")
    CkStringArray::ckAppend(saFilenames,"cknotes.out")
    CkStringArray::ckAppend(saFilenames,"google.out")
    CkStringArray::ckAppend(saFilenames,"example-code.out")
    CkStringArray::ckAppend(saFilenames,"yahoo.out")

    numConnections.i = 5

    ; This example will connect to 5 different web servers,
    ; send an HTTP request to each, and read the HTTP response
    ; form each.  It will call the SelectForReading method to wait
    ; until data arrives from any of the connected sockets.

    ; NOTE: As you'll see later, communicating with HTTP servers
    ; is better left to the Chilkat HTTP component/library because
    ; of many HTTP protocol issues such as redirects, GZIP responses,
    ; chunked responses, etc.  We're only communicating with
    ; HTTP servers here as a convenient way of demonstrating
    ; the technique of waiting for data to arrive from a set of 
    ; connected sockets.

    ; First, connect to each of the web servers:
    i.i
    useSsl.i = 0
    maxWaitMs.i = 5000
    port.i = 80
    domain.s
    getReq.s

    For i = 0 To numConnections - 1
        sock.i = CkSocket::ckCreate()
        If sock.i = 0
            Debug "Failed to create object."
            ProcedureReturn
        EndIf

        domain = CkStringArray::ckGetString(saDomains,i)

        success = CkSocket::ckConnect(sock,domain,port,useSsl,maxWaitMs)
        If success <> 1
            Debug CkSocket::ckLastErrorText(sock)
            CkSocket::ckDispose(socketSet)
            CkStringArray::ckDispose(saDomains)
            CkStringArray::ckDispose(saUrls)
            CkStringArray::ckDispose(saFilenames)
            CkSocket::ckDispose(sock)
            ProcedureReturn
        EndIf

        ; Save a filename in the socket object's UserData.  We'll use this
        ; later when saving the data read in the HTTP response.
        CkSocket::setCkUserData(sock, CkStringArray::ckGetString(saFilenames,i))

        ; Display the remote IP address of the connected socket:
        Debug "connected to " + CkSocket::ckRemoteIpAddress(sock)

        ; Build the HTTP GET request to be sent to the web server.
        getReq = CkSocket::ckBuildHttpGetRequest(sock,CkStringArray::ckGetString(saUrls,i))

        ; Send the HTTP GET request to the web server.
        success = CkSocket::ckSendString(sock,getReq)
        If success <> 1
            Debug CkSocket::ckLastErrorText(sock)
            CkSocket::ckDispose(socketSet)
            CkStringArray::ckDispose(saDomains)
            CkStringArray::ckDispose(saUrls)
            CkStringArray::ckDispose(saFilenames)
            CkSocket::ckDispose(sock)
            ProcedureReturn
        EndIf

        ; Tell the socketSet object to take ownership of the connected socket.
        ; This adds the connection to the internal set of sockets contained
        ; within socketSet.   
        success = CkSocket::ckTakeSocket(socketSet,sock)
        If success <> 1
            ; The TakeSocket method shouldn't fail.  The only reason it might
            ; is if we try to give it an unconnected socket -- but we already 
            ; know it's connected at this point..
            Debug CkSocket::ckLastErrorText(socketSet)
            CkSocket::ckDispose(socketSet)
            CkStringArray::ckDispose(saDomains)
            CkStringArray::ckDispose(saUrls)
            CkStringArray::ckDispose(saFilenames)
            CkSocket::ckDispose(sock)
            ProcedureReturn
        EndIf

    Next

    ; At this point we have 5 TCP/IP connections contained within the socketSet object.
    ; Each of the web servers have received a GET request and will be
    ; sending a response.  We now want to write a loop that waits for data
    ; to arrive from any of the 5 connections, reads incoming data, and
    ; saves the data to files.

    ; We'll use the StartTiming method and ElapsedSeconds property
    ; to wait a maximum of 10 seconds.  The reason we do this is because
    ; different web servers will behave differently w.r.t. idle connections.
    ; Some web servers close the connections quickly while others do not.
    ; The socket component is not "HTTP aware", meaning that it is not parsing
    ; the HTTP response and therefore does not know when it has received
    ; the full response.  Because of this, we might receive the full response
    ; and then wait a long time before the server decides to close its side of
    ; the connection.  
    ; The ElapsedSeconds property will return the number of seconds that
    ; have elapsed since the last call to StartTiming (on the same object instance).
    CkSocket::ckStartTiming(socketSet)

    While ((CkSocket::ckNumSocketsInSet(socketSet) > 0) AND (CkSocket::ckElapsedSeconds(socketSet) < 10))

        maxWaitMs = 300

        numReady.i
        ; Wait for data to arrive on any of the sockets.  Waits a maximum
        ; of 300 milliseconds.  If maxWaitMs = 0, then it is effectively a poll.
        ; If no sockets have data available for reading, then a value of 0 is 
        ; returned.  A value of -1 indicates an error condition.
        ; Note: when the remote peer (in this case the web server) disconnects,
        ; the socket will appear as if it has data available.  A "ready" socket
        ; is one where either data is available for reading or the socket has
        ; become disconnected.
        numReady = CkSocket::ckSelectForReading(socketSet,maxWaitMs)
        If numReady < 0
            Debug CkSocket::ckLastErrorText(socketSet)
            CkSocket::ckDispose(socketSet)
            CkStringArray::ckDispose(saDomains)
            CkStringArray::ckDispose(saUrls)
            CkStringArray::ckDispose(saFilenames)
            CkSocket::ckDispose(sock)
            ProcedureReturn
        EndIf

        ; Consume data from each of the ready sockets, and show those
        ; that become disconnected.   
        For i = 0 To numReady - 1

            ; To make method calls on the "ready" socket, or to get/set property
            ; values, set the SelectorReadIndex.  
            CkSocket::setCkSelectorReadIndex(socketSet, i)

            ; Print information that identifies the socket that is ready for reading:
            Debug "ready: IP address = " + CkSocket::ckRemoteIpAddress(socketSet) + " filename = " + CkSocket::ckUserData(socketSet)

            ; Read the selected socket and send the data directly to a file (appending
            ; to the file).
            success = CkSocket::ckReceiveBytesToFile(socketSet,CkSocket::ckUserData(socketSet))

            ; The success/failure of a socket read should normally be checked.
            ; In this case it is not necessary.  If the socket became ready for
            ; reading because the remote peer disconnected and there is no
            ; data available, then nothing will be read.  The socketSet object
            ; will automatically remove a disconnected socket from its internal set of sockets
            ; the next time SelectForReading or SelectForWriting is called.
            ; We can check to see if the socket is still connected by examining
            ; the IsConnected property:
            If CkSocket::ckIsConnected(socketSet) <> 1
                Debug "disconnected: " + CkSocket::ckUserData(socketSet)
            EndIf

        Next

        ; Set the SelectorReadIndex = -1 so that method calls
        ; and property gets/sets are not routed to one of the socketSet's
        ; contained sockets.  This is necessary because we want to
        ; check the number of elapsed seconds from when we called
        ; StartTiming.  
        CkSocket::setCkSelectorReadIndex(socketSet, -1)

    Wend

    Debug "Finished."

    ; Some final notes:
    ; If you examine the output files, you'll see that the HTTP protocol is a little
    ; more complex than you may have originally thought.
    ; 1) HTTP responses are MIME -- there is a MIME header followed by a MIME body.
    ;     In most cases, the MIME body is the HTML document itself.
    ; 2) Some HTTP responses return gzip compressed data (which is binary).  It must
    ;      be decompressed to get the HTML.
    ; 3) Some HTTP responses arrive in "chunked" form.  You'll see lines containing nothing but
    ;      a hexidecimal number indicating the size of the chunk to follow.  It ends with
    ;      a 0-sized chunk.
    ; 4) You'll find that some HTTP responses might be redirects to other URL's (such as a 302 redirect).

    ; For the above reasons, and many more, you would typically use the Chilkat HTTP component
    ; to handle the complexities of HTTP.  

    ; The reason HTTP was chosen for this example is because:
    ; 1) It is easy to establish multiple connections with existing servers that are not typically not blocked by firewalls.
    ; 2) It is easy to send a request and receive a response.
    ; 3) There is variability  in the amount of time before a server decides to disconnect from an idle client


    CkSocket::ckDispose(socketSet)
    CkStringArray::ckDispose(saDomains)
    CkStringArray::ckDispose(saUrls)
    CkStringArray::ckDispose(saFilenames)
    CkSocket::ckDispose(sock)


    ProcedureReturn
EndProcedure

 

© 2000-2024 Chilkat Software, Inc. All Rights Reserved.