playframework 拦截器

我觉得play的拦截器有点AOP的思想，相当于struts的filter，play的拦截器使用注解方式实现的。

源码定义了这么几种注解：@before、@after、@catch、@finally 可谓是三百六十度无死角的拦截了。

标注了@Before的方法会在该类的所有方法之前执行，举例：

[java] view plaincopy

1. public class Admin extends Controller {
2. @Before
3. static void checkAuthentification() {
4. if(session.get("user") == null) login();
5. }
6. public static void index() {
7. List<User> users = User.findAll();
8. render(users);
9. }
10. …
11. }

当请求进入Admin时会先检查这个类中是否有@before注解，有就优先执行。

当然还有高级点的特性，如果您不想拦截某些方法，您可以使用unless表明，这样如果用户发来login的请求就不会执行@Before了，如下：

[java] view plaincopy

1. public class Admin extends Controller {
2. @Before(unless="login")
3. static void checkAuthentification() {
4. if(session.get("user") == null) login();
5. }
6. public static void index() {
7. List<User> users = User.findAll();
8. render(users);
9. }
10. …
11. }

同样，您也可以使用only属性，指定需要拦截的请求：

[java] view plaincopy

1. public class Admin extends Controller {
2. @Before(only={"login","logout"})
3. static void doSomething() {
4. …
5. }
6. …
7. }

@After注解的道理是一样的，不过是执行了请求方法之后执行

[java] view plaincopy

1. public class Admin extends Controller {
2. @After
3. static void log() {
4. Logger.info("Action executed ...");
5. }
6. public static void index() {
7. List<User> users = User.findAll();
8. render(users);
9. }
10. …
11. }

下面说说@Catch注解，这个很好用，当程序抛出异常时候可以被标注了@Catch的方法抓住，我们可以在里面做一些必要的操作，比如rollback等。

[java] view plaincopy

1. public class Admin extends Controller {
2. @Catch(IllegalStateException.class)
3. public static void logIllegalState(Throwable throwable) {
4. Logger.error("Illegal state %s…", throwable);
5. }
6. public static void index() {
7. List<User> users = User.findAll();
8. if (users.size() == 0) {
9. throw new IllegalStateException("Invalid database - 0 users");
10. }
11. render(users);
12. }
13. }

对了，其中的prioroty属性可以设置执行顺序的优先级，priority=1是最先执行的。

[java] view plaincopy

1. public class Admin extends Controller {
2. @Catch(value = Throwable.class, priority = 1)
3. public static void logThrowable(Throwable throwable) {
4. // Custom error logging…
5. Logger.error("EXCEPTION %s", throwable);
6. }
7. @Catch(value = IllegalStateException.class, priority = 2)
8. public static void logIllegalState(Throwable throwable) {
9. Logger.error("Illegal state %s…", throwable);
10. }
11. public static void index() {
12. List<User> users = User.findAll();
13. if(users.size() == 0) {
14. throw new IllegalStateException("Invalid database - 0 users");
15. }
16. render(users);
17. }
18. }

@Finally注解的方法和java的finally一样，不管有没有执行成功都会进入该方法，我们可以在里面打印日志：

[java] view plaincopy

1. public class Admin extends Controller {
2. @Finally
3. static void log(Throwable e) {
4. if( e == null ){
5. Logger.info("action call was successful");
6. } else{
7. Logger.info("action call failed", e);
8. }
9. }
10. public static void index() {
11. List<User> users = User.findAll();
12. render(users);
13. }
14. …
15. }

上述所有的注解作用域都是类级别的，如果您想对另外的类也起作用，请用@With标签：

[java] view plaincopy

1. public class Secure extends Controller {
2. @Before
3. static void checkAuthenticated() {
4. if(!session.containsKey("user")) {
5. unAuthorized();
6. }
7. }
8. }
9. @With(Secure.class)
10. public class Admin extends Controller {
11. …
12. }

实现的原理应该是这样：socket请求发过来的时候，play 的路由会去匹配进入哪个Controller，然后看这个Controller里面有哪些系统标签，然后按规定好的执行顺序依次执行，这就是所谓的拦截了。（有时间把源码分析也一起发出来）

知道原理，我们就可以写自己的拦截器了，比如权限管理：在每个需要权限的方法上加上自定义的权限注解如:@MyAnatation(priority=1)，用户发起请求——@Before拦截——从登录token拿到用户信息——查看该用户所有权限ID——对比自定义注解的priority——priority在权限ID中则允许访问，不包含返回无此权限信息。

[java] view plaincopy

1. @Before(priority = 1)
2. public static void doAuth(){
3. Annotation annotation =  request.invokedMethod.getAnnotation(MyAnotation.class);
4. if(annotation !=null){
5. //鉴权开始
6. QicFunction function =  (QicFunction)annotation;
7. //todo
8. }
9. }

有了这种思想，我们可以做任何自定义的拦截行为，谁也拦不住。

最后，要提醒自己，路漫漫其修远兮，吾将上下而求索。加油啊！