net.sf.serfj.client

Class Client

java.lang.Object

net.sf.serfj.client.Client

public class Client
extends Object

Client to manage REST calls to a REST Controller. It provides methods to make POST, GET, PUT and DELETE HTTP request to any controller. It's necessary to provide the resource's name (plural) and the action if anyone wants to be invocated.

Author:

Eduardo Yáñez

Constructor Summary

Constructors

Constructor and Description
Client() Constructor.
Client(String host) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
Object	deleteRequest(String restUrl, Map<String,String> params) Do a DELETE HTTP request to the given REST-URL.
Object	getRequest(String restUrl, Map<String,String> params) Do a GET HTTP request to the given REST-URL.
Object	postRequest(String restUrl, Map<String,String> params) Do a POST HTTP request to the given REST-URL.
Object	putRequest(String restUrl, Map<String,String> params) Do a PUT HTTP request to the given REST-URL.

Methods inherited from class java.lang.Object

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

Constructor Detail

Client

public Client()

Constructor. This constructor has to be used in case the server is in the same context as the client.

Client

public Client(String host)

Constructor.

Parameters:

host - Host which will receive the calls.

Method Detail

getRequest

public Object getRequest(String restUrl,
                Map<String,String> params)
                  throws IOException,
                         WebServiceException

Do a GET HTTP request to the given REST-URL.

Parameters:

restUrl - REST URL.

params - Parameters for adding to the query string.

Throws:

IOException - if the request go bad.

WebServiceException

postRequest

public Object postRequest(String restUrl,
                 Map<String,String> params)
                   throws IOException,
                          WebServiceException

Do a POST HTTP request to the given REST-URL.

Parameters:

restUrl - REST URL.

params - Parameters for adding to the query string.

Throws:

IOException - if the request go bad.

WebServiceException

putRequest

public Object putRequest(String restUrl,
                Map<String,String> params)
                  throws IOException,
                         WebServiceException

Do a PUT HTTP request to the given REST-URL.

Parameters:

restUrl - REST URL.

params - Parameters for adding to the query string.

Throws:

IOException - if the request go bad.

WebServiceException

deleteRequest

public Object deleteRequest(String restUrl,
                   Map<String,String> params)
                     throws IOException,
                            WebServiceException

Do a DELETE HTTP request to the given REST-URL.

Parameters:

restUrl - REST URL.

params - Parameters for adding to the query string.

Throws:

IOException - if the request go bad.

WebServiceException