org.jolokia.client

Class J4pClient

java.lang.Object

org.jolokia.client.J4pClientBuilderFactory

org.jolokia.client.J4pClient

public class J4pClient
extends J4pClientBuilderFactory

Client class for accessing the j4p agent

Since:

Apr 24, 2010

Author:

roland

Constructor Summary

Constructors

Constructor and Description
J4pClient(String pJ4pServerUrl) Construct a new client for a given server url
J4pClient(String pJ4pServerUrl, org.apache.http.client.HttpClient pHttpClient) Constructor for a given agent URl and a given HttpClient
J4pClient(String pJ4pServerUrl, org.apache.http.client.HttpClient pHttpClient, J4pTargetConfig pTargetConfig) Constructor using a given Agent URL, HttpClient and a proxy target config.

Method Summary

Methods

Modifier and Type	Method and Description
<R extends J4pResponse<T>,T extends J4pRequest> List<R>	execute(List<T> pRequests) Execute multiple requests at once.
<R extends J4pResponse<T>,T extends J4pRequest> List<R>	execute(List<T> pRequests, Map<J4pQueryParameter,String> pProcessingOptions) Execute multiple requests at once.
<R extends J4pResponse<T>,T extends J4pRequest> List<R>	execute(T... pRequests) Execute multiple requests at once.
<R extends J4pResponse<T>,T extends J4pRequest> R	execute(T pRequest) Execute a single J4pRequest returning a single response.
<R extends J4pResponse<T>,T extends J4pRequest> R	execute(T pRequest, Map<J4pQueryParameter,String> pProcessingOptions) Execute a single J4pRequest returning a single response.
<R extends J4pResponse<T>,T extends J4pRequest> R	execute(T pRequest, String pMethod) Execute a single J4pRequest which returns a single response.
<R extends J4pResponse<T>,T extends J4pRequest> R	execute(T pRequest, String pMethod, Map<J4pQueryParameter,String> pProcessingOptions) Execute a single J4pRequest which returns a single response.
org.apache.http.client.HttpClient	getHttpClient() Expose the embedded HttpClient for tuning connection parameters.
URI	getUri() Get base URL for Jolokia requests

Methods inherited from class org.jolokia.client.J4pClientBuilderFactory

authenticator, connectionTimeout, contentCharset, cookieStore, expectContinue, maxConnectionPoolTimeout, maxTotalConnections, password, pooledConnections, singleConnection, socketBufferSize, socketTimeout, tcpNoDelay, url, user

Methods inherited from class java.lang.Object

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

Constructor Detail

J4pClient

public J4pClient(String pJ4pServerUrl)

Construct a new client for a given server url

Parameters:

pJ4pServerUrl - the agent URL for how to contact the server.

J4pClient

public J4pClient(String pJ4pServerUrl,
         org.apache.http.client.HttpClient pHttpClient)

Constructor for a given agent URl and a given HttpClient

Parameters:

pJ4pServerUrl - the agent URL for how to contact the server.

pHttpClient - HTTP client to use for the connecting to the agent

J4pClient

public J4pClient(String pJ4pServerUrl,
         org.apache.http.client.HttpClient pHttpClient,
         J4pTargetConfig pTargetConfig)

Constructor using a given Agent URL, HttpClient and a proxy target config. If the HttpClient is null, a default client is used. If no target config is given, a plain request is performed

Parameters:

pJ4pServerUrl - the agent URL for how to contact the server.

pHttpClient - HTTP client to use for the connecting to the agent

pTargetConfig - optional target

Method Detail

execute

public <R extends J4pResponse<T>,T extends J4pRequest> R execute(T pRequest)
                              throws J4pException

Execute a single J4pRequest returning a single response. The HTTP Method used is determined automatically.

Type Parameters:

R - response type

T - request type

Parameters:

pRequest - request to execute

Returns:

the response as returned by the server

Throws:

J4pException

execute

public <R extends J4pResponse<T>,T extends J4pRequest> R execute(T pRequest,
                                                        Map<J4pQueryParameter,String> pProcessingOptions)
                              throws J4pException

Execute a single J4pRequest returning a single response. The HTTP Method used is determined automatically.

Type Parameters:

R - response type

T - request type

Parameters:

pRequest - request to execute

pProcessingOptions - optional map of processing options

Returns:

the response as returned by the server

Throws:

IOException - when the execution fails

org.json.simple.parser.ParseException - if parsing of the JSON answer fails

J4pException

execute

public <R extends J4pResponse<T>,T extends J4pRequest> R execute(T pRequest,
                                                        String pMethod)
                              throws J4pException

Execute a single J4pRequest which returns a single response.

Type Parameters:

R - response type

T - request type

Parameters:

pRequest - request to execute

pMethod - method to use which should be either "GET" or "POST"

Returns:

response object

Throws:

J4pException - if something's wrong (e.g. connection failed or read timeout)

execute

public <R extends J4pResponse<T>,T extends J4pRequest> R execute(T pRequest,
                                                        String pMethod,
                                                        Map<J4pQueryParameter,String> pProcessingOptions)
                              throws J4pException

Execute a single J4pRequest which returns a single response.

Type Parameters:

R - response type

T - request type

Parameters:

pRequest - request to execute

pMethod - method to use which should be either "GET" or "POST"

pProcessingOptions - optional map of processiong options

Returns:

response object

Throws:

J4pException - if something's wrong (e.g. connection failed or read timeout)

execute

public <R extends J4pResponse<T>,T extends J4pRequest> List<R> execute(List<T> pRequests)
                                       throws J4pException

Execute multiple requests at once. All given request will result in a single HTTP request where it gets dispatched on the agent side. The results are given back in the same order as the arguments provided.

Type Parameters:

R - response type

T - request type

Parameters:

pRequests - requests to execute

Returns:

list of responses, one response for each request

Throws:

J4pException - when an communication error occurs

execute

public <R extends J4pResponse<T>,T extends J4pRequest> List<R> execute(List<T> pRequests,
                                                              Map<J4pQueryParameter,String> pProcessingOptions)
                                       throws J4pException

Execute multiple requests at once. All given request will result in a single HTTP request where it gets dispatched on the agent side. The results are given back in the same order as the arguments provided.

Type Parameters:

R - response type

T - request type

Parameters:

pRequests - requests to execute

pProcessingOptions - processing options to use

Returns:

list of responses, one response for each request

Throws:

J4pException - when an communication error occurs

execute

public <R extends J4pResponse<T>,T extends J4pRequest> List<R> execute(T... pRequests)
                                       throws J4pException

Execute multiple requests at once. All given request will result in a single HTTP request where it gets dispatched on the agent side. The results are given back in the same order as the arguments provided.

Type Parameters:

R - response typex

T - request type

Parameters:

pRequests - requests to execute

Returns:

list of responses, one response for each request

Throws:

J4pException - when an communication error occurs

getHttpClient

public org.apache.http.client.HttpClient getHttpClient()

Expose the embedded HttpClient for tuning connection parameters.

Returns:

the http client used for HTTP communications

getUri

public URI getUri()

Get base URL for Jolokia requests

Returns:

the Jolokia URL