Package org.fcrepo.client

Class RequestBuilder

java.lang.Object

org.fcrepo.client.RequestBuilder

Direct Known Subclasses:

BodyRequestBuilder, DeleteBuilder, OptionsBuilder, OriginalMementoBuilder, RetrieveRequestBuilder

public abstract class RequestBuilder
extends Object

Base RequestBuilder class for constructing requests to the Fedora API

Author:

bbpennel

Field Summary

Fields

Modifier and Type	Field	Description
protected FcrepoClient	client
protected org.apache.http.client.methods.HttpRequestBase	request
protected URI	targetUri

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	RequestBuilder(URI uri, FcrepoClient client)	Instantiate builder.

Method Summary

Modifier and Type	Method	Description
protected RequestBuilder	addHeader(String name, String value)	Add a header with the given name and value to the request.
protected RequestBuilder	addLinkHeader(FcrepoLink linkHeader)	Add a link header to the request
protected RequestBuilder	addTransaction(URI transaction)	Add a transaction atomic id header to the request
protected abstract org.apache.http.client.methods.HttpRequestBase	createRequest()	Creates the HTTP request object for this builder
FcrepoResponse	perform()	Performs the request constructed in this builder and returns the response

Methods inherited from class java.lang.Object

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

Field Detail

client

protected FcrepoClient client

targetUri

protected URI targetUri

request

protected org.apache.http.client.methods.HttpRequestBase request

Constructor Detail

RequestBuilder

protected RequestBuilder(URI uri,
                         FcrepoClient client)

Instantiate builder. Throws an IllegalArgumentException if either the uri or client are null.

Parameters:

uri - uri of the resource this request is being made to

client - the client

Method Detail

createRequest

protected abstract org.apache.http.client.methods.HttpRequestBase createRequest()

Creates the HTTP request object for this builder

Returns:

HTTP request object for this builder

perform

public FcrepoResponse perform()
                       throws FcrepoOperationFailedException

Performs the request constructed in this builder and returns the response

Returns:

the repository response

Throws:

FcrepoOperationFailedException - when the underlying HTTP request results in an error

addHeader

protected RequestBuilder addHeader(String name,
                                   String value)

Add a header with the given name and value to the request.

Parameters:

name - name of the header

value - value of the header

Returns:

this builder

addLinkHeader

protected RequestBuilder addLinkHeader(FcrepoLink linkHeader)

Add a link header to the request

Parameters:

linkHeader - link header value represented as a FcrepoLink

Returns:

this builder

addTransaction

protected RequestBuilder addTransaction(URI transaction)

Add a transaction atomic id header to the request

Parameters:

transaction - transaction atomic id

Returns:

this builder