com.offbytwo.jenkins.client

Class JenkinsHttpClient

java.lang.Object

com.offbytwo.jenkins.client.JenkinsHttpClient

public class JenkinsHttpClient
extends Object

Constructor Summary

Constructors

Constructor and Description
JenkinsHttpClient(URI uri) Create an unauthenticated Jenkins HTTP client
JenkinsHttpClient(URI uri, org.apache.http.impl.client.DefaultHttpClient defaultHttpClient) Create an unauthenticated Jenkins HTTP client
JenkinsHttpClient(URI uri, String username, String password) Create an authenticated Jenkins HTTP client

Method Summary

Methods

Modifier and Type	Method and Description
String	get(String path) Perform a GET request and parse the response and return a simple string of the content
<T extends BaseModel> T	get(String path, Class<T> cls) Perform a GET request and parse the response to the given class
InputStream	getFile(URI path) Perform a GET request and return the response as InputStream
String	post_xml(String path, String xml_data) Perform a POST request of XML (instead of using json mapper) and return a string rendering of the response entity.
String	post_xml(String path, String xml_data, boolean crumbFlag)
void	post(String path) Perform POST request that takes no parameters and returns no response
<R extends BaseModel,D> R	post(String path, D data, Class<R> cls) Perform a POST request and parse the response to the given class

Methods inherited from class java.lang.Object

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

Constructor Detail

JenkinsHttpClient

public JenkinsHttpClient(URI uri,
                 org.apache.http.impl.client.DefaultHttpClient defaultHttpClient)

Create an unauthenticated Jenkins HTTP client

Parameters:

uri - Location of the jenkins server (ex. http://localhost:8080)

defaultHttpClient - Configured DefaultHttpClient to be used

JenkinsHttpClient

public JenkinsHttpClient(URI uri)

Create an unauthenticated Jenkins HTTP client

Parameters:

uri - Location of the jenkins server (ex. http://localhost:8080)

JenkinsHttpClient

public JenkinsHttpClient(URI uri,
                 String username,
                 String password)

Create an authenticated Jenkins HTTP client

Parameters:

uri - Location of the jenkins server (ex. http://localhost:8080)

username - Username to use when connecting

password - Password or auth token to use when connecting

Method Detail

get

public <T extends BaseModel> T get(String path,
                          Class<T> cls)
                        throws IOException

Perform a GET request and parse the response to the given class

Type Parameters:

T - type of the response

Parameters:

path - path to request, can be relative or absolute

cls - class of the response

Returns:

an instance of the supplied class

Throws:

IOException, - HttpResponseException

IOException

get

public String get(String path)
           throws IOException

Perform a GET request and parse the response and return a simple string of the content

Parameters:

path - path to request, can be relative or absolute

Returns:

the entity text

Throws:

IOException, - HttpResponseException

IOException

getFile

public InputStream getFile(URI path)
                    throws IOException

Perform a GET request and return the response as InputStream

Parameters:

path - path to request, can be relative or absolute

Returns:

the response stream

Throws:

IOException, - HttpResponseException

IOException

post

public <R extends BaseModel,D> R post(String path,
                             D data,
                             Class<R> cls)
                         throws IOException

Perform a POST request and parse the response to the given class

Type Parameters:

R - type of the response

D - type of the data

Parameters:

path - path to request, can be relative or absolute

data - data to post

cls - class of the response

Returns:

an instance of the supplied class

Throws:

IOException, - HttpResponseException

IOException

post_xml

public String post_xml(String path,
              String xml_data)
                throws IOException

Perform a POST request of XML (instead of using json mapper) and return a string rendering of the response entity.

Parameters:

path - path to request, can be relative or absolute

xml_data - data data to post

Returns:

A string containing the xml response (if present)

Throws:

IOException, - HttpResponseException

IOException

post_xml

public String post_xml(String path,
              String xml_data,
              boolean crumbFlag)
                throws IOException

Throws:

IOException

post

public void post(String path)
          throws IOException

Perform POST request that takes no parameters and returns no response

Parameters:

path - path to request

Throws:

IOException, - HttpResponseException

IOException