@@ -35,47 +35,47 @@ |
||
| 35 | 35 | * @package OCA\DAV\Connector\Sabre |
| 36 | 36 | */ |
| 37 | 37 | class BlockLegacyClientPlugin extends ServerPlugin { |
| 38 | - /** @var \Sabre\DAV\Server */ |
|
| 39 | - protected $server; |
|
| 40 | - /** @var IConfig */ |
|
| 41 | - protected $config; |
|
| 38 | + /** @var \Sabre\DAV\Server */ |
|
| 39 | + protected $server; |
|
| 40 | + /** @var IConfig */ |
|
| 41 | + protected $config; |
|
| 42 | 42 | |
| 43 | - /** |
|
| 44 | - * @param IConfig $config |
|
| 45 | - */ |
|
| 46 | - public function __construct(IConfig $config) { |
|
| 47 | - $this->config = $config; |
|
| 48 | - } |
|
| 43 | + /** |
|
| 44 | + * @param IConfig $config |
|
| 45 | + */ |
|
| 46 | + public function __construct(IConfig $config) { |
|
| 47 | + $this->config = $config; |
|
| 48 | + } |
|
| 49 | 49 | |
| 50 | - /** |
|
| 51 | - * @param \Sabre\DAV\Server $server |
|
| 52 | - * @return void |
|
| 53 | - */ |
|
| 54 | - public function initialize(\Sabre\DAV\Server $server) { |
|
| 55 | - $this->server = $server; |
|
| 56 | - $this->server->on('beforeMethod', [$this, 'beforeHandler'], 200); |
|
| 57 | - } |
|
| 50 | + /** |
|
| 51 | + * @param \Sabre\DAV\Server $server |
|
| 52 | + * @return void |
|
| 53 | + */ |
|
| 54 | + public function initialize(\Sabre\DAV\Server $server) { |
|
| 55 | + $this->server = $server; |
|
| 56 | + $this->server->on('beforeMethod', [$this, 'beforeHandler'], 200); |
|
| 57 | + } |
|
| 58 | 58 | |
| 59 | - /** |
|
| 60 | - * Detects all unsupported clients and throws a \Sabre\DAV\Exception\Forbidden |
|
| 61 | - * exception which will result in a 403 to them. |
|
| 62 | - * @param RequestInterface $request |
|
| 63 | - * @throws \Sabre\DAV\Exception\Forbidden If the client version is not supported |
|
| 64 | - */ |
|
| 65 | - public function beforeHandler(RequestInterface $request) { |
|
| 66 | - $userAgent = $request->getHeader('User-Agent'); |
|
| 67 | - if($userAgent === null) { |
|
| 68 | - return; |
|
| 69 | - } |
|
| 59 | + /** |
|
| 60 | + * Detects all unsupported clients and throws a \Sabre\DAV\Exception\Forbidden |
|
| 61 | + * exception which will result in a 403 to them. |
|
| 62 | + * @param RequestInterface $request |
|
| 63 | + * @throws \Sabre\DAV\Exception\Forbidden If the client version is not supported |
|
| 64 | + */ |
|
| 65 | + public function beforeHandler(RequestInterface $request) { |
|
| 66 | + $userAgent = $request->getHeader('User-Agent'); |
|
| 67 | + if($userAgent === null) { |
|
| 68 | + return; |
|
| 69 | + } |
|
| 70 | 70 | |
| 71 | - $minimumSupportedDesktopVersion = $this->config->getSystemValue('minimum.supported.desktop.version', '2.0.0'); |
|
| 71 | + $minimumSupportedDesktopVersion = $this->config->getSystemValue('minimum.supported.desktop.version', '2.0.0'); |
|
| 72 | 72 | |
| 73 | - // Match on the mirall version which is in scheme "Mozilla/5.0 (%1) mirall/%2" or |
|
| 74 | - // "mirall/%1" for older releases |
|
| 75 | - preg_match("/(?:mirall\\/)([\d.]+)/i", $userAgent, $versionMatches); |
|
| 76 | - if(isset($versionMatches[1]) && |
|
| 77 | - version_compare($versionMatches[1], $minimumSupportedDesktopVersion) === -1) { |
|
| 78 | - throw new \Sabre\DAV\Exception\Forbidden('Unsupported client version.'); |
|
| 79 | - } |
|
| 80 | - } |
|
| 73 | + // Match on the mirall version which is in scheme "Mozilla/5.0 (%1) mirall/%2" or |
|
| 74 | + // "mirall/%1" for older releases |
|
| 75 | + preg_match("/(?:mirall\\/)([\d.]+)/i", $userAgent, $versionMatches); |
|
| 76 | + if(isset($versionMatches[1]) && |
|
| 77 | + version_compare($versionMatches[1], $minimumSupportedDesktopVersion) === -1) { |
|
| 78 | + throw new \Sabre\DAV\Exception\Forbidden('Unsupported client version.'); |
|
| 79 | + } |
|
| 80 | + } |
|
| 81 | 81 | } |
@@ -32,61 +32,61 @@ |
||
| 32 | 32 | * This property contains multiple "share-type" elements, each containing a share type. |
| 33 | 33 | */ |
| 34 | 34 | class ShareTypeList implements Element { |
| 35 | - const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 35 | + const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 36 | 36 | |
| 37 | - /** |
|
| 38 | - * Share types |
|
| 39 | - * |
|
| 40 | - * @var int[] |
|
| 41 | - */ |
|
| 42 | - private $shareTypes; |
|
| 37 | + /** |
|
| 38 | + * Share types |
|
| 39 | + * |
|
| 40 | + * @var int[] |
|
| 41 | + */ |
|
| 42 | + private $shareTypes; |
|
| 43 | 43 | |
| 44 | - /** |
|
| 45 | - * @param int[] $shareTypes |
|
| 46 | - */ |
|
| 47 | - public function __construct($shareTypes) { |
|
| 48 | - $this->shareTypes = $shareTypes; |
|
| 49 | - } |
|
| 44 | + /** |
|
| 45 | + * @param int[] $shareTypes |
|
| 46 | + */ |
|
| 47 | + public function __construct($shareTypes) { |
|
| 48 | + $this->shareTypes = $shareTypes; |
|
| 49 | + } |
|
| 50 | 50 | |
| 51 | - /** |
|
| 52 | - * Returns the share types |
|
| 53 | - * |
|
| 54 | - * @return int[] |
|
| 55 | - */ |
|
| 56 | - public function getShareTypes() { |
|
| 57 | - return $this->shareTypes; |
|
| 58 | - } |
|
| 51 | + /** |
|
| 52 | + * Returns the share types |
|
| 53 | + * |
|
| 54 | + * @return int[] |
|
| 55 | + */ |
|
| 56 | + public function getShareTypes() { |
|
| 57 | + return $this->shareTypes; |
|
| 58 | + } |
|
| 59 | 59 | |
| 60 | - /** |
|
| 61 | - * The deserialize method is called during xml parsing. |
|
| 62 | - * |
|
| 63 | - * @param Reader $reader |
|
| 64 | - * @return mixed |
|
| 65 | - */ |
|
| 66 | - static function xmlDeserialize(Reader $reader) { |
|
| 67 | - $shareTypes = []; |
|
| 60 | + /** |
|
| 61 | + * The deserialize method is called during xml parsing. |
|
| 62 | + * |
|
| 63 | + * @param Reader $reader |
|
| 64 | + * @return mixed |
|
| 65 | + */ |
|
| 66 | + static function xmlDeserialize(Reader $reader) { |
|
| 67 | + $shareTypes = []; |
|
| 68 | 68 | |
| 69 | - $tree = $reader->parseInnerTree(); |
|
| 70 | - if ($tree === null) { |
|
| 71 | - return null; |
|
| 72 | - } |
|
| 73 | - foreach ($tree as $elem) { |
|
| 74 | - if ($elem['name'] === '{' . self::NS_OWNCLOUD . '}share-type') { |
|
| 75 | - $shareTypes[] = (int)$elem['value']; |
|
| 76 | - } |
|
| 77 | - } |
|
| 78 | - return new self($shareTypes); |
|
| 79 | - } |
|
| 69 | + $tree = $reader->parseInnerTree(); |
|
| 70 | + if ($tree === null) { |
|
| 71 | + return null; |
|
| 72 | + } |
|
| 73 | + foreach ($tree as $elem) { |
|
| 74 | + if ($elem['name'] === '{' . self::NS_OWNCLOUD . '}share-type') { |
|
| 75 | + $shareTypes[] = (int)$elem['value']; |
|
| 76 | + } |
|
| 77 | + } |
|
| 78 | + return new self($shareTypes); |
|
| 79 | + } |
|
| 80 | 80 | |
| 81 | - /** |
|
| 82 | - * The xmlSerialize metod is called during xml writing. |
|
| 83 | - * |
|
| 84 | - * @param Writer $writer |
|
| 85 | - * @return void |
|
| 86 | - */ |
|
| 87 | - function xmlSerialize(Writer $writer) { |
|
| 88 | - foreach ($this->shareTypes as $shareType) { |
|
| 89 | - $writer->writeElement('{' . self::NS_OWNCLOUD . '}share-type', $shareType); |
|
| 90 | - } |
|
| 91 | - } |
|
| 81 | + /** |
|
| 82 | + * The xmlSerialize metod is called during xml writing. |
|
| 83 | + * |
|
| 84 | + * @param Writer $writer |
|
| 85 | + * @return void |
|
| 86 | + */ |
|
| 87 | + function xmlSerialize(Writer $writer) { |
|
| 88 | + foreach ($this->shareTypes as $shareType) { |
|
| 89 | + $writer->writeElement('{' . self::NS_OWNCLOUD . '}share-type', $shareType); |
|
| 90 | + } |
|
| 91 | + } |
|
| 92 | 92 | } |
@@ -34,53 +34,53 @@ |
||
| 34 | 34 | use Sabre\HTTP\RequestInterface; |
| 35 | 35 | |
| 36 | 36 | class LockPlugin extends ServerPlugin { |
| 37 | - /** |
|
| 38 | - * Reference to main server object |
|
| 39 | - * |
|
| 40 | - * @var \Sabre\DAV\Server |
|
| 41 | - */ |
|
| 42 | - private $server; |
|
| 37 | + /** |
|
| 38 | + * Reference to main server object |
|
| 39 | + * |
|
| 40 | + * @var \Sabre\DAV\Server |
|
| 41 | + */ |
|
| 42 | + private $server; |
|
| 43 | 43 | |
| 44 | - /** |
|
| 45 | - * {@inheritdoc} |
|
| 46 | - */ |
|
| 47 | - public function initialize(\Sabre\DAV\Server $server) { |
|
| 48 | - $this->server = $server; |
|
| 49 | - $this->server->on('beforeMethod', [$this, 'getLock'], 50); |
|
| 50 | - $this->server->on('afterMethod', [$this, 'releaseLock'], 50); |
|
| 51 | - } |
|
| 44 | + /** |
|
| 45 | + * {@inheritdoc} |
|
| 46 | + */ |
|
| 47 | + public function initialize(\Sabre\DAV\Server $server) { |
|
| 48 | + $this->server = $server; |
|
| 49 | + $this->server->on('beforeMethod', [$this, 'getLock'], 50); |
|
| 50 | + $this->server->on('afterMethod', [$this, 'releaseLock'], 50); |
|
| 51 | + } |
|
| 52 | 52 | |
| 53 | - public function getLock(RequestInterface $request) { |
|
| 54 | - // we can't listen on 'beforeMethod:PUT' due to order of operations with setting up the tree |
|
| 55 | - // so instead we limit ourselves to the PUT method manually |
|
| 56 | - if ($request->getMethod() !== 'PUT' || isset($_SERVER['HTTP_OC_CHUNKED'])) { |
|
| 57 | - return; |
|
| 58 | - } |
|
| 59 | - try { |
|
| 60 | - $node = $this->server->tree->getNodeForPath($request->getPath()); |
|
| 61 | - } catch (NotFound $e) { |
|
| 62 | - return; |
|
| 63 | - } |
|
| 64 | - if ($node instanceof Node) { |
|
| 65 | - try { |
|
| 66 | - $node->acquireLock(ILockingProvider::LOCK_SHARED); |
|
| 67 | - } catch (LockedException $e) { |
|
| 68 | - throw new FileLocked($e->getMessage(), $e->getCode(), $e); |
|
| 69 | - } |
|
| 70 | - } |
|
| 71 | - } |
|
| 53 | + public function getLock(RequestInterface $request) { |
|
| 54 | + // we can't listen on 'beforeMethod:PUT' due to order of operations with setting up the tree |
|
| 55 | + // so instead we limit ourselves to the PUT method manually |
|
| 56 | + if ($request->getMethod() !== 'PUT' || isset($_SERVER['HTTP_OC_CHUNKED'])) { |
|
| 57 | + return; |
|
| 58 | + } |
|
| 59 | + try { |
|
| 60 | + $node = $this->server->tree->getNodeForPath($request->getPath()); |
|
| 61 | + } catch (NotFound $e) { |
|
| 62 | + return; |
|
| 63 | + } |
|
| 64 | + if ($node instanceof Node) { |
|
| 65 | + try { |
|
| 66 | + $node->acquireLock(ILockingProvider::LOCK_SHARED); |
|
| 67 | + } catch (LockedException $e) { |
|
| 68 | + throw new FileLocked($e->getMessage(), $e->getCode(), $e); |
|
| 69 | + } |
|
| 70 | + } |
|
| 71 | + } |
|
| 72 | 72 | |
| 73 | - public function releaseLock(RequestInterface $request) { |
|
| 74 | - if ($request->getMethod() !== 'PUT' || isset($_SERVER['HTTP_OC_CHUNKED'])) { |
|
| 75 | - return; |
|
| 76 | - } |
|
| 77 | - try { |
|
| 78 | - $node = $this->server->tree->getNodeForPath($request->getPath()); |
|
| 79 | - } catch (NotFound $e) { |
|
| 80 | - return; |
|
| 81 | - } |
|
| 82 | - if ($node instanceof Node) { |
|
| 83 | - $node->releaseLock(ILockingProvider::LOCK_SHARED); |
|
| 84 | - } |
|
| 85 | - } |
|
| 73 | + public function releaseLock(RequestInterface $request) { |
|
| 74 | + if ($request->getMethod() !== 'PUT' || isset($_SERVER['HTTP_OC_CHUNKED'])) { |
|
| 75 | + return; |
|
| 76 | + } |
|
| 77 | + try { |
|
| 78 | + $node = $this->server->tree->getNodeForPath($request->getPath()); |
|
| 79 | + } catch (NotFound $e) { |
|
| 80 | + return; |
|
| 81 | + } |
|
| 82 | + if ($node instanceof Node) { |
|
| 83 | + $node->releaseLock(ILockingProvider::LOCK_SHARED); |
|
| 84 | + } |
|
| 85 | + } |
|
| 86 | 86 | } |
@@ -24,42 +24,42 @@ |
||
| 24 | 24 | |
| 25 | 25 | class Forbidden extends \Sabre\DAV\Exception\Forbidden { |
| 26 | 26 | |
| 27 | - const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 27 | + const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 28 | 28 | |
| 29 | - /** |
|
| 30 | - * @var bool |
|
| 31 | - */ |
|
| 32 | - private $retry; |
|
| 29 | + /** |
|
| 30 | + * @var bool |
|
| 31 | + */ |
|
| 32 | + private $retry; |
|
| 33 | 33 | |
| 34 | - /** |
|
| 35 | - * @param string $message |
|
| 36 | - * @param bool $retry |
|
| 37 | - * @param \Exception $previous |
|
| 38 | - */ |
|
| 39 | - public function __construct($message, $retry = false, \Exception $previous = null) { |
|
| 40 | - parent::__construct($message, 0, $previous); |
|
| 41 | - $this->retry = $retry; |
|
| 42 | - } |
|
| 34 | + /** |
|
| 35 | + * @param string $message |
|
| 36 | + * @param bool $retry |
|
| 37 | + * @param \Exception $previous |
|
| 38 | + */ |
|
| 39 | + public function __construct($message, $retry = false, \Exception $previous = null) { |
|
| 40 | + parent::__construct($message, 0, $previous); |
|
| 41 | + $this->retry = $retry; |
|
| 42 | + } |
|
| 43 | 43 | |
| 44 | - /** |
|
| 45 | - * This method allows the exception to include additional information |
|
| 46 | - * into the WebDAV error response |
|
| 47 | - * |
|
| 48 | - * @param \Sabre\DAV\Server $server |
|
| 49 | - * @param \DOMElement $errorNode |
|
| 50 | - * @return void |
|
| 51 | - */ |
|
| 52 | - public function serialize(\Sabre\DAV\Server $server,\DOMElement $errorNode) { |
|
| 44 | + /** |
|
| 45 | + * This method allows the exception to include additional information |
|
| 46 | + * into the WebDAV error response |
|
| 47 | + * |
|
| 48 | + * @param \Sabre\DAV\Server $server |
|
| 49 | + * @param \DOMElement $errorNode |
|
| 50 | + * @return void |
|
| 51 | + */ |
|
| 52 | + public function serialize(\Sabre\DAV\Server $server,\DOMElement $errorNode) { |
|
| 53 | 53 | |
| 54 | - // set ownCloud namespace |
|
| 55 | - $errorNode->setAttribute('xmlns:o', self::NS_OWNCLOUD); |
|
| 54 | + // set ownCloud namespace |
|
| 55 | + $errorNode->setAttribute('xmlns:o', self::NS_OWNCLOUD); |
|
| 56 | 56 | |
| 57 | - // adding the retry node |
|
| 58 | - $error = $errorNode->ownerDocument->createElementNS('o:','o:retry', var_export($this->retry, true)); |
|
| 59 | - $errorNode->appendChild($error); |
|
| 57 | + // adding the retry node |
|
| 58 | + $error = $errorNode->ownerDocument->createElementNS('o:','o:retry', var_export($this->retry, true)); |
|
| 59 | + $errorNode->appendChild($error); |
|
| 60 | 60 | |
| 61 | - // adding the message node |
|
| 62 | - $error = $errorNode->ownerDocument->createElementNS('o:','o:reason', $this->getMessage()); |
|
| 63 | - $errorNode->appendChild($error); |
|
| 64 | - } |
|
| 61 | + // adding the message node |
|
| 62 | + $error = $errorNode->ownerDocument->createElementNS('o:','o:reason', $this->getMessage()); |
|
| 63 | + $errorNode->appendChild($error); |
|
| 64 | + } |
|
| 65 | 65 | } |
@@ -29,27 +29,27 @@ |
||
| 29 | 29 | |
| 30 | 30 | class PasswordLoginForbidden extends NotAuthenticated { |
| 31 | 31 | |
| 32 | - const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 33 | - |
|
| 34 | - public function getHTTPCode() { |
|
| 35 | - return 401; |
|
| 36 | - } |
|
| 37 | - |
|
| 38 | - /** |
|
| 39 | - * This method allows the exception to include additional information |
|
| 40 | - * into the WebDAV error response |
|
| 41 | - * |
|
| 42 | - * @param Server $server |
|
| 43 | - * @param DOMElement $errorNode |
|
| 44 | - * @return void |
|
| 45 | - */ |
|
| 46 | - public function serialize(Server $server, DOMElement $errorNode) { |
|
| 47 | - |
|
| 48 | - // set ownCloud namespace |
|
| 49 | - $errorNode->setAttribute('xmlns:o', self::NS_OWNCLOUD); |
|
| 50 | - |
|
| 51 | - $error = $errorNode->ownerDocument->createElementNS('o:', 'o:hint', 'password login forbidden'); |
|
| 52 | - $errorNode->appendChild($error); |
|
| 53 | - } |
|
| 32 | + const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 33 | + |
|
| 34 | + public function getHTTPCode() { |
|
| 35 | + return 401; |
|
| 36 | + } |
|
| 37 | + |
|
| 38 | + /** |
|
| 39 | + * This method allows the exception to include additional information |
|
| 40 | + * into the WebDAV error response |
|
| 41 | + * |
|
| 42 | + * @param Server $server |
|
| 43 | + * @param DOMElement $errorNode |
|
| 44 | + * @return void |
|
| 45 | + */ |
|
| 46 | + public function serialize(Server $server, DOMElement $errorNode) { |
|
| 47 | + |
|
| 48 | + // set ownCloud namespace |
|
| 49 | + $errorNode->setAttribute('xmlns:o', self::NS_OWNCLOUD); |
|
| 50 | + |
|
| 51 | + $error = $errorNode->ownerDocument->createElementNS('o:', 'o:hint', 'password login forbidden'); |
|
| 52 | + $errorNode->appendChild($error); |
|
| 53 | + } |
|
| 54 | 54 | |
| 55 | 55 | } |
@@ -30,20 +30,20 @@ |
||
| 30 | 30 | |
| 31 | 31 | class FileLocked extends \Sabre\DAV\Exception { |
| 32 | 32 | |
| 33 | - public function __construct($message = "", $code = 0, Exception $previous = null) { |
|
| 34 | - if($previous instanceof \OCP\Files\LockNotAcquiredException) { |
|
| 35 | - $message = sprintf('Target file %s is locked by another process.', $previous->path); |
|
| 36 | - } |
|
| 37 | - parent::__construct($message, $code, $previous); |
|
| 38 | - } |
|
| 33 | + public function __construct($message = "", $code = 0, Exception $previous = null) { |
|
| 34 | + if($previous instanceof \OCP\Files\LockNotAcquiredException) { |
|
| 35 | + $message = sprintf('Target file %s is locked by another process.', $previous->path); |
|
| 36 | + } |
|
| 37 | + parent::__construct($message, $code, $previous); |
|
| 38 | + } |
|
| 39 | 39 | |
| 40 | - /** |
|
| 41 | - * Returns the HTTP status code for this exception |
|
| 42 | - * |
|
| 43 | - * @return int |
|
| 44 | - */ |
|
| 45 | - public function getHTTPCode() { |
|
| 40 | + /** |
|
| 41 | + * Returns the HTTP status code for this exception |
|
| 42 | + * |
|
| 43 | + * @return int |
|
| 44 | + */ |
|
| 45 | + public function getHTTPCode() { |
|
| 46 | 46 | |
| 47 | - return 423; |
|
| 48 | - } |
|
| 47 | + return 423; |
|
| 48 | + } |
|
| 49 | 49 | } |
@@ -31,15 +31,15 @@ |
||
| 31 | 31 | */ |
| 32 | 32 | class UnsupportedMediaType extends \Sabre\DAV\Exception { |
| 33 | 33 | |
| 34 | - /** |
|
| 35 | - * Returns the HTTP status code for this exception |
|
| 36 | - * |
|
| 37 | - * @return int |
|
| 38 | - */ |
|
| 39 | - public function getHTTPCode() { |
|
| 34 | + /** |
|
| 35 | + * Returns the HTTP status code for this exception |
|
| 36 | + * |
|
| 37 | + * @return int |
|
| 38 | + */ |
|
| 39 | + public function getHTTPCode() { |
|
| 40 | 40 | |
| 41 | - return 415; |
|
| 41 | + return 415; |
|
| 42 | 42 | |
| 43 | - } |
|
| 43 | + } |
|
| 44 | 44 | |
| 45 | 45 | } |
@@ -31,15 +31,15 @@ |
||
| 31 | 31 | */ |
| 32 | 32 | class EntityTooLarge extends \Sabre\DAV\Exception { |
| 33 | 33 | |
| 34 | - /** |
|
| 35 | - * Returns the HTTP status code for this exception |
|
| 36 | - * |
|
| 37 | - * @return int |
|
| 38 | - */ |
|
| 39 | - public function getHTTPCode() { |
|
| 34 | + /** |
|
| 35 | + * Returns the HTTP status code for this exception |
|
| 36 | + * |
|
| 37 | + * @return int |
|
| 38 | + */ |
|
| 39 | + public function getHTTPCode() { |
|
| 40 | 40 | |
| 41 | - return 413; |
|
| 41 | + return 413; |
|
| 42 | 42 | |
| 43 | - } |
|
| 43 | + } |
|
| 44 | 44 | |
| 45 | 45 | } |
@@ -34,92 +34,92 @@ |
||
| 34 | 34 | * This property contains multiple "tag" elements, each containing a tag name. |
| 35 | 35 | */ |
| 36 | 36 | class TagList implements Element { |
| 37 | - const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 37 | + const NS_OWNCLOUD = 'http://owncloud.org/ns'; |
|
| 38 | 38 | |
| 39 | - /** |
|
| 40 | - * tags |
|
| 41 | - * |
|
| 42 | - * @var array |
|
| 43 | - */ |
|
| 44 | - private $tags; |
|
| 39 | + /** |
|
| 40 | + * tags |
|
| 41 | + * |
|
| 42 | + * @var array |
|
| 43 | + */ |
|
| 44 | + private $tags; |
|
| 45 | 45 | |
| 46 | - /** |
|
| 47 | - * @param array $tags |
|
| 48 | - */ |
|
| 49 | - public function __construct(array $tags) { |
|
| 50 | - $this->tags = $tags; |
|
| 51 | - } |
|
| 46 | + /** |
|
| 47 | + * @param array $tags |
|
| 48 | + */ |
|
| 49 | + public function __construct(array $tags) { |
|
| 50 | + $this->tags = $tags; |
|
| 51 | + } |
|
| 52 | 52 | |
| 53 | - /** |
|
| 54 | - * Returns the tags |
|
| 55 | - * |
|
| 56 | - * @return array |
|
| 57 | - */ |
|
| 58 | - public function getTags() { |
|
| 53 | + /** |
|
| 54 | + * Returns the tags |
|
| 55 | + * |
|
| 56 | + * @return array |
|
| 57 | + */ |
|
| 58 | + public function getTags() { |
|
| 59 | 59 | |
| 60 | - return $this->tags; |
|
| 60 | + return $this->tags; |
|
| 61 | 61 | |
| 62 | - } |
|
| 62 | + } |
|
| 63 | 63 | |
| 64 | - /** |
|
| 65 | - * The deserialize method is called during xml parsing. |
|
| 66 | - * |
|
| 67 | - * This method is called statictly, this is because in theory this method |
|
| 68 | - * may be used as a type of constructor, or factory method. |
|
| 69 | - * |
|
| 70 | - * Often you want to return an instance of the current class, but you are |
|
| 71 | - * free to return other data as well. |
|
| 72 | - * |
|
| 73 | - * You are responsible for advancing the reader to the next element. Not |
|
| 74 | - * doing anything will result in a never-ending loop. |
|
| 75 | - * |
|
| 76 | - * If you just want to skip parsing for this element altogether, you can |
|
| 77 | - * just call $reader->next(); |
|
| 78 | - * |
|
| 79 | - * $reader->parseInnerTree() will parse the entire sub-tree, and advance to |
|
| 80 | - * the next element. |
|
| 81 | - * |
|
| 82 | - * @param Reader $reader |
|
| 83 | - * @return mixed |
|
| 84 | - */ |
|
| 85 | - static function xmlDeserialize(Reader $reader) { |
|
| 86 | - $tags = []; |
|
| 64 | + /** |
|
| 65 | + * The deserialize method is called during xml parsing. |
|
| 66 | + * |
|
| 67 | + * This method is called statictly, this is because in theory this method |
|
| 68 | + * may be used as a type of constructor, or factory method. |
|
| 69 | + * |
|
| 70 | + * Often you want to return an instance of the current class, but you are |
|
| 71 | + * free to return other data as well. |
|
| 72 | + * |
|
| 73 | + * You are responsible for advancing the reader to the next element. Not |
|
| 74 | + * doing anything will result in a never-ending loop. |
|
| 75 | + * |
|
| 76 | + * If you just want to skip parsing for this element altogether, you can |
|
| 77 | + * just call $reader->next(); |
|
| 78 | + * |
|
| 79 | + * $reader->parseInnerTree() will parse the entire sub-tree, and advance to |
|
| 80 | + * the next element. |
|
| 81 | + * |
|
| 82 | + * @param Reader $reader |
|
| 83 | + * @return mixed |
|
| 84 | + */ |
|
| 85 | + static function xmlDeserialize(Reader $reader) { |
|
| 86 | + $tags = []; |
|
| 87 | 87 | |
| 88 | - $tree = $reader->parseInnerTree(); |
|
| 89 | - if ($tree === null) { |
|
| 90 | - return null; |
|
| 91 | - } |
|
| 92 | - foreach ($tree as $elem) { |
|
| 93 | - if ($elem['name'] === '{' . self::NS_OWNCLOUD . '}tag') { |
|
| 94 | - $tags[] = $elem['value']; |
|
| 95 | - } |
|
| 96 | - } |
|
| 97 | - return new self($tags); |
|
| 98 | - } |
|
| 88 | + $tree = $reader->parseInnerTree(); |
|
| 89 | + if ($tree === null) { |
|
| 90 | + return null; |
|
| 91 | + } |
|
| 92 | + foreach ($tree as $elem) { |
|
| 93 | + if ($elem['name'] === '{' . self::NS_OWNCLOUD . '}tag') { |
|
| 94 | + $tags[] = $elem['value']; |
|
| 95 | + } |
|
| 96 | + } |
|
| 97 | + return new self($tags); |
|
| 98 | + } |
|
| 99 | 99 | |
| 100 | - /** |
|
| 101 | - * The xmlSerialize metod is called during xml writing. |
|
| 102 | - * |
|
| 103 | - * Use the $writer argument to write its own xml serialization. |
|
| 104 | - * |
|
| 105 | - * An important note: do _not_ create a parent element. Any element |
|
| 106 | - * implementing XmlSerializble should only ever write what's considered |
|
| 107 | - * its 'inner xml'. |
|
| 108 | - * |
|
| 109 | - * The parent of the current element is responsible for writing a |
|
| 110 | - * containing element. |
|
| 111 | - * |
|
| 112 | - * This allows serializers to be re-used for different element names. |
|
| 113 | - * |
|
| 114 | - * If you are opening new elements, you must also close them again. |
|
| 115 | - * |
|
| 116 | - * @param Writer $writer |
|
| 117 | - * @return void |
|
| 118 | - */ |
|
| 119 | - function xmlSerialize(Writer $writer) { |
|
| 100 | + /** |
|
| 101 | + * The xmlSerialize metod is called during xml writing. |
|
| 102 | + * |
|
| 103 | + * Use the $writer argument to write its own xml serialization. |
|
| 104 | + * |
|
| 105 | + * An important note: do _not_ create a parent element. Any element |
|
| 106 | + * implementing XmlSerializble should only ever write what's considered |
|
| 107 | + * its 'inner xml'. |
|
| 108 | + * |
|
| 109 | + * The parent of the current element is responsible for writing a |
|
| 110 | + * containing element. |
|
| 111 | + * |
|
| 112 | + * This allows serializers to be re-used for different element names. |
|
| 113 | + * |
|
| 114 | + * If you are opening new elements, you must also close them again. |
|
| 115 | + * |
|
| 116 | + * @param Writer $writer |
|
| 117 | + * @return void |
|
| 118 | + */ |
|
| 119 | + function xmlSerialize(Writer $writer) { |
|
| 120 | 120 | |
| 121 | - foreach ($this->tags as $tag) { |
|
| 122 | - $writer->writeElement('{' . self::NS_OWNCLOUD . '}tag', $tag); |
|
| 123 | - } |
|
| 124 | - } |
|
| 121 | + foreach ($this->tags as $tag) { |
|
| 122 | + $writer->writeElement('{' . self::NS_OWNCLOUD . '}tag', $tag); |
|
| 123 | + } |
|
| 124 | + } |
|
| 125 | 125 | } |