Package org.apache.webdav.lib.methods

Class ReportMethod

java.lang.Object

org.apache.commons.httpclient.HttpMethodBase

org.apache.webdav.lib.methods.HttpRequestBodyMethodBase

org.apache.webdav.lib.methods.XMLResponseMethodBase

org.apache.webdav.lib.methods.ReportMethod

All Implemented Interfaces:

org.apache.commons.httpclient.HttpMethod, DepthSupport

public class ReportMethod
extends XMLResponseMethodBase
implements DepthSupport

This class implements the WebDAV REPORT Method.

The REPORT method retrieves properties defined on the resource identified by the Request-URI, if the resource does not have any internal members, or on the resource identified by the Request-URI and potentially its member resources, if the resource is a collection that has internal member URIs.

A typical request looks like this:

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.webdav.lib.methods.XMLResponseMethodBase

XMLResponseMethodBase.OptionsResponse, XMLResponseMethodBase.Response, XMLResponseMethodBase.ResponseWithinMultistatus, XMLResponseMethodBase.SingleResponse

Field Summary

Fields

Modifier and Type	Field	Description
static final int	ALL	Request of all properties name and value.
protected int	depth	Depth.
static final int	LOCATE_HISTORY
protected String	prefix	The namespace abbreviation that prefixes DAV tags
protected PropertyName[]	propertyNames	Property name list.
static final int	SUB_SET	Request specified properties.
String	sVersionHistory
protected int	type	Type of the Propfind.

Fields inherited from class org.apache.webdav.lib.methods.XMLResponseMethodBase

builder, decodeResponseHrefs, responseURLs

Fields inherited from class org.apache.commons.httpclient.HttpMethodBase

effectiveVersion, statusLine

Fields inherited from interface org.apache.webdav.lib.methods.DepthSupport

DEPTH_0, DEPTH_1, DEPTH_INFINITY

Constructor Summary

Constructors

Constructor	Description
ReportMethod()	Method constructor.
ReportMethod(String path)	Method constructor.
ReportMethod(String path, int depth)	Method constructor.
ReportMethod(String path, int depth, String sBody)
ReportMethod(String path, int depth, Enumeration propertyNames)	Method constructor.
ReportMethod(String path, int depth, Enumeration propertyNames, Enumeration histUrl)	Method constructor.
ReportMethod(String path, Enumeration propertyNames)	Method constructor.

Method Summary

Modifier and Type	Method	Description
void	addRequestHeaders(org.apache.commons.httpclient.HttpState state, org.apache.commons.httpclient.HttpConnection conn)	Generate additional headers needed by the request.
protected String	generateRequestBody()	DAV requests that contain a body must override this function to generate that body.
Enumeration	getAllResponseURLs()	This method returns an enumeration of URL paths.
int	getDepth()	Depth getter.
String	getName()
Enumeration	getResponseProperties(String urlPath)	Returns an enumeration of Property objects.
int	getType()	Type getter.
void	recycle()	Reset the State of the class to its initial state, so that it can be used again.
void	setDepth(int depth)	Depth setter.
void	setHistoryURLs(Enumeration historyURLs)	sets History URL for locate by history Report
void	setPropertyNames(Enumeration propertyNames)	Property names setter.
void	setRequestHeader(String headerName, String headerValue)	Set a header value, redirecting attempts to set the "Depth" header to a setDepth(int) call.
void	setType(int type)	Type setter.

Methods inherited from class org.apache.webdav.lib.methods.XMLResponseMethodBase

convertElementToProperty, getDebug, getRequestContentLength, getResponseDocument, getResponseHashtable, getResponses, getResponseURLs, parseResponse, parseXMLResponse, readResponseBody, setDebug, setDecodeResponseHrefs, setDocument, setResponseHashtable, writeRequestBody

Methods inherited from class org.apache.webdav.lib.methods.HttpRequestBodyMethodBase

isRequestContentAlreadySet, readContinueCode, setRequestBody, setRequestBody, setRequestBody, setRequestBody, setRequestBody

Methods inherited from class org.apache.commons.httpclient.HttpMethodBase

abort, addCookieRequestHeader, addHostRequestHeader, addProxyConnectionHeader, addRequestHeader, addRequestHeader, addResponseFooter, addUserAgentRequestHeader, checkNotUsed, checkUsed, execute, generateRequestLine, getAuthenticationRealm, getContentCharSet, getDoAuthentication, getEffectiveVersion, getFollowRedirects, getHostAuthState, getHostConfiguration, getMethodRetryHandler, getParams, getPath, getProxyAuthenticationRealm, getProxyAuthState, getQueryString, getRecoverableExceptionCount, getRequestCharSet, getRequestHeader, getRequestHeaderGroup, getRequestHeaders, getRequestHeaders, getResponseBody, getResponseBody, getResponseBodyAsStream, getResponseBodyAsString, getResponseBodyAsString, getResponseCharSet, getResponseContentLength, getResponseFooter, getResponseFooters, getResponseHeader, getResponseHeaderGroup, getResponseHeaders, getResponseHeaders, getResponseStream, getResponseTrailerHeaderGroup, getStatusCode, getStatusLine, getStatusText, getURI, hasBeenUsed, isAborted, isConnectionCloseForced, isHttp11, isRequestSent, isStrictMode, processCookieHeaders, processResponseBody, processResponseHeaders, processStatusLine, readResponse, readResponseHeaders, readStatusLine, releaseConnection, removeRequestHeader, removeRequestHeader, responseBodyConsumed, setConnectionCloseForced, setDoAuthentication, setFollowRedirects, setHostConfiguration, setHttp11, setMethodRetryHandler, setParams, setPath, setQueryString, setQueryString, setRequestHeader, setResponseStream, setStrictMode, setURI, shouldCloseConnection, validate, writeRequest, writeRequestHeaders, writeRequestLine

Methods inherited from class java.lang.Object

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

Field Details

SUB_SET

public static final int SUB_SET

Request specified properties.

See Also:

• Constant Field Values

ALL

public static final int ALL

Request of all properties name and value.

See Also:

• Constant Field Values

LOCATE_HISTORY

public static final int LOCATE_HISTORY

See Also:

• Constant Field Values

sVersionHistory

public String sVersionHistory

type

protected int type

Type of the Propfind.

propertyNames

protected PropertyName[] propertyNames

Property name list.

depth

protected int depth

Depth.

prefix

protected String prefix

The namespace abbreviation that prefixes DAV tags

Constructor Details

ReportMethod

public ReportMethod()

Method constructor.

ReportMethod

public ReportMethod(String path)

Method constructor.

ReportMethod

public ReportMethod(String path,
 int depth)

Method constructor.

ReportMethod

public ReportMethod(String path,
 Enumeration propertyNames)

Method constructor.

ReportMethod

public ReportMethod(String path,
 int depth,
 Enumeration propertyNames,
 Enumeration histUrl)

Method constructor.

ReportMethod

public ReportMethod(String path,
 int depth,
 Enumeration propertyNames)

Method constructor.

ReportMethod

public ReportMethod(String path,
 int depth,
 String sBody)

Method Details

setRequestHeader

public void setRequestHeader(String headerName,
 String headerValue)

Set a header value, redirecting attempts to set the "Depth" header to a setDepth(int) call.

Specified by:

setRequestHeader in interface org.apache.commons.httpclient.HttpMethod

Overrides:

setRequestHeader in class org.apache.commons.httpclient.HttpMethodBase

Parameters:

headerName - Header name

headerValue - Header value

setType

public void setType(int type)

Type setter.

Parameters:

type - New type value

getType

public int getType()

Type getter.

Returns:

int type value

setDepth

public void setDepth(int depth)

Depth setter.

Specified by:

setDepth in interface DepthSupport

Parameters:

depth - New depth value

getDepth

public int getDepth()

Depth getter.

Specified by:

getDepth in interface DepthSupport

Returns:

int depth value

setPropertyNames

public void setPropertyNames(Enumeration propertyNames)

Property names setter. The enumeration may contain strings with or without a namespace prefix but the preferred way is to provide PropertyName objects.

Parameters:

propertyNames - List of the property names

setHistoryURLs

public void setHistoryURLs(Enumeration historyURLs)

sets History URL for locate by history Report

getName

public String getName()

Specified by:

getName in interface org.apache.commons.httpclient.HttpMethod

Specified by:

getName in class org.apache.commons.httpclient.HttpMethodBase

recycle

public void recycle()

Description copied from class: XMLResponseMethodBase

Reset the State of the class to its initial state, so that it can be used again.

Specified by:

recycle in interface org.apache.commons.httpclient.HttpMethod

Overrides:

recycle in class XMLResponseMethodBase

addRequestHeaders

public void addRequestHeaders(org.apache.commons.httpclient.HttpState state,
 org.apache.commons.httpclient.HttpConnection conn)
                       throws IOException,
org.apache.commons.httpclient.HttpException

Generate additional headers needed by the request.

Overrides:

addRequestHeaders in class org.apache.commons.httpclient.HttpMethodBase

Parameters:

state - State token

conn - The connection being used to make the request.

Throws:

IOException

org.apache.commons.httpclient.HttpException

generateRequestBody

protected String generateRequestBody()

DAV requests that contain a body must override this function to generate that body.

The default behavior simply returns an empty body.

Overrides:

generateRequestBody in class XMLResponseMethodBase

getAllResponseURLs

public Enumeration getAllResponseURLs()

This method returns an enumeration of URL paths. If the ReportMethod was sent to the URL of a collection, then there will be multiple URLs. The URLs are picked out of the <D:href> elements of the response.

Returns:

an enumeration of URL paths as Strings

getResponseProperties

public Enumeration getResponseProperties(String urlPath)

Returns an enumeration of Property objects.