Client: CookieClient
Provides the cookie functionality across HTTP client actions.
Remote Methods
get | The |
post | The |
head | The |
put | The |
forward | The |
execute | The |
patch | The |
delete | The |
options | The |
submit | Submits an HTTP request to a service with the specified HTTP verb. |
getResponse | Retrieves the |
hasPromise | Checks whether an |
getNextPromise | Retrieves the next available |
getPromisedResponse | Retrieves the promised server push |
rejectPromise | Rejects an |
get
function get(string path, RequestMessage message) returns Response | ClientError
The CookieClient.get()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Request path
- message RequestMessage (default ())
An optional HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
post
function post(string path, RequestMessage message) returns Response | ClientError
The CookieClient.post()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Resource path
- message RequestMessage
An HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
head
function head(string path, RequestMessage message) returns Response | ClientError
The CookieClient.head()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Resource path
- message RequestMessage (default ())
An optional HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
put
function put(string path, RequestMessage message) returns Response | ClientError
The CookieClient.put()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Resource path
- message RequestMessage
An HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
forward
function forward(string path, Request request) returns Response | ClientError
The CookieClient.forward()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
execute
function execute(string httpVerb, string path, RequestMessage message) returns Response | ClientError
The CookieClient.execute()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- httpVerb string
HTTP verb value
- path string
Resource path
- message RequestMessage
An HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
patch
function patch(string path, RequestMessage message) returns Response | ClientError
The CookieClient.patch()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Resource path
- message RequestMessage
An HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
delete
function delete(string path, RequestMessage message) returns Response | ClientError
The CookieClient.delete()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Resource path
- message RequestMessage (default ())
An optional HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
options
function options(string path, RequestMessage message) returns Response | ClientError
The CookieClient.options()
function wraps the underlying HTTP remote functions in a way to provide
the cookie functionality for a given endpoint.
Parameters
- path string
Request path
- message RequestMessage (default ())
An optional HTTP outbound request or any allowed payload
Return Type
(Response | ClientError)The response or an http:ClientError
if failed to establish the communication with the upstream server
submit
function submit(string httpVerb, string path, RequestMessage message) returns HttpFuture | ClientError
Submits an HTTP request to a service with the specified HTTP verb.
The CookieClient.submit()
function does not produce a Response
as the result.
Rather, it returns an HttpFuture
, which can be used to do further interactions with the endpoint.
Parameters
- httpVerb string
The HTTP verb value
- path string
The resource path
- message RequestMessage
An HTTP outbound request or any allowed payload
Return Type
(HttpFuture | ClientError)An HttpFuture
, which represents an asynchronous service invocation or else an http:ClientError
if the submission fails
getResponse
function getResponse(HttpFuture httpFuture) returns Response | ClientError
Retrieves the http:Response
for a previously-submitted request.
Parameters
- httpFuture HttpFuture
The http:HttpFuture
relates to a previous asynchronous invocation
Return Type
(Response | ClientError)An HTTP response message or else an http:ClientError
if the invocation fails
hasPromise
function hasPromise(HttpFuture httpFuture) returns boolean
Checks whether an http:PushPromise
exists for a previously-submitted request.
Parameters
- httpFuture HttpFuture
The http:HttpFuture
related to a previous asynchronous invocation
getNextPromise
function getNextPromise(HttpFuture httpFuture) returns PushPromise | ClientError
Retrieves the next available http:PushPromise
for a previously-submitted request.
Parameters
- httpFuture HttpFuture
The http:HttpFuture
related to a previous asynchronous invocation
Return Type
(PushPromise | ClientError)An HTTP Push Promise message or else an http:ClientError
if the invocation fails
getPromisedResponse
function getPromisedResponse(PushPromise promise) returns Response | ClientError
Retrieves the promised server push http:Response
message.
Parameters
- promise PushPromise
The related http:PushPromise
Return Type
(Response | ClientError)A promised HTTP http:Response
message or else an http:ClientError
if the invocation fails
rejectPromise
function rejectPromise(PushPromise promise)
Rejects an http:PushPromise
. When an http:PushPromise
is rejected, there is no chance of fetching a promised
response using the rejected promise.
Parameters
- promise PushPromise
The Push Promise to be rejected