路径参数使用RestHttpRequest::getPathValue()方法获取。注：多路由不支持路径参数。

访问地址/users/97，获取用户ID：97

    /**
     * @RequestMapping("/users")
     */
    class UserController {
        /**
         * @RequestMapping(value="/{userId}", method="GET")
         */
        public function userInfo() {
            $userId = RestHttpRequest::getGet("userId");
            echo $userId;
        }
    }

                            

Query参数使用RestHttpRequest::getGet() 或 RestHttpRequest::getParameterAsObject() 获取；使用 RestHttpRequest::getPageParam() 获取分页对象。

其中RestHttpRequest::getGet() 用于获取单个路径参数，RestHttpRequest::getParameterAsObject() 用于以对象的形式获取一个或多个参数。

1.RestHttpRequest::getGet()应用举例

访问地址/users?name=张，获取name参数值：

    /**
     * @RequestMapping("/users")
     */
    class UserController {
        /**
         * @RequestMapping(value="", method="GET")
         */
        public function userList() {
            $name = RestHttpRequest::getGet("name");
            echo $name;
        }
    }

                            

2.RestHttpRequest::getParameterAsObject()应用举例

访问路径`/users?name=张&mobile=1360000`，获取name和mobile的查询对象

定义接收对象，QueryForm:

    final class QueryForm {
        private $_name;
        private $_mobile;
        public function getName() {
            return $this->_name;
        }
        public function setName($name) {
            $this->_name = $name;
        }
        public function getMobile() {
            return $this->_mobile;
        }
        public function setMobile($mobile) {
            $this->_mobile = $mobile;
        }
    }

                            

在UserController中，使用RestHttpRequest::getParameterAsObject()方法获取QueryForm对象：

    /**
     * @RequestMapping("/users")
     */
    class UserController {
        /**
         * @RequestMapping(value="", method="GET")
         */
        public function userList() {
            $queryForm = RestHttpRequest::getParameterAsObject(new QueryForm());
            var_export($queryForm);
        }
    }

                            

Body 参数使用 RestHttpRequest::getBody() 获取。

应用举例，获取body内容：{"username":"小红","mobile":"13800000000","age":"18"}

定义接收对象，UserForm:

    final class UserForm {
        private $_name;
        private $_mobile;
        private $_age;
        public function getName() {
            return $this->_name;
        }
        public function setName($name) {
            $this->_name = $name;
        }
        public function getMobile() {
            return $this->_mobile;
        }
        public function setMobile($mobile) {
            $this->_mobile = $mobile;
        }
        public function getAge() {
            return $this->_age;
        }
        public function setAge($age) {
            $this->_age = $age;
        }
    }

                            

在UserController中，使用RestHttpRequest::getBody()方法获取UserForm对象，或者获取为数组：

    /**
     * @RequestMapping("/users")
     */
    class UserController {
        /**
         * @RequestMapping(value="", method="POST")
         */
        public function newUser() {
            //获取为对象
            $userForm = RestHttpRequest::getBody(new UserForm());
            var_export($userForm);
            //获取为数组
            $arrUser = RestHttpRequest::getBody();
            var_dump($arrUser);
        }
    }

                            

框架提供了以下注解表单验：

@length(min=最小长度,max=最大长度,message=错误提示:xxx长度只能在[最小长度]至[最大长度]之间)

@notnull(message=错误提示:xxx不能为空)

@mobile(message=错误提示:xxx不是正确的手机号)

@email(message=错误提示:xxx不是正确的邮箱地址)

@domain(message=错误提示:xxx不是正确的域名)

@date(format=日期格式,message=错误提示:xxx不符合日期格式)

@range(min=最小值,max=最大值,message=错误提示:xxx的值不在[最小值]到[最大值]范围内)

@int(min=最小值,max=最大值,message=错误提示:xxx的值不在[最小值]到[最大值]范围内或不是整数)

@ipv4(message=错误提示：xxx不是正确的ipv4地址)

@ipv6(message=错误提示：xxx不是正确的ipv6地址)

@inArray(value=[可选值1|可选值2],message=错误提示:xxx不在取值范围内)

@notEmpty(message=错误提示：xxx不能为空)

@customer(method=自定义校验方法,message=错误提示)

使用示例：

创建MessageVo:

    namespace classes\controller\api\vo;

    /**
     * Class MessageVo
     * @package classes\controller\api\vo
     */
    class MessageVo {
        /**
         * 客户名称.
         * @length(min=1,max=20,message=名字输入长度为1~20个字符)
         * @var string.
         */
        private $_name;

        /**
         * 感兴趣的产品.
         * @length(min=1,max=50,message=感兴趣的产品输入长度为1-50个字符)
         * @var string
         */
        private $_product;

        /**
         * 手机号码.
         * @mobile(message=手机号不正确)
         * @var string
         */
        private $_mobile;

        /**
         * 更多说明
         * @length(max=255,message=更多说明长度不能超过255字)
         * @var string
         */
        private $_more;

        /**
         * @return string
         */
        public function getName()
        {
            return $this->_name;
        }

        /**
        * @param string $name
        */
        public function setName($name)
        {
            $this->_name = $name;
        }

        /**
        * @return string
        */
        public function getProduct()
        {
            return $this->_product;
        }

        /**
        * @param string $product
        */
        public function setProduct($product)
        {
            $this->_product = $product;
        }

        /**
        * @return string
        */
        public function getMobile()
        {
            return $this->_mobile;
        }

        /**
        * @param string $mobile
        */
        public function setMobile($mobile)
        {
            $this->_mobile = $mobile;
        }

        /**
        * @return string
        */
        public function getMore()
        {
            return $this->_more;
        }

        /**
        * @param string $more
        */
        public function setMore($more)
        {
            $this->_more = $more;
        }
    }

                            

在MessagesController使用：

    namespace classes\controller\api;

    use classes\controller\api\vo\MessageVo;
    use classes\service\CrmMessageService;
    use restphp\http\RestHttpRequest;
    use restphp\validate\RestValidate;

    /**
     * Class MessagesController
     * @RequestMapping(value="/api/messages")
     * @package classes\controller\api
     */
    class MessagesController {
        /**
         * 接收消息.
         * @RequestMapping(value="", method="POST")
         * @throws \ReflectionException
         */
        public function receiveMessage() {
            $message = RestHttpRequest::getRequestBody(new MessageVo(), true);

            CrmMessageService::saveMessage($message);
        }
    }

                            

数据响应为开放自由式响应，无特殊固定规则和格式。

框架的RestHttpResponse类提供常用数据响应方法封状；RestTpl类提供了简单的模板引擎。

自定义一个切面逻辑片段：\example\annotation\AopExample

    namespace example\annotation;

    use restphp\aop\AopParam;
    use restphp\aop\Aspect;

    /**
     * @Aspect(name="AopExample")
     */
    class AopExample implements Aspect
    {
        /**
         * @param AopParam $aopParam
         * @return void
         */
        function before($aopParam)
        {
            // TODO: Implement before() method.
            echo "aop before executed with params:\n ";
            var_dump($aopParam->getProcessParam());
        }

        /**
         * @param AopParam $aopParam
         * @return void
         */
        function after($aopParam)
        {
            // TODO: Implement after() method.
        }

    }

                            

使用AOP（需构建后运行引用代码查看效果）:

    namespace example\controller;

    use restphp\tpl\RestTpl;

    /**
     * @RequestMapping(value="/tpl")
     */
    class ControllerTplTest {
        private $_tpl;
        public function __construct() {
            $GLOBALS['_EVN_PARAM']['TPL_DIR'] = PROJECT_ROOT . 'src/resources/template/default';
            $GLOBALS['_EVN_PARAM']['TPL_CACHE_DIR'] = PROJECT_ROOT . 'runtime/template';
            $this->_tpl = new RestTpl();
            $this->_tpl->caching = false;
        }

        /**
         * @Get (value = "")
         * @AopExample(param1="test",param2="test2")
         * @return void
         */
        public function index() {
            $this->_tpl->assign('app_name', 'RESTPHP 3.0');
            $this->_tpl->display('index.tpl');
        }
    }