RWHttpClient

Module:  Internet Protocols Module   Package:  HTTP

RWHttpClientRWHandleBase

• Local Index
• Header File
• Description
• Public Constructors
• Protected Constructor
• Public Destructor
• Public Member Operator
• Public Member Functions
• Protected Function

Members

body() connect()

getReply() isConnected()

operator=() RWHttpClient()

submit() ~RWHttpClient()

#include <rw/http/RWHttpClient.h>

RWHttpClient, along with helper RWHttpMethod classes, enables detailed control over HTTP communications. The asynchronous nature of HTTP/1.1 enables you to submit multiple requests to the server before retrieving any of the replies. Replies are returned in the same order that they are submitted.

RWHttpClient objects are lightweight. They are implemented using the handle-body pattern. The RWHttpClient is a handle to an implementation that performs the protocol interaction.

RWHttpClient();

Constructs a default RWHttpClient object.

RWHttpClient(const RWHttpClient& client);

Copy constructor. The body of the new client is the same as client.

RWHttpClient(RWHttpClientImp* imp);

Protected constructor from imp.

~RWHttpClient();

Virtual destructor.

RWHttpClient&
operator=(const RWHttpClient& other);

Assigns the body of other to this. Any previous bodies associated with this RWHttpClient object are released.

void
connect(const RWSockAddrBase& address, 
        unsigned long maxwait);

Enables an HTTP client to establish a connection session with an HTTP server. The address argument specifies the address of the server to connect to.

The optional value maxwait specifies how long the RWHttpClient waits for data to become available on a socket before deciding that the socket is dead. maxwait defaults to 0, which specifies that RWHttpClient waits indefinitely for data. If the maxwait time expires, an RWNetOperationTimeoutError exception is thrown.

RWHttpReply
getReply(unsigned long maxwait = 0);

Returns the next response from the server. The response contains the status code and headers, plus the body of the response as an RWCString.

The optional value maxwait is the number of milliseconds that the RWHttpClient waits for data to become available on a socket before deciding that the socket is dead. maxwait defaults to 0, which specifies that RWHttpClient waits indefinitely for data. If the maxwait time expires, an RWNetOperationTimeoutError exception is thrown.

RWHttpReply
getReply(RWTFunctor1<RWPortal> handler, 
         unsigned long maxwait = 0);

Returns the next reply from the server. The reply contains the status code and headers for the reply. A portal containing the body of the message is passed to the user-defined handler. If the message is not read fully from the portal by the handler, an RWHttpHandlerError exception is thrown.

The optional value maxwait is the number of milliseconds that the RWHttpClient waits for data to become available on a socket before deciding that the socket is dead. maxwait defaults to 0, which specifies that RWHttpClient waits indefinitely for data. If the maxwait time expires, an RWNetOperationTimeoutError exception is thrown.

RWHttpReply
getReply(RWTFunctor2<RWPortal, RWHttpReply&> handler,
         unsigned long maxwait = 0);

Equivalent to the previous getReply() method, however this method also receives a reference to the RWHttpReply instance that is returned when the function completes. This method allows the user to access the headers and status of the message while processing the body.

bool
isConnected() const;

Returns true if the client was last known to be connected to an HTTP server. Otherwise returns false.

A return of true does not guarantee that the client is currently connected to the server. true indicates only the state of the connection after the last read or write attempt. For example, if the server silently closed the connection, this function returns true.

bool
submit(RWHttpRequest request, 
       RWHttpPipeline pl = RW_HTTP_FORBID_PIPELINING,
       unsigned long maxwait = 0); 

Returns true if it successfully submits a request to the server. Otherwise returns false. If pl is equal to RW_HTTP_ALLOW_PIPELINING, the client assumes that it is safe to pipeline the request. For information about pipelining, see the Internet Protocols Module User's Guide.

The optional value maxwait is the number of milliseconds that the RWHttpClient waits for data to become available on a socket before deciding that the socket is dead. maxwait defaults to 0, which specifies that RWHttpClient waits indefinitely for data. If the maxwait time expires, an RWNetOperationTimeoutError exception is thrown.

RWHttpClientImp&
body() const;

Returns a reference to the body.

© Copyright Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave and SourcePro are registered trademarks of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.
Contact Rogue Wave about documentation or support issues.