http

(plugins.http)

Returned Types

PatchRequest,PostRequest,PutRequest,GetRequest,DeleteRequest,OptionsRequest,HeadRequest,TraceRequest,Cookie,Response,HttpClient,HttpClientConfig,HTTP_STATUS,

Methods Summarized

Type	Name	Summary
HttpClient	createNewHttpClient()	Create an http client (like a web browser with session binding) usable todo multiple request/posts in same server session .
HttpClient	createNewHttpClient(config)	Create an http client (like a web browser with session binding) usable todo multiple request/posts in same server session.
HttpClientConfig	createNewHttpClientConfig()	Create a http client config
Array	getMediaData(url)	Get media (binary data) such as images in a variable.
String	getPageData(url)	Get all page html in a variable, if this url is an https url that uses certificates unknown to Java then you have to use the HttpClient so that smart client users will get the unknown certificate dialog that they then can accept or you must make sure that those server certificates are stored in the cacerts of the java vm that is used (this is required for a web or headless client)

Methods Detailed

createNewHttpClient()

Create an http client (like a web browser with session binding) usable todo multiple request/posts in same server session . WARNING: Make sure you call client.close() on it after you used this client object to clean up resources. Starting a HTTPClient is the same as starting an actual browser without UI!

Returns: HttpClient

Sample

var client = plugins.http.createNewHttpClient();

createNewHttpClient(config)

Create an http client (like a web browser with session binding) usable todo multiple request/posts in same server session.

WARNING: Make sure you call client.close() on it after you used this client object to clean up resources. Starting a HTTPClient is the same as starting an actual browser without UI!

Parameters

• HttpClientConfig config httpclient config

Returns: HttpClient

Sample

var client = plugins.http.createNewHttpClient(config);

createNewHttpClientConfig()

Create a http client config

Returns: HttpClientConfig

Sample

var config = plugins.http.createNewHttpClientConfig();

getMediaData(url)

Get media (binary data) such as images in a variable. It also supports gzip-ed content. If this url is an https url that uses certificates unknown to Java then you have to use the HttpClient so that smart client users will get the unknown certificate dialog that they then can accept or you must make sure that those server certificates are stored in the cacerts of the java vm that is used (this is required for a web or headless client)

Parameters

• String url ;

Returns: Array

Sample

var image_byte_array = plugins.http.getMediaData('http://www.cnn.com/cnn.gif');

getPageData(url)

Get all page html in a variable, if this url is an https url that uses certificates unknown to Java then you have to use the HttpClient so that smart client users will get the unknown certificate dialog that they then can accept or you must make sure that those server certificates are stored in the cacerts of the java vm that is used (this is required for a web or headless client)

Parameters

• String url ;

Returns: String

Sample

// get data using a default connection
var pageData = plugins.http.getPageData('http://www.cnn.com');

---