nextcloud/lib/public/appframework/ocscontroller.php

102 lines
3.0 KiB
PHP
Raw Normal View History

2015-02-05 16:02:17 +03:00
<?php
/**
2015-03-26 13:44:34 +03:00
* @author Bernhard Posselt <dev@bernhard-posselt.com>
* @author Morris Jobke <hey@morrisjobke.de>
2015-02-05 16:02:17 +03:00
*
2015-03-26 13:44:34 +03:00
* @copyright Copyright (c) 2015, ownCloud, Inc.
* @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\Controller class
*/
2015-02-05 16:02:17 +03:00
namespace OCP\AppFramework;
use OCP\AppFramework\Http\DataResponse;
use OCP\AppFramework\Http\OCSResponse;
use OCP\IRequest;
/**
* Base class to inherit your controllers from that are used for RESTful APIs
* @since 8.1.0
2015-02-05 16:02:17 +03:00
*/
abstract class OCSController extends ApiController {
/**
* constructor of the controller
* @param string $appName the name of the app
* @param IRequest $request an instance of the request
2015-08-03 22:03:11 +03:00
* @param string $corsMethods comma separated string of HTTP verbs which
2015-02-05 16:02:17 +03:00
* should be allowed for websites or webapps when calling your API, defaults to
* 'PUT, POST, GET, DELETE, PATCH'
2015-04-18 15:31:28 +03:00
* @param string $corsAllowedHeaders comma seperated string of HTTP headers
2015-02-05 16:02:17 +03:00
* which should be allowed for websites or webapps when calling your API,
* defaults to 'Authorization, Content-Type, Accept'
* @param int $corsMaxAge number in seconds how long a preflighted OPTIONS
* request should be cached, defaults to 1728000 seconds
* @since 8.1.0
2015-02-05 16:02:17 +03:00
*/
public function __construct($appName,
IRequest $request,
$corsMethods='PUT, POST, GET, DELETE, PATCH',
$corsAllowedHeaders='Authorization, Content-Type, Accept',
$corsMaxAge=1728000){
parent::__construct($appName, $request, $corsMethods,
$corsAllowedHeaders, $corsMaxAge);
$this->registerResponder('json', function ($data) {
return $this->buildOCSResponse('json', $data);
});
$this->registerResponder('xml', function ($data) {
return $this->buildOCSResponse('xml', $data);
});
}
/**
* Unwrap data and build ocs response
* @param string $format json or xml
* @param array|DataResponse $data the data which should be transformed
* @since 8.1.0
2015-02-05 16:02:17 +03:00
*/
private function buildOCSResponse($format, $data) {
if ($data instanceof DataResponse) {
$data = $data->getData();
}
$params = [
'statuscode' => 100,
'message' => 'OK',
'data' => [],
'itemscount' => '',
'itemsperpage' => ''
];
foreach ($data as $key => $value) {
$params[$key] = $value;
}
return new OCSResponse(
2015-08-03 23:19:04 +03:00
$format, $params['statuscode'],
2015-08-03 22:03:11 +03:00
$params['message'], $params['data'],
2015-02-05 16:02:17 +03:00
$params['itemscount'], $params['itemsperpage']
);
}
}