* @author Christoph Wurst * @author Lukas Reschke * @author Morris Jobke * @author Roeland Jago Douma * @author Thomas Müller * @author Thomas Tanghus * * @license AGPL-3.0 * * 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. * * 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, version 3, * along with this program. If not, see * */ namespace OCP\AppFramework\Http; use OCP\AppFramework\Http; /** * A renderer for JSON calls * @since 6.0.0 */ class JSONResponse extends Response { /** * response data * @var array|object */ protected $data; /** * constructor of JSONResponse * @param array|object $data the object or array that should be transformed * @param int $statusCode the Http status code, defaults to 200 * @since 6.0.0 */ public function __construct($data = [], $statusCode = Http::STATUS_OK) { parent::__construct(); $this->data = $data; $this->setStatus($statusCode); $this->addHeader('Content-Type', 'application/json; charset=utf-8'); } /** * Returns the rendered json * @return string the rendered json * @since 6.0.0 * @throws \Exception If data could not get encoded */ public function render() { return json_encode($this->data, JSON_HEX_TAG | JSON_THROW_ON_ERROR); } /** * Sets values in the data json array * @param array|object $data an array or object which will be transformed * to JSON * @return JSONResponse Reference to this object * @since 6.0.0 - return value was added in 7.0.0 */ public function setData($data) { $this->data = $data; return $this; } /** * Used to get the set parameters * @return array the data * @since 6.0.0 */ public function getData() { return $this->data; } }