nextcloud/lib/public/AppFramework/Http/OCSResponse.php

96 lines
2.7 KiB
PHP
Raw Normal View History

2015-02-05 16:02:17 +03:00
<?php
/**
2016-07-21 18:07:57 +03:00
* @copyright Copyright (c) 2016, ownCloud, Inc.
*
2015-03-26 13:44:34 +03:00
* @author Bernhard Posselt <dev@bernhard-posselt.com>
* @author Lukas Reschke <lukas@statuscode.ch>
2015-03-26 13:44:34 +03:00
* @author Morris Jobke <hey@morrisjobke.de>
* @author Roeland Jago Douma <roeland@famdouma.nl>
2015-10-05 21:54:56 +03:00
* @author Thomas Müller <thomas.mueller@tmit.eu>
2015-02-05 16:02:17 +03:00
*
2015-03-26 13:44:34 +03:00
* @license AGPL-3.0
2015-02-05 16:02:17 +03:00
*
2015-03-26 13:44:34 +03:00
* This code is free software: you can redistribute it and/or modify
* it under the terms of the GNU Affero General Public License, version 3,
* as published by the Free Software Foundation.
2015-02-05 16:02:17 +03:00
*
2015-03-26 13:44:34 +03:00
* This program is distributed in the hope that it will be useful,
2015-02-05 16:02:17 +03:00
* but WITHOUT ANY WARRANTY; without even the implied warranty of
2015-03-26 13:44:34 +03:00
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Affero General Public License for more details.
2015-02-05 16:02:17 +03:00
*
2015-03-26 13:44:34 +03:00
* You should have received a copy of the GNU Affero General Public License, version 3,
* along with this program. If not, see <http://www.gnu.org/licenses/>
2015-02-05 16:02:17 +03:00
*
*/
/**
* Public interface of ownCloud for apps to use.
* AppFramework\HTTP\JSONResponse class
*/
2015-02-05 16:02:17 +03:00
namespace OCP\AppFramework\Http;
/**
* A renderer for OCS responses
* @since 8.1.0
* @deprecated 9.2.0 To implement an OCS endpoint extend the OCSController
2015-02-05 16:02:17 +03:00
*/
class OCSResponse extends Response {
private $data;
private $format;
private $statuscode;
private $message;
private $itemscount;
private $itemsperpage;
/**
* generates the xml or json response for the API call from an multidimenional data array.
* @param string $format
2015-08-03 22:03:11 +03:00
* @param int $statuscode
2015-02-05 16:02:17 +03:00
* @param string $message
* @param array $data
* @param int|string $itemscount
* @param int|string $itemsperpage
* @since 8.1.0
* @deprecated 9.2.0 To implement an OCS endpoint extend the OCSController
2015-02-05 16:02:17 +03:00
*/
2015-08-03 22:03:11 +03:00
public function __construct($format, $statuscode, $message,
$data = [], $itemscount = '',
$itemsperpage = '') {
parent::__construct();
2015-02-05 16:02:17 +03:00
$this->format = $format;
$this->statuscode = $statuscode;
$this->message = $message;
$this->data = $data;
$this->itemscount = $itemscount;
$this->itemsperpage = $itemsperpage;
// set the correct header based on the format parameter
if ($format === 'json') {
$this->addHeader(
'Content-Type', 'application/json; charset=utf-8'
);
} else {
$this->addHeader(
'Content-Type', 'application/xml; charset=utf-8'
);
}
}
/**
* @return string
* @since 8.1.0
* @deprecated 9.2.0 To implement an OCS endpoint extend the OCSController
* @suppress PhanDeprecatedClass
*/
2015-02-05 16:02:17 +03:00
public function render() {
$r = new \OC\OCS\Result($this->data, $this->statuscode, $this->message);
2015-08-03 22:03:11 +03:00
$r->setTotalItems($this->itemscount);
$r->setItemsPerPage($this->itemsperpage);
return \OC_API::renderResult($this->format, $r->getMeta(), $r->getData());
2015-02-05 16:02:17 +03:00
}
}