Tool class to work with XML.
An instance of this tool class is used to perform XML operations while parsing incoming requests and serializing outgoing responses.
If a client expects different behavior regarding fundamental XML handling, this class can be extended. To make it being used for a certain client, the new class name needs to be specified in an instance of ezcWebdacServerConfiguration, which then needs to be registered in the ezcWebdacServerConfigurationManager instance, located in the ezcWebdacServer singleton instance.
Source for this file: /Webdav/src/tools/xml.php
Version: | //autogen// |
XML_DEFAULT_NAMESPACE
= 'DAV:'
|
The default namespace, where WebDAV XML elements reside in. |
XML_ENCODING
= 'utf-8'
|
Encoding to use to create DOM documents. |
XML_VERSION
= '1.0'
|
The XML version to create DOM documents in. |
ezcWebdavNamespaceRegistry | read/write |
$namespaceRegistry
Registry class that keeps track of used namespace URIs and their abbreviations. |
protected array(string=>mixed) |
$properties
= array()
Properties. |
public void |
__construct(
[ $namespaceRegistry
= null] )
Creates a new XML tool. |
public DOMDocument |
createDom(
[ $content
= null] )
Returns a DOMDocument from the given XML. |
public DOMDocument|false |
createDomDocument(
[ $content
= null] )
Returns a DOMDocument from the given XML. |
public DOMElement |
createDomElement(
$dom
, $localName
, [ $namespace
= self::XML_DEFAULT_NAMESPACE] )
Returns a new DOMElement in the given namespace. |
Creates a new XML tool.
Creates an new XML tool instance. If not $namespaceRegistry is provided, the default ezcWebdavNamespaceRegistry will be instantiated and used. The registry can be accessed through the $namespaceRegistry property.
Name | Type | Description |
---|---|---|
$namespaceRegistry |
ezcWebdavNamespaceRegistry |
Returns a DOMDocument from the given XML.
Creates a new DOMDocument with the options set in the class constants and loads the optionally given $xml string with settings appropriate to work with it. Throws an exception if the loading fails.
Name | Type | Description |
---|---|---|
$content |
sting |
Type | Description |
---|---|
ezcWebdavInvalidRequestBodyException |
in case libxml produces an error with code other than 100 while loading $content. |
Returns a DOMDocument from the given XML.
Creates a new DOMDocument with the options set in the class constants and loads the optionally given $xml string with settings appropriate to work with it. Returns false if the loading fails.
Name | Type | Description |
---|---|---|
$content |
sting |
Returns a new DOMElement in the given namespace.
Retrieves the shortcut for the $namespace and creates a new DOMElement object with the correct global name for the given $localName.
Name | Type | Description |
---|---|---|
$dom |
DOMDocument | |
$localName |
string | |
$namespace |
string |