lit/parameter: 数据结构映射验证

/**
 * @property Types $name
 * @property Types $age
 * @property Types $height
 * @property Types $gender
 * @property Types $title
 * @property Types $description
 * @property Types $children
 * @property Types $city
 * @property Types $number
 * @property Types $data
 */ 
class AbcMapper extends \Lit\Parameter\V2\Parameter {
 public function __construct($params = []) {
  //声明一个属性 age, 整型, 介于12值18之间, 如果验证出错, 错误代码: 10001, 错误信息: 年龄错误 (下同)
  $this->age->isInteger()->between(12, 18)->setCode(10001)->setMsg("年龄错误");
  //声明一个属性 height, 整型, 大于120, 小于180
  $this->height->isInteger()->ge(120)->le(180)->setCode(10002)->setMsg("身高错误");
  //声明一个属性 name, 字符串, 最小长度3, 最大长度32
  $this->name->isString()->minLength(3)->maxLength(32)->setCode(10003)->setMsg("名称错误");
  //声明一个属性 gender, 字符串, 枚举: m, f
  $this->gender->isString()->in(["m", "f"])->setCode(10004)->setMsg("性别错误");
  //声明一个属性 title, 字符串, 长度为5
  $this->title->isString()->length(5)->notEmpty()->setCode(10005)->setMsg("标题错误");
  //声明一个属性 description, 字符串, 不为 null
  $this->description->isString()->notNull()->setCode(10006)->setMsg("描述错误");
  //声明一个属性 children, 数组, 元素数最小2个, 最大3个
  $this->children->isArray()->minSize(2)->maxSize(3)->setCode(10007)->setMsg("子集错误");
  //声明一个属性 city, 字符串, 无赋值时默认为
  $this->city->isString()->setDefault("zz")->setCode(10008)->setMsg("城市错误");
  //声明一个属性 number, 数值, 使用回调函数自行验证
  $this->number->isNumeric()->callback(function ($number) {
  return $number > 999;
  })->setCode(10009)->setMsg("编号错误");
  //声明一个属性 data, 数组, 数组的键不能包含 aa, bb , 数组的键必须包含 cc, dd
  $this->data->isArray()->excFields(["aa", "bb"])->incFields(["cc", "dd"])->setCode(10010)->setMsg("数据集错误");
  //启用快速赋值(非必须)
  parent::__construct($params);
 }
}

//赋值 
$abcMapper = new AbcMapper(); 
$abcMapper->age = 12; 
$abcMapper->height = 180; 
$abcMapper->name = "good boy"; 
$abcMapper->gender = "f"; 
$abcMapper->title = "title"; 
$abcMapper->description = ""; 
$abcMapper->children = ["a", "b", "c"]; 
$abcMapper->number = 9990; 
$abcMapper->data = ["cc" => 11, "dd" => 22, "ee" => 33]; 
//快速赋值 (需在映射器中调用父类构造函数) 
$abcMapper = new AbcMapper(["age"=>12, "name" =>"good boy"]);

var_dump($abcMapper->name->value()); 
var_dump($abcMapper->age->value());

//已赋值的属性 
var_dump($abcMapper->getAssigned()); 
//所有属性 
var_dump($abcMapper->toArray());

var_dump($abcMapper->must(["age", "name"])->check());

//错误码 $abcMapper->errCode(); 
//错误码 $abcMapper->errMsg(); 
//错误的属性名称 $abcMapper->errName(); 
//错误属性的值 $abcMapper->errValue(); 
//出错的验证条件 $abcMapper->errCondition();

//验证一个数组是否符合规范, 保证要验证的形参已经编写过规则. (参考初始化) 
$array = ["title"=>"title","description"=>"description"]; 
if ($abcMapper->must(["age"])->check($array)) {
 //如果验证失败 var_dump("验证成功"); 
}else{
 var_export([ //调试信息 
  "errCode" => $abcMapper->errCode(),
  "errMsg" => $abcMapper->errMsg(),
  "errName" => $abcMapper->errName(),
  "errValue" => $abcMapper->errValue(),
  "errCondition" => $abcMapper->errCondition()
 ]);
}

//验证函数或者类方法, 保证要验证的形参已经编写过规则. (参考初始化) 
function test($bookId, $bookName, $bookTags, $bookDesc) {
 if (!$abcMapper->check(get_defined_vars())) {
  //如果验证失败
  var_export([ //调试信息 
   "errCode" => $abcMapper->errCode(),
   "errMsg" => $abcMapper->errMsg(),
   "errName" => $abcMapper->errName(),
   "errValue" => $abcMapper->errValue(),
   "errCondition" => $abcMapper->errCondition()
   ]);
  return false; 
 } 
 //正常业务逻辑
 return true;
 } 
//在调用时传入实参 
test(1234,"abcd",["id"=>890,"name"=>"xyz","target"=>"abc","bug1"=>"bug1"],"opqrst");