Data Service HTTP Library Functions
Functions from Data Service HTTP Library are available in context of Data API jobs.
addResponseHeader
void addResponseHeader( string name, string value );
The addResponseHeader
function adds an HTTP response header field. If the function is called multiple times, multiple headers will be added.
The name
parameter is a header field name. See list of header field names.
If name
is null
or empty string, the response header field is not added.
The value
parameter is a value of the header field. If value
is empty string, empty string is used. If value
is null the header field is not added.
Example 343. Usage of addResponseHeader
The addResponseHeader("Content-Language", "fr")
adds an HTTP header field Content-Language
with value fr
.
Content-Language: fr
The addResponseHeader("foo", "")
adds header field with empty value
foo:
The addResponseHeder("foo", null)
does not add an HTTP header field because of null
.
See also: containsResponseHeader
containsResponseHeader
boolean containsResponseHeader( string headerField );
The containsResponseHeader()
function checks for presence of a user-added header field. It does not check existence of header fields not added by user, e.g. Server: Apache-Coyote/1.1
. The check is case insensitive.
The headerField
parameter is a name of HTTP header field.
Example 344. Usage of containsResponseHeader
There is no Content-Language
header. The containsResponseHeader("Content-Language")
returns false
.
If the header was added by setResponseHeader()
function. The function containsResponseHeader()
returns true
.
setResponseHeader("Content-Language", "fr");
boolean a = containsResponseHeader("Content-Language"); // true
The containsResponseHeader("Server")
returns false
. The header was not added by user.
See also: addResponseHeader
getRequestBody
string getRequestBody( );
The getRequestBody()
function returns the request body.
Example 345. Usage of getRequestBody
If you query the data service with
wget \
--user=userName \
--password=password \
--method=POST \
--body-data="Once upon a time" \
"http://${HOST_PORT}/clover/data-service/getRequestBody"
the getRequestBody()
returns Once upon a time.
See also: getRequestEncoding
getRequestClientIPAddress
string getRequestClientIPAddress( );
The getRequestClientIPAddress()
function returns the IP address of client performing the request.
Example 346. Usage of getRequestClientIPAddress
If you run the Data Shaper Server locally, the getRequestClientIPAddress()
returns IP address corresponding to localhost: "127.0.0.1"
or "0:0:0:0:0:0:0:1"
.
See also: getRequestBody
getRequestContentType
string getRequestContentType( );
The getRequestContentType()
function returns the content type.
Example 347. Usage of getRequestContentType
If you query the data service API with
wget \
--user=... \
--password=... \
--method=POST \
--body-data="Once upon a time" \
"http://${HOST_PORT}/clover/data-service/getRequestContentType"
the getRequestContentType()
returns application/x-www-form-urlencoded
.
See also: getResponseContentType
getRequestEncoding
string getRequestEncoding( );
The getRequestEncoding()
function encoding specified in Content-Type header.
If the header does not exist, the function returns null
.
Example 348. Usage of getRequestEncoding
If you query the data with
wget \
--user=... \
--password=... \
--header="Content-Type: text/html; charset=UTF-8" \
"http://${HOST_PORT}/clover/data-service/getRequestEncoding"
the getRequestEncoding()
function returns UTF-8
.
See also: setRequestEncoding
getRequestHeader
string getRequestHeader( string headerField );
The getRequestHeader()
function returns value of the header field.
The headerField
parameter is HTTP header field name.
If the header field does not exist, the function returns null
.
Example 349. Usage of getRequestHeader
If you query the service with
wget \
--user=... \
--password=... \
--header="Accept-Language: de" \
"http://${HOST_PORT}/clover/data-service/getRequestHeader"
the getRequestHeader("Accept-Language")
returns de
.
See also: getRequestHeaderNames
getRequestHeaderNames
string[] getRequestHeaderNames( );
The getRequestHeaderNames()
function returns names of request header fields.
Example 350. Usage of getRequestHeaderNames
If the data service receives
GET /clover/data-service/getRequestHeaderNames HTTP/1.1
User-Agent: Wget/1.19.1 (cygwin)
Accept: */*
Accept-Encoding: identity
Host: 172.22.2.71:33754
Connection: Keep-Alive
Accept-Language: es
Authorization: Basic Y2xvdmVyOmNsb3Zlcg==
Cookie: JSESSIONID=AE6A63EA112A0BADD046CDE0D068DCC1
The getRequestHeaderNames()
function returns user-agent,accept,accept-encoding,host,connection,accept-language,authorization,cookie
(as a list of strings).
See also: getRequestHeader, getRequestHeaders
getRequestHeaders
map[string,string] getRequestHeaders( );
string[] getRequestHeaders( string param );
The getRequestHeaders()
function returns a map with request headers. The header name is a key, header field value is value.
The param
parameter is header field name.
Example 351. Usage of getRequestHeaders
If you query the data service with:
curl.exe \
--user clover:clover \
--header "Accept-Language: de, en, es, fr" \
--header "Accept: text/plain" \
--header "Accept: text/html" \
--header "Accept: application/xml" \
--header "Accept: application/json" \
http://${HOST_PORT}/clover/data-service/getRequestHeaders
the getRequestHeaders()
function returns map with key-value pairs:
User-Agent=curl/7.54.1;Accept=application/json;Accept-Language=de, en, es, fr;…​.
As the function does not return a multimap, the Accept header field contains only one of the received header fields values. To get all received header field values, use the getRequestHeaders(string)
function.
The getRequestHeaders("Accept")
function returns list of strings: text/plain;text/html;application/xml;application/json.
See also: getRequestHeader, getRequestHeaderNames
getRequestMethod
string getRequestMethod( );
The getRequestMethod()
function returns the HTTP method: GET, POST, PUT, PATCH or DELETE.
Example 352. Usage of getRequestMethod
If you query the data service with:
wget \
--user=clover \
--password=clover \
--method=GET \
"http://${HOST_PORT}/clover/data-service/getRequestMethod"
the getRequestMethod()
returns GET
.
getRequestParameter
string getRequestParameter( string param );
The getRequestParameter()
function returns value of GET or POST parameter.
The param
parameter is the parameter name.
Example 353. Usage of getRequestParameter
If you query the data service with:
wget \
--user=clover \
--password=clover \
"http://${HOST_PORT}/clover/data-service/getRequestParameter?id=1234&"
the getRequestParameter("id")
returns 1234
(as string).
If you query data service on .../getRequestParameter/id/{id}
URL with
wget \
--user=clover \
--password=clover \
"http://${HOST_PORT}/clover/data-service/getRequestParameter/id/123"
the getRequestParameter("id")
returns 123
(as string). Note parameters in the URL in data service configuration.
If you query data service with
wget \
--user=clover \
--password=clover \
--post-data "id=234&" \
"http://${HOST_PORT}/clover/data-service/getRequestParameter"
the getRequestParameter("id")
returns 234
(as string).
See also: getRequestParameters, getRequestParameterNames
getRequestParameterNames
string[] getRequestParameterNames( );
The getRequestParameterNames()
function returns names of GET or POST parameters., e.g. http://example.com/?id=123&
Example 354. Usage of getRequestParameterNames
If you query the data service with:
wget \
--user=clover \
--password=clover \
"http://${HOST_PORT}/clover/data-service/getRequestParameterNames?id=123&name=doe&"
the getRequestParameterNames()
returns list containing id
and name
.
If you query data service on ./getRequestParameterNames2/id/{id}/name/{name}
with:
wget \
--user=clover \
--password=clover \
"http://${HOST_PORT}/clover/data-service/getRequestParameterNames2/id/123/name/doe"
the getRequestParameterNames()
function returns list containing id
and name
.
If you query data service with:
wget \
--user=clover \
--password=clover \
--post-data "name=doe&" \
"http://${HOST_PORT}/clover/data-service/getRequestParameterNames3?id=234&"
the getRequestParameterNames()
returns list containing id
and name
.
See also: getRequestParameter, getRequestParameters
getRequestParameters
string[] getRequestParameters( string name );
map[string,string] getRequestParameters( );
The getRequestParameters()
function return map of GET or POST request parameters and request parameter values. The parameters are from URL: www.example.com/getRequestParameters?id=123&name=doe&name=john&
The name
parameter is name of the parameter.
Example 355. Usage of getRequestParameters
If you query data service with:
wget \
--user=clover \
--password=clover \
"http://${HOST_PORT}/clover/data-service/getReqPar?id=123&name=doe&name=john&"
The getRequestParameters()
returns map. The key is parameter name, the value is the parameter value.
The getRequestParameters("name")
returns list containing doe
and john
.
See also: getRequestParameter, getRequestParameterNames
getRequestPartFilename
string getRequestPartFilename( string paramName );
The getRequestPartFilename()
function returns name of file received in multipart entity. Usually, it is a file name from HTML form.
The paramName
parameter is name of HTML input field containing the file.
Example 356. Usage of getRequestPartFilename
If you query the web service with:
curl -F name=@/tmp/filename \
http://example.com:8080/clover/data-service/getRequestPartFilename \
--user clover:clover
the getRequestPartFilename("name")
returns somefile
.
getResponseContentType
string getResponseContentType( );
The getResponseContentType()
function returns response content type - the value of Content-Type
response header field.
Example 357. Usage of getResponseContentType
The getResponseContentType()
returns for example application/json
.
See also: getRequestContentType, setResponseContentType
getResponseEncoding
string getResponseEncoding( );
The getResponseEncoding()
function returns the response encoding.
Example 358. Usage of getResponseEncoding
E.g. the getResponseEncoding()
returns iso-8859-1
.
See also: getRequestEncoding, setResponseEncoding
setRequestEncoding
void setRequestEncoding( string encoding );
The setRequestEncoding()
function sets the encoding to be used in POST request parsing. Call this function in init()
.
The encoding
parameter is encoding.
Example 359. Usage of setRequestEncoding
The setRequestEncoding("utf-8")
sets request encoding to UTF-8.
The setRequestEncoding("iso-8859-2")
sets request encoding to latin2.
The setRequestEncoding("cp1250")
sets request encoding to code page 1250.
See also: getRequestEncoding
setResponseBody
void setResponseBody( string body );
The setResponseBody()
function sets HTTP response body. Consider setting the response body encoding explicitly.
The body
parameter is the content of the body.
If you try to create response body with setResponsebody()
function and with writing to response:body
, the later one will be used. You should use only one way to create the response body.
Example 360. Usage of getResponseBody
The setResponseBody("The response")
sets the response body.
See also: setResponseEncoding
setResponseContentType
void setResponseContentType( string contentType );
The setResponseContentType()
function sets the response content type - the value of Content-Type
response header field.
The contentType
parameter is the value of Content-Type
response header field.
Example 361. Usage of setResponseContentType
setResponseContentType("text/plain");
See also: setResponseBody, getResponseContentType
setResponseEncoding
void setResponseEncoding( string encoding );
The setResponseEncoding()
function sets HTTP response encoding. This encoding is used if you set the response body with the setResponseBody()
function.
The encoding parameter is the response body encoding.
Example 362. Usage of setResponseEncoding
The setResponseEncoding("UTF-8")
; sets response body encoding to UTF-8.
See also: getResponseEncoding, setResponseBody
setResponseHeader
void setResponseHeader( string field, string value );
The setResponseHeader()
function sets the response header. If the header does not exist, it will be created.
The field
parameter is HTTP header field name.
The value
parameter is HTTP header field value.
Example 363. Usage of setResponseHeader
setResponseHeader("Server", "BOA")
See also: addResponseHeader
setResponseStatus
void setResponseStatus( integer statusCode );
void setResponseStatus( integer statusCode, string message );
The setResponseStatus()
function sets the response status code.
The statusCode
parameter is the returned status code.
The message
parameter is a message.
Example 364. Usage of setResponseStatus
The setResponseStatus(403)
sets the response status to 403.
The setResponseStatus(414, "URI Too Long")
returns a status code 414.
HTTP/1.1 414 URI Too Long
See also: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes, https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
Updated 11 months ago