Collaboration diagram for XML_RPC2_Server_Method:

Public Member Functions
	getInternalMethod ()
	internalMethod getter More...

	isHidden ()
	hidden getter More...

	getName ()
	name getter More...

	__construct (ReflectionMethod $method, $defaultPrefix)
	Create a new XML-RPC method by introspecting a PHP method. More...

	matchesSignature ($methodName, $callParams)
	Check if method matches provided call signature. More...

	getHTMLSignature ()
	Return a HTML signature of the method. More...

	autoDocument ()
	Print a complete HTML description of the method. More...

Static Private Member Functions
static	_limitPHPType ($type)

Private Attributes
	$_parameters

	$_returns

	$_help

	$_internalMethod

	$_hidden

	$_name

	$_numberOfRequiredParameters

Detailed Description

Definition at line 59 of file Method.php.

Constructor & Destructor Documentation

◆ __construct()

XML_RPC2_Server_Method::__construct	(	ReflectionMethod	$method,
			$defaultPrefix
	)

Create a new XML-RPC method by introspecting a PHP method.

Parameters

ReflectionMethod	The PHP method to introspect
string	default prefix

Definition at line 160 of file Method.php.

    {
        $hidden = false;
        $docs = $method->getDocComment();
        if (!$docs) {
            $hidden = true;
        }
        $docs = explode("\n", $docs);
 
        $parameters = array();
        $methodname = null;
        $returns = 'mixed';
        $shortdesc = '';
        $paramcount = -1;
        $prefix = $defaultPrefix;
 
        // Extract info from Docblock
        $paramDocs = array();
        foreach ($docs as $i => $doc) {
            $doc = trim($doc, " \r\t/*");
            if (strlen($doc) && strpos($doc, '@') !== 0) {
                if ($shortdesc) {
                    $shortdesc .= "\n";
                }
                $shortdesc .= $doc;
                continue;
            }
            if (strpos($doc, '@xmlrpc.hidden') === 0) {
                $hidden = true;
            }
            if ((strpos($doc, '@xmlrpc.prefix') === 0) && preg_match('/@xmlrpc.prefix( )*(.*)/', $doc, $matches)) {
                $prefix = $matches[2];
            }
            if ((strpos($doc, '@xmlrpc.methodname') === 0) && preg_match('/@xmlrpc.methodname( )*(.*)/', $doc, $matches)) {
                $methodname = $matches[2];
            }
            if (strpos($doc, '@param') === 0) { // Save doctag for usage later when filling parameters
                $paramDocs[] = $doc;
            }
 
            if (strpos($doc, '@return') === 0) {
                $param = preg_split("/\s+/", $doc);
                if (isset($param[1])) {
                    $param = $param[1];
                    $returns = $param;
                }
            }
        }
        $this->_numberOfRequiredParameters = $method->getNumberOfRequiredParameters(); // we don't use isOptional() because of bugs in the reflection API
        // Fill in info for each method parameter
        foreach ($method->getParameters() as $parameterIndex => $parameter) {
            // Parameter defaults
            $newParameter = array('type' => 'mixed');
 
            // Attempt to extract type and doc from docblock
            if (array_key_exists($parameterIndex, $paramDocs) &&
                preg_match('/@param\s+(\S+)(\s+(.+))/', $paramDocs[$parameterIndex], $matches)) {
                if (strpos($matches[1], '|')) {
                    $newParameter['type'] = XML_RPC2_Server_Method::_limitPHPType(explode('|', $matches[1]));
                } else {
                    $newParameter['type'] = XML_RPC2_Server_Method::_limitPHPType($matches[1]);
                }
                $tmp = '$' . $parameter->getName() . ' ';
                if (strpos($matches[2], '$' . $tmp) === 0) {
                    $newParameter['doc'] = $matches[2];
                } else {
                    // The phpdoc comment is something like "@param string $param description of param"    
                    // Let's keep only "description of param" as documentation (remove $param)
                    $newParameter['doc'] = substr($matches[2], strlen($tmp));
                }
            }
 
            $parameters[$parameter->getName()] = $newParameter;
        }
 
        if (is_null($methodname)) {
            $methodname = $prefix . $method->getName();
        }
 
        $this->_internalMethod = $method->getName();
        $this->_parameters = $parameters;
        $this->_returns  = $returns;
        $this->_help = $shortdesc;
        $this->_name = $methodname;
        $this->_hidden = $hidden;
    }

References _limitPHPType().

Here is the call graph for this function:

Member Function Documentation

◆ _limitPHPType()

static XML_RPC2_Server_Method::_limitPHPType ( $type )

staticprivate

Definition at line 358 of file Method.php.

    {
        $tmp = strtolower($type);
        $convertArray = array(
            'int' => 'integer',
            'i4' => 'integer',
            'integer' => 'integer',
            'string' => 'string',
            'str' => 'string',
            'char' => 'string',
            'bool' => 'boolean',
            'boolean' => 'boolean',
            'array' => 'array',
            'float' => 'double',
            'double' => 'double',
            'array' => 'array',
            'struct' => 'array',
            'assoc' => 'array',
            'structure' => 'array',
            'datetime' => 'mixed',
            'datetime.iso8601' => 'mixed',
            'iso8601' => 'mixed',
            'base64' => 'string'
        );      
        if (isset($convertArray[$tmp])) {
            return $convertArray[$tmp]; 
        }
        return 'mixed'; 
    }

Referenced by __construct(), and matchesSignature().

Here is the caller graph for this function:

◆ autoDocument()

XML_RPC2_Server_Method::autoDocument ( )

Print a complete HTML description of the method.

Definition at line 323 of file Method.php.

    {
        $name = $this->getName();
        $signature = $this->getHTMLSignature();
        $id = md5($name);
        $help = nl2br(htmlentities($this->_help));
        print "      <h3><a name=\"$id\">$signature</a></h3>\n";
        print "      <p><b>Description :</b></p>\n";
        print "      <div class=\"description\">\n";
        print "        $help\n";
        print "      </div>\n";
        if (count($this->_parameters)>0) {
            print "      <p><b>Parameters : </b></p>\n";
            if (count($this->_parameters)>0) {
                print "      <table>\n";
                print "        <tr><td><b>Type</b></td><td><b>Name</b></td><td><b>Documentation</b></td></tr>\n";
                while (list($name, $parameter) = each($this->_parameters)) {
                    $type = $parameter['type'];
                    $doc = htmlentities($parameter['doc']);
                    print "        <tr><td>$type</td><td>$name</td><td>$doc</td></tr>\n";
                }
                reset($this->_parameters);
                print "      </table>\n";
            }
        }
    }

References getHTMLSignature(), getName(), and print.

Here is the call graph for this function:

◆ getHTMLSignature()

XML_RPC2_Server_Method::getHTMLSignature ( )

Return a HTML signature of the method.

Returns: string HTML signature

Definition at line 287 of file Method.php.

    {
        $name = $this->_name;
        $returnType = $this->_returns;
        $result  = "<span class=\"type\">($returnType)</span> ";
        $result .= "<span class=\"name\">$name</span>";
        $result  .= "<span class=\"other\">(</span>";
        $first = true;
        $nbr = 0;
        while (list($name, $parameter) = each($this->_parameters)) {
            $nbr++;
            if ($nbr == $this->_numberOfRequiredParameters + 1) {
                $result .= "<span class=\"other\"> [ </span>";
            }
            if ($first) {
                $first = false;
            } else {
                $result .= ', ';
            }
            $type = $parameter['type'];
            $result .= "<span class=\"paratype\">($type) </span>";
            $result .= "<span class=\"paraname\">$name</span>";
        }
        reset($this->_parameters);
        if ($nbr > $this->_numberOfRequiredParameters) {
            $result .= "<span class=\"other\"> ] </span>";
        }
        $result .= "<span class=\"other\">)</span>";
        return $result;
    }

References $_name, $_returns, and $result.

Referenced by autoDocument().

Here is the caller graph for this function:

◆ getInternalMethod()

XML_RPC2_Server_Method::getInternalMethod ( )

internalMethod getter

Returns: string internalMethod

Definition at line 120 of file Method.php.

    {
        return $this->_internalMethod;
    }

References $_internalMethod.

◆ getName()

XML_RPC2_Server_Method::getName ( )

name getter

Returns: string name

Definition at line 146 of file Method.php.

    {
        return $this->_name;
    }

References $_name.

Referenced by XML_RPC2_Server_CallHandler\addMethod(), and autoDocument().

Here is the caller graph for this function:

◆ isHidden()

XML_RPC2_Server_Method::isHidden ( )

hidden getter

Returns: boolean hidden value

Definition at line 133 of file Method.php.

    {
        return $this->_hidden;
    }

References $_hidden.

◆ matchesSignature()

XML_RPC2_Server_Method::matchesSignature	(	$methodName,
		$callParams
	)

Check if method matches provided call signature.

Compare the provided call signature with this methods' signature and return true iff they match.

Parameters

string	Signature to compare method name
array	Array of parameter values for method call.

Returns: boolean True if call matches signature, false otherwise

Definition at line 260 of file Method.php.

    {
        if ($methodName != $this->_name) return false;
        if (count($callParams) < $this->_numberOfRequiredParameters) return false;
        if (count($callParams) > $this->_parameters) return false;
        $paramIndex = 0;
        foreach($this->_parameters as $param) {
            $paramIndex++;
            if ($paramIndex <= $this->_numberOfRequiredParameters) {
                // the parameter is not optional
                $callParamType = XML_RPC2_Server_Method::_limitPHPType(gettype($callParams[$paramIndex-1]));
                if ((!($param['type'] == 'mixed')) and ($param['type'] != $callParamType)) {
                    return false;
                }
            }
        }
        return true;
    }

References _limitPHPType().

Here is the call graph for this function:

Field Documentation

◆ $_help

XML_RPC2_Server_Method::$_help

private

Definition at line 82 of file Method.php.

◆ $_hidden

XML_RPC2_Server_Method::$_hidden

private

Definition at line 96 of file Method.php.

Referenced by isHidden().

◆ $_internalMethod

XML_RPC2_Server_Method::$_internalMethod

private

Definition at line 89 of file Method.php.

Referenced by getInternalMethod().

◆ $_name

XML_RPC2_Server_Method::$_name

private

Definition at line 103 of file Method.php.

Referenced by getHTMLSignature(), and getName().

◆ $_numberOfRequiredParameters

XML_RPC2_Server_Method::$_numberOfRequiredParameters

private

Definition at line 110 of file Method.php.

◆ $_parameters

XML_RPC2_Server_Method::$_parameters

private

Definition at line 68 of file Method.php.

◆ $_returns

XML_RPC2_Server_Method::$_returns

private

Definition at line 75 of file Method.php.

Referenced by getHTMLSignature().

The documentation for this class was generated from the following file:

Services/PEAR/lib/XML/RPC2/Server/Method.php

Public Member Functions

Static Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ _limitPHPType()

◆ autoDocument()

◆ getHTMLSignature()

◆ getInternalMethod()

◆ getName()

◆ isHidden()

◆ matchesSignature()

Field Documentation

◆ $_help

◆ $_hidden

◆ $_internalMethod

◆ $_name

◆ $_numberOfRequiredParameters

◆ $_parameters

◆ $_returns