org.glassfish.jersey.client.proxy
Class WebResourceFactory

java.lang.Object
  org.glassfish.jersey.client.proxy.WebResourceFactory

All Implemented Interfaces:

java.lang.reflect.InvocationHandler

public final class WebResourceFactory
extends java.lang.Object
implements java.lang.reflect.InvocationHandler

Factory for client-side representation of a resource. See the package overview for an example on how to use this class.

Author:

Martin Matula (martin.matula at oracle.com)

Method Summary

java.lang.Object	invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)
static <C> C	newResource(java.lang.Class<C> resourceInterface, WebTarget target) Creates a new client-side representation of a resource described by the interface passed in the first argument.
static <C> C	newResource(java.lang.Class<C> resourceInterface, WebTarget target, boolean ignoreResourcePath, MultivaluedMap<java.lang.String,java.lang.Object> headers, java.util.List<Cookie> cookies, Form form) Creates a new client-side representation of a resource described by the interface passed in the first argument.

Methods inherited from class java.lang.Object

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

Method Detail

newResource

public static <C> C newResource(java.lang.Class<C> resourceInterface,
                                WebTarget target)

Creates a new client-side representation of a resource described by the interface passed in the first argument. Calling this method has the same effect as calling WebResourceFactory.newResource(resourceInterface, rootTarget, false).

Type Parameters:

C - Type of the resource to be created.

Parameters:

resourceInterface - Interface describing the resource to be created.

target - WebTarget pointing to the resource or the parent of the resource.

Returns:

Instance of a class implementing the resource interface that can be used for making requests to the server.

newResource

public static <C> C newResource(java.lang.Class<C> resourceInterface,
                                WebTarget target,
                                boolean ignoreResourcePath,
                                MultivaluedMap<java.lang.String,java.lang.Object> headers,
                                java.util.List<Cookie> cookies,
                                Form form)

Creates a new client-side representation of a resource described by the interface passed in the first argument.

Type Parameters:

C - Type of the resource to be created.

Parameters:

resourceInterface - Interface describing the resource to be created.

target - WebTarget pointing to the resource or the parent of the resource.

ignoreResourcePath - If set to true, ignores path annotation on the resource interface (this is used when creating sub-resources)

headers - Header params collected from parent resources (used when creating a sub-resource)

cookies - Cookie params collected from parent resources (used when creating a sub-resource)

form - Form params collected from parent resources (used when creating a sub-resource)

Returns:

Instance of a class implementing the resource interface that can be used for making requests to the server.

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

Specified by:

invoke in interface java.lang.reflect.InvocationHandler

Throws:

java.lang.Throwable