220 lines
11 KiB
PHP
220 lines
11 KiB
PHP
<?php
|
|
namespace SYSTEM\API;
|
|
|
|
class api {
|
|
const ROOT_PARENTID = -1;
|
|
const DEFAULT_GROUP = 0;
|
|
const DEFAULT_STRICT = true;
|
|
const DEFAULT_DEFAULT = false;
|
|
|
|
public static function run( $verifyclassname,$apiclassname,
|
|
$params,$group = self::DEFAULT_GROUP,
|
|
$strict = self::DEFAULT_STRICT,$default = self::DEFAULT_DEFAULT){
|
|
//Verify Class
|
|
if(!\class_exists($verifyclassname)){
|
|
throw new \SYSTEM\LOG\ERROR("Verify Class given to the api does not exist: '".$verifyclassname."'");}
|
|
|
|
//API Class
|
|
if(!\class_exists($apiclassname)){
|
|
throw new \SYSTEM\LOG\ERROR("API Class given to the api does not exist: '".$apiclassname."'");}
|
|
|
|
//check parameters
|
|
if( !isset($params) || !is_array($params) || count($params) <= 0){
|
|
return self::do_default($default, $apiclassname);} //throws
|
|
|
|
//Get the Databasetree
|
|
$tree = self::getApiTree($group); //throws
|
|
|
|
$statics = self::do_statics($params, $tree, $apiclassname, $verifyclassname, $default); //throws
|
|
|
|
//Commands
|
|
$commands = self::do_commands($params, $tree);
|
|
if(count($commands) <= 0){
|
|
return self::do_default($default, $apiclassname);} //throws
|
|
|
|
//Parameters
|
|
$parentid = $commands[count($commands)-1][0];
|
|
$parentid = $parentid[\SYSTEM\DBD\system_api::FIELD_ID];
|
|
$parameters = self::do_parameters($params, $tree, $parentid, $commands[count($commands)-1][1],$verifyclassname); //throws
|
|
|
|
//Opt Parameters
|
|
$parentid = $commands[count($commands)-1][0];
|
|
$parentid = $parentid[\SYSTEM\DBD\system_api::FIELD_ID];
|
|
$parameters_opt = self::do_parameters_opt($params, $tree, $parentid, $commands[count($commands)-1][1],$verifyclassname); //throws
|
|
|
|
//strict check
|
|
self::do_strict($strict, $params, $statics, $commands, $parameters, $parameters_opt); //throws
|
|
|
|
//Function Name
|
|
$call_funcname = self::do_func_name($commands); //throws
|
|
|
|
//Function Parameters
|
|
$call_funcparam = self::do_func_params($parameters, $parameters_opt);
|
|
|
|
//Does function exist?
|
|
if(!\method_exists($apiclassname, $call_funcname)){
|
|
return self::do_default($default, $apiclassname, $call_funcname);} //throws
|
|
|
|
//Call Function
|
|
return \call_user_func_array(array($apiclassname,$call_funcname),$call_funcparam);
|
|
}
|
|
|
|
private static function getApiTree($group){
|
|
$result = \SYSTEM\DBD\SYS_API_TREE::QA(array($group));
|
|
if(!isset($result) || !is_array($result) || count($result) <= 0){
|
|
throw new \SYSTEM\LOG\ERROR("Database Tree for Api empty - cannot proced! GROUP: ".$group);}
|
|
|
|
return $result;
|
|
}
|
|
|
|
private static function do_statics($params,$tree,$apiclassname,$verifyclassname,$default){
|
|
$statics = array();
|
|
$parentid = self::ROOT_PARENTID;
|
|
foreach($tree as $item){
|
|
if( intval($item[\SYSTEM\DBD\system_api::FIELD_TYPE]) == \SYSTEM\DBD\system_api::VALUE_TYPE_STATIC &&
|
|
intval($item[\SYSTEM\DBD\system_api::FIELD_PARENTID]) == $parentid &&
|
|
isset($params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
|
|
$statics[] = array($item,$params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]]);
|
|
$call_funcname = 'static_'.$item[\SYSTEM\DBD\system_api::FIELD_NAME];
|
|
|
|
//verify func
|
|
if(!\method_exists($apiclassname, $call_funcname)){
|
|
return self::do_default($default, $apiclassname, $call_funcname);} //throws
|
|
|
|
//verify parameter
|
|
if( !method_exists($verifyclassname, $item[\SYSTEM\DBD\system_api::FIELD_VERIFY]) ||
|
|
!call_user_func(array($verifyclassname,$item[\SYSTEM\DBD\system_api::FIELD_VERIFY]),$params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
throw new \SYSTEM\LOG\ERROR('Parameter type missmacht or Missing Verifier. Param: '.$item[\SYSTEM\DBD\system_api::FIELD_NAME].' Verifier: '.$item[\SYSTEM\DBD\system_api::FIELD_VERIFY]);}
|
|
|
|
\call_user_func_array(array($apiclassname,$call_funcname),array($params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]]));
|
|
}
|
|
}
|
|
|
|
return $statics;
|
|
}
|
|
|
|
private static function do_default($default, $apiclassname, $call_funcname = null){
|
|
if($default){ //should we call the default function or throw an error?
|
|
return \call_user_func(array($apiclassname,'default_page'));}
|
|
if($call_funcname == null){
|
|
throw new \SYSTEM\LOG\ERROR("No call given for the api");}
|
|
throw new \SYSTEM\LOG\ERROR("API call is not implemented in API: ".$call_funcname);
|
|
}
|
|
|
|
private static function do_strict($strict, $params, $statics, $commands, $parameters, $parameters_opt){
|
|
if( $strict &&
|
|
count($params) != (count($statics) + count($parameters) + count($commands) + count($parameters_opt))){
|
|
throw new \SYSTEM\LOG\ERROR( 'Unhandled or misshandled parameters - api query is invalid'.
|
|
'; given: '.count($params).
|
|
'; statics: '.count($statics).
|
|
'; req_command: '.count($commands).
|
|
'; req_param: '.count($parameters).
|
|
'; opt_param: '.count($parameters_opt).
|
|
'; url: ' .$_SERVER["REQUEST_URI"]);}
|
|
}
|
|
|
|
private static function do_commands($params,$tree){
|
|
$commands = array();
|
|
$parentid = self::ROOT_PARENTID;
|
|
foreach($tree as $item){
|
|
if( (intval($item[\SYSTEM\DBD\system_api::FIELD_TYPE]) == \SYSTEM\DBD\system_api::VALUE_TYPE_COMMAND ||
|
|
intval($item[\SYSTEM\DBD\system_api::FIELD_TYPE]) == \SYSTEM\DBD\system_api::VALUE_TYPE_COMMAND_FLAG) &&
|
|
intval($item[\SYSTEM\DBD\system_api::FIELD_PARENTID]) == $parentid &&
|
|
isset($params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
|
|
//check parent value
|
|
if( isset($item[\SYSTEM\DBD\system_api::FIELD_PARENTVALUE]) &&
|
|
$commands[count($commands)-1][1] != $item[\SYSTEM\DBD\system_api::FIELD_PARENTVALUE]){
|
|
continue;}
|
|
|
|
$commands[] = array($item,$params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]]);
|
|
$parentid = intval($item[\SYSTEM\DBD\system_api::FIELD_ID]);
|
|
}
|
|
}
|
|
|
|
return $commands;
|
|
}
|
|
|
|
private static function do_parameters($params,$tree,$parentid,$lastcommandvalue,$verifyclassname){
|
|
$parameters = array();
|
|
foreach($tree as $item){
|
|
if( intval($item[\SYSTEM\DBD\system_api::FIELD_TYPE]) == \SYSTEM\DBD\system_api::VALUE_TYPE_PARAM &&
|
|
intval($item[\SYSTEM\DBD\system_api::FIELD_PARENTID]) == $parentid){
|
|
|
|
//check parent value
|
|
if( isset($item[\SYSTEM\DBD\system_api::FIELD_PARENTVALUE]) &&
|
|
$lastcommandvalue != $item[\SYSTEM\DBD\system_api::FIELD_PARENTVALUE]){
|
|
continue;}
|
|
|
|
//all parameters are required
|
|
if(!isset($params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
throw new \SYSTEM\LOG\ERROR('Parameter missing: '.$item[\SYSTEM\DBD\system_api::FIELD_NAME]);}
|
|
|
|
//verify parameter
|
|
if( !method_exists($verifyclassname, $item[\SYSTEM\DBD\system_api::FIELD_VERIFY]) ||
|
|
!call_user_func(array($verifyclassname,$item[\SYSTEM\DBD\system_api::FIELD_VERIFY]),$params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
throw new \SYSTEM\LOG\ERROR('Parameter type missmacht or Missing Verifier. Param: '.$item[\SYSTEM\DBD\system_api::FIELD_NAME].' Verifier: '.$item[\SYSTEM\DBD\system_api::FIELD_VERIFY]);}
|
|
|
|
$parameters[] = array($item, $params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]]);
|
|
}
|
|
}
|
|
|
|
return $parameters;
|
|
}
|
|
|
|
private static function do_parameters_opt($params,$tree,$parentid,$lastcommandvalue,$verifyclassname){
|
|
$parameters_opt = array();
|
|
foreach($tree as $item){
|
|
if( intval($item[\SYSTEM\DBD\system_api::FIELD_TYPE]) == \SYSTEM\DBD\system_api::VALUE_TYPE_PARAM_OPT &&
|
|
intval($item[\SYSTEM\DBD\system_api::FIELD_PARENTID]) == $parentid){
|
|
|
|
//check parent value
|
|
if( isset($item[\SYSTEM\DBD\system_api::FIELD_PARENTVALUE]) &&
|
|
$lastcommandvalue != $item[\SYSTEM\DBD\system_api::FIELD_PARENTVALUE]){
|
|
continue;}
|
|
|
|
//all parameters are NOT required - just continue
|
|
if(!isset($params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
continue;}
|
|
|
|
//verify parameter
|
|
if( !method_exists($verifyclassname, $item[\SYSTEM\DBD\system_api::FIELD_VERIFY]) ||
|
|
!call_user_func(array($verifyclassname,$item[\SYSTEM\DBD\system_api::FIELD_VERIFY]),$params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]])){
|
|
throw new \SYSTEM\LOG\ERROR('Parameter type missmacht or Missing Verifier. Param: '.$item[\SYSTEM\DBD\system_api::FIELD_NAME].' Verifier: '.$item[\SYSTEM\DBD\system_api::FIELD_VERIFY]);}
|
|
|
|
$parameters_opt[] = array($item, $params[$item[\SYSTEM\DBD\system_api::FIELD_NAME]]);
|
|
}
|
|
}
|
|
|
|
return $parameters_opt;
|
|
}
|
|
|
|
private static function do_func_name($commands){
|
|
$call_funcname = '';
|
|
foreach($commands as $com){
|
|
if(!\preg_match('^[0-9A-Za-z_]+$^', $com[1])){
|
|
throw new \SYSTEM\LOG\ERROR('Call Command can only have letters! command: '.$com[0]['name'].'; value: '.$com[1]);}
|
|
|
|
if($com[0][\SYSTEM\DBD\system_api::FIELD_TYPE] == \SYSTEM\DBD\system_api::VALUE_TYPE_COMMAND_FLAG){
|
|
$call_funcname .= '_flag_'.$com[0][\SYSTEM\DBD\system_api::FIELD_NAME];
|
|
} else {
|
|
$call_funcname .= '_'.$com[0][\SYSTEM\DBD\system_api::FIELD_NAME].'_'.\strtolower($com[1]);}
|
|
}
|
|
$call_funcname = substr($call_funcname, 1); //strip leading _
|
|
|
|
return $call_funcname;
|
|
}
|
|
|
|
private static function do_func_params($parameters,$parameters_opt){
|
|
$call_funcparam = array();
|
|
foreach($parameters as $param){
|
|
$call_funcparam[] = $param[1];}
|
|
|
|
//Optional Function Parameters
|
|
foreach($parameters_opt as $param){
|
|
$call_funcparam[] = $param[1];}
|
|
|
|
return $call_funcparam;
|
|
}
|
|
} |