3.5.1 用来做什么
----------------
* 我们把的参数验证办法叫ParamValidator
* 一般来说，像比如说验证http传来的参数是不是为空呀啥的（发挥你的想象力）。
* 好处在于不用再重复地写if else

3.5.2 怎么用
------------
* 来看一个例子，验证用户的参数不可为空(灰常灰常的实用)：

解读：

* 放到controllers下
* 实现ParamValidator
* 实现supports方法，这个方法用来做判断是否要验证当前得到的http参数，一般都用个注解来判断比较文艺
* 实现validate方法，这里是主要逻辑
* metaData里放的是参数的原型
* inv是rose的基础调用
* target是这个参数的最后解析结果，参看上一节里提到的东西
* errors是这个参数解析时出来的错误
* NotBlank是一个自己定义的annotation

3.5.3 使用时action长什么样？
----------------------
* 下面的代码是action中使用时长的样子:

解读：
* 当遇到NotBlank注解的参数时，会自动执行参数判断
* 如果messages为空，则会得到“参数不能为空”的返回

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
文档持续修改版本在 https://github.com/XiaoMi/rose/tree/master/chapter_3_5。

rose手册第三章四节：controller层：自定义http参数支持 http://t.co/IVbj5RB2 #
https://t.co/jJ2osdy4 收到了不少rose用户的反馈，要继续完善写下去，写文档是个快乐的活。 #
rose手册第三章三节：controller层：ErrorHandler支持 http://t.co/xsjKNL9s #
还是有人用rose的，继续准备rose文档 https://t.co/jJ2osdy4 #
54chen Twitter memo 2012-05-13 http://t.co/2YPpChAl #

3.4.1 http参数支持的一些前言
-----------------------------------------
* 我们把一个controller的类里的一个方法叫做action，它实际对应用户看到的一个url。
* 在action里可以接收各种各样的参数，也可以自己定义需要的参数。
* rose自己定义了一些常见的类型，基本上很有机会会用到自己定义，但是在某些情况下，也是个不错的选择：
* 用来对指定的参数类型的值进行固定的修改和赋值。

3.4.2 看一个例子
--------------------------

ChenBeanResolver.java放在controllers目录下：

* 上述代码的意思：
* 如果在action里一个参数的类型是Chen(com.chen.model.Chen)，就会走这个resolver，这里对两个参数进行了组装。
* 用户如果访问的参数里传入了chen1和chen2的值，则会直接组装出来一个Chen对象。

* 配合上述resolver的action代码为：

* 用户访问：http://127.0.0.1/param?chen1=1&chen2=2 将会返回：
** hello world:1:2

3.4.2 rose内置的参数支持
------------------------------
除了上述的自定义resolver外，rose还内置了丰富的resolver，都是大家的经验总结，使用起来会非常方便，它们是：
* 所有的基础java类型，都可以直接使用，rose进行自动转换，比如在action中的类型为long id，则id可以转为数字，不再需要从string转为long。
* array/map/bean同样可用，它们的接收参数规则为：
* ?id=1,2,3,4 或者 ?id=1&id=2&id=3 对应 @Param("id") int[] idArray
* ?map:1=paoding&map:2=rose 对应 @Param("map") Map map
* POST http://127.0.0.1/user?id=1&name=rose&level.id=3 对应接收代码：

* 代码中User是一个自定义的bean，有属性id,name,level等。

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
文档持续修改版本在 https://github.com/XiaoMi/rose/tree/master/chapter_3_4。

3.3.1 ErrorHandler的作用
一般来说传统的编程都会到处去try，特别是java里，try来try去的（如果你用erlang一定就知道，已经知道的可能性，怎么能叫异常？都try了还是让它崩了算了。。。）。
如果打开你的项目，每个java文件中的代码都有一堆的try，那这时候就是ErrorHandle上阵的时候了。
ErrorHanle致力于：统一捕捉和处理各种异常，可区分对待和返回；统一的出错体验。
非常类似做web开发时的500统一出错页面这样的东东。
3.3.2 示例

/**
* @author chenzhen@xiaomi.com
* 2010-12-1
*/

package com.chen.controllers;

import net.paoding.rose.web.ControllerErrorHandler;
import net.paoding.rose.web.Invocation;

public class ErrorHandler implements ControllerErrorHandler {

public Object onError(Invocation inv, Throwable ex) throws Throwable {

// TODO logger.error("handle err:", ex);

return "@error";
}
}

这是这么简单，不用怀疑！

3.3.3 放在哪里才能生效？
放在controllers目录下，和controller们在一起（幸福快乐地生活）。
一般来讲，ErrorHandler都是用在web项目里，在最快层起作用。
所有的方法都可以尽情地向处throws Exception了。
不需要再try了。

@Path("")
public class HelloController {
@Get("")
public String index2() throws Exception {
return "@hello world";
}
}

3.3.3 有用的例子: 不同的异常类型做不用的事情

/**
* @author chenzhen@xiaomi.com
* 2010-12-1
*/

package com.chen.controllers;

import net.paoding.rose.web.ControllerErrorHandler;
import net.paoding.rose.web.Invocation;

public class ErrorHandler implements ControllerErrorHandler {

public Object onError(Invocation inv, Throwable ex) throws Throwable {

// TODO logger.error("handle err:", ex);
if (ex instanceof RuntimeException) {
return "@runtime";
}
return "@error";
}
}

文中所提及代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example 提供。
文档持续修改版本在 https://github.com/XiaoMi/rose/tree/master/chapter_3_3。

开这些年互联网开发最怕的事情：设立一个专门的QA团队，让研发团队通过不断的开关bug帮助QA团队理解产品需求和架构设计。 #
54chen Twitter memo 2012-05-06 http://t.co/5RcTU0GG #

在小米面试技术，基础一定要好，数据结构算法啥的，最关键的，一定要有一技之长，或者叫做闪光点。没有闪光点的哥们，来了也会很郁闷，我们也会很郁闷。面试不通过的哥们，不是你技术太差，是被上一家公司磨洋工磨得太平。 #
rose手册第三章二节：controller层：拦截器支持 http://t.co/qX4gW9qG #
今天五四，丢出来一份青春时期的代码，802.1x在gtk下的实现，大学校园局域网拔号你用过吧，https://t.co/OU6LpNPM 一晃已经过去七八年了，当时还没有git啊(readme写的时间大概是08年左右)，为了不侵犯人家公司权利，代码仅供学习呀作毕业设计呀啥的使用。 #
NIH综合症是叫“不花钱自己搞癖好”好呢，还是叫“参考开源自己搞癖好”好呢？ #
今天是五四青年节，http://t.co/WPe8C5Cn ，五四陈科学院祝十四岁以上的青年们节日快乐！同时不要忘记下个月的今天。 #
scala会越来越流行。 #
保持松散结构团队持续战斗力的秘密：每一个成员明确自己的目标，分清主次，日常解决重要不紧急的事情，形成良好的时间管理习惯，还有scrum。 #
快要败给这个官方读法了 http://t.co/wogMYjAg #

3.2.1 拦截器作用

面向切面编程（AOP）方法可以让一个项目更加关注核心逻辑，常见的一些最佳实践包括
权限
缓存
错误处理
延时加载
调试
持久化
资源池
等等。。。
而此处的拦截器目标是在controller层提供各种在controller执行前、执行后的代码切入，以达到各种可AOP的目标。
简单地说，拦截器能干的事情就是当你的项目写了一半时发现缺少啥全局要做的事情（比如需要验证权限），不用担心，搞一个拦截器就是了。

3.2.2 拦截器例子

public class AccessTrackInterceptor extends ControllerInterceptorAdapter {
public AccessTrackInterceptor() {
setPriority(29600);
}
@Override
public Class getRequiredAnnotationClass() {
return PriCheckRequired.class; // 这是一个注解，只有标过的controller才会接受这个拦截器的洗礼。
}
@Override
public Object before(Invocation inv) throws Exception {
// TODO ....
return super.before(inv);
}

@Override
public void afterCompletion(final Invocation inv, Throwable ex) throws Exception {
// TODO ....
}
}

需要注意几点：

拦截器要放在controllers下(高级用法:打在rose-jar包里，参见5.1)
继承net.paoding.rose.web.ControllerInterceptorAdapter
按照实现的方法名，在controller执行前、中、后执行：
before：在controller执行前执行。
after：在controller执行中（后）执行，如果一个返回抛出了异常，则不会进来。
afterCompletion：在controller执行后执行，不论是否异常，都会进来。
isForAction：定义满足某条件的才会被拦截。

3.2.3 拦截器可动的位置细节

上面都讲得差不多了，实际上还有不少地方可以拦截的：
isForDispatcher：根据响应的情况判断是否拦截，比如说是正常请求、内部forward、还是include （但是没用过）
setPriority：设置一个数字表示拦截优先级，当有多个拦截器时，要精准控制，数字小的内层，大的在外层，在最外层的before方法最先执行，大家都执行完后它的after才最后执行。
round：这才是真正的controller执行中执行，不过用得很少。
getRequiredAnnotationClass：返回一个Annotation class name，表示这个拦截器只对此Annotation标过的controller才生效。常用。

3.2.4 实际应用场景

全站是否登录判断相关的逻辑，写在一个拦截器里，一次完成后，其他地方不再关心这个代码，在需要登录才能做的controller上注解一下，表示需要被执行拦截。
日志收集的逻辑，在一个拦截器里进行当前的access log记录。
权限体系的逻辑，写在一个拦截器里，在对应的操作上作注解，拦截器中进行细节的判断，新加的api也只是需要一次注解就得到了权限的判断。

[文中所提代码均在 https://github.com/XiaoMi/rose/tree/master/rose-example]
常期更新版本在：https://github.com/XiaoMi/rose/tree/master/chapter_3_2

nginx准备支持spdy，不错哦，http://t.co/ylumpRSn #
@sosofaraway 去哪了哥 #
@shenzhenyu 要使用0.5.0的thrift包。 #
@roadli 这个是假的活动 #
@PiouseLeo 哈哈，还没，不过只差最后这道工序了 #
@Fenng 哪尼？ #
IT从业人员京城摇号买车攻略，哈哈，有空写一写。 #
rose手册第三章一节：controller层：url对照规则与返回结果规则 http://t.co/OZmQzv5w #
roser 第3.1节，https://t.co/jMa5Xa7h，由团队的@vaporz 完成此节，是不是和之前的风格有点不一样，很细很有爱。 #

3.1.1) url对照规则——最简单的例子

先看看怎样把url和某个方法对应起来。为了方便说明，现在我们来一起完成一个极简版的贴吧。
1)贴吧需要什么功能？

贴吧中当然会有很多“主帖”（topic），“主帖”下会有很多“跟帖”（comment）。
一般，贴吧中最基本的，会有下面这几个功能需要我们完成：

显示主帖列表
显示单个主帖和它的跟贴
显示单个跟贴
创建一个主帖
创建一个跟贴

2)设计 web API

然后让我们来规划一个REST风格的 web API :（“GET”和“POST”是指HTTP1.1中的请求方法）

显示主帖列表
GET http://github.com/myforum/topic
显示单个主帖和它的跟贴
GET http://github.com/myforum/topic/123
显示单个跟贴
GET http://github.com/myforum/topic/123/comment/456
创建一个主帖
POST http://github.com/myforum/topic
创建一个跟贴
POST http://github.com/myforum/topic/123/comment

可以发现一个共同点，所有API中，URI部分的第一级都是“/myforum”（但这并不是规定，仅仅为了演示）。
3)实现 web API

首先新建一个类，这个类的类名必须以“Controller”结尾：

@Path("myforum")
public class ForumController {
}

注意标注在类(class)上的注解“@Path("myforum")”，这意味着，这个类中定义的所有API的URI，都必须以“myforum”开头，比如“/myforum/xxx”和“/myforum/yyy”等（但“myforum”不一定是整个URI的第一级，比如“/aaa/myforum/bbb”）。

接着，实现第一个API——“GET http://github.com/myforum/topic”：

@Path("myforum")
public class ForumController {
@Get("topic")
public String getTopics() {
//显示主帖列表
return "topiclist";
}
}

因为是“GET”方法，所以在该方法上标注“@Get("")”，URI“/myforum/topic”中的“myforum”已经在“@Path("myforum")”中定义过了，所以只剩下“topic”，于是写“@Get("topic")”。

再看第二个API——“GET http://github.com/myforum/topic/123”。
跟前一个的唯一区别是，后面多了个“/123”，表示主帖id，而这个id当然不是固定的，只有用户点击链接发来请求时才能知道，肿么办？
没关系，rose支持正则表达式！可以这么写：

@Get("topic/{topicId:[0-9]+}")
public String showTopic(@Param("topicId") int topicId) {
//显示单个主帖和它的跟贴
return "topic";
}

与前一个API相比，多了段“/{topicId:[0-9]+}”。正则表达式被大括号"{}"包围，格式为“{ paramName : regularExpression }”，只有请求的URI能被正则表达式匹配时，才会执行这个方法，而被匹配的值将被保存在名为“topicId”的参数中。

同理，实现第三个API，稍微复杂一点：

@Get("topic/{topicId:[0-9]+}/comment/{commentId:[0-9]+}")
public String showComment(@Param("topicId") int topicId, @Param("commentId") int commentId) {
//显示单个跟贴
return "comment";
}

最后两个API使用POST方法，其他与前面相同：

@Post("topic")
public String createTopic(){
//创建一个主帖
return "topic";
}
@Post("topic/{topicId:[0-9]+}/comment")
public String createComment(@Param("topicId") int topicId){
//创建一个跟贴
return "comment";
}

完整的代码如下（省略了import语句）：

@Path("myforum")
public class ForumController {

@Get("topic")
public String getTopics() {
//显示主帖列表
return "topiclist";
}

@Get("topic/{topicId:[0-9]+}")
public String showTopic(@Param("topicId") int topicId) {
//显示单个主帖和它的跟贴
return "topic";
}

@Get("topic/{topicId:[0-9]+}/comment/{commentId:[0-9]+}")
public String showComment(@Param("topicId") int topicId, @Param("commentId") int commentId) {
//显示单个跟贴
return "comment";
}

@Post("topic")
public String createTopic(){
//创建一个主帖
return "topic";
}

@Post("topic/{topicId:[0-9]+}/comment")
public String createComment(@Param("topicId") int topicId){
//创建一个跟贴
return "comment";
}
}

至此，一个贴吧功能的Controller就编写完成了。
4) 更多细节

除了上面例子中的做法（@Path("")，@Get("")和@Post("")），还可以通过包路径来规划URI。

比如前面例子中的Controller，在API不变的前提下，还可以这么做：

1.在controllers路径下新建一个叫做“myforum”的文件夹。
2.将ForumController从“xxx.controllers”移动到“xxx.controllers.myforum”
并改成下面这样：

@Path("")
public class ForumController {
@Get("topic")
public String getTopics() {
//显示主帖列表
return "topiclist";
}
... ...
}

只是将“@Path("myforum")”改成了“@Path("")”。这样做的好处是可以让项目中的代码组织清晰。
3.1.2) 返回结果规则
___NOT EOF___

author:vaporz

完整和长期修改版本在：https://github.com/XiaoMi/rose/tree/master/chapter_3_1
关于rose手册计划：https://github.com/XiaoMi/rose

收集最佳实践：在SOA框架（非msgQ）固定的情况下，messageQueue的位置应该是同SOA框架还是应该在各个service内部？ #
54chen Twitter memo 2012-04-15 http://t.co/BwRRIR44 #