javax.ws.rs.client
Interface SyncInvoker

All Known Subinterfaces:

Invocation.Builder

All Known Implementing Classes:

ClientInvocationBuilder

public interface SyncInvoker

Uniform interface for synchronous invocation of HTTP methods.

Since:

2.0

Author:

Marek Potociar

Method Summary

Response	delete() Invoke HTTP DELETE method for the current request synchronously.
<T> T	delete(Class<T> responseType) Invoke HTTP DELETE method for the current request synchronously.
<T> T	delete(GenericType<T> responseType) Invoke HTTP DELETE method for the current request synchronously.
Response	get() Invoke HTTP GET method for the current request synchronously.
<T> T	get(Class<T> responseType) Invoke HTTP GET method for the current request synchronously.
<T> T	get(GenericType<T> 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> T	method(String name, Class<T> 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> T	method(String name, Entity<?> entity, Class<T> responseType) Invoke an arbitrary method for the current request synchronously.
<T> T	method(String name, Entity<?> entity, GenericType<T> responseType) Invoke an arbitrary method for the current request synchronously.
<T> T	method(String name, GenericType<T> responseType) Invoke an arbitrary method for the current request synchronously.
Response	options() Invoke HTTP OPTIONS method for the current request synchronously.
<T> T	options(Class<T> responseType) Invoke HTTP OPTIONS method for the current request synchronously.
<T> T	options(GenericType<T> responseType) Invoke HTTP OPTIONS method for the current request synchronously.
Response	post(Entity<?> entity) Invoke HTTP POST method for the current request synchronously.
<T> T	post(Entity<?> entity, Class<T> responseType) Invoke HTTP POST method for the current request synchronously.
<T> T	post(Entity<?> entity, GenericType<T> responseType) Invoke HTTP POST method for the current request synchronously.
Response	put(Entity<?> entity) Invoke HTTP PUT method for the current request synchronously.
<T> T	put(Entity<?> entity, Class<T> responseType) Invoke HTTP PUT method for the current request synchronously.
<T> T	put(Entity<?> entity, GenericType<T> responseType) Invoke HTTP PUT method for the current request synchronously.
Response	trace() Invoke HTTP TRACE method for the current request synchronously.
<T> T	trace(Class<T> responseType) Invoke HTTP TRACE method for the current request synchronously.
<T> T	trace(GenericType<T> responseType) Invoke HTTP TRACE method for the current request synchronously.

Method Detail

get

Response get()
             throws ClientException

Invoke HTTP GET method for the current request synchronously.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

get

<T> T get(Class<T> responseType)
      throws ClientException,
             WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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> T get(GenericType<T> responseType)
      throws ClientException,
             WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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)
             throws ClientException

Invoke HTTP PUT method for the current request synchronously.

Parameters:

entity - request entity.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

put

<T> T put(Entity<?> entity,
          Class<T> responseType)
      throws ClientException,
             WebApplicationException

Invoke HTTP PUT method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

entity - request entity.

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

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

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> T put(Entity<?> entity,
          GenericType<T> responseType)
      throws ClientException,
             WebApplicationException

Invoke HTTP PUT method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

entity - request entity.

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

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

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)
              throws ClientException

Invoke HTTP POST method for the current request synchronously.

Parameters:

entity - request entity.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

post

<T> T post(Entity<?> entity,
           Class<T> responseType)
       throws ClientException,
              WebApplicationException

Invoke HTTP POST method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

entity - request entity.

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

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

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> T post(Entity<?> entity,
           GenericType<T> responseType)
       throws ClientException,
              WebApplicationException

Invoke HTTP POST method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

entity - request entity.

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

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

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()
                throws ClientException

Invoke HTTP DELETE method for the current request synchronously.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

delete

<T> T delete(Class<T> responseType)
         throws ClientException,
                WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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> T delete(GenericType<T> responseType)
         throws ClientException,
                WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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()
              throws ClientException

Invoke HTTP HEAD method for the current request synchronously.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

options

Response options()
                 throws ClientException

Invoke HTTP OPTIONS method for the current request synchronously.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

options

<T> T options(Class<T> responseType)
          throws ClientException,
                 WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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> T options(GenericType<T> responseType)
          throws ClientException,
                 WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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()
               throws ClientException

Invoke HTTP TRACE method for the current request synchronously.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

trace

<T> T trace(Class<T> responseType)
        throws ClientException,
               WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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> T trace(GenericType<T> responseType)
        throws ClientException,
               WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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)
                throws ClientException

Invoke an arbitrary method for the current request synchronously.

Parameters:

name - method name.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

method

<T> T method(String name,
             Class<T> responseType)
         throws ClientException,
                WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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> T method(String name,
             GenericType<T> responseType)
         throws ClientException,
                WebApplicationException

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:

ClientException - in case the invocation processing has failed.

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)
                throws ClientException

Invoke an arbitrary method for the current request synchronously.

Parameters:

name - method name.

entity - request entity.

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

method

<T> T method(String name,
             Entity<?> entity,
             Class<T> responseType)
         throws ClientException,
                WebApplicationException

Invoke an arbitrary method for the current request synchronously.

Type Parameters:

T - response entity type.

Parameters:

name - method name.

entity - request entity.

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

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

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> T method(String name,
             Entity<?> entity,
             GenericType<T> responseType)
         throws ClientException,
                WebApplicationException

Invoke an arbitrary method for the current request synchronously.

Type Parameters:

T - generic response entity type.

Parameters:

name - method name.

entity - request entity.

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

Returns:

invocation response.

Throws:

ClientException - in case the invocation processing has failed.

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.