com.atlassian.bamboo.rest.utils

Class RESTCall<M extends org.apache.http.client.methods.HttpRequestBase>

java.lang.Object

com.atlassian.bamboo.rest.utils.RESTCall<M>

Direct Known Subclasses:

Delete, Get, Post, Put

public abstract class RESTCall<M extends org.apache.http.client.methods.HttpRequestBase>
extends Object

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RESTCall(org.apache.http.client.HttpClient client, M method)
protected	RESTCall(M method)

Method Summary

Modifier and Type	Method and Description
void	addRequestHeader(String key, String value)
protected void	assertExecuted()
protected void	assertNotExecuted()
protected void	beforeExecute()
void	execute()
M	getMethod()
InputStream	getResponseAsStream()
byte[]	getResponseBody() Returns the response body as a byte array.
com.google.common.collect.Multimap<String,String>	getResponseHeaders()
int	getStatusCode()
URI	getURI()
protected void	marshal(Object obj, OutputStream out)
void	release() Releases the resources held by the underlying HTTP request.
void	setBasicCredentials(String username, String password) Configured this call to use Basic HTTP Authentication using the specified username and password.
void	setClientProxy()
void	setMarshalledClasses(Class... classes)
<T> T	unmarshal(Class<T> responseType)
protected Object	unmarshal(InputStream in)

Methods inherited from class java.lang.Object

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

Constructor Detail

RESTCall

protected RESTCall(org.apache.http.client.HttpClient client,
                   M method)

RESTCall

protected RESTCall(M method)

Method Detail

setMarshalledClasses

public void setMarshalledClasses(Class... classes)
                          throws JAXBException

Throws:

JAXBException

marshal

protected void marshal(Object obj,
                       OutputStream out)
                throws JAXBException

Throws:

JAXBException

unmarshal

protected Object unmarshal(InputStream in)
                    throws JAXBException

Throws:

JAXBException

unmarshal

public <T> T unmarshal(Class<T> responseType)
                throws IOException,
                       JAXBException

Throws:

IOException

JAXBException

setBasicCredentials

public void setBasicCredentials(String username,
                                String password)

Configured this call to use Basic HTTP Authentication using the specified username and password. This eliminates the need to manually encode the Basic authentication string in Authorization request header.

Parameters:

username -

password -

setClientProxy

public void setClientProxy()

addRequestHeader

public void addRequestHeader(String key,
                             String value)

execute

public void execute()

beforeExecute

protected void beforeExecute()

getStatusCode

public int getStatusCode()

getResponseBody

public byte[] getResponseBody()

Returns the response body as a byte array.

This assertion must be called after the call has been executed sucessfully, or it will fail the test.

Returns:

the response body as a byte array.

getResponseAsStream

public InputStream getResponseAsStream()
                                throws IOException

Throws:

IOException

getURI

public URI getURI()

getResponseHeaders

public com.google.common.collect.Multimap<String,String> getResponseHeaders()

release

public void release()

Releases the resources held by the underlying HTTP request. Always call this method (e.g. in a finally clause) to ensure all HTTP connections are properly closed.

assertExecuted

protected void assertExecuted()

assertNotExecuted

protected void assertNotExecuted()

getMethod

public M getMethod()