org.fcrepo.client

Class FcrepoResponse

java.lang.Object

org.fcrepo.client.FcrepoResponse

All Implemented Interfaces:

Closeable, AutoCloseable

public class FcrepoResponse
extends Object
implements Closeable

Represents a response from a fedora repository using a FcrepoClient.

This class implements Closeable. Suggested usage is to create the FcrepoResponse within a try-with-resources block, insuring that any resources held by the response are freed automatically.

 FcrepoClient client = ...;
 try (FcrepoResponse res = client.get(...)) {
     // do something with the response
 } catch (FcrepoOperationFailedException|IOException e) {
     // handle any exceptions
 }
 

Closed responses have no obligation to provide access to released resources.

Since:

October 20, 2014

Author:

Aaron Coburn

Constructor Summary

Constructors

Constructor and Description
FcrepoResponse(URI url, int statusCode, String contentType, URI location, InputStream body) Create a FcrepoResponse object from the http response

Method Summary

Modifier and Type	Method and Description
void	close()
InputStream	getBody() body getter
String	getContentType() contentType getter
URI	getLocation() location getter
int	getStatusCode() statusCode getter
URI	getUrl() url getter
boolean	isClosed() Whether or not the resources have been freed from this response.
void	setBody(InputStream body) body setter
void	setContentType(String contentType) contentType setter
void	setLocation(URI location) location setter
void	setStatusCode(int statusCode) statusCode setter
void	setUrl(URI url) url setter

Methods inherited from class java.lang.Object

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

Constructor Detail

FcrepoResponse

public FcrepoResponse(URI url,
                      int statusCode,
                      String contentType,
                      URI location,
                      InputStream body)

Create a FcrepoResponse object from the http response

Parameters:

url - the requested URL

statusCode - the HTTP status code

contentType - the mime-type of the response

location - the location of a related resource

body - the response body stream

Method Detail

close

public void close()
           throws IOException

Implementation note: Invoking this method will close the underlying InputStream containing the entity body of the HTTP response.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException - if there is an error closing the underlying HTTP response stream.

isClosed

public boolean isClosed()

Whether or not the resources have been freed from this response. There should be no expectation that a closed response provides access to the entity body.

Returns:

true if resources have been freed, otherwise false

getUrl

public URI getUrl()

url getter

Returns:

the requested URL

setUrl

public void setUrl(URI url)

url setter

Parameters:

url - the requested URL

getStatusCode

public int getStatusCode()

statusCode getter

Returns:

the HTTP status code

setStatusCode

public void setStatusCode(int statusCode)

statusCode setter

Parameters:

statusCode - the HTTP status code

getBody

public InputStream getBody()

body getter

Returns:

the response body as a stream

setBody

public void setBody(InputStream body)

body setter

Parameters:

body - the contents of the response body

getLocation

public URI getLocation()

location getter

Returns:

the location of a related resource

setLocation

public void setLocation(URI location)

location setter

Parameters:

location - the value of a related resource

getContentType

public String getContentType()

contentType getter

Returns:

the mime-type of response

setContentType

public void setContentType(String contentType)

contentType setter

Parameters:

contentType - the mime-type of the response