WebDavHandler::AbstractWebDavHandler Class Reference

Abstract WebDavHandler interface class. More...

#include <AbstractWebDavHandler.qc.dox.h>

Inheritance diagram for WebDavHandler::AbstractWebDavHandler:

Public Member Methods
	constructor (*AbstractAuthenticator auth)
	Creates the object with an empty logger and an in-memory property handler.
	constructor (*AbstractAuthenticator auth, string virtual_relative_path_base)
	Creates the object with the given argument and an in-memory property handler.
	constructor (*AbstractAuthenticator auth, AbstractWebDavPropertyHandler property_handler, string virtual_relative_path_base='/')
	Creates the object with the given arguments.
	constructor (*AbstractAuthenticator auth, Logger logger, AbstractWebDavPropertyHandler property_handler=new InMemoryWebDavPropertyHandler(), string virtual_relative_path_base='/')
	Creates the object with the given arguments.
list< string >	getHttpMethods ()
	Returnd a list of WebDavHandler methods.
	setLogger (Logger logger)
	Replace the logger.
hash< HttpResponseInfo >	handleRequest (HttpListenerInterface listener, Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP/WebDavHandler requests and returns the response.
string	getRelativePath (string raw_path)
	Returns a relative path from an absolute path.
hash< HttpResponseInfo >	response (int response_code=200, data msg='OK')
	Returns a hash that can be used as an HTTP response with the given HTTP response code and response message.
hash< HttpResponseInfo >	response (int response_code=200, hash< auto > hdr)
	Returns a hash that can be used as an HTTP response with the given HTTP response code and response headers.
hash< HttpResponseInfo >	resp400 (data msg='Bad Request')
	Returns a hash that can be used as an HTTP response with a 400 response code and response message.
hash< HttpResponseInfo >	resp404 ()
	Returns a hash that can be used as an HTTP response with a 404 response code and response message.
hash< HttpResponseInfo >	resp500 (data msg='General Server Error')
	Returns a hash that can be used as an HTTP response with a 500 response code and response message.
hash< HttpResponseInfo >	resp501 ()
	Returns a hash that can be used as an HTTP response with a 501 response code and response message.
hash< HttpResponseInfo >	handleOptions (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles a WebDavHandler OPTIONS request.
hash< HttpResponseInfo >	handleGet (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP GET requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleHead (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP HEAD requests for WebDavHandler resources.
hash< HttpResponseInfo >	handlePost (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP POST requests for WebDavHandler resources.
hash< HttpResponseInfo >	handlePut (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP PUT requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleDelete (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP DELETE requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleCopy (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler COPY requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleMove (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler MOVE requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleLock (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler LOCK requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleUnlock (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler UNLOCK requests for WebDavHandler resources.
hash< HttpResponseInfo >	handleMkcol (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler MKCOL requests for WebDavHandler resources.
hash< HttpResponseInfo >	handlePropfind (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler PROPFIND requests for WebDavHandler resources; reetrieves properties from WebDavHandler resources.
hash< HttpResponseInfo >	handleProppatch (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler PROPPATCH requests for WebDavHandler resources; sets or removes properties on WebDavHandler resources.
	logInfo (string fmt)
	This method is called with informational log messages.
	logError (string fmt)
	This method is called with error log messages.
	logDebug (string fmt)
	This method is called with debug log messages.

Static Public Member Methods
static	combineValue (reference< auto > h, auto v)
	Combines values recursively.

Public Attributes
const	RequestMethods = ...
	A hash of all supported WebDavHandler methods mapped to method names.
const	DestMethods = ...
	A hash of methods that require a Destination header.
const	AllowHeaderValue = RequestMethods.keys().join(",")
	List of WebDavHandler methods in a string suitable for use in HTTP responses.
const	MethodList = keys RequestMethods
	List of WebDavHandler methods.
const	PPA_Remove = "R"
	PROPPATCH action: remove.
const	PPA_Set = "S"
	PROPPATCH action: set.

Private Member Methods
	init (Logger logger, AbstractWebDavPropertyHandler property_handler, string virtual_relative_path_base='/')
	Common constructor code.
string	getRealPath (string raw_path)
	Converts a request path to a normalized real path on the filesystem in the root WebDavHandler directory.
*hash< HttpResponseInfo >	checkAuth (string method, hash< auto > cx, hash< auto > hdr, *data body)
	Checks if the request is authorized; if not, this method must return a value.
	copyProperties (string source_url, string target_url)
	Copies all properties from the given source URL to the target URL.
	moveProperties (string source_url, string target_url)
	Moves all properties from the given source URL to the target URL.
	deleteProperties (string source_url)
	Deletes all properties from the given URL.
hash< auto >	preparePropFindXmlResponse (string local_path, string href, bool is_collection, hash< auto > base_props, bool all_props=False, *hash< string, hash< string, bool > > additional_props)
	Returns a hash that can be serialized to an XML string for a PROPFIND request.
string	getStatusMessage (softstring http_code)
	Returns a status message for the given HTTP response code.
hash< auto >	getXml (string body)
	Parse incoming XML and handle namespaces.
hash< HttpResponseInfo >	handleOptionsImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles an HTTP/WebDavHandler OPTIONS request.
abstract hash< HttpResponseInfo >	handleGetImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP GET requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleHeadImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP HEAD requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handlePostImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP POST requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handlePutImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP PUT requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleDeleteImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles HTTP DELETE requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleCopyImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler COPY requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleMoveImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler MOVE requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleLockImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler LOCK requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleUnlockImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler UNLOCK requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handleMkcolImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler MKCOL requests for WebDavHandler resources.
abstract hash< HttpResponseInfo >	handlePropfindImpl (Socket s, hash< auto > cx, hash< auto > hdr, *data body)
	Handles WebDavHandler PROPFIND requests for WebDavHandler resources; reetrieves properties from WebDavHandler resources.
abstract *hash< string, hash< string, hash< string, bool > > >	handleProppatchImpl (reference< string > href, hash< auto > cx, hash< auto > hdr, *hash< auto > request_xml, *list< hash< PropPatchActionInfo > > actions)
	Internal method for handling PROPPATCH requests.

Private Attributes
AbstractWebDavPropertyHandler	property_handler
	The property handler object.
string	virtual_base_path
	The virtual base path for resources served by the WebDavHandler handler.
Logger	logger
	The Logger for this object.

Detailed Description

Abstract WebDavHandler interface class.

Member Function Documentation

checkAuth()

*hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::checkAuth ( string  method, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Checks if the request is authorized; if not, this method must return a value.

Override this in a subclass to implement authorization controls

constructor() [1/4]

WebDavHandler::AbstractWebDavHandler::constructor

(

*AbstractAuthenticator

auth

)

Creates the object with an empty logger and an in-memory property handler.

Parameters

auth	the authentication object to use to authenticate connections

constructor() [2/4]

WebDavHandler::AbstractWebDavHandler::constructor	(	*AbstractAuthenticator	auth,
		AbstractWebDavPropertyHandler	property_handler,
		string	virtual_relative_path_base = '/'
	)

Creates the object with the given arguments.

Parameters

auth	the authentication object to use to authenticate connections
property_handler	to handle properties
virtual_relative_path_base	the virtual base path for WebDavHandler requests; this path will be stripped from requests internally when serving WebDavHandler resources

constructor() [3/4]

WebDavHandler::AbstractWebDavHandler::constructor	(	*AbstractAuthenticator	auth,
		Logger	logger,
		AbstractWebDavPropertyHandler	property_handler = new InMemoryWebDavPropertyHandler(),
		string	virtual_relative_path_base = '/'
	)

Creates the object with the given arguments.

Parameters

auth	the authentication object to use to authenticate connections
logger	the logger
property_handler	to handle properties
virtual_relative_path_base	the virtual base path for WebDavHandler requests; this path will be stripped from requests internally when serving WebDavHandler resources

constructor() [4/4]

WebDavHandler::AbstractWebDavHandler::constructor	(	*AbstractAuthenticator	auth,
		string	virtual_relative_path_base
	)

Creates the object with the given argument and an in-memory property handler.

Parameters

auth	the authentication object to use to authenticate connections
virtual_relative_path_base	the virtual base path for WebDavHandler requests; this path will be stripped from requests internally when serving WebDavHandler resources

getRealPath()

string WebDavHandler::AbstractWebDavHandler::getRealPath ( string  raw_path )

private

Converts a request path to a normalized real path on the filesystem in the root WebDavHandler directory.

Exceptions

WEBDAVHANDLER-FORBIDDEN

if the path is not valid

getRelativePath()

string WebDavHandler::AbstractWebDavHandler::getRelativePath

(

string

raw_path

)

Returns a relative path from an absolute path.

Parameters

raw_path

the rar path to process

Returns

a relative path generated by stripping any virtual base path (set in the constructor) from the argument

getStatusMessage()

string WebDavHandler::AbstractWebDavHandler::getStatusMessage ( softstring  http_code )

private

Returns a status message for the given HTTP response code.

Exceptions

RESPONSE-ERROR

the code is unknown

handleCopy()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleCopy	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler COPY requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handleCopyImpl() to process the request

handleCopyImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleCopyImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles WebDavHandler COPY requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

handleDelete()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleDelete	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles HTTP DELETE requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

Note

this base class method calls handleDeleteImpl() to process the request

handleDeleteImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleDeleteImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles HTTP DELETE requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

handleGet()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleGet	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles HTTP GET requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

Note

this base class method calls handleGetImpl() to process the request

handleGetImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleGetImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles HTTP GET requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

handleHead()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleHead	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles HTTP HEAD requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

Note

this base class method calls handleHeadImpl() to process the request

handleHeadImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleHeadImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles HTTP HEAD requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

handleLock()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleLock	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler LOCK requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handleLockImpl() to process the request

handleLockImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleLockImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles WebDavHandler LOCK requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

handleMkcol()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleMkcol	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler MKCOL requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handleMkcolImpl() to process the request

handleMkcolImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleMkcolImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles WebDavHandler MKCOL requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

handleMove()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleMove	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler MOVE requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handleMoveImpl() to process the request

handleMoveImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleMoveImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles WebDavHandler MOVE requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

handleOptions()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleOptions	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles a WebDavHandler OPTIONS request.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

a 200 response with headers indicating WebDavHandler support

Note

this base class method calls handleOptionsImpl() to process the request

handleOptionsImpl()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleOptionsImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles an HTTP/WebDavHandler OPTIONS request.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

a 200 response with headers indicating WebDavHandler support

handlePost()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handlePost	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles HTTP POST requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

Note

this base class method calls handlePostImpl() to process the request

handlePostImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handlePostImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles HTTP POST requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

handlePropfind()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handlePropfind	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler PROPFIND requests for WebDavHandler resources; reetrieves properties from WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handlePropfindImpl() to process the request

handlePropfindImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handlePropfindImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles WebDavHandler PROPFIND requests for WebDavHandler resources; reetrieves properties from WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

handleProppatch()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleProppatch	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler PROPPATCH requests for WebDavHandler resources; sets or removes properties on WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handleProppatchImpl() to process the request

handleProppatchImpl()

abstract *hash< string, hash< string, hash< string, bool > > > WebDavHandler::AbstractWebDavHandler::handleProppatchImpl ( reference< string >  href, hash< auto >  cx, hash< auto >  hdr, *hash< auto >  request_xml, *list< hash< PropPatchActionInfo > >  actions  )

private

Internal method for handling PROPPATCH requests.

Parameters

href	the href for the response
cx	the HTTP call context
hdr	as hash HTTP headers
request_xml	the parsed XML in the request
actions	a list of set and remove actions to execute on the given properties

Returns

a status map of HTTP code -> namespace -> property -> True

Exceptions

WEBDAVHANDLER-ERROR

an error occured

handlePut()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handlePut	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles HTTP PUT requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

Note

this base class method calls handlePutImpl() to process the request

handlePutImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handlePutImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles HTTP PUT requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the HTTP request

handleUnlock()

hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleUnlock	(	Socket	s,
		hash< auto >	cx,
		hash< auto >	hdr,
		*data	body
	)

Handles WebDavHandler UNLOCK requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

Note

this base class method calls handleUnlockImpl() to process the request

handleUnlockImpl()

abstract hash< HttpResponseInfo > WebDavHandler::AbstractWebDavHandler::handleUnlockImpl ( Socket  s, hash< auto >  cx, hash< auto >  hdr, *data  body  )

private

Handles WebDavHandler UNLOCK requests for WebDavHandler resources.

Parameters

cx	call context hash; this hash will have the following keys: header-info: a hash of information about the request header with the following keys: accept-charset: this key will be set to an appropriate value from any "Accept-Charset" header; if any of "*", "utf8", or "utf-8" are present, then this will be set to "utf8", otherwise it will be set to the first requested character encoding in the list accept-encoding: a hash where keys are values from any "Accept-Encoding" header and the values are True body-content-type: this is the "Content-Type" header without any charset declaration charset: if there is a charset declaration in the "Content-Type" header, the value is returned in this key client-cert: if the server is configured to capture remote client certificates, and the client supplied a certificate, this key will be populated with the SSLCertificate for the client close: set to True if the connection should be closed after responding, False if not (as derived from the request header) headers-raw: a hash of raw request headers without any case conversions or other processing request-uri: gives the request URI in an HTTP request socket: the bind address used to bind the listener ("socket-info" provides more detailed information) socket-info: a hash of socket information for the listening socket (as returned by Qore::Socket::getSocketInfo()) peer-info: a hash of socket information for the remote socket (as returned by Qore::Socket::getPeerInfo()) url: a hash of broken-down URL information (as returned from Qore::parse_url()) id: the unique HTTP connection ID ssl: True if the request was encrypted with HTTPS, False if not listener-id: the HTTP server listener ID (see HttpServer::getListenerInfo()) user: the current RBAC username (if any) root_path: the root URL path matched if the request was matched by a URL prefix
hdr	incoming header hash; all keys will be converted to lower-case, additionally the following keys will be present: method: the HTTP method received (ie "GET", "POST", etc) path: the HTTP path given in the request, after processing by Qore::decode_uri_request() http_version: the HTTP version number in the request (either "1.0" or "1.1")
body	message body, if any

Returns

the response to the WebDavHandler request

---

The documentation for this class was generated from the following file:

• doxygen/qlib/WebDavHandler/AbstractWebDavHandler.qc.dox.h