com.sun.jersey.api.client
Class WebResource.Builder

java.lang.Object
  extended by com.sun.jersey.api.client.PartialRequestBuilder<WebResource.Builder>
      extended by com.sun.jersey.api.client.WebResource.Builder
All Implemented Interfaces:
RequestBuilder<WebResource.Builder>, UniformInterface
Enclosing class:
WebResource

public final class WebResource.Builder
extends PartialRequestBuilder<WebResource.Builder>
implements UniformInterface

The builder for building a ClientRequest instance and handling the request using the UniformInterface. The methods of the UniformInterface are the build methods of the builder.


Field Summary
 
Fields inherited from class com.sun.jersey.api.client.PartialRequestBuilder
entity, metadata
 
Method Summary
 void delete()
          Invoke the DELETE method with no request entity or response.
<T> T
delete(java.lang.Class<T> c)
          Invoke the DELETE method with no request entity that returns a response.
<T> T
delete(java.lang.Class<T> c, java.lang.Object requestEntity)
          Invoke the DELETE method with a request entity that returns a response.
<T> T
delete(GenericType<T> gt)
          Invoke the DELETE method with a request entity that returns a response.
<T> T
delete(GenericType<T> gt, java.lang.Object requestEntity)
          Invoke the DELETE method with a request entity that returns a response.
 void delete(java.lang.Object requestEntity)
          Invoke the DELETE method with a request entity but no response.
<T> T
get(java.lang.Class<T> c)
          Invoke the GET method.
<T> T
get(GenericType<T> gt)
          Invoke the GET method.
 ClientResponse head()
          Invoke the HEAD method.
 void method(java.lang.String method)
          Invoke a HTTP method with no request entity or response.
<T> T
method(java.lang.String method, java.lang.Class<T> c)
          Invoke a HTTP method with no request entity that returns a response.
<T> T
method(java.lang.String method, java.lang.Class<T> c, java.lang.Object requestEntity)
          Invoke a HTTP method with a request entity that returns a response.
<T> T
method(java.lang.String method, GenericType<T> gt)
          Invoke a HTTP method with no request entity that returns a response.
<T> T
method(java.lang.String method, GenericType<T> gt, java.lang.Object requestEntity)
          Invoke a HTTP method with a request entity that returns a response.
 void method(java.lang.String method, java.lang.Object requestEntity)
          Invoke a HTTP method with a request entity but no response.
<T> T
options(java.lang.Class<T> c)
          Invoke the OPTIONS method.
<T> T
options(GenericType<T> gt)
          Invoke the OPTIONS method.
 void post()
          Invoke the POST method with no request entity or response.
<T> T
post(java.lang.Class<T> c)
          Invoke the POST method with no request entity that returns a response.
<T> T
post(java.lang.Class<T> c, java.lang.Object requestEntity)
          Invoke the POST method with a request entity that returns a response.
<T> T
post(GenericType<T> gt)
          Invoke the POST method with a request entity that returns a response.
<T> T
post(GenericType<T> gt, java.lang.Object requestEntity)
          Invoke the POST method with a request entity that returns a response.
 void post(java.lang.Object requestEntity)
          Invoke the POST method with a request entity but no response.
 void put()
          Invoke the PUT method with no request entity or response.
<T> T
put(java.lang.Class<T> c)
          Invoke the PUT method with no request entity that returns a response.
<T> T
put(java.lang.Class<T> c, java.lang.Object requestEntity)
          Invoke the PUT method with a request entity that returns a response.
<T> T
put(GenericType<T> gt)
          Invoke the PUT method with a request entity that returns a response.
<T> T
put(GenericType<T> gt, java.lang.Object requestEntity)
          Invoke the PUT method with a request entity that returns a response.
 void put(java.lang.Object requestEntity)
          Invoke the PUT method with a request entity but no response.
 
Methods inherited from class com.sun.jersey.api.client.PartialRequestBuilder
accept, accept, acceptLanguage, acceptLanguage, cookie, entity, entity, entity, header, type, type
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

head

public ClientResponse head()
Description copied from interface: UniformInterface
Invoke the HEAD method.

Specified by:
head in interface UniformInterface
Returns:
the HTTP response.

options

public <T> T options(java.lang.Class<T> c)
Description copied from interface: UniformInterface
Invoke the OPTIONS method.

Specified by:
options in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
Returns:
an instance of type c.

options

public <T> T options(GenericType<T> gt)
Description copied from interface: UniformInterface
Invoke the OPTIONS method.

Specified by:
options in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
Returns:
an instance of type represented by the generic type.

get

public <T> T get(java.lang.Class<T> c)
Description copied from interface: UniformInterface
Invoke the GET method.

Specified by:
get in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
Returns:
an instance of type c.

get

public <T> T get(GenericType<T> gt)
Description copied from interface: UniformInterface
Invoke the GET method.

Specified by:
get in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
Returns:
an instance of type represented by the generic type.

put

public void put()
Description copied from interface: UniformInterface
Invoke the PUT method with no request entity or response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
put in interface UniformInterface

put

public void put(java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the PUT method with a request entity but no response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
put in interface UniformInterface
Parameters:
requestEntity - the request entity.

put

public <T> T put(java.lang.Class<T> c)
Description copied from interface: UniformInterface
Invoke the PUT method with no request entity that returns a response.

Specified by:
put in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
Returns:
an instance of type c.

put

public <T> T put(GenericType<T> gt)
Description copied from interface: UniformInterface
Invoke the PUT method with a request entity that returns a response.

Specified by:
put in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
Returns:
an instance of type represented by the generic type.

put

public <T> T put(java.lang.Class<T> c,
                 java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the PUT method with a request entity that returns a response.

Specified by:
put in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type c.

put

public <T> T put(GenericType<T> gt,
                 java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the PUT method with a request entity that returns a response.

Specified by:
put in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type represented by the generic type.

post

public void post()
Description copied from interface: UniformInterface
Invoke the POST method with no request entity or response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
post in interface UniformInterface

post

public void post(java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the POST method with a request entity but no response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
post in interface UniformInterface
Parameters:
requestEntity - the request entity.

post

public <T> T post(java.lang.Class<T> c)
Description copied from interface: UniformInterface
Invoke the POST method with no request entity that returns a response.

Specified by:
post in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
Returns:
an instance of type c.

post

public <T> T post(GenericType<T> gt)
Description copied from interface: UniformInterface
Invoke the POST method with a request entity that returns a response.

Specified by:
post in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
Returns:
an instance of type represented by the generic type.

post

public <T> T post(java.lang.Class<T> c,
                  java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the POST method with a request entity that returns a response.

Specified by:
post in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type c.

post

public <T> T post(GenericType<T> gt,
                  java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the POST method with a request entity that returns a response.

Specified by:
post in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type represented by the generic type.

delete

public void delete()
Description copied from interface: UniformInterface
Invoke the DELETE method with no request entity or response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
delete in interface UniformInterface

delete

public void delete(java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the DELETE method with a request entity but no response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
delete in interface UniformInterface
Parameters:
requestEntity - the request entity.

delete

public <T> T delete(java.lang.Class<T> c)
Description copied from interface: UniformInterface
Invoke the DELETE method with no request entity that returns a response.

Specified by:
delete in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
Returns:
an instance of type c.

delete

public <T> T delete(GenericType<T> gt)
Description copied from interface: UniformInterface
Invoke the DELETE method with a request entity that returns a response.

Specified by:
delete in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
Returns:
an instance of type represented by the generic type.

delete

public <T> T delete(java.lang.Class<T> c,
                    java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the DELETE method with a request entity that returns a response.

Specified by:
delete in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
c - the type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type c.

delete

public <T> T delete(GenericType<T> gt,
                    java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke the DELETE method with a request entity that returns a response.

Specified by:
delete in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
gt - the generic type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type represented by the generic type.

method

public void method(java.lang.String method)
Description copied from interface: UniformInterface
Invoke a HTTP method with no request entity or response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
method in interface UniformInterface
Parameters:
method - the HTTP method.

method

public void method(java.lang.String method,
                   java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke a HTTP method with a request entity but no response.

If the status code is less than 300 and a representation is present then that representation is ignored.

Specified by:
method in interface UniformInterface
Parameters:
method - the HTTP method.
requestEntity - the request entity.

method

public <T> T method(java.lang.String method,
                    java.lang.Class<T> c)
Description copied from interface: UniformInterface
Invoke a HTTP method with no request entity that returns a response.

Specified by:
method in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
method - the HTTP method.
c - the type of the returned response.
Returns:
an instance of type c.

method

public <T> T method(java.lang.String method,
                    GenericType<T> gt)
Description copied from interface: UniformInterface
Invoke a HTTP method with no request entity that returns a response.

Specified by:
method in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
method - the HTTP method.
gt - the generic type of the returned response.
Returns:
an instance of type represented by the generic type.

method

public <T> T method(java.lang.String method,
                    java.lang.Class<T> c,
                    java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke a HTTP method with a request entity that returns a response.

Specified by:
method in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
method - the HTTP method.
c - the type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type c.

method

public <T> T method(java.lang.String method,
                    GenericType<T> gt,
                    java.lang.Object requestEntity)
Description copied from interface: UniformInterface
Invoke a HTTP method with a request entity that returns a response.

Specified by:
method in interface UniformInterface
Type Parameters:
T - the type of the response.
Parameters:
method - the HTTP method.
gt - the generic type of the returned response.
requestEntity - the request entity.
Returns:
an instance of type represented by the generic type.


Copyright © 2008 Sun Microsystems, Inc. All Rights Reserved.