org.dmfs.httpclientinterfaces

Interface HttpRequestExecutor

public interface HttpRequestExecutor

The interface of an instance that knows how to execute an HttpRequest.

It's worth noting, that the request URI is never determined by the request. All execute methods take a dedicated URI parameter.

Author:

Marten Gajda

Method Summary

Modifier and Type	Method and Description
<T> T	execute(java.net.URI uri, HttpRequest<T> request) Sends the given HttpRequest to the given URI and returns the result.
<T> T	execute(java.net.URI uri, HttpRequest<T> request, OnRedirectCallback redirectionCallback) Sends the given HttpRequest to the given URI and returns the result.
<T> void	execute(java.net.URI uri, HttpRequest<T> request, OnResponseCallback<T> callback) Sends the given HttpRequest to the given URI and calls an OnResponseCallback with the result.
<T> void	execute(java.net.URI uri, HttpRequest<T> request, OnResponseCallback<T> callback, OnRedirectCallback redirectionCallback) Sends the given HttpRequest to the given URI and calls an OnResponseCallback with the result.

Method Detail

execute

<T> T execute(java.net.URI uri,
              HttpRequest<T> request)
       throws java.io.IOException,
              ProtocolError,
              ProtocolException,
              RedirectionException,
              UnexpectedResponseException

Sends the given HttpRequest to the given URI and returns the result. This method uses the default redirection handling policy as configured in the executer instance.

Parameters:

uri - The URI to send this request to.

request - The request to execute.

Returns:

The result, i.e. the handled server response.

Throws:

java.io.IOException

ProtocolError

ProtocolException

RedirectionException

UnexpectedResponseException

execute

<T> T execute(java.net.URI uri,
              HttpRequest<T> request,
              OnRedirectCallback redirectionCallback)
       throws java.io.IOException,
              ProtocolError,
              ProtocolException,
              RedirectionException,
              UnexpectedResponseException

Sends the given HttpRequest to the given URI and returns the result. This method uses a custom OnRedirectCallback to handle any redirections.

Parameters:

uri - The URI to send this request to.

request - The request to execute.

redirectionCallback - An OnRedirectCallback that determines how to handle any redirections.

Returns:

The result, i.e. the handled server response.

Throws:

java.io.IOException

ProtocolError

ProtocolException

RedirectionException

UnexpectedResponseException

execute

<T> void execute(java.net.URI uri,
                 HttpRequest<T> request,
                 OnResponseCallback<T> callback)

Sends the given HttpRequest to the given URI and calls an OnResponseCallback with the result. This method uses the default redirection handling policy as configured in the executer instance. This method may be executed asynchronously, so the caller must be aware that the result may not be available yet, when the method returns.

Parameters:

uri - The URI to send this request to.

request - The request to execute.

callback - An OnResponseCallback to call with the result of the request.

execute

<T> void execute(java.net.URI uri,
                 HttpRequest<T> request,
                 OnResponseCallback<T> callback,
                 OnRedirectCallback redirectionCallback)

Sends the given HttpRequest to the given URI and calls an OnResponseCallback with the result. This method uses a custom OnRedirectCallback to handle any redirections. This method may be executed asynchronously, so the caller must be aware that the result may not be available yet, when the method returns.

Parameters:

uri - The URI to send this request to.

request - The request to execute.

callback - An OnResponseCallback to call with the result of the request.

redirectionCallback - An OnRedirectCallback that determines how to handle any redirections.