HttpGet

Supports the basic needs of a client making requests of an HTTP server. The following is a usage example:

// open a web-page for reading (see HttpPost for writing)
auto page = new HttpGet ("http://www.digitalmars.com/d/intro.html");

// retrieve and flush display content
Cout (cast(char[]) page.read) ();

class HttpGet : HttpClient {

alias read = HttpClient.read;

this(const(char)[] url);

this(Uri uri);

void[] read();

}

Constructors

this this(const(char)[] url): Create a client for the given URL. The argument should be fully qualified with an "http:" or "https:" scheme, or an explicit port should be provided.
this this(Uri uri): Create a client with the provided Uri instance. The Uri should be fully qualified with an "http:" or "https:" scheme, or an explicit port should be provided.

Members

Aliases

read alias read = HttpClient.read: Undocumented in source.

Functions

read void[] read()

Inherited Members

From HttpClient

Pump alias Pump = void delegate(OutputBuffer): callback for sending PUT content
Version enum Version: Undocumented in source.
Get RequestMethod Get;
Put RequestMethod Put;
Head RequestMethod Head;
Post RequestMethod Post;
Trace RequestMethod Trace;
Delete RequestMethod Delete;
Options RequestMethod Options;
Connect RequestMethod Connect;: Undocumented in source.
getResponseHeaders HttpHeadersView getResponseHeaders(): Get the current input headers, as returned by the host request.
getRequestHeaders HttpHeaders getRequestHeaders(): Gain access to the request headers. Use this to add whatever headers are required for a request.
getRequestParams HttpParams getRequestParams(): Gain access to the request parameters. Use this to add x=y style parameters to the request. These will be appended to the request assuming the original Uri does not contain any of its own.
getUri UriView getUri(): Return the Uri associated with this client
getResponse ResponseLine getResponse(): Return the response-line for the latest request. This takes the form of "version status reason" as defined in the HTTP RFC.
getStatus int getStatus(): Return the HTTP status code set by the remote server
isResponseOK bool isResponseOK(): Return whether the response was OK or not
addCookie HttpClient addCookie(Cookie cookie): Add a cookie to the outgoing headers
close void close(): Close all resources used by a request. You must invoke this between successive open() calls.
reset HttpClient reset(): Reset the client such that it is ready for a new request.
setRequest HttpClient setRequest(RequestMethod method): Set the request method
setVersion HttpClient setVersion(Version v): Set the request version
enableRedirect HttpClient enableRedirect(bool yes): enable/disable the internal redirection suppport
setTimeout HttpClient setTimeout(float interval): set timeout period for read operation
keepAlive HttpClient keepAlive(bool yes): Control keepalive option
encodeUri HttpClient encodeUri(bool yes): Control Uri output encoding
open InputBuffer open(): Make a request for the resource specified via the constructor, using the specified timeout period (in milli-seconds).The return value represents the input buffer, from which all returned headers and content may be accessed.
open InputBuffer open(Pump pump): Make a request for the resource specified via the constructor, using a callback for pumping additional data to the host. This defaults to a three-second timeout period. The return value represents the input buffer, from which all returned headers and content may be accessed.
open InputBuffer open(RequestMethod method, Pump pump): Make a request for the resource specified via the constructor using the specified timeout period (in micro-seconds), and a user-defined callback for pumping additional data to the host. The callback would be used when uploading data during a 'put' operation (or equivalent). The return value represents the input buffer, from which all returned headers and content may be accessed.
read void read(void delegate(const(void)[]) sink, size_t len): Read the content from the returning input stream, up to a maximum length, and pass content to the given sink delegate as it arrives.
redirectPost InputBuffer redirectPost(Pump pump, int status): Handle redirection of Post
canRepost bool canRepost(uint status): Handle user-notification of Post redirection. This should be overridden appropriately.
createSocket Socket createSocket(): Overridable socket factory, for use with HTTPS and so on

HttpGet

Constructors

Members

Aliases

Functions

Inherited Members

From HttpClient

Meta

Source