【开博第一篇】Struts 1.x下的自动异常处理、国际化处理

我技术浅薄，可写的东西实在太少，今天刚好搭建了一下开发框架，就把这些写出来共享，顺便留作以后参考。

 

转载请申明原创作者【selfimpr】。

 

涉及的问题主要有两个：

1. 自动异常处理：struts支持的配置异常处理，采用自己定义的异常处理系统中的所有自定义异常。

2. 国际化：一时半会想不出怎么解释，自己查查吧。

 

首先，看自动异常处理：

先定义自己的异常类

package deploy.test.exception;public class SystemException extends RuntimeException {private String key;private Object[] values;public SystemException(String key, Object... values) {this.key = key;this.values = values;}public Object[] getValues() {return values;}public void setValues(Object[] values) {this.values = values;}public String getKey() {return key;}public void setKey(String key) {this.key = key;}}

 

定义自己的异常的处理类.

package deploy.test.exception;import javax.servlet.ServletException;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.apache.struts.action.ActionError;import org.apache.struts.action.ActionForm;import org.apache.struts.action.ActionForward;import org.apache.struts.action.ActionMapping;import org.apache.struts.action.ActionMessage;import org.apache.struts.action.ExceptionHandler;import org.apache.struts.config.ExceptionConfig;public class SystemExceptionHandler extends ExceptionHandler {@Override/** * ex : 截获的异常. * ae : struts-config.xml中对该异常的配置信息 */public ActionForward execute(Exception ex, ExceptionConfig ae,ActionMapping mapping, ActionForm formInstance,HttpServletRequest request, HttpServletResponse response)throws ServletException {//如果异常不是我们自己定义的异常,向上抛出,由struts处理.if (!(ex instanceof SystemException)) {return super.execute(ex, ae, mapping, formInstance, request,response);}//错误消息ActionMessage msg = null;//消息在国际化消息文本中的keyString key = null;//把错误消息放到request请求的哪个生命周期中//HTTPRequest请求包括4个生命周期://page: 当前页面有效//request: 当前会话有效//session: 浏览器窗口关闭失效//application: 服务器关闭失效//这里查看SystemException的配置信息中是否配置了scope属性//如果没有配置,默认使用requestScope,否则,使用配置的属性值.String scope = (ae.getScope() == null || ae.getScope().trim().equals(""))? "request" : ae.getScope();//发生这个异常之后要转向的页面ActionForward forward = null;//国际化消息文本中的占位符对应的值Object[] values = null;//从该异常的配置信息中获取"path"//如果path属性配置,则转向path配置的路径//如果path没有配置,转向发生异常的action的配置信息中的input属性指向的页面if (ae.getPath() != null) {forward = new ActionForward(ae.getPath());} else {forward = mapping.getInputForward();}SystemException exception = (SystemException) ex;//从异常中获取key值key = exception.getKey();//从异常中获取占位符的具体值values = exception.getValues();//如果程序中声明抛出异常的时候,没有指定key值,//使用异常SystemException的配置信息中的key值.//如果声明抛出异常的时候,指定了key值,则使用指定的key值.//使用key值和占位符代表的具体值创建错误信息对象.if (key == null || key.trim().equals("")) {msg = new ActionMessage(ae.getKey(), values);} else {msg = new ActionMessage(key, values);}//调用Struts的存储异常方法,将异常信息保存到指定的请求生命周期中super.storeException(request, key, msg, forward, scope);return forward;}@Overrideprotected void logException(Exception e) {// TODO Auto-generated method stubsuper.logException(e);}@Overrideprotected void storeException(HttpServletRequest request, String property,ActionError error, ActionForward forward, String scope) {// TODO Auto-generated method stubsuper.storeException(request, property, error, forward, scope);}@Overrideprotected void storeException(HttpServletRequest request, String property,ActionMessage error, ActionForward forward, String scope) {// TODO Auto-generated method stubsuper.storeException(request, property, error, forward, scope);}}

 

在struts-config.xml文件中配置异常的处理方式:

这里不要忘记最底下指定国际化资源文本的名字哦

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.2//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd"><struts-config><form-beans><form-bean name="userForm" type="deploy.test.web.forms.UserForm" /></form-beans><!-- 将我们自定义的SystemException异常定义为全局的Exception指定默认的key值为:errors.detail指定我们的异常处理器是我们自定义的异常处理器SystemExceptionHandler指定异常转向的页面是/error.jsp用bundle指定默认的国际化消息文本是MessageResources --><global-exceptions><exception key="errors.detail"type="deploy.test.exception.SystemException"handler="deploy.test.exception.SystemExceptionHandler"path="/error.jsp"bundle="MessageResources"/></global-exceptions><action-mappings><action path="/user"type="org.springframework.web.struts.DelegatingActionProxy"name="userForm"scope="request"parameter="method"><forward name="success" path="/success.jsp" /></action></action-mappings><message-resources parameter="MessageResources" /></struts-config>

这样异常处理的"后台就做完了"

定义好我们需要的测试页面之后,在action中的调用中,我们模拟一个异常:

package deploy.test.web.actions;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import org.apache.struts.action.ActionForm;import org.apache.struts.action.ActionForward;import org.apache.struts.action.ActionMapping;import deploy.test.exception.SystemException;import deploy.test.manager.UserManager;import deploy.test.web.forms.UserForm;public class UserAction extends BaseAction {private UserManager userManager;public void setUserManager(UserManager userManager) {this.userManager = userManager;}public ActionForward add(ActionMapping mapping, ActionForm form,HttpServletRequest request, HttpServletResponse response)throws Exception {UserForm uf = (UserForm) form;userManager.add(uf.getUsername(), uf.getPassword());//在异常处理中,不用关心其他业务逻辑代码.//我们模拟抛出一个自定义的SystemException异常//指定异常的key是user.exist, 其中占位符的第一个是用户名//请读者自己测试不指定key的情况,和有多个占位符的情况.if(1 == 1)throw new SystemException("user.exist", uf.getUsername());return mapping.findForward("success");}}

让我们来看看MessageResource.properties中的内容(MessageResource.properties放到类路径下就可以了,也就是我们开发的时候的src目录,部署之后的/WEB-INF/classes目录), 不用关注其他的信息,看我用# here标注的那几个我们用到的那几行.

# -- standard errors --errors.header=<UL>errors.prefix=<LI>errors.suffix=</LI>errors.footer=</UL># -- validator --errors.invalid={0} is invalid.errors.maxlength={0} can not be greater than {1} characters.errors.minlength={0} can not be less than {1} characters.errors.range={0} is not in the range {1} through {2}.errors.required={0} is required.errors.byte={0} must be an byte.errors.date={0} is not a date.errors.double={0} must be an double.errors.float={0} must be an float.errors.integer={0} must be an integer.errors.long={0} must be an long.errors.short={0} must be an short.errors.creditcard={0} is not a valid credit card number.errors.email={0} is an invalid e-mail address.# -- other --errors.cancel=Operation cancelled.# hereerrors.detail={0}errors.general=The process did not complete. Details should follow.errors.token=Request could not be completed. Operation is not in sequence.# -- welcome --welcome.title=Struts Blank Applicationwelcome.heading=Welcome!welcome.message=To get started on your own application, copy the struts-blank.war to a new WAR file using the name for your application. Place it in your container's "webapp" folder (or equivalent), and let your container auto-deploy the application. Edit the skeleton configuration files as needed, restart your container, and you are on your way! (You can find the application.properties file with this message in the /WEB-INF/src/java/resources folder.)# here# -- our keys --user.exist=user /u3010{0}/u3011 is exists/!# -- label keys --label.username=usernamelabel.password=passwordlabel.register=register

这样,我们在最后的异常转向页面,也就是error.jsp中用一句<html:errors />就可以拿到异常信息了

注意,在error.jsp中使用<html:errors />标签的时候需要引入相关的taglib

<%@ taglib prefix="html" uri="http://struts.apache.org/tags-html" %>

 

 

其实上面已经涉及了国际化的处理了,但是,我在做国际化处理的时候,发现我改了浏览器的语言,他也给我不变.

我就做了一个filter

下面具体看看我的国际化处理方式:

首先,定义我们的国际化过滤器,主要是用来获取浏览器中定义的语言选项,然后设置到struts中,让struts获取相应的国际化资源文本.

package deploy.test.i18n;import java.io.IOException;import java.util.Locale;import javax.servlet.Filter;import javax.servlet.FilterChain;import javax.servlet.FilterConfig;import javax.servlet.ServletException;import javax.servlet.ServletRequest;import javax.servlet.ServletResponse;import javax.servlet.http.HttpServletRequest;import org.apache.struts.Globals;public class LocaleFilter implements Filter {@Overridepublic void destroy() {// TODO Auto-generated method stub}@Overridepublic void doFilter(ServletRequest request, ServletResponse response,FilterChain chain) throws IOException, ServletException {//从当前请求中获取浏览器定义的Locale信息Locale locale = request.getLocale();//将Locale信息设置到session中的Globals.LOCALE_KEY属性,//这样,struts在获取本地化信息的时候就能找到相应的资源文本((HttpServletRequest)request).getSession().setAttribute(Globals.LOCALE_KEY, locale);chain.doFilter(request, response);}@Overridepublic void init(FilterConfig arg0) throws ServletException {// TODO Auto-generated method stub}}

在web.xml中配置这个filter的时候,采用/*配置uri-pattern就可以了,让它去过滤所有的请求.

 

这样,就已经基本完工了,具体的其他代码,可以看看我上传的这个项目的源码.

地址在:http://download.csdn.net/source/1162430.

 

另外,提一个思路:

对于国际化而言,用户往往并不是希望固定的看浏览器语言设定的那一种语言的.这样,我们其实可以像google那样让用户可以选择语言.

这个的实现思路是:

用一个ThreadLocal保存每个用户选择的Locale信息,还是用过滤器.