HTTP 验证器

    目录

    请先阅读 验证器 章节,HTTP 验证器基于验证器扩展,基本使用方式相似。

    @HttpValidation

    首先,HTTP 验证器是@HttpValidation注解,它只能写在方法上。写了这个注解,在action方法调用前会触发验证,验证失败同样的抛出异常

    验证注解

    @Required等验证注解的name属性用法跟验证器章节中说明的略有不同。

    你可以使用$get$post$body$headers$cookie$session$this后面跟上.参数名指定参数,其中getpost自然不用多说,这body的用处就是,比如参数是以jsonbody传给你的,他会自动给你json_decode,你用$body就可以指定了。

    $this 代表是当前控制器对象。

    在 HTTP 验证器场景下,不推荐在验证注解上指定 default 参数,而是应该直接给方法参数加上默认值。

    @ExtractData

    还有一个@ExtractData注解,它可以把get/post/body中的参数导出到action方法的参数中。

    @ExtractData注解可以独立使用,不依赖@HttpValidation注解,但只能在控制器中使用。

    示例

    /**
     * http参数验证测试
     * 
     * @Action
     * 
     * @HttpValidation
     * 
     * @Required(name="$get.id", message="用户ID为必传参数")
     * @Integer(name="$get.id", min=1, message="用户ID不符合规则")
     * @Required(name="$get.name", message="用户姓名为必传参数")
     * @Text(name="$get.name", min=2, message="用户姓名长度不得少于2位")
     * @Required(name="$get.age")
     * 
     * @ExtractData(name="$get.id", to="id")
     * @ExtractData(name="$get.name", to="name")
     * @ExtractData(name="$get.age", to="age")
     *
     * @return void
     */
    public function httpValidation($id, $name, $age = -1)
    {
        return compact('id', 'name', 'age');
    }