/**
* 设置绑定
* @param $params 绑定相关参数:[目标变量 , 源变量]
* @param $method_info 方法变量信息 [变量名=>[是否引用, 是否有默认值, 默认值]]
*/
public function set($id, $params, $method_info)
{
Verify::isTrue(is_array($params) && count($params) >= 2, "{$this->class_name}::{$this->method_name} invalid @throws");
$exception = $params[0];
$to = $params[1];
$from = array_slice($params, 2);
$to_func =& $this->params[$exception][$to][$id];
foreach ($from as $index => $name) {
// 输入方法 $index变量序号 $name变量名
if (is_array($name)) {
$is_const = true;
} else {
$is_const = substr($name, 0, 1) != '$';
}
Verify::isTrue($is_const, "{$this->class_name}::{$this->method_name} dynamic variable not supported by @throws");
$to_func[$index] = $name;
}
}
/**
* 绑定到函数调用的参数上去
* @param $req
* @param $res
* @param array $args
*/
public function bind($req, &$res, &$args)
{
foreach ($this->params as $pos => $param) {
list($is_const, $value, $info) = $param;
if ($is_const) {
// 常量
$args[$pos] = $value;
} else {
//变量
list(, $is_ref, $is_optional, $default) = $info;
$found = $req->find($value, $is_ref, $default);
if (!$found[1]) {
Verify::isTrue($is_optional, new BadRequest("{$this->class_name}::{$this->method_name} {$value} not found in request"));
$args[$pos] = $default;
} else {
if ($is_ref) {
$args[$pos] =& $found[0];
} else {
$args[$pos] = $found[0];
}
}
}
}
}
/**
* 设置绑定
* @param $params 绑定相关参数:[目标变量 , 源变量]
* @param $method_info 方法变量信息 [变量名=>[是否引用, 是否有默认值, 默认值]]
*/
public function set($id, $params, $method_info)
{
Verify::isTrue(is_array($params) || is_string($params), "{$this->class_name}::{$this->method_name} invalid @return");
if (is_string($params)) {
$to = $params;
$from = array();
} else {
$to = $params[0];
$from = array_slice($params, 1);
}
$to_func =& $this->params[$to][$id];
if ($this->auto_bind_return && $to == 'body' && isset($this->params['body'][-1])) {
unset($this->params['body'][-1]);
// 指定了body输出, 去掉默认的body输出
}
if (0 === count($from)) {
$to_func[0] = array(false, null, -1, null);
}
foreach ($from as $index => $name) {
// 输入方法 $index变量序号 $name变量名
$is_const = substr($name, 0, 1) != '$';
if ($is_const) {
// 输出常量, 不需要绑定变量
$to_func[$index] = array(true, $name, 0, null);
//[是否常量, 值 , 参数来源位置, 参数信息]
continue;
}
$name = substr($name, 1);
//变量输出, 需要绑定
$pos = -1;
$step = 0;
//是(输出)方法的第几个参数
foreach ($method_info as $item) {
list($param_name, ) = $item;
if ($name === $param_name) {
$pos = $step;
break;
}
$step++;
}
Verify::isTrue($pos !== -1, "{$this->class_name}::{$this->method_name} param: {$name} not found");
//只能是引用
list(, $is_ref, ) = $item;
Verify::isTrue($is_ref, "{$this->class_name}::{$this->method_name} param: {$name} @return must be a reference");
$to_func[$index] = array(false, $name, $pos, $item);
//[是否常量, 值 , 参数位置, 参数信息]
}
}
/**
* 加载api类
* @param array $routes
* @param string $class_file
* @param string $class_name
* @param string $method
* @return void
*/
private function loadApi(&$routes, $class_file, $class_name, $method = null)
{
Verify::isTrue(is_file($class_file), $class_file . ' is not an exist file');
Logger::debug("attempt to load api: {$class_name}, {$class_file}");
$this->class_loader->addClass($class_name, $class_file);
$api = $this->factory->create('caoym\\phprs\\Container', array($class_name, $method), null, null);
foreach ($api->routes as $http_method => $route) {
if (!isset($routes[$http_method])) {
$routes[$http_method] = new HttpRouterEntries();
}
$cur = $routes[$http_method];
foreach ($route as $entry) {
$realpath = preg_replace('/\\/+/', '/', '/' . $entry[0]);
Verify::isTrue($cur->insert($realpath, $entry[1]), "repeated path {$realpath}");
Logger::debug("api: {$http_method} {$realpath} => {$class_name}::{$entry[1]->method_name} ok");
}
}
Logger::debug("load api: {$class_name}, {$class_file} ok");
}
/**
* 获取当前用户信息
* @route({"GET","/current"})
*
* @param({"token", "$._COOKIE.token"}) 登录后获取的cookie
* @return("body")
* 返回用户信息
* {
* "uid":"id",
* "avatar":"头像",
* "alias":"昵称",
* "level":2, //0, 普通用户 1,未审核研究员 2,研究员
* "fields":"农林牧渔", //领域 ,level>0时有效
* "company":"公司名", //level>0时有效
* }
* ...
*/
public function getCurrentUser($token)
{
$tokens = $this->factory->create('Tokens');
$token = $tokens->getToken($token);
$uid = $token['uid'];
Verify::isTrue($token['uid'], new Forbidden('invalid uid ' . $uid));
$res = $this->getUserByIds([$uid]);
Verify::isTrue(count($res) != 0, new NotFound("user {$uid} not found"));
//根据当前uid获取自选股列表
$portfolio = $this->factory->create('Portfolio');
$stockList = $portfolio->getStockList($uid);
$res[0]['stocklist'] = $stockList;
return $res[0];
}
/**
* 获取API实现类的实例
* @param Request $request
* @return object
*/
public function getImpl($request)
{
Verify::isTrue($request !== null);
if ($this->impl === null) {
$injected =& $this->injected;
$injected = array();
$this->impl = $this->factory->create($this->class, null, null, function ($src, &$succeeded) use($request, &$injected) {
list($val, $found) = $request->find($src);
$succeeded = $found;
$injected[$src] = $val;
return $val;
});
asort($injected);
}
return $this->impl;
}
/**
* 检查参数是否均已经绑定
*/
public function check()
{
$params = $this->getBindParamPos();
foreach ($this->method_args as $id => $arg) {
list($name, $is_ref, $is_optional, $default) = $arg;
if (false === array_search($id, $params)) {
Verify::isTrue($is_optional, "{$this->ins->class}::{$this->method_name} param: {$name} not be bound");
}
}
}
/**
* 异常父类匹配
* @route({"GET", "/func10"})
* @param({"arg0", "$._SERVER.REQUEST_URI"})
* @param({"arg1", "$.arg1.arg1"})
*/
public function funReferenceReqParam(&$arg0, &$arg1 = 'default', &$arg2 = 'default')
{
$arg0 = 'funReferenceReqParam arg0';
$arg1 = 'funReferenceReqParam arg1';
Verify::isTrue($arg2 == 'default');
}
public static function condition($context, $prefix, $expr, $args)
{
if ($expr) {
if ($args) {
//因为PDO不支持绑定数组变量, 这里需要手动展开数组
//也就是说把 where("id IN(?)", [1,2]) 展开成 where("id IN(?,?)", 1,2)
$cutted = null;
$cut = null;
$toReplace = array();
$newArgs = array();
//找到所有数组对应的?符位置
foreach ($args as $k => $arg) {
if (is_array($arg) || is_a($arg, 'caoym\\ezsql\\Native')) {
if (!$cutted) {
$cut = new NestedStringCut($expr);
$cutted = $cut->getText();
}
//找到第$k个?符
$pos = self::findQ($cutted, 0, $k);
$pos = $cut->mapPos($pos);
Verify::isTrue($pos !== false, new \InvalidArgumentException("unmatched params and ? @ {$expr}"));
if (is_array($arg)) {
$stubs = [];
foreach ($arg as $i) {
if (is_a($i, 'caoym\\ezsql\\Native')) {
$stubs[] = strval($i);
} else {
$stubs[] = '?';
$newArgs[] = $i;
}
}
$stubs = implode(',', $stubs);
} else {
$stubs = strval($arg);
}
$toReplace[] = [$pos, $stubs];
} else {
$newArgs[] = $arg;
}
}
if (count($toReplace)) {
$toReplace = array_reverse($toReplace);
foreach ($toReplace as $i) {
list($pos, $v) = $i;
$expr = substr($expr, 0, $pos) . $v . substr($expr, $pos + 1);
}
$args = $newArgs;
}
}
$context->appendSql($prefix . ' ' . $expr);
if ($args) {
$context->appendParams($args);
}
}
}
/**
* 想缓存写出
* @param $limit 取指定的项目
* @param $func 取出后调用的方法
* @return array:
*/
public function flush($limit = null, $func = null)
{
foreach ($this->sender as $name => $sender) {
if (!isset($this->buffer[$name])) {
continue;
}
if ($limit !== null) {
if ($limit !== $name) {
continue;
}
if ($func !== null) {
$sender = $func;
}
}
$funcs = $this->buffer[$name];
foreach ($funcs as $args) {
// 确保所有参数均已设置
ksort($args, SORT_NUMERIC);
$i = 0;
foreach ($args as $k => $v) {
Verify::isTrue($k === $i++, "the no.{$i} arg from {$name} not exist");
}
call_user_func_array($sender, $args);
}
if ($limit !== null) {
break;
}
}
}
/**
* (non-PHPdoc)
* @see ArrayAccess::offsetUnset()
*/
public function offsetUnset($offset)
{
Verify::isTrue(false, 'NOT IMPL');
}
/**
* 生成请求的示例和说明
*
* @param array $api
* @return array [sample, doc]
*/
private function createRequestDoc($api)
{
//TODO: 需要处理特殊情况: 输入被绑定在多个参数, 或者输入的不同重叠区域被绑定到不同参数时
$docs = '';
// 提取参数
$params = new JsonStore(array());
foreach ($api['params'] as $name => $param) {
$ori = $params->get($param['value']);
if (count($ori) !== 0) {
// 现在不支持同一个变量多个地方引用
continue;
}
$info = new \ArrayObject(array($name, $param));
$params->set($param['value'], $info);
}
$params = $params->toArray();
// 路由中指定的路径
$route_path = HttpRouterEntries::stringToPath($api['uri'][1]);
// 这是绝对路径
$path = $api['uri'][0];
// 路径拼到示例中
if (isset($params['path'])) {
$req_path = $params['path'];
// 请求中使用的路径, 这是相对路径
$offest = count(HttpRouterEntries::stringToPath($api['root']));
// 相对于绝对路径的偏移
if (is_array($req_path)) {
// 参数只是路径的一部分
if (count($req_path) > 0) {
$end = max(array_keys($req_path));
Verify::isTrue($end < 128, "too long path with length {$end}");
for ($i = 0; $i <= $end; $i++) {
if (isset($req_path[$i])) {
list($arg_name, $arg_info) = $req_path[$i];
if (isset($route_path[$i + $offest]) && $route_path[$i + $offest] !== '*') {
//忽略固定的路径
} else {
$route_path[$i + $offest] = "[{$arg_name}]";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
} else {
if (!isset($route_path[$i + $offest])) {
$route_path[$i + $offest] = '*';
}
}
}
}
} else {
// 参数整个路径
list($arg_name, $arg_info) = $req_path;
$route_path[$offest] = "[{$arg_name}]";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
unset($params['path']);
}
$path .= ' /';
$path .= implode('/', $route_path);
// querystring
if (isset($params['_GET'])) {
$get = $params['_GET'];
if (is_array($get)) {
$first = true;
foreach ($get as $name => $value) {
list($arg_name, $arg_info) = $value;
if ($first) {
$path = $path . '?';
$first = false;
} else {
$path = $path . '&';
}
$path = "{$path}{$name}=[{$arg_name}]";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
} else {
// 参数整个_GET
list($arg_name, $arg_info) = $get;
$path = "{$path}?[{$arg_name}]";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
unset($params['_GET']);
}
$path .= " HTTP/1.1\r\n";
// header
$header = '';
if (isset($params['header'])) {
$headers = $params['header'];
$first = true;
foreach ($headers as $header_name => $value) {
//if (substr_compare($name, 'HTTP_X_', 0, 7) !== 0) {
// continue;
//}
//$words = explode('_', substr($name, 7));
//$header_name = '';
//foreach ($words as $k => $word) {
// $words[$k] = ucwords(strtolower($word));
//}
//$header_name = implode('-', $words);
list($arg_name, $arg_info) = $value;
$header = "{$header}{$header_name}: [{$arg_name}]\r\n";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
unset($params['_SERVER'][$name]);
}
}
// cookie
$header = '';
if (isset($params['_COOKIE'])) {
$cookies = $params['_COOKIE'];
$first = true;
$header = $header . "Cookie: ";
foreach ($cookies as $cookie_name => $value) {
list($arg_name, $arg_info) = $value;
$header = "{$header}{$cookie_name}=[{$arg_name}];";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
$header .= "\r\n";
}
// body
$body = '';
if (isset($params['_POST'])) {
$post = $params['_POST'];
$first = true;
if (is_array($post)) {
foreach ($post as $name => $value) {
list($arg_name, $arg_info) = $value;
if ($first) {
$first = false;
} else {
$body = $body . '&';
}
$body = "{$body}{$name}=[{$arg_name}]";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
} else {
// 参数整个_POST
list($arg_name, $arg_info) = $post;
$body = "{$body}[{$arg_name}]";
$docs = "{$docs}{$arg_name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
unset($params['_POST']);
}
if (isset($params['_FILES'])) {
$files = $params['_FILES'];
if (is_array($files)) {
foreach ($files as $name => $value) {
//TODO: 这里假设只有一个文件上传
list($arg_name, $arg_info) = $this->searchArgInfo($value);
$docs = "{$docs}{$name}:\r\n {$arg_info['doc']}\r\n\r\n";
}
}
unset($params['_POST']);
}
$sample = $path . $header . "\r\n" . $body;
return array($sample, $docs);
}