Yet more doc tweaks:
[lhc/web/wiklou.git] / includes / api / ApiFormatJson.php
1 <?php
2
3 /*
4 * Created on Sep 19, 2006
5 *
6 * API for MediaWiki 1.8+
7 *
8 * Copyright (C) 2006 Yuri Astrakhan <FirstnameLastname@gmail.com>
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License along
21 * with this program; if not, write to the Free Software Foundation, Inc.,
22 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
23 * http://www.gnu.org/copyleft/gpl.html
24 */
25
26 if (!defined('MEDIAWIKI')) {
27 // Eclipse helper - will be ignored in production
28 require_once ('ApiFormatBase.php');
29 }
30
31 /**
32 * @addtogroup API
33 */
34 class ApiFormatJson extends ApiFormatBase {
35
36 private $mIsRaw;
37
38 public function __construct($main, $format) {
39 parent :: __construct($main, $format);
40 $this->mIsRaw = ($format === 'rawfm');
41 }
42
43 public function getMimeType() {
44 return 'application/json';
45 }
46
47 public function getNeedsRawData() {
48 return $this->mIsRaw;
49 }
50
51 public function execute() {
52 if (!function_exists('json_encode') || $this->getIsHtml()) {
53 $json = new Services_JSON();
54 $this->printText($json->encode($this->getResultData(), $this->getIsHtml()));
55 } else {
56 $this->printText(json_encode($this->getResultData()));
57 }
58 }
59
60 protected function getDescription() {
61 if ($this->mIsRaw)
62 return 'Output data with the debuging elements in JSON format' . parent :: getDescription();
63 else
64 return 'Output data in JSON format' . parent :: getDescription();
65 }
66
67 public function getVersion() {
68 return __CLASS__ . ': $Id$';
69 }
70 }
71 ?>