基于JBoss Seam拦截器的异常消息提示体系设计

每个技术体系框架都有自己的消息（message）机制，Struts2框架下有ActionError、ActionMessage、FieldError这三种消息方式，JSF框架也提供了消息API—FacesMessage，这些消息处理结合页面消息标签，将程序产生的错误、人为的消息显示在页面上，给用户非常友好的提示。但是在使用这些消息API的时候，我感觉这些提供的功能还是比较原始，达不到我想要的程度。比如，在Struts2中我如果想将错误消息通过弹出框弹出，我发现是一种非常难以实现的工作。在不使用AJAX的时候，本页提示更是想都不敢想，还要防止出错后的重复提交问题。采用基于事件的JSF框架，本页消息提示容易实现多了，通过标签输出类似于alert(‘程序出错啦’)来达到弹出提示的功能，但是这种实现方式如此简陋。在OECP项目中，客户端采用的是基于JSF的架构，怎样来提供统一的、漂亮的消息提示呢？同时怎样将捕获到的所有异常来封装成消息来显示到客户端呢？现在我就来简单的介绍一下OECP项目中对异常消息提示体系的设计思路。

       JSF作为一个标准大力推广，然而SUN却没有提供一个非常强大的实现，SUN的实现太简陋了，网上笔诛讨伐甚多。开发JSF应用，我们依然要采用其他第三方的实现，现在存在比较成熟的第三方实现主要有Apache的MyFaces，JBoss的Richfaces，ICEFaces，甚至把Seam也加上。Seam作为JBoss大力发展的大一统的Web集成框架，已经在各方面展示强劲的能力。OECP客户端也是基于JBoss Seam框架体系的，引入JBoss Seam后，在拦截器、UI展现等方面都对JSF起到一个非常好的补充。
为什么要引入JBoss Seam的拦截器，主要是因为虽然JSF的监听器机制虽然已经比较强大了，但是却存在一个缺陷（也许是自己才疏学浅没有研究深入）。JSF提供的PhaseListener接口提供了两个方法beforePhase和afterPhase让我们在事件执行前后做一些处理，但是我却得不到当前执行的类、方法，我无法获得这些方法操作的控制权，最简单的异常捕获封装消息的操作都不知道怎么实现，这让我很怀念Struts2的拦截器功能。幸亏JBoss Seam想到了这些问题，JBoss Seam为自己的组件提供了强大的拦截器实现，通过JBoss Seam的拦截器我们不就可以将所有的操作给拦住，然后做加工处理了吗？那就看看JBoss Seam是怎么做的吧。
      首先要为你的应用添加JBoss Seam，这个我就不多说了，google一下吧。OECP项目开始就使用JBoss Seam构建，所以那就赶紧添加拦截器吧。在使用EJB的情况下，JBoss Seam推荐使用会话Bean作为Seam的action，使用EJB标准的拦截器和Seam本身的拦截器都可以很好工作。但是在OECP项目中，我们为了保证业务组件的纯洁性（按标准实现，无框架污染），我们放弃了JBoss Seam的方式而采用了JavaEE标准的分层架构，那么客户端的Action就是简单的Manage Bean。

1、将这个Manage Bean变成Seam的组件。将action类加入Seam提供的@Name注解，这个普通的manage bean就成了Seam组件。

 

Java代码

1. @Name("resourceRegisterAction")  
2. @Scope(ScopeType.PAGE)  
3. public class ResourceRegisterAction  

 2、构建拦截器

Seam构建拦截器的方式是采用的标准的JavaEE体系。如下面代码所示，构造一个拦截机要有一个带有InvocationContext参数的方法，返回值使用Object。需要注意的是，一定要加上@AroundInvoke这个注解，否则框架不将它作为拦截方法。然后在ic.proceed()前后就可以加入你要处理的操作了。建议继承seam提供的AbstractInterceptor，seam会在效率上进行相应的优化。isInterceptorEnabled是该拦截器的开关，如果返回false，该拦截器将不可用。该方法在容器一启动就加载执行，不要想着在里面处理一些动态的信息。

Java代码

1. public class DefaultActionInterceptor extends AbstractInterceptor {  
2.     private Object rv = null;  
3. @AroundInvoke  
4. public Object aroundInvoke(InvocationContext ic) throws Exception {  
5.                     try {  
6.                         rv = ic.proceed();  
7.                     } catch (Exception e) {  
8.                         dealException(ic, e);  
9.                     }  
10. return rv;            
11. }  
12.                   
13.                 @Override  
14.                 public boolean isInterceptorEnabled() {  
15.                     return true;  
16.                 }  
17.                   
18. }  

 

3、封装异常消息

在OECP中，我们把异常粗略的分为业务异常和系统异常。对于这两种异常我们将区分对待。业务异常是EJB业务组件抛出的业务执行过程中出现的异常，而系统异常通常是客户端的程序书写存在问题而出现的异常。我们把异常信息包装后，通过OecpUtil.setPopMsg(msg)将异常信息放到request上下文中，并在页面上显示出来。

Java代码

Java代码

1. private void dealException(InvocationContext ic, Exception e)  
2.                 throws NamingException {  
3.                 if (e instanceof BusinessEJBException) {  
4.                     OecpUtil.setPopMsg(new Message("出错提示", e.getMessage()));  
5.                     BusinessEJBException be = (BusinessEJBException) e;  
6.                     if (!be.isLogged()) {// 如果该异常没有被记录，则调用日志记录组件记录  
7.                         log(ic, be);  
8.                 }  
9.             } else {  
10.                 OecpUtil.setPopMsg(new Message("出错提示",  
11.                     "程序出现错误，您可以拨打以下电话告知处理。1364642****"));  
12.                 log(ic, e);  
13.             }  
14. }  
15.   
16. OecpUtil.java  
17. public static void setPopMsg(Message message) {  
18. FacesUtil.getExternalContext().getRequestMap().put("_pop", message);  
19.     }  

 未完，请点击《基于JBoss Seam拦截器的异常消息提示体系设计（二）》