nanoserv
[ class tree: nanoserv ] [ index: nanoserv ] [ all elements ]
Packages:
nanoserv

Source for file NS_JSON_RPC_Service_Handler.php

Documentation is available at NS_JSON_RPC_Service_Handler.php

  1. <?php
  2.  
  3. /**
  4.  *
  5.  * nanoserv handlers - JSON-RPC server
  6.  * 
  7.  * Copyright (C) 2004-2010 Vincent Negrier aka. sIX <six@aegis-corp.org>
  8.  * 
  9.  * This library is free software; you can redistribute it and/or
  10.  * modify it under the terms of the GNU Lesser General Public
  11.  * License as published by the Free Software Foundation; either
  12.  * version 2.1 of the License, or (at your option) any later version.
  13.  * 
  14.  * This library is distributed in the hope that it will be useful,
  15.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17.  * Lesser General Public License for more details.
  18.  * 
  19.  * You should have received a copy of the GNU Lesser General Public
  20.  * License along with this library; if not, write to the Free Software
  21.  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA *
  22.  *
  23.  * @package nanoserv
  24.  * @subpackage Handlers
  25.  */
  26.  
  27. /**
  28.  * Require the HTTP server
  29.  */
  30. require_once "nanoserv-compat/handlers/NS_HTTP_Service_Handler.php";
  31.  
  32.  
  33. /**
  34.  * JSON-RPC Service handler class
  35.  *
  36.  * @package nanoserv
  37.  * @subpackage Handlers
  38.  */
  39. abstract class NS_JSON_RPC_Service_Handler extends NS_HTTP_Service_Handler {
  40.  
  41.     /**
  42.      * Request URL
  43.      * @var string 
  44.      */
  45.     protected $request_url = "";
  46.     
  47.     final public function on_Request($url) {
  48.  
  49.         $this->request_url = $url;
  50.         
  51.         $req = json_decode($this->request_content);
  52.  
  53.         $ret = array("id" => $req->id);
  54.         
  55.         if ($req === NULL) {
  56.  
  57.             $this->Set_Response_Status(400);
  58.  
  59.             switch (json_last_error()) {
  60.  
  61.                 case JSON_ERROR_DEPTH:        $ret["error"] = "The maximum stack depth has been exceeded";                break;
  62.                 case JSON_ERROR_CTRL_CHAR:    $ret["error"] = "Control character error, possibly incorrectly encoded";    break;
  63.                 case JSON_ERROR_SYNTAX:        $ret["error"] = "Syntax error";                                                break;
  64.                 default:                    $ret["error"] = "Unknown error";                                            break;
  65.             
  66.             }
  67.             
  68.             return json_encode($ret);
  69.         
  70.         }
  71.  
  72.         try {
  73.         
  74.             $ret["result"] = $this->on_Call($req->method, $req->params);
  75.             
  76.         } catch (Exception $e) {
  77.  
  78.             $ret["error"] = $e->getMessage();
  79.         
  80.         }
  81.     
  82.         if (isset($req->id)) {
  83.  
  84.             return json_encode($ret);
  85.  
  86.         } else {
  87.  
  88.             return "";
  89.  
  90.         }
  91.     
  92.     }
  93.  
  94.     /**
  95.      * Event called on JSON-RPC method call
  96.      *
  97.      * The value returned by on_Call() will be sent back as the JSON-RPC method call response
  98.      *
  99.      * @param string $method 
  100.      * @param array $args 
  101.      * @return mixed 
  102.      */
  103.     abstract public function on_Call($method, $args);
  104.  
  105. }
  106.  
  107. ?>
Documentation generated on Wed, 30 Nov 2011 22:03:24 +0100 by phpDocumentor 1.4.3