public class PropFindMethod extends XMLResponseMethodBase implements DepthSupport
The PROPFIND 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:
PROPFIND /file HTTP/1.1 Host: www.foo.bar Content-type: text/xml; charset="utf-8" Content-Length: xxxx <?xml version="1.0" encoding="utf-8" ?> <D:propfind xmlns:D="DAV:"> <D:prop xmlns:R="http://www.foo.bar/boxschema/"> <R:bigbox/> <R:author/> <R:DingALing/> <R:Random/> </D:prop> </D:propfind>
XMLResponseMethodBase.OptionsResponse, XMLResponseMethodBase.Response, XMLResponseMethodBase.ResponseWithinMultistatus, XMLResponseMethodBase.SingleResponse
Modifier and Type | Field and Description |
---|---|
static int |
ALL
Request of all properties name and value.
|
static int |
BY_NAME
Request of named properties.
|
protected int |
depth
Depth.
|
static int |
NAMES
Request of all properties name.
|
protected java.lang.String |
prefix
The namespace abbreviation that prefixes DAV tags
|
protected PropertyName[] |
propertyNames
Property name list.
|
protected int |
type
Type of the Propfind.
|
builder, decodeResponseHrefs, responseURLs
effectiveVersion, statusLine
DEPTH_0, DEPTH_1, DEPTH_INFINITY
Constructor and Description |
---|
PropFindMethod()
Method constructor.
|
PropFindMethod(java.lang.String path)
Method constructor.
|
PropFindMethod(java.lang.String path,
java.util.Enumeration propertyNames)
Method constructor.
|
PropFindMethod(java.lang.String path,
int depth)
Method constructor.
|
PropFindMethod(java.lang.String path,
int depth,
java.util.Enumeration propertyNames)
Method constructor.
|
PropFindMethod(java.lang.String path,
int depth,
int type)
Method constructor.
|
Modifier and Type | Method and Description |
---|---|
void |
addRequestHeaders(org.apache.commons.httpclient.HttpState state,
org.apache.commons.httpclient.HttpConnection conn)
Generate additional headers needed by the request.
|
protected java.lang.String |
generateRequestBody()
DAV requests that contain a body must override this function to
generate that body.
|
java.util.Enumeration |
getAllResponseURLs()
This method returns an enumeration of URL paths.
|
int |
getDepth()
Depth getter.
|
java.lang.String |
getName() |
java.util.Enumeration |
getResponseProperties(java.lang.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 |
setPropertyNames(java.util.Enumeration propertyNames)
Property names setter.
|
void |
setRequestHeader(java.lang.String headerName,
java.lang.String headerValue)
Set a request header value, redirecting the special case of the "Depth" header
to invoke
setDepth(int) instead. |
void |
setType(int type)
Type setter.
|
convertElementToProperty, getDebug, getRequestContentLength, getResponseDocument, getResponseHashtable, getResponses, getResponseURLs, parseResponse, parseXMLResponse, readResponseBody, setDebug, setDecodeResponseHrefs, setDocument, setResponseHashtable, writeRequestBody
isRequestContentAlreadySet, readContinueCode, setRequestBody, setRequestBody, setRequestBody, setRequestBody, setRequestBody
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
public static final int BY_NAME
public static final int ALL
public static final int NAMES
protected int type
protected PropertyName[] propertyNames
protected int depth
protected java.lang.String prefix
public PropFindMethod()
public PropFindMethod(java.lang.String path)
public PropFindMethod(java.lang.String path, int depth)
public PropFindMethod(java.lang.String path, int depth, int type)
public PropFindMethod(java.lang.String path, java.util.Enumeration propertyNames)
public PropFindMethod(java.lang.String path, int depth, java.util.Enumeration propertyNames)
public void setRequestHeader(java.lang.String headerName, java.lang.String headerValue)
setDepth(int)
instead.setRequestHeader
in interface org.apache.commons.httpclient.HttpMethod
setRequestHeader
in class org.apache.commons.httpclient.HttpMethodBase
headerName
- Header nameheaderValue
- Header valuepublic void setType(int type)
type
- New type valuepublic int getType()
public void setDepth(int depth)
setDepth
in interface DepthSupport
depth
- New depth valuepublic int getDepth()
getDepth
in interface DepthSupport
public void setPropertyNames(java.util.Enumeration propertyNames)
propertyNames
- List of the property namespublic void recycle()
XMLResponseMethodBase
recycle
in interface org.apache.commons.httpclient.HttpMethod
recycle
in class XMLResponseMethodBase
public java.lang.String getName()
getName
in interface org.apache.commons.httpclient.HttpMethod
getName
in class org.apache.commons.httpclient.HttpMethodBase
public void addRequestHeaders(org.apache.commons.httpclient.HttpState state, org.apache.commons.httpclient.HttpConnection conn) throws java.io.IOException, org.apache.commons.httpclient.HttpException
addRequestHeaders
in class org.apache.commons.httpclient.HttpMethodBase
state
- State tokenconn
- The connection being used to make the request.java.io.IOException
org.apache.commons.httpclient.HttpException
protected java.lang.String generateRequestBody()
The default behavior simply returns an empty body.
generateRequestBody
in class XMLResponseMethodBase
public java.util.Enumeration getAllResponseURLs()
<D:href>
elements
of the response.public java.util.Enumeration getResponseProperties(java.lang.String urlPath)
Property
objects.