HTTPClient object

The HTTPClient object is a base object for sending HTTP requests and
receiving HTTP responses from a resource identified by a URI. Compared to
the Inet object, the HTTPClient object is easier to use and supports more
methods (Get/Post/Put/Delete) and more SSL protocols (TLS 1.0, TLS 1.1,
TLS 1.2, SSL 2.0, and SSL 3.0).

Note

It is not recommended to use this object to process large data (20
MB or 100,000 data rows can be considered as large data based on our
tests), because this object will call a third-party library which is
memory intensive. If you want to process large data using HTTPClient, it
is recommended that you disable the AutoReadData property (by default it is
enabled) and use the ReadData
function. See a code example in ReadData
for how to process large data.

Note

This object cannot be referenced in .NET Web Service or .NET
Assembly components, otherwise the component will fail to be
deployed.

Properties

HTTPClient property	Datatype	Description
AutoReadData	Boolean	Whether to read the response body automatically.
CheckForServerCertRevocation	Boolean	Checks if the server certificate is revoked.
IgnoreServerCertificate	Integer	Ignores certain error(s) of the server certificate.
SecureProtocol	Integer	The secure protocol.
TimeOut	Long	The timeout seconds.
ClassDefinition	PowerObject	An object of type PowerObject containing information about the class definition of the object or control.

Events

HTTPClient event	Occurs
Constructor	Immediately before the Open event occurs in the window.
Destructor	Immediately after the Close event occurs in the window.

Functions

HTTPClient function	Datatype returned	Description
ClassName	String	Returns the name assigned to the object.
ClearRequestHeaders	Integer	Clears the headers of the request.
GetContextService	Integer	Creates a reference to a context-specific instance of the specified service.
GetParent	PowerObject	Returns a reference to the name of the parent object.
GetRequestHeader	String	Gets the request header by name.
GetRequestHeaders	String	Gets all of the request headers’ information.
GetResponseBody	Integer	Gets the response body.
GetResponseHeader	String	Gets the response header by name.
GetResponseHeaders	String	Gets all of the response headers’ information.
GetResponseStatusCode	Long	Gets the response status code.
GetResponseStatusText	String	Gets the response status description.
PostData	Integer	Sends the data with POST method.
PostDataEnd	Integer	Finishes sending the data with POST method.
PostDataStart	Integer	Starts sending the data with POST method.
PostEvent	Boolean	Adds an event to the end of the message queue for the object.
ReadData	Integer	Reads the response body.
SendRequest	Integer	Sends the request to the server.
SetRequestHeader	Integer	Sets the request header.
SetRequestHeaders	Integer	Sets all of the request headers’ information.
TriggerEvent	Integer	Triggers a specific event in the object and executes the script for the event.
TypeOf	Object	Returns the type of the object.

Document get from Powerbuilder help

Thank you for watching.

Powerbuilder Documentation 2019

August 21, 2023

Was this article helpful?

Connection Information

HTTPClient object – PB Docs 2019