mirror of
https://github.com/nextcloud/server.git
synced 2024-08-22 17:55:31 +02:00
![Joas Schilling](/assets/img/avatar_default.png)
Signed-off-by: Joas Schilling <coding@schilljs.com> Signed-off-by: Benjamin Gaussorgues <benjamin.gaussorgues@nextcloud.com>
172 lines
4.3 KiB
PHP
172 lines
4.3 KiB
PHP
<?php
|
|
/**
|
|
* @copyright 2016 Roeland Jago Douma <roeland@famdouma.nl>
|
|
*
|
|
* @author Christoph Wurst <christoph@winzerhof-wurst.at>
|
|
* @author Daniel Kesselberg <mail@danielkesselberg.de>
|
|
* @author Joas Schilling <coding@schilljs.com>
|
|
* @author Lukas Reschke <lukas@statuscode.ch>
|
|
* @author Roeland Jago Douma <roeland@famdouma.nl>
|
|
* @author Kate Döen <kate.doeen@nextcloud.com>
|
|
*
|
|
* @license GNU AGPL version 3 or any later version
|
|
*
|
|
* This program is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as
|
|
* published by the Free Software Foundation, either version 3 of the
|
|
* License, or (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
namespace OC\AppFramework\OCS;
|
|
|
|
use OCP\AppFramework\Http;
|
|
use OCP\AppFramework\Http\DataResponse;
|
|
use OCP\AppFramework\Http\Response;
|
|
|
|
/**
|
|
* @psalm-import-type DataResponseType from DataResponse
|
|
* @template S of int
|
|
* @template-covariant T of DataResponseType
|
|
* @template H of array<string, mixed>
|
|
* @template-extends Response<int, array<string, mixed>>
|
|
*/
|
|
abstract class BaseResponse extends Response {
|
|
/** @var array */
|
|
protected $data;
|
|
|
|
/** @var string */
|
|
protected $format;
|
|
|
|
/** @var ?string */
|
|
protected $statusMessage;
|
|
|
|
/** @var ?int */
|
|
protected $itemsCount;
|
|
|
|
/** @var ?int */
|
|
protected $itemsPerPage;
|
|
|
|
/**
|
|
* BaseResponse constructor.
|
|
*
|
|
* @param DataResponse<S, T, H> $dataResponse
|
|
* @param string $format
|
|
* @param string|null $statusMessage
|
|
* @param int|null $itemsCount
|
|
* @param int|null $itemsPerPage
|
|
*/
|
|
public function __construct(DataResponse $dataResponse,
|
|
$format = 'xml',
|
|
$statusMessage = null,
|
|
$itemsCount = null,
|
|
$itemsPerPage = null) {
|
|
parent::__construct();
|
|
|
|
$this->format = $format;
|
|
$this->statusMessage = $statusMessage;
|
|
$this->itemsCount = $itemsCount;
|
|
$this->itemsPerPage = $itemsPerPage;
|
|
|
|
$this->data = $dataResponse->getData();
|
|
|
|
$this->setHeaders($dataResponse->getHeaders());
|
|
$this->setStatus($dataResponse->getStatus());
|
|
$this->setETag($dataResponse->getETag());
|
|
$this->setLastModified($dataResponse->getLastModified());
|
|
$this->setCookies($dataResponse->getCookies());
|
|
|
|
if ($dataResponse->isThrottled()) {
|
|
$throttleMetadata = $dataResponse->getThrottleMetadata();
|
|
$this->throttle($throttleMetadata);
|
|
}
|
|
|
|
if ($format === 'json') {
|
|
$this->addHeader(
|
|
'Content-Type', 'application/json; charset=utf-8'
|
|
);
|
|
} else {
|
|
$this->addHeader(
|
|
'Content-Type', 'application/xml; charset=utf-8'
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param array<string,string|int> $meta
|
|
* @return string
|
|
*/
|
|
protected function renderResult(array $meta): string {
|
|
$status = $this->getStatus();
|
|
if ($status === Http::STATUS_NO_CONTENT ||
|
|
$status === Http::STATUS_NOT_MODIFIED ||
|
|
($status >= 100 && $status <= 199)) {
|
|
// Those status codes are not supposed to have a body:
|
|
// https://stackoverflow.com/q/8628725
|
|
return '';
|
|
}
|
|
|
|
$response = [
|
|
'ocs' => [
|
|
'meta' => $meta,
|
|
'data' => $this->data,
|
|
],
|
|
];
|
|
|
|
if ($this->format === 'json') {
|
|
return json_encode($response, JSON_HEX_TAG);
|
|
}
|
|
|
|
$writer = new \XMLWriter();
|
|
$writer->openMemory();
|
|
$writer->setIndent(true);
|
|
$writer->startDocument();
|
|
$this->toXML($response, $writer);
|
|
$writer->endDocument();
|
|
return $writer->outputMemory(true);
|
|
}
|
|
|
|
protected function toXML(array $array, \XMLWriter $writer): void {
|
|
foreach ($array as $k => $v) {
|
|
if ($k === '@attributes' && is_array($v)) {
|
|
foreach ($v as $k2 => $v2) {
|
|
$writer->writeAttribute($k2, $v2);
|
|
}
|
|
continue;
|
|
}
|
|
|
|
if (\is_string($k) && str_starts_with($k, '@')) {
|
|
$writer->writeAttribute(substr($k, 1), $v);
|
|
continue;
|
|
}
|
|
|
|
if (\is_numeric($k)) {
|
|
$k = 'element';
|
|
}
|
|
|
|
if ($v instanceof \stdClass) {
|
|
$v = [];
|
|
}
|
|
|
|
if (\is_array($v)) {
|
|
$writer->startElement($k);
|
|
$this->toXML($v, $writer);
|
|
$writer->endElement();
|
|
} else {
|
|
$writer->writeElement($k, $v);
|
|
}
|
|
}
|
|
}
|
|
|
|
public function getOCSStatus() {
|
|
return parent::getStatus();
|
|
}
|
|
}
|