org.glassfish.jersey.client
Class JerseyClient

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

All Implemented Interfaces:

javax.ws.rs.client.Client, javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

public class JerseyClient
extends java.lang.Object
implements javax.ws.rs.client.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(javax.ws.rs.core.Configuration config, javax.net.ssl.SSLContext sslContext, javax.net.ssl.HostnameVerifier verifier) Create a new Jersey client instance.
protected	JerseyClient(javax.ws.rs.core.Configuration config, UnsafeValue<javax.net.ssl.SSLContext,java.lang.IllegalStateException> sslContextProvider, javax.net.ssl.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()
javax.net.ssl.HostnameVerifier	getHostnameVerifier() Get the hostname verifier.
javax.net.ssl.SSLContext	getSslContext()
JerseyInvocation.Builder	invocation(javax.ws.rs.core.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(java.lang.String name, java.lang.Object value)
JerseyClient	register(java.lang.Class<?> providerClass)
JerseyClient	register(java.lang.Class<?> providerClass, java.lang.Class<?>... contracts)
JerseyClient	register(java.lang.Class<?> providerClass, int bindingPriority)
JerseyClient	register(java.lang.Class<?> providerClass, java.util.Map<java.lang.Class<?>,java.lang.Integer> contracts)
JerseyClient	register(java.lang.Object provider)
JerseyClient	register(java.lang.Object provider, java.lang.Class<?>... contracts)
JerseyClient	register(java.lang.Object provider, int bindingPriority)
JerseyClient	register(java.lang.Object provider, java.util.Map<java.lang.Class<?>,java.lang.Integer> contracts)
JerseyWebTarget	target(javax.ws.rs.core.Link link)
JerseyWebTarget	target(java.lang.String uri)
JerseyWebTarget	target(java.net.URI uri)
JerseyWebTarget	target(javax.ws.rs.core.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(javax.ws.rs.core.Configuration config,
                       javax.net.ssl.SSLContext sslContext,
                       javax.net.ssl.HostnameVerifier verifier)

Create a new Jersey client instance.

Parameters:

config - jersey client configuration.

sslContext - jersey client SSL context.

verifier - jersey client host name verifier.

JerseyClient

protected JerseyClient(javax.ws.rs.core.Configuration config,
                       UnsafeValue<javax.net.ssl.SSLContext,java.lang.IllegalStateException> sslContextProvider,
                       javax.net.ssl.HostnameVerifier verifier)

Create a new Jersey client instance.

Parameters:

config - jersey client configuration.

sslContextProvider - jersey client SSL context provider.

verifier - jersey client host name verifier.

Method Detail

close

public void close()

Specified by:

close in interface javax.ws.rs.client.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(java.lang.String uri)
                       throws java.lang.IllegalArgumentException,
                              java.lang.NullPointerException

Specified by:

target in interface javax.ws.rs.client.Client

Throws:

java.lang.IllegalArgumentException

java.lang.NullPointerException

target

public JerseyWebTarget target(java.net.URI uri)
                       throws java.lang.NullPointerException

Specified by:

target in interface javax.ws.rs.client.Client

Throws:

java.lang.NullPointerException

target

public JerseyWebTarget target(javax.ws.rs.core.UriBuilder uriBuilder)
                       throws java.lang.NullPointerException

Specified by:

target in interface javax.ws.rs.client.Client

Throws:

java.lang.NullPointerException

target

public JerseyWebTarget target(javax.ws.rs.core.Link link)
                       throws java.lang.NullPointerException

Specified by:

target in interface javax.ws.rs.client.Client

Throws:

java.lang.NullPointerException

invocation

public JerseyInvocation.Builder invocation(javax.ws.rs.core.Link link)
                                    throws java.lang.NullPointerException,
                                           java.lang.IllegalArgumentException

Specified by:

invocation in interface javax.ws.rs.client.Client

Throws:

java.lang.NullPointerException

java.lang.IllegalArgumentException

register

public JerseyClient register(java.lang.Class<?> providerClass)

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

public JerseyClient register(java.lang.Object provider)

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

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

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

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

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

public JerseyClient register(java.lang.Class<?> providerClass,
                             java.util.Map<java.lang.Class<?>,java.lang.Integer> contracts)

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

public JerseyClient register(java.lang.Object provider,
                             int bindingPriority)

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

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

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

register

public JerseyClient register(java.lang.Object provider,
                             java.util.Map<java.lang.Class<?>,java.lang.Integer> contracts)

Specified by:

register in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

property

public JerseyClient property(java.lang.String name,
                             java.lang.Object value)

Specified by:

property in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

getConfiguration

public ClientConfig getConfiguration()

Specified by:

getConfiguration in interface javax.ws.rs.core.Configurable<javax.ws.rs.client.Client>

getSslContext

public javax.net.ssl.SSLContext getSslContext()

Specified by:

getSslContext in interface javax.ws.rs.client.Client

getHostnameVerifier

public javax.net.ssl.HostnameVerifier getHostnameVerifier()

Get the hostname verifier.

Specified by:

getHostnameVerifier in interface javax.ws.rs.client.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.