OIL2 Class Local.HTTPget

class Local . HTTPget {
        int32   bytesIn;
        oid     clientObj;
        oid     connObj;
        int32   eofEncountered;
        string  response;
} inherits from Object;

DESCRIPTION

The class HTTPget is a convenience class that performs simple HTTP 1.0 GET requests. It has been superseded by the class HTTPrequest and HTTPget should no longer be used by new applications. The intent is to ultimately remove support for HTTPget; as an initial step, it has been removed from the Standard namespace and placed into the Local namespace. Existing usage should be modified as demonstrated below:

	obj = send "createObject"("HTTPget", acl,
		url, host, port, client) to ObjectCreator;
should become:
	obj = send "createObject"("HTTPrequest", acl, "GET",
		url, host, port, client, "", "") to ObjectCreator;

METHODS

Local.HTTPget:create

HTTPget:create(string url, string host, string port, oid client)

Method Description

URL to retrieve
default host if not specified in URL
default port if other than 80 nor specified in URL
object Id of client to be notified when request complete

When the result of the request is available, the client is sent a dataRead message and passed the parsed result of the response. If unsuccessful, this will be nil; otherwise it is a two-element array. Subscript 0 will be the MIME header; subscript 1 will contain the entity body.