Clients -
http :
RedirectClient
Provides redirect functionality for HTTP client remote functions.
Constructor
__init
(string url, ClientEndpointConfig config, FollowRedirects redirectConfig, HttpClient httpClient)
- url string
-
Target service url
- config ClientEndpointConfig
-
HTTP ClientEndpointConfig to be used for HTTP client invocation
- redirectConfig FollowRedirects
-
Configurations associated with redirect
- httpClient HttpClient
-
HTTP client for outbound HTTP requests
Remote Methods
The forward()
function is used to invoke an HTTP call with inbound request's HTTP verb.
The execute()
sends an HTTP request to a service with the specified HTTP verb. Redirect will be performed
only for HTTP methods.
Submits an HTTP request to a service with the specified HTTP verb.
The submit()
function does not give out a Response
as the result,
rather it returns an HttpFuture
which can be used to do further interactions with the endpoint.
Methods
If the received response for the get()
remote function is redirect eligible, redirect will be performed automatically
by this get()
function.
If the received response for the post()
remote function is redirect eligible, redirect will be performed automatically
by this post()
function.
If the received response for the head()
remote function is redirect eligible, redirect will be performed automatically
by this head()
function.
If the received response for the put()
remote function is redirect eligible, redirect will be performed automatically
by this put()
function.
If the received response for the patch()
remote function is redirect eligible, redirect will be performed automatically
by this patch()
function.
If the received response for the delete()
remote function is redirect eligible, redirect will be performed automatically
by this delete()
function.
If the received response for the options()
remote function is redirect eligible, redirect will be performed automatically
by this options()
function.
Retrieves the Response
for a previously submitted request.
Checks whether a PushPromise
exists for a previously submitted request.
Retrieves the next available PushPromise
for a previously submitted request.
Retrieves the promised server push Response
message.
Rejects a PushPromise
.
When a PushPromise
is rejected, there is no chance of fetching a promised response using the rejected promise.
Fields
- url string
-
Target service url
- config ClientEndpointConfig
-
HTTP ClientEndpointConfig to be used for HTTP client invocation
- redirectConfig FollowRedirects
-
Configurations associated with redirect
- httpClient HttpClient
-
HTTP client for outbound HTTP requests
- currentRedirectCount int 0
-
Current redirect count of the HTTP client
The forward()
function is used to invoke an HTTP call with inbound request's HTTP verb.
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
The execute()
sends an HTTP request to a service with the specified HTTP verb. Redirect will be performed
only for HTTP methods.
Parameters
- httpVerb string
-
The HTTP verb value
- path string
-
Resource path
- message RequestMessage
-
An HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
Submits an HTTP request to a service with the specified HTTP verb.
The submit()
function does not give out 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 message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(HttpFuture | ClientError) An
HttpFuture
that represents an asynchronous service invocation, or an error if the submission fails
If the received response for the get()
remote function is redirect eligible, redirect will be performed automatically
by this get()
function.
Parameters
- path string
-
Resource path
- message RequestMessage - ()
-
An optional HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
If the received response for the post()
remote function is redirect eligible, redirect will be performed automatically
by this post()
function.
Parameters
- path string
-
Resource path
- message RequestMessage
-
An HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
If the received response for the head()
remote function is redirect eligible, redirect will be performed automatically
by this head()
function.
Parameters
- path string
-
Resource path
- message RequestMessage - ()
-
An optional HTTP outbound request message or or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
If the received response for the put()
remote function is redirect eligible, redirect will be performed automatically
by this put()
function.
Parameters
- path string
-
Resource path
- message RequestMessage
-
An HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
If the received response for the patch()
remote function is redirect eligible, redirect will be performed automatically
by this patch()
function.
Parameters
- path string
-
Resource path
- message RequestMessage
-
An HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
If the received response for the delete()
remote function is redirect eligible, redirect will be performed automatically
by this delete()
function.
Parameters
- path string
-
Resource path
- message RequestMessage - ()
-
An HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
If the received response for the options()
remote function is redirect eligible, redirect will be performed automatically
by this options()
function.
Parameters
- path string
-
Resource path
- message RequestMessage - ()
-
An optional HTTP outbound request message or any payload of type
string
,xml
,json
,byte[]
,io:ReadableByteChannel
ormime:Entity[]
-
Return Type
(Response | ClientError) The HTTP
Response
message, or an error if the invocation fails
Retrieves the Response
for a previously submitted request.
Parameters
- httpFuture HttpFuture
-
The
HttpFuture
relates to a previous asynchronous invocation
-
Return Type
(Response | ClientError) An HTTP response message, or an error if the invocation fails
Checks whether a PushPromise
exists for a previously submitted request.
Parameters
- httpFuture HttpFuture
-
The
HttpFuture
relates to a previous asynchronous invocation
-
Return Type
(boolean) A
boolean
that represents whether aPushPromise
exists
Retrieves the next available PushPromise
for a previously submitted request.
Parameters
- httpFuture HttpFuture
-
The
HttpFuture
relates to a previous asynchronous invocation
-
Return Type
(PushPromise | ClientError) An HTTP Push Promise message, or an error if the invocation fails
Retrieves the promised server push Response
message.
Parameters
- promise PushPromise
-
The related
PushPromise
-
Return Type
(Response | ClientError) A promised HTTP
Response
message, or an error if the invocation fails
Rejects a PushPromise
.
When a 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