/usr/share/php/XML/RPC2/Server/CallHandler/Instance.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 | <?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 an instance's public methods.
*
* XML_RPC2_Server_Callhandler_Instance is the preferred call handler to use when
* you just need to quickly expose an already existing object. If designing a remote
* API from the ground up, it's best to use XML_RPC2_Server_Callhandler_Class instead.
*
* Usage is simple:
* - PhpDoc the 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>
* class EchoServer {
* /**
* * Echo the message
* *
* * @param string The string to echo
* * @return string The echo
* {@*}
* public function echoecho($string)
* {
* return $string;
* }
* }
*
* require_once 'XML/RPC2/Server.php';
* $someInstance = new EchoServer();
* $server = XML_RPC2_Server::create($someInstance);
* $server->handleCall();
* </code>
*
* @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_Class
*/
class XML_RPC2_Server_Callhandler_Instance extends XML_RPC2_Server_CallHandler
{
// {{{ properties
/**
* instance of target object
*
* @var mixed
*/
private $_instance;
// }}}
// {{{ constructor
/**
* XML_RPC2_Server_Callhandler_Class Constructor. Creates a new call handler exporting the given object 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 object The Target object. Calls will be made on this instance
* @param string Default prefix to prepend to all exported methods (defaults to '')
*/
public function __construct($instance, $defaultPrefix)
{
$this->_instance = $instance;
$reflection = new ReflectionClass(get_class($instance));
foreach ($reflection->getMethods() as $method) {
if (!$method->isStatic() && $method->isPublic() && !$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 object, 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->_instance, $this->getMethod($methodName)->getInternalMethod()), $parameters);
}
// }}}
}
?>
|