Package org.apache.jackrabbit.webdav.client.methods

Class BaseDavRequest

java.lang.Object

org.apache.http.message.AbstractHttpMessage

org.apache.http.client.methods.AbstractExecutionAwareRequest

org.apache.http.client.methods.HttpRequestBase

org.apache.http.client.methods.HttpEntityEnclosingRequestBase

org.apache.jackrabbit.webdav.client.methods.BaseDavRequest

All Implemented Interfaces:

Cloneable, AbortableHttpRequest, Configurable, HttpExecutionAware, HttpUriRequest, HttpEntityEnclosingRequest, HttpMessage, HttpRequest

Direct Known Subclasses:

HttpBind, HttpCheckin, HttpCheckout, HttpCopy, HttpDelete, HttpLabel, HttpLock, HttpMerge, HttpMkcol, HttpMkworkspace, HttpMove, HttpOrderpatch, HttpPoll, HttpPropfind, HttpProppatch, HttpRebind, HttpReport, HttpSearch, HttpSubscribe, HttpUnbind, HttpUnlock, HttpUnsubscribe, HttpUpdate, HttpVersionControl

public abstract class BaseDavRequest
extends HttpEntityEnclosingRequestBase

Base class for HTTP request classes defined in this package.

Constructor Summary

Constructors

Constructor	Description
BaseDavRequest(URI uri)

Method Summary

Modifier and Type	Method	Description
void	checkSuccess(HttpResponse response)	Check the response and throw when it is considered to represent a failure.
Document	getResponseBodyAsDocument(HttpEntity entity)	Gets a Document representing the response body.
EventDiscovery	getResponseBodyAsEventDiscovery(HttpResponse response)	Return response body as EventDiscovery object.
LockDiscovery	getResponseBodyAsLockDiscovery(HttpResponse response)	Return response body as LockDiscovery object.
MultiStatus	getResponseBodyAsMultiStatus(HttpResponse response)	Return response body as MultiStatus object.
SubscriptionDiscovery	getResponseBodyAsSubscriptionDiscovery(HttpResponse response)	Return response body as SubscriptionDiscovery object.
DavException	getResponseException(HttpResponse response)	Obtain a DavException representing the response.
boolean	succeeded(HttpResponse response)	Check the provided HttpResponse for successful execution.

Methods inherited from class org.apache.http.client.methods.HttpEntityEnclosingRequestBase

clone, expectContinue, getEntity, setEntity

Methods inherited from class org.apache.http.client.methods.HttpRequestBase

getConfig, getMethod, getProtocolVersion, getRequestLine, getURI, releaseConnection, setConfig, setProtocolVersion, setURI, started, toString

Methods inherited from class org.apache.http.client.methods.AbstractExecutionAwareRequest

abort, completed, isAborted, reset, setCancellable, setConnectionRequest, setReleaseTrigger

Methods inherited from class org.apache.http.message.AbstractHttpMessage

addHeader, addHeader, containsHeader, getAllHeaders, getFirstHeader, getHeaders, getLastHeader, getParams, headerIterator, headerIterator, removeHeader, removeHeaders, setHeader, setHeader, setHeaders, setParams

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.http.HttpMessage

addHeader, addHeader, containsHeader, getAllHeaders, getFirstHeader, getHeaders, getLastHeader, getParams, getProtocolVersion, headerIterator, headerIterator, removeHeader, removeHeaders, setHeader, setHeader, setHeaders, setParams

Methods inherited from interface org.apache.http.HttpRequest

getRequestLine

Methods inherited from interface org.apache.http.client.methods.HttpUriRequest

abort, isAborted

Constructor Details

BaseDavRequest

public BaseDavRequest(URI uri)

Method Details

getResponseBodyAsDocument

public Document getResponseBodyAsDocument(HttpEntity entity)
                                   throws IOException

Gets a Document representing the response body.

Returns:

document or null for null entity

Throws:

IOException - in case of I/O or XMP pasting problems

getResponseBodyAsMultiStatus

public MultiStatus getResponseBodyAsMultiStatus(HttpResponse response)
                                         throws DavException

Return response body as MultiStatus object.

Throws:

IllegalStateException - when response does not represent a MultiStatus

DavException - for failures in obtaining/parsing the response body

getResponseBodyAsLockDiscovery

public LockDiscovery getResponseBodyAsLockDiscovery(HttpResponse response)
                                             throws DavException

Return response body as LockDiscovery object.

Throws:

IllegalStateException - when response does not represent a LockDiscovery

DavException - for failures in obtaining/parsing the response body

getResponseBodyAsSubscriptionDiscovery

public SubscriptionDiscovery getResponseBodyAsSubscriptionDiscovery(HttpResponse response)
                                                             throws DavException

Return response body as SubscriptionDiscovery object.

Throws:

IllegalStateException - when response does not represent a SubscriptionDiscovery

DavException - for failures in obtaining/parsing the response body

getResponseBodyAsEventDiscovery

public EventDiscovery getResponseBodyAsEventDiscovery(HttpResponse response)
                                               throws DavException

Return response body as EventDiscovery object.

Throws:

IllegalStateException - when response does not represent a EventDiscovery

DavException - for failures in obtaining/parsing the response body

checkSuccess

public void checkSuccess(HttpResponse response)
                  throws DavException

Check the response and throw when it is considered to represent a failure.

Throws:

DavException

getResponseException

public DavException getResponseException(HttpResponse response)

Obtain a DavException representing the response.

Throws:

IllegalStateException - when the response is considered to be successful

succeeded

public boolean succeeded(HttpResponse response)

Check the provided HttpResponse for successful execution. The default implementation treats all 2xx status codes (RFC 7231, Section 6.3). Implementations can further restrict the accepted range of responses (or even check the response body).