23c754aed3
use method exists lookup to be safe and not break on old hhvm versions add test that checks if type hint is preferred over annotation
119 lines
3.3 KiB
PHP
119 lines
3.3 KiB
PHP
<?php
|
|
/**
|
|
* @author Bernhard Posselt <dev@bernhard-posselt.com>
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
* @author Olivier Paroz <github@oparoz.com>
|
|
* @author Robin McCorkell <rmccorkell@karoshi.org.uk>
|
|
* @author Thomas Müller <thomas.mueller@tmit.eu>
|
|
* @author Vincent Petry <pvince81@owncloud.com>
|
|
*
|
|
* @copyright Copyright (c) 2015, ownCloud, Inc.
|
|
* @license AGPL-3.0
|
|
*
|
|
* This code is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
* as published by the Free Software Foundation.
|
|
*
|
|
* This program 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 Affero General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Affero General Public License, version 3,
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
|
*
|
|
*/
|
|
|
|
|
|
namespace OC\AppFramework\Utility;
|
|
|
|
use \OCP\AppFramework\Utility\IControllerMethodReflector;
|
|
|
|
|
|
/**
|
|
* Reads and parses annotations from doc comments
|
|
*/
|
|
class ControllerMethodReflector implements IControllerMethodReflector{
|
|
|
|
private $annotations;
|
|
private $types;
|
|
private $parameters;
|
|
|
|
public function __construct() {
|
|
$this->types = array();
|
|
$this->parameters = array();
|
|
$this->annotations = array();
|
|
}
|
|
|
|
|
|
/**
|
|
* @param object $object an object or classname
|
|
* @param string $method the method which we want to inspect
|
|
*/
|
|
public function reflect($object, $method){
|
|
$reflection = new \ReflectionMethod($object, $method);
|
|
$docs = $reflection->getDocComment();
|
|
|
|
// extract everything prefixed by @ and first letter uppercase
|
|
preg_match_all('/@([A-Z]\w+)/', $docs, $matches);
|
|
$this->annotations = $matches[1];
|
|
|
|
// extract type parameter information
|
|
preg_match_all('/@param\h+(?P<type>\w+)\h+\$(?P<var>\w+)/', $docs, $matches);
|
|
$this->types = array_combine($matches['var'], $matches['type']);
|
|
|
|
foreach ($reflection->getParameters() as $param) {
|
|
// extract type information from PHP 7 scalar types and prefer them
|
|
// over phpdoc annotations
|
|
if (method_exists($param, 'getType')) {
|
|
$type = $param->getType();
|
|
if ($type !== null) {
|
|
$this->types[$param->getName()] = (string) $type;
|
|
}
|
|
}
|
|
|
|
if($param->isOptional()) {
|
|
$default = $param->getDefaultValue();
|
|
} else {
|
|
$default = null;
|
|
}
|
|
$this->parameters[$param->name] = $default;
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* Inspects the PHPDoc parameters for types
|
|
* @param string $parameter the parameter whose type comments should be
|
|
* parsed
|
|
* @return string|null type in the type parameters (@param int $something)
|
|
* would return int or null if not existing
|
|
*/
|
|
public function getType($parameter) {
|
|
if(array_key_exists($parameter, $this->types)) {
|
|
return $this->types[$parameter];
|
|
} else {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
|
|
/**
|
|
* @return array the arguments of the method with key => default value
|
|
*/
|
|
public function getParameters() {
|
|
return $this->parameters;
|
|
}
|
|
|
|
|
|
/**
|
|
* Check if a method contains an annotation
|
|
* @param string $name the name of the annotation
|
|
* @return bool true if the annotation is found
|
|
*/
|
|
public function hasAnnotation($name){
|
|
return in_array($name, $this->annotations);
|
|
}
|
|
|
|
|
|
}
|