org.glassfish.jersey.client
Class JerseyClient

java.lang.Object
  org.glassfish.jersey.client.JerseyClient

All Implemented Interfaces:

Client, Configurable<Client>

public class JerseyClient
extends Object
implements Client

Jersey implementation of JAX-RS JerseyClient contract.

Author:

Marek Potociar (marek.potociar at oracle.com)

Constructor Summary

protected	JerseyClient() Create a new Jersey client instance using a default configuration.
protected	JerseyClient(Configuration config, SSLContext sslContext, HostnameVerifier verifier) Create a new Jersey client instance.

Method Summary

void	addListener(org.glassfish.jersey.client.JerseyClient.LifecycleListener listener) Add a new client lifecycle listener.
void	close()
ClientConfig	getConfiguration()
HostnameVerifier	getHostnameVerifier() Get the hostname verifier.
SSLContext	getSslContext()
JerseyInvocation.Builder	invocation(Link link)
boolean	isClosed() Check client state.
JerseyClient	preInitialize() Pre initializes the configuration of this client in order to improve performance during the first request.
JerseyClient	property(String name, Object value)
JerseyClient	register(Class<?> providerClass)
JerseyClient	register(Class<?> providerClass, Class<?>... contracts)
JerseyClient	register(Class<?> providerClass, int bindingPriority)
JerseyClient	register(Class<?> providerClass, Map<Class<?>,Integer> contracts)
JerseyClient	register(Object provider)
JerseyClient	register(Object provider, Class<?>... contracts)
JerseyClient	register(Object provider, int bindingPriority)
JerseyClient	register(Object provider, Map<Class<?>,Integer> contracts)
JerseyWebTarget	target(Link link)
JerseyWebTarget	target(String uri)
JerseyWebTarget	target(URI uri)
JerseyWebTarget	target(UriBuilder uriBuilder)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

JerseyClient

protected JerseyClient()

Create a new Jersey client instance using a default configuration.

JerseyClient

protected JerseyClient(Configuration config,
                       SSLContext sslContext,
                       HostnameVerifier verifier)

Create a new Jersey client instance.

Parameters:

config - jersey client configuration.

sslContext - jersey client SSL context.

verifier - jersey client host name verifier.

Method Detail

close

public void close()

Specified by:

close in interface Client

addListener

public void addListener(org.glassfish.jersey.client.JerseyClient.LifecycleListener listener)

Add a new client lifecycle listener.

Parameters:

listener - client lifecycle listener.

isClosed

public boolean isClosed()

Check client state.

Returns:

true if current JerseyClient instance is closed, otherwise false.

See Also:

close()

target

public JerseyWebTarget target(String uri)
                       throws IllegalArgumentException,
                              NullPointerException

Specified by:

target in interface Client

Throws:

IllegalArgumentException

NullPointerException

target

public JerseyWebTarget target(URI uri)
                       throws NullPointerException

Specified by:

target in interface Client

Throws:

NullPointerException

target

public JerseyWebTarget target(UriBuilder uriBuilder)
                       throws NullPointerException

Specified by:

target in interface Client

Throws:

NullPointerException

target

public JerseyWebTarget target(Link link)
                       throws NullPointerException

Specified by:

target in interface Client

Throws:

NullPointerException

invocation

public JerseyInvocation.Builder invocation(Link link)
                                    throws NullPointerException,
                                           IllegalArgumentException

Specified by:

invocation in interface Client

Throws:

NullPointerException

IllegalArgumentException

register

public JerseyClient register(Class<?> providerClass)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Object provider)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Class<?> providerClass,
                             int bindingPriority)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Class<?> providerClass,
                             Class<?>... contracts)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Class<?> providerClass,
                             Map<Class<?>,Integer> contracts)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Object provider,
                             int bindingPriority)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Object provider,
                             Class<?>... contracts)

Specified by:

register in interface Configurable<Client>

register

public JerseyClient register(Object provider,
                             Map<Class<?>,Integer> contracts)

Specified by:

register in interface Configurable<Client>

property

public JerseyClient property(String name,
                             Object value)

Specified by:

property in interface Configurable<Client>

getConfiguration

public ClientConfig getConfiguration()

Specified by:

getConfiguration in interface Configurable<Client>

getSslContext

public SSLContext getSslContext()

Specified by:

getSslContext in interface Client

getHostnameVerifier

public HostnameVerifier getHostnameVerifier()

Get the hostname verifier.

Specified by:

getHostnameVerifier in interface Client

Returns:

the configured hostname verifier, or null if not set.

preInitialize

public JerseyClient preInitialize()

Pre initializes the configuration of this client in order to improve performance during the first request.

Once this method is called no other method implementing Configurable should be called on this pre initialized JerseyClient instance, otherwise configuration will change back to uninitialized.

Returns:

Jersey client.