javax.ws.rs.client

Interface SyncInvoker

All Known Subinterfaces:

Invocation.Builder

public interface SyncInvoker

Uniform interface for synchronous invocation of HTTP methods.

Since:

2.0

Author:

Marek Potociar

Method Summary

Modifier and Type	Method and Description
Response	delete() Invoke HTTP DELETE method for the current request synchronously.
T	delete(Class responseType) Invoke HTTP DELETE method for the current request synchronously.
T	delete(GenericType responseType) Invoke HTTP DELETE method for the current request synchronously.
Response	get() Invoke HTTP GET method for the current request synchronously.
T	get(Class responseType) Invoke HTTP GET method for the current request synchronously.
T	get(GenericType responseType) Invoke HTTP GET method for the current request synchronously.
Response	head() Invoke HTTP HEAD method for the current request synchronously.
Response	method(String name) Invoke an arbitrary method for the current request synchronously.
T	method(String name, Class responseType) Invoke an arbitrary method for the current request synchronously.
Response	method(String name, Entity entity) Invoke an arbitrary method for the current request synchronously.
T	method(String name, Entity entity, Class responseType) Invoke an arbitrary method for the current request synchronously.
T	method(String name, Entity entity, GenericType responseType) Invoke an arbitrary method for the current request synchronously.
T	method(String name, GenericType responseType) Invoke an arbitrary method for the current request synchronously.
Response	options() Invoke HTTP OPTIONS method for the current request synchronously.
T	options(Class responseType) Invoke HTTP OPTIONS method for the current request synchronously.
T	options(GenericType responseType) Invoke HTTP OPTIONS method for the current request synchronously.
Response	post(Entity entity) Invoke HTTP POST method for the current request synchronously.
T	post(Entity entity, Class responseType) Invoke HTTP POST method for the current request synchronously.
T	post(Entity entity, GenericType responseType) Invoke HTTP POST method for the current request synchronously.
Response	put(Entity entity) Invoke HTTP PUT method for the current request synchronously.
T	put(Entity entity, Class responseType) Invoke HTTP PUT method for the current request synchronously.
T	put(Entity entity, GenericType responseType) Invoke HTTP PUT method for the current request synchronously.
Response	trace() Invoke HTTP TRACE method for the current request synchronously.
T	trace(Class responseType) Invoke HTTP TRACE method for the current request synchronously.
T	trace(GenericType responseType) Invoke HTTP TRACE method for the current request synchronously.

Method Detail

get

Response get()

Invoke HTTP GET method for the current request synchronously.

Returns:

invocation response.

Throws:

ProcessingException - in case the invocation processing has failed.

get

 T get(Class responseType)

Invoke HTTP GET method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

get

 T get(GenericType responseType)

Invoke HTTP GET method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response

put

Response put(Entity entity)

Invoke HTTP PUT method for the current request synchronously.

Parameters:

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

put

 T put(Entity entity,
          Class responseType)

Invoke HTTP PUT method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

put

 T put(Entity entity,
          GenericType responseType)

Invoke HTTP PUT method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.

post

Response post(Entity entity)

Invoke HTTP POST method for the current request synchronously.

Parameters:

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

post

 T post(Entity entity,
           Class responseType)

Invoke HTTP POST method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

post

 T post(Entity entity,
           GenericType responseType)

Invoke HTTP POST method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.

delete

Response delete()

Invoke HTTP DELETE method for the current request synchronously.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

delete

 T delete(Class responseType)

Invoke HTTP DELETE method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

delete

 T delete(GenericType responseType)

Invoke HTTP DELETE method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.

head

Response head()

Invoke HTTP HEAD method for the current request synchronously.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

options

Response options()

Invoke HTTP OPTIONS method for the current request synchronously.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

options

 T options(Class responseType)

Invoke HTTP OPTIONS method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

options

 T options(GenericType responseType)

Invoke HTTP OPTIONS method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.

trace

Response trace()

Invoke HTTP TRACE method for the current request synchronously.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

trace

 T trace(Class responseType)

Invoke HTTP TRACE method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

trace

 T trace(GenericType responseType)

Invoke HTTP TRACE method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.

method

Response method(String name)

Invoke an arbitrary method for the current request synchronously.

Parameters:

name - method name.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

method

 T method(String name,
             Class responseType)

Invoke an arbitrary method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

name - method name.

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

method

 T method(String name,
             GenericType responseType)

Invoke an arbitrary method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

name - method name.

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.

method

Response method(String name,
                Entity entity)

Invoke an arbitrary method for the current request synchronously.

Parameters:

name - method name.

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

method

 T method(String name,
             Entity entity,
             Class responseType)

Invoke an arbitrary method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

name - method name.

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

responseType - Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified response type is not Response.

method

 T method(String name,
             Entity entity,
             GenericType responseType)

Invoke an arbitrary method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

name - method name.

entity - request entity, including it's full Variant information. Any variant-related HTTP headers previously set (namely Content-Type, Content-Language and Content-Encoding) will be overwritten using the entity variant information.

responseType - representation of a generic Java type the response entity will be converted to.

Returns:

invocation response.

Throws:

ResponseProcessingException - in case processing of a received HTTP response fails (e.g. in a filter or during conversion of the response entity data to an instance of a particular Java type).

ProcessingException - in case the request processing or subsequent I/O operation fails.

WebApplicationException - in case the response status code of the response returned by the server is not successful and the specified generic response type does not represent Response.