org.apache.slider.client.rest

Class BaseRestClient

java.lang.Object

org.apache.slider.client.rest.BaseRestClient

Direct Known Subclasses:

SliderApplicationApiRestClient

public class BaseRestClient
extends Object

This is a base class for Jersey REST clients in Slider. It supports the execution of operations —with exceptions uprated to IOExceptions when needed.

Subclasses can use these operations to provide an API-like view of the REST model

Constructor Summary

Constructors

Constructor and Description
BaseRestClient(com.sun.jersey.api.client.Client client)

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	exec(HttpVerb method, com.sun.jersey.api.client.WebResource resource, Class<T> c) Execute the operation.
<T> T	exec(HttpVerb method, com.sun.jersey.api.client.WebResource resource, com.sun.jersey.api.client.GenericType<T> t) Execute the operation.
<T> T	get(com.sun.jersey.api.client.WebResource resource, Class<T> c) Execute the GET operation.
com.sun.jersey.api.client.Client	getClient() Get the jersey client
com.sun.jersey.api.client.WebResource	resource(String url) Create a Web resource from the client.
com.sun.jersey.api.client.WebResource	resource(URI u) Create a Web resource from the client.

Methods inherited from class java.lang.Object

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

Constructor Detail

BaseRestClient

public BaseRestClient(com.sun.jersey.api.client.Client client)

Method Detail

getClient

public com.sun.jersey.api.client.Client getClient()

Get the jersey client

Returns:

jersey client

exec

public <T> T exec(HttpVerb method,
         com.sun.jersey.api.client.WebResource resource,
         Class<T> c)
       throws IOException

Execute the operation. Failures are raised as IOException subclasses

Type Parameters:

T - type expected

Parameters:

method - method to execute

resource - resource to work against

c - class to build

Returns:

an instance of the type T

Throws:

IOException - on any failure

exec

public <T> T exec(HttpVerb method,
         com.sun.jersey.api.client.WebResource resource,
         com.sun.jersey.api.client.GenericType<T> t)
       throws IOException

Execute the operation. Failures are raised as IOException subclasses

Type Parameters:

T - type expected

Parameters:

method - method to execute

resource - resource to work against

t - type to work with

Returns:

an instance of the type T

Throws:

IOException - on any failure

get

public <T> T get(com.sun.jersey.api.client.WebResource resource,
        Class<T> c)
      throws IOException

Execute the GET operation. Failures are raised as IOException subclasses

Type Parameters:

T - type expected

Parameters:

resource - resource to work against

c - class to build

Returns:

an instance of the type T

Throws:

IOException - on any failure

resource

public com.sun.jersey.api.client.WebResource resource(URI u)

Create a Web resource from the client.

Parameters:

u - the URI of the resource.

Returns:

the Web resource.

resource

public com.sun.jersey.api.client.WebResource resource(String url)

Create a Web resource from the client.

Parameters:

u - the URI of the resource.

Returns:

the Web resource.