class net.http.Client

$.net.http.Client Class

HTTP(s) Client for outbound connectivity. This client supports HTTP and HTTPs connections over HTTP or SOCKS proxy. You can either use a destination (preferred way) or a URL as target. To use HTTPs you need to specify a trust store with the needed certificates (either in the destination or with setTrustStore).

To choose between HTTP and SOCKS proxy, the proxy URL starts with either "http://" or "socks://".

This HttpClient is equipped with a cookie database. If a previous response sent a "set-cookie" header, the cookie is stored for the relevant domain and path. Subsequent requests will be enriched with the stored cookies automatically.

Reference

• SAP Help

https://help.sap.com/doc/3de842783af24336b6305a3c0223a369/2.0.03/en-US/$.net.http.Client.html

• Module

https://github.com/SAP/xsk/tree/main/modules/api/api-xsjs/src/main/resources/xsk/http

• Sample usage:

let http = $.net.http;
let response_prev = require('http/v4/response');

/*
Read service.xshttpdest inside the Demo package that contains:
host=https://services.odata.org;
pathPrefix=/V4/Northwind/Northwind.svc/;
*/
let dest = http.readDestination("Demo", "service");

// create client
let client = new http.Client();
let request = new http.Request(http.GET, "/"); // new Request(METHOD, PATH)
// the PATH will be prefixed by destination's pathPrefix, e.g. "/search?" on the request
// set the timeout in seconds
client.setTimeout(10);
// send the request and synchronously get the response
client.request(request, dest);
let response = client.getResponse();

// get all the cookies and headers from the response
let co = [], he = [];
for(let c in response.cookies) {
    co.push(response.cookies[c]);
}

for(let c in response.headers) {
    he.push(response.headers[c]);
}

// get the body
let body;
if(!response.body)
    body = "";
else
    body = response.body;

// check the contents of the response
response_prev.println("status: " +response.status+ " cookies: " +co+ " headers: " +he+ " body: " +body);

• Coverage

Methods	Return Type	Description	Status
close()	void	Close the connection. It is done automatically inside the HttpClientFacade. No need to call it explicitly!	✅
getResponse()	$.web.WebResponse	Retrieve the response from the previously sent request synchronously/blocking. Throws an error if there is no valid response to return	✅
request($.net.http.Request, $.net.http.Destination)	void	Send a new request object to the given destination. Throws an error if the request fails or the parameters are invalid.	✅
request($.net.http.Request, url, proxy (optional))	void	Send a request object to the given URL. Throws an error if the request fails or the parameters are invalid.	✅
request(WebMethod ($.net.http), url, proxy (optional))	void	Send a new request to the given URL, using the specified HTTP method. Throws an error if the request fails or the parameters are invalid.	✅
setTimeout(timeout)	void	Sets the timeout for communication with the server. Throws an error if the parameter is not a numeric value.	✅
setTrustStore(trustStore)	void	Sets the default trust store the will be used when issuing https:// requests via request(request, URI, ...)-syntax.	❌

• Issues

https://github.com/SAP/xsk/issues/20

• Unit Tests

https://github.com/SAP/xsk/tree/main/modules/engines/engine-xsjs/src/test/resources/test/xsk/http/http.xsjs

• Integration Tests ❌

Wiki icons legend

✅ - Feature implemented and working as supposed.
⚠️ - Feature partially implemented and needs to be finished.
❌ - Feature not implemented yet.