org.apache.slider.client.rest

Class SliderApplicationApiRestClient

java.lang.Object

org.apache.slider.client.rest.BaseRestClient

org.apache.slider.client.rest.SliderApplicationApiRestClient

All Implemented Interfaces:

SliderApplicationApi

public class SliderApplicationApiRestClient
extends BaseRestClient
implements SliderApplicationApi

Implementation of the SliderApplicationApi

Constructor Summary

Constructors

Constructor and Description
SliderApplicationApiRestClient(com.sun.jersey.api.client.Client jerseyClient, String appmaster) Create an instance
SliderApplicationApiRestClient(com.sun.jersey.api.client.Client jerseyClient, com.sun.jersey.api.client.WebResource appResource) Create an instance

Method Summary

Methods

Modifier and Type	Method and Description
com.sun.jersey.api.client.WebResource	applicationResource(String subpath) Create a resource under the application path
<T> T	appResourceOperation(HttpVerb method, String subpath, Class<T> c)
<T> T	appResourceOperation(HttpVerb method, String subpath, com.sun.jersey.api.client.GenericType<T> t) Get operation against a path under the Application
Map<String,ComponentInformation>	enumComponents() List all components into a map of [name:info]
Map<String,ContainerInformation>	enumContainers() Get a map of live containers [containerId:info]
ApplicationLivenessInformation	getApplicationLiveness() Get the application liveness
<T> T	getApplicationResource(String subpath, Class<T> c) Get operation against a path under the Application
<T> T	getApplicationResource(String subpath, com.sun.jersey.api.client.GenericType<T> t) Get operation against a path under the Application
ComponentInformation	getComponent(String componentName) Get information about a component
ContainerInformation	getContainer(String containerId) Get a container from the container Id
ConfTreeOperations	getDesiredAppconf() Get the desired application configuration
AggregateConf	getDesiredModel() Get the aggregate desired model
ConfTreeOperations	getDesiredResources() Get the desired YARN resources
NodeInformation	getLiveNode(String hostname) Get information about a node
NodeInformationList	getLiveNodes() List all nodes into a map of [name:info]
ConfTreeOperations	getLiveResources() Get the live YARN resources
ConfTreeOperations	getResolvedAppconf() Get the resolved application configuration
AggregateConf	getResolvedModel() Get the aggregate resolved model
ConfTreeOperations	getResolvedResources() Get the resolved YARN resources
PingInformation	ping(String text) Ping as a GET
PingInformation	pingGet(String text) Ping as a GET
PingInformation	pingPost(String text) Ping as a POST
PingInformation	pingPut(String text) Ping as a POST
void	putDesiredResources(ConfTree updated) Put an updated resources structure.
void	stop(String text) Stop the AM (async operation)
String	toString()

Methods inherited from class org.apache.slider.client.rest.BaseRestClient

exec, exec, get, getClient, resource, resource

Methods inherited from class java.lang.Object

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

Constructor Detail

SliderApplicationApiRestClient

public SliderApplicationApiRestClient(com.sun.jersey.api.client.Client jerseyClient,
                              com.sun.jersey.api.client.WebResource appResource)

Create an instance

Parameters:

jerseyClient - jersey client for operations

appResource - resource of application API

SliderApplicationApiRestClient

public SliderApplicationApiRestClient(com.sun.jersey.api.client.Client jerseyClient,
                              String appmaster)

Create an instance

Parameters:

jerseyClient - jersey client for operations

appmaster - URL of appmaster/proxy to AM

Method Detail

toString

public String toString()

Overrides:

toString in class Object

applicationResource

public com.sun.jersey.api.client.WebResource applicationResource(String subpath)

Create a resource under the application path

Parameters:

subpath - path under application

Returns:

a resource under the application path

getApplicationResource

public <T> T getApplicationResource(String subpath,
                           Class<T> c)
                         throws IOException

Get operation against a path under the Application

Type Parameters:

T - type expected

Parameters:

subpath - path

c - class to instantiate

Returns:

instance

Throws:

IOException - on any problem

getApplicationResource

public <T> T getApplicationResource(String subpath,
                           com.sun.jersey.api.client.GenericType<T> t)
                         throws IOException

Get operation against a path under the Application

Type Parameters:

T - type expected

Parameters:

subpath - path

t - type info

Returns:

instance

Throws:

IOException - on any problem

appResourceOperation

public <T> T appResourceOperation(HttpVerb method,
                         String subpath,
                         Class<T> c)
                       throws IOException

Type Parameters:

T - type expected

Parameters:

method - method to exec

subpath - path

c - class to instantiate

Returns:

instance

Throws:

IOException - on any problem

appResourceOperation

public <T> T appResourceOperation(HttpVerb method,
                         String subpath,
                         com.sun.jersey.api.client.GenericType<T> t)
                       throws IOException

Get operation against a path under the Application

Type Parameters:

T - type expected

Parameters:

subpath - path

t - type info

Returns:

instance

Throws:

IOException - on any problem

getDesiredModel

public AggregateConf getDesiredModel()
                              throws IOException

Description copied from interface: SliderApplicationApi

Get the aggregate desired model

Specified by:

getDesiredModel in interface SliderApplicationApi

Returns:

the aggregate configuration of what was asked for -before resolution has taken place

Throws:

IOException - on any failure

getDesiredAppconf

public ConfTreeOperations getDesiredAppconf()
                                     throws IOException

Description copied from interface: SliderApplicationApi

Get the desired application configuration

Specified by:

getDesiredAppconf in interface SliderApplicationApi

Returns:

the application configuration asked for -before resolution has taken place

Throws:

IOException - on any failure

getDesiredResources

public ConfTreeOperations getDesiredResources()
                                       throws IOException

Description copied from interface: SliderApplicationApi

Get the desired YARN resources

Specified by:

getDesiredResources in interface SliderApplicationApi

Returns:

the resources asked for -before resolution has taken place

Throws:

IOException - on any failure

putDesiredResources

public void putDesiredResources(ConfTree updated)
                         throws IOException

Description copied from interface: SliderApplicationApi

Put an updated resources structure. This triggers a cluster flex operation

Specified by:

putDesiredResources in interface SliderApplicationApi

Parameters:

updated - updated resources

Throws:

IOException - on any problem.

getResolvedModel

public AggregateConf getResolvedModel()
                               throws IOException

Description copied from interface: SliderApplicationApi

Get the aggregate resolved model

Specified by:

getResolvedModel in interface SliderApplicationApi

Returns:

the aggregate configuration of what was asked for -after resolution has taken place

Throws:

IOException - on any failure

getResolvedAppconf

public ConfTreeOperations getResolvedAppconf()
                                      throws IOException

Description copied from interface: SliderApplicationApi

Get the resolved application configuration

Specified by:

getResolvedAppconf in interface SliderApplicationApi

Returns:

the application configuration asked for -after resolution has taken place

Throws:

IOException - on any failure

getResolvedResources

public ConfTreeOperations getResolvedResources()
                                        throws IOException

Description copied from interface: SliderApplicationApi

Get the resolved YARN resources

Specified by:

getResolvedResources in interface SliderApplicationApi

Returns:

the resources asked for -after resolution has taken place

Throws:

IOException - on any failure

getLiveResources

public ConfTreeOperations getLiveResources()
                                    throws IOException

Description copied from interface: SliderApplicationApi

Get the live YARN resources

Specified by:

getLiveResources in interface SliderApplicationApi

Returns:

the live set of resources in the cluster

Throws:

IOException - on any failure

enumContainers

public Map<String,ContainerInformation> enumContainers()
                                                throws IOException

Description copied from interface: SliderApplicationApi

Get a map of live containers [containerId:info]

Specified by:

enumContainers in interface SliderApplicationApi

Returns:

a possibly empty list of serialized containers

Throws:

IOException - on any failure

getContainer

public ContainerInformation getContainer(String containerId)
                                  throws IOException

Description copied from interface: SliderApplicationApi

Get a container from the container Id

Specified by:

getContainer in interface SliderApplicationApi

Parameters:

containerId - YARN container ID

Returns:

the container information

Throws:

IOException - on any failure

enumComponents

public Map<String,ComponentInformation> enumComponents()
                                                throws IOException

Description copied from interface: SliderApplicationApi

List all components into a map of [name:info]

Specified by:

enumComponents in interface SliderApplicationApi

Returns:

a possibly empty map of components

Throws:

IOException - on any failure

getComponent

public ComponentInformation getComponent(String componentName)
                                  throws IOException

Description copied from interface: SliderApplicationApi

Get information about a component

Specified by:

getComponent in interface SliderApplicationApi

Parameters:

componentName - name of the component

Returns:

the component details

Throws:

IOException - on any failure

getLiveNodes

public NodeInformationList getLiveNodes()
                                 throws IOException

Description copied from interface: SliderApplicationApi

List all nodes into a map of [name:info]

Specified by:

getLiveNodes in interface SliderApplicationApi

Returns:

a possibly empty list of nodes

Throws:

IOException - on any failure

getLiveNode

public NodeInformation getLiveNode(String hostname)
                            throws IOException

Description copied from interface: SliderApplicationApi

Get information about a node

Specified by:

getLiveNode in interface SliderApplicationApi

Parameters:

hostname - name of the node

Returns:

the node details

Throws:

IOException - on any failure

ping

public PingInformation ping(String text)
                     throws IOException

Description copied from interface: SliderApplicationApi

Ping as a GET

Specified by:

ping in interface SliderApplicationApi

Parameters:

text - text to include

Returns:

the response

Throws:

IOException - on any failure

pingGet

public PingInformation pingGet(String text)
                        throws IOException

Ping as a GET

Parameters:

text - text to include

Returns:

the response

Throws:

IOException - on any failure

pingPost

public PingInformation pingPost(String text)
                         throws IOException

Ping as a POST

Parameters:

text - text to include

Returns:

the response

Throws:

IOException - on any failure

pingPut

public PingInformation pingPut(String text)
                        throws IOException

Ping as a POST

Parameters:

text - text to include

Returns:

the response

Throws:

IOException - on any failure

stop

public void stop(String text)
          throws IOException

Description copied from interface: SliderApplicationApi

Stop the AM (async operation)

Specified by:

stop in interface SliderApplicationApi

Parameters:

text - text to include

Throws:

IOException - on any failure

getApplicationLiveness

public ApplicationLivenessInformation getApplicationLiveness()
                                                      throws IOException

Description copied from interface: SliderApplicationApi

Get the application liveness

Specified by:

getApplicationLiveness in interface SliderApplicationApi

Returns:

current liveness information

Throws:

IOException