/usr/share/php/XML/RPC2/Server/CallHandler/Class.php is in php-xml-rpc2 1.1.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 | <?php
/* vim: set expandtab tabstop=4 shiftwidth=4 softtabstop=4 foldmethod=marker: */
// LICENSE AGREEMENT. If folded, press za here to unfold and read license {{{
/**
* +-----------------------------------------------------------------------------+
* | Copyright (c) 2004-2006 Sergio Goncalves Carvalho |
* +-----------------------------------------------------------------------------+
* | This file is part of XML_RPC2. |
* | |
* | XML_RPC2 is free software; you can redistribute it and/or modify |
* | it under the terms of the GNU Lesser General Public License as published by |
* | the Free Software Foundation; either version 2.1 of the License, or |
* | (at your option) any later version. |
* | |
* | XML_RPC2 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 Lesser General Public License for more details. |
* | |
* | You should have received a copy of the GNU Lesser General Public License |
* | along with XML_RPC2; if not, write to the Free Software |
* | Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA |
* | 02111-1307 USA |
* +-----------------------------------------------------------------------------+
* | Author: Sergio Carvalho <sergio.carvalho@portugalmail.com> |
* +-----------------------------------------------------------------------------+
*
* @category XML
* @package XML_RPC2
* @author Sergio Carvalho <sergio.carvalho@portugalmail.com>
* @copyright 2004-2006 Sergio Carvalho
* @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1
* @version CVS: $Id$
* @link http://pear.php.net/package/XML_RPC2
*/
// }}}
// dependencies {{{
require_once 'XML/RPC2/Exception.php';
require_once 'XML/RPC2/Server/Method.php';
require_once 'XML/RPC2/Server/CallHandler.php';
// }}}
/**
* This class is a server call handler which exposes a classe's static public methods.
*
* XML_RPC2_Server_Callhandler_Class is the preferred call handler to use when you are
* designing your XML-RPC server from the ground up. Usage is quite simple:
* - Create a class holding all of the XML-RPC server's exported procedures as public static methods (the interface class).
* - PhpDoc the classes' methods, including at least method signature (params and return types) and short description.
* - Use the XML_RPC2 factory method to create a server based on the interface class.
* A simple example:
* <code>
* /**
* * echoecho echoes the message received
* *
* * @param string Message
* * @return string The echo
* {@*}
* class EchoServer {
* public static function echoecho($string)
* {
* return $string;
* }
* }
*
* require_once 'XML/RPC2/Server.php';
* $server = XML_RPC2_Server::create('EchoServer');
* $server->handleCall();
* </code>
*
* Use this call handler if you have designed your xml-rpc external interface as a set of
* public class methods on a given class. If, on the other hand, you intend to export an
* already existing class, it may be that not all of the methods you want to export are static.
* In that case, it is probably best to use XML_RPC2_Server_Callhandler_Instance instead.
*
* @category XML
* @package XML_RPC2
* @author Sergio Carvalho <sergio.carvalho@portugalmail.com>
* @copyright 2004-2006 Sergio Carvalho
* @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1
* @link http://pear.php.net/package/XML_RPC2
* @see XML_RPC2_Server::create
* @see XML_RPC2_Server_Callhandler_Instance
*/
class XML_RPC2_Server_Callhandler_Class extends XML_RPC2_Server_CallHandler
{
// {{{ properties
/**
* name of target class
*
* @var string
*/
private $_className;
// }}}
// {{{ constructor
/**
* XML_RPC2_Server_Callhandler_Class Constructor. Creates a new call handler exporting the give static class' methods
*
* Before using this constructor, take a look at XML_RPC2_Server::create. The factory
* method is usually a quicker way of instantiating the server and its call handler.
*
* @see XML_RPC2_Server::create()
* @param string The Target class. Calls will be made on this class
* @param string Default prefix to prepend to all exported methods (defaults to '')
*/
public function __construct($className, $defaultPrefix)
{
$this->_className = $className;
$reflection = new ReflectionClass($className);
foreach ($reflection->getMethods() as $method) {
if ($method->isStatic() && $method->isPublic() && !$method->isAbstract() && !$method->isConstructor())
{
$candidate = new XML_RPC2_Server_Method($method, $defaultPrefix);
if (!$candidate->isHidden()) $this->addMethod($candidate);
}
}
}
// }}}
// {{{ __call()
/**
* __call catchall. Delegate the method call to the target class, and return its result
*
* @param string Name of method to call
* @param array Array of parameters for call
* @return mixed Whatever the target method returned
*/
public function __call($methodName, $parameters)
{
if (!array_key_exists($methodName, $this->getMethods())) {
throw new XML_RPC2_UnknownMethodException("Method $methodName is not exported by this server");
}
return call_user_func_array(array($this->_className, $this->getMethod($methodName)->getInternalMethod()), $parameters);
}
// }}}
}
?>
|