org.apache.jackrabbit.webdav

Interface DavServletRequest

All Superinterfaces:

javax.servlet.http.HttpServletRequest, javax.servlet.ServletRequest

All Known Subinterfaces:

DeltaVServletRequest, ObservationDavServletRequest, OrderingDavServletRequest, TransactionDavServletRequest, WebdavRequest

All Known Implementing Classes:

WebdavRequestImpl

public interface DavServletRequest
extends javax.servlet.http.HttpServletRequest

DavServletRequest extends the HttpServletRequest by Webdav specific METHODS.

Field Summary

Fields inherited from interface javax.servlet.http.HttpServletRequest

BASIC_AUTH, CLIENT_CERT_AUTH, DIGEST_AUTH, FORM_AUTH

Method Summary

Modifier and Type	Method and Description
DavSession	getDavSession() Returns the DavSession created for this request.
int	getDepth() Return the integer representation of the given Depth header.
int	getDepth(int defaultValue) Returns the integer representation of the Depth header or the given defaultValue, if the Depth header is missing.
DavResourceLocator	getDestinationLocator() Parse the Destination header and return the locator of the corresponding resource.
LockInfo	getLockInfo() Return the parsed 'lockinfo' request body, the Timeout header and the Depth header of a LOCK request as LockInfo object.
String	getLockToken() Returns the token present in the Lock-Token Header or null if no such header is available. Note: The 'Lock-Token' header is sent with UNLOCK requests and with lock responses only.
DavPropertyNameSet	getPropFindProperties() Return the set of properties the client requested with a PROPFIND request or an empty set if the type of PROPFIND request was DavConstants.PROPFIND_ALL_PROP or DavConstants.PROPFIND_PROPERTY_NAMES.
int	getPropFindType() Return the type of PROPFIND request as indicated by the PROPFIND request body.
List<? extends PropEntry>	getPropPatchChangeList() Return a List of property change operations.
Document	getRequestDocument() Parse the Xml request body and return a Document.
DavResourceLocator	getRequestLocator() Return the locator of the requested resource.
long	getTimeout() Return the timeout requested in the Timeout header as long.
boolean	isOverwrite() Returns true if the Overwrite header is set to 'T' thus instructing the server to overwrite the state of a non-null destination resource during a COPY or MOVE.
boolean	matchesIfHeader(DavResource resource) Returns true, if the If header present with the request matches the given resource.
boolean	matchesIfHeader(String href, String token, String eTag) Returns true, if the If header present with the request matches to the given href, token and eTag.
void	setDavSession(DavSession session) Sets the DavSession to this request.

Methods inherited from interface javax.servlet.http.HttpServletRequest

getAuthType, getContextPath, getCookies, getDateHeader, getHeader, getHeaderNames, getHeaders, getIntHeader, getMethod, getPathInfo, getPathTranslated, getQueryString, getRemoteUser, getRequestedSessionId, getRequestURI, getRequestURL, getServletPath, getSession, getSession, getUserPrincipal, isRequestedSessionIdFromCookie, isRequestedSessionIdFromUrl, isRequestedSessionIdFromURL, isRequestedSessionIdValid, isUserInRole

Methods inherited from interface javax.servlet.ServletRequest

getAttribute, getAttributeNames, getCharacterEncoding, getContentLength, getContentType, getInputStream, getLocale, getLocales, getParameter, getParameterMap, getParameterNames, getParameterValues, getProtocol, getReader, getRealPath, getRemoteAddr, getRemoteHost, getRequestDispatcher, getScheme, getServerName, getServerPort, isSecure, removeAttribute, setAttribute, setCharacterEncoding

Method Detail

setDavSession

void setDavSession(DavSession session)

Sets the DavSession to this request.

Parameters:

session -

getDavSession

DavSession getDavSession()

Returns the DavSession created for this request.

Returns:

session for this resource

getRequestLocator

DavResourceLocator getRequestLocator()

Return the locator of the requested resource.

Returns:

locator of the requested resource.

getDestinationLocator

DavResourceLocator getDestinationLocator()
                                  throws DavException

Parse the Destination header and return the locator of the corresponding resource.

Returns:

locator of the resource specified with the Destination header.

Throws:

DavException

See Also:

DavConstants.HEADER_DESTINATION

isOverwrite

boolean isOverwrite()

Returns true if the Overwrite header is set to 'T' thus instructing the server to overwrite the state of a non-null destination resource during a COPY or MOVE. A Overwrite header value of 'F' will return false.

Returns:

true if the Overwrite header is set to 'T', false if it is set to 'F'.

See Also:

DavConstants.HEADER_OVERWRITE

getDepth

int getDepth()

Return the integer representation of the given Depth header. 'Infinity' is represented by DavConstants.DEPTH_INFINITY.

Returns:

integer representation of the Depth header.

See Also:

DavConstants.HEADER_DEPTH

getDepth

int getDepth(int defaultValue)

Returns the integer representation of the Depth header or the given defaultValue, if the Depth header is missing.

Parameters:

defaultValue - to be returned if no Depth header is present.

Returns:

integer representation of the Depth header or the given defaultValue.

See Also:

DavConstants.HEADER_DEPTH

getLockToken

String getLockToken()

Returns the token present in the Lock-Token Header or null if no such header is available.
Note: The 'Lock-Token' header is sent with UNLOCK requests and with lock responses only. For any other request that may be affected by a lock the 'If' header field is responsible.

Returns:

the token present in the Lock-Token header.

See Also:

DavConstants.HEADER_LOCK_TOKEN

getTimeout

long getTimeout()

Return the timeout requested in the Timeout header as long. The representation of the 'Infinite' timeout is left to the implementation.

Returns:

long value representation of the Timeout header.

See Also:

DavConstants.HEADER_TIMEOUT, DavConstants.TIMEOUT_INFINITE

getRequestDocument

Document getRequestDocument()
                     throws DavException

Parse the Xml request body and return a Document.

Returns:

Document representing the Xml request body or null if no request body is present.

Throws:

DavException - If the request body cannot be parsed into an Xml Document.

getPropFindType

int getPropFindType()
             throws DavException

Return the type of PROPFIND request as indicated by the PROPFIND request body.

Returns:

type of PROPFIND request

Throws:

DavException - If the propfind type could not be determined due to an invalid request body.

See Also:

DavConstants.PROPFIND_ALL_PROP, DavConstants.PROPFIND_BY_PROPERTY, DavConstants.PROPFIND_PROPERTY_NAMES, DavConstants.PROPFIND_ALL_PROP_INCLUDE

getPropFindProperties

DavPropertyNameSet getPropFindProperties()
                                  throws DavException

Return the set of properties the client requested with a PROPFIND request or an empty set if the type of PROPFIND request was DavConstants.PROPFIND_ALL_PROP or DavConstants.PROPFIND_PROPERTY_NAMES.

Returns:

set of properties the client requested with a PROPFIND request

Throws:

DavException - In case of invalid request body

getPropPatchChangeList

List<? extends PropEntry> getPropPatchChangeList()
                                          throws DavException

Return a List of property change operations. Each entry is either of type DavPropertyName, indicating a <remove> operation, or of type DavProperty, indicating a <set> operation. Note that ordering is significant here.

Returns:

List of property change operations

Throws:

DavException - In case of invalid request body

getLockInfo

LockInfo getLockInfo()
              throws DavException

Return the parsed 'lockinfo' request body, the Timeout header and the Depth header of a LOCK request as LockInfo object.

Returns:

LockInfo object encapsulating the information present in the LOCK request.

Throws:

DavException

See Also:

DavConstants.HEADER_TIMEOUT, DavConstants.HEADER_DEPTH, DavConstants.XML_LOCKINFO

matchesIfHeader

boolean matchesIfHeader(DavResource resource)

Returns true, if the If header present with the request matches the given resource.

Parameters:

resource -

Returns:

true, if the test is successful, false otherwise.

matchesIfHeader

boolean matchesIfHeader(String href,
                        String token,
                        String eTag)

Returns true, if the If header present with the request matches to the given href, token and eTag.

Parameters:

href -

token -

eTag -

Returns:

true, if the test is successful, false otherwise.