十三、自定义类型转换器
struts2有两种类型转换器：
1、局部类型转换器：只对单个Action作用域内起作用
java.util.Date类型的属性可以接收格式为2009-07-20的请求参数。但如果我们需要接收格式为20090720的请求参数时，就必须定义类型转换器，否则struts2无法自动完成类型转换。
import java.util.Date;
public class HelloWorldAction{
private Date createtime;
public Date getCreatetime(){
return createtime;
}
public Date setCreatetime(Date createtime){
this.createtime = createtime;
}
}
相应类型转换器：
public class DateConverter extends DefaultTypeConverter{
@Override
public Object convertValue(Map context,Object value,Class toType){
SimpleDateFormat dateFormat=new SimpleDateFormat("yyyyMMdd");
try{
if(toType==Date.class){//当字符串向Date类型转换时
String[] params = (String[])value;//Request.getParameterValues()
return dateFormat.parse(params[0]);
}
else if (toType==String.class){//当Date转换成字符串时
Date date=(Date)value;
return dateFormat.format(date);
}
}
}
}
将上面的类型转换器注册为局部类型转换器：
在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties。
在properties文件的内容为：
属性名称=类型转换器的全类名
对于本例而言，HelloWorldAction-conversion.properties文件中的内容为：
createtime=com.rlcc.conversion.DateConverter
2、全局类型转换器：整个应用的Action起作用
将上面的类型转换器注册为全局类型转换器：
在WEB-INF/class下放置xwork-conversion.properties文件。在properties文件中的内容为：
待转换的类型=类型转换器的全类名
对于本例而言，xwork-conversion.properties文件中的内容为：
java.util.Date=com.rlcc.conversion.DateConverter
十四、访问或添加request/session/application属性
1、通过ActionContext对象直接访问或者添加
public String scope() throws Exception{
ActionContext ctx = ActionContext.getContext();
ctx.getApplication().put("app","应用范围");//往ServletContext里放入app
ctx.getSession().put("ses","session范围");//往session里放入app
ctx.put("req","request范围");//往request里放入app
return "scope";
}
JSP:
<body>
${applicationScope.app} <br>
${sessionScope.ses} <br>
${requestScope.req} <br>
</body>
2、获取HttpServletRequest/HttpSession/ServletContext/HttpServletResponse对象
方法一，通过ServletActionContext类直接获取：
public String rsa() throws Exception{
HttpServletRequest request=ServletActionContext.getRequest();
ServletContext servletContext=ServletActionContext.getServletContext();
request.getSession();
HttpServletResponse response = ServletActionContext.getResponse();
return "scope";
}
方法二，实现指定接口，由struts框架运行时注入：
public class HelloWorldAction implements ServletRequestAware,ServletResponseAware,ServletContextAware{
private HttpServletRequest request;
private ServletContext servletContext;
private HttpServletResponse response;
public void setServletRequest(HttpServletRequest req){
this.request = req;
}
public void setServletResponse(HttpServletResponse res){
this.response = res;
}
public void setServletContext(ServletContext ser){
this.servletContext = ser;
}
}
注：如果只是往三个作用域里写入信息，则用“1”方式；如果要获取工程的绝对路径、请求信息中的其它信息，则可以用“2”方式。
十五、文件上传
1、单文件上传
第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org下载。
第二步：把form表的enctype设置为：“multipart/form-data”，如下：
<form enctype="multipart/form-data" action="${pageContext.request.contentPath}/xxx.action" method="post">
<input type="file" name="uploadImage">
</form>
第三步：在Action类中添加以下属性，属性uploadImage和表单中文件字段的名称对应：
public class HelloWorldAction{
private File uploadImage; //得到上传的文件
private String uploadImageContentType; //得到文件的类型
private String uploadImageFileName; //得到文件的名称
... //这里省略了属性的getter/setter方法
public String upload() throws Exception{
String realpath=ServletActionContext.getServletContext.getRealPath("/images");
File file = new File(realpath);
if(!file.exists()){
file.mkdirs();
}
FileUtils.copyFile(uploadImage,new File(file,uploadImageFileName));
return "sucess";
}
}
注：一般web只上传下载小文件，网上门户网的大文件上传下载一般都要安装一个插件，通过插件使用socket技术来实现上传下载。也可以实现断点续传，即大文件一般都得通过应用软件来上传，而不是web。
2、多文件上传
第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org下载。
第二步：把form表的enctype设置为：“multipart/form-data”，如下：
<form enctype="multipart/form-data" action="${pageContext.request.contentPath}/xxx.action" method="post">
<input type="file" name="uploadImages">
<input type="file" name="uploadImages">
</form>
第三步：在Action类中添加以下属性，属性uploadImage和表单中文件字段的名称对应：
public class HelloWorldAction{
private File[] uploadImages; //得到上传的文件
private String[] uploadImagesContentType; //得到文件的类型
private String[] uploadImagesFileName; //得到文件的名称
... //这里省略了属性的getter/setter方法
public String upload() throws Exception{
String realpath=ServletActionContext.getServletContext.getRealPath("/images");
File file = new File(realpath);
if(!file.exists()){
file.mkdirs();
}
for(int i=0;i<uploadImages.length;i++){
FileUtils.copyFile(uploadImages[i],new File(file,uploadImagesFileName[i]));
}
return "sucess";
}
}
十六、自定义拦截器
1、要自定义拦截器需要实现com.opensymphony.xwork2.interceptor.interceptor接口：
public class PermissionInterceptor implements Interceptor{
public void destory(){
}
pulbic void init(){
}
public String intercept(ActionInvocation invocation) throws Exception{
System.out.println("进入拦截器");
if(session里存在用户){
String result = invocation.invoke();
} else {
return "logon";
}
//System.out.println("返回值:"+result);
//return result;
}
}
2、拦截器注册
<package name="example" namespace="/example" extends="struts-default">
<interceptors>
<interceptor name="permission" class="com.rlcc.action.PermissionInterceptor"/>
<interceptor-stack name="permissionStack">
<interceptor-ref name="defaultStack"/>
<interceptor-ref name="permission"/>
</interceptor-stack>
<interceptors>
<action name="view_*" class="com.rlcc.HelloWorldAction" method="{1}">
<result name="success">/WEB-INF/page/hello.jsp</result>
<interceptor-ref name="permissionStack"/>
</action>
</package>
因为struts2中如文件上传，数据验证，封装请求参数到action等功能都是由系统默认的defaultStack中的拦截器实现的，所以我们定义的拦截器需要引用系统默认的defaultStack，这样应用才可以使用struts2框架提供的众多功能。
如果希望包下的所有action都使用自定义的拦截器，可以通过<default-interceptor-ref name="permissionStack"/>把拦截器定义为默认拦截器。注意：每个包只能指定一个默认拦截器。另外，一旦我们为该包中的某个action显示指定了某个拦截器，则默认拦截器不会起作用。
十七、输入校验
在struts2中，我们可以实现对action的所有方法进行校验或者对action的指定方法进行校验。
对于输入校验struts2提供了两种实现方法：
* 采用手工编写代码实现。
* 基于xml配置方式实现。
1、手工编写代码实现对action中所有方法输入校验
a、通过重写validate()方法实现，validate()方法会校验action中所有与execute方法签名相同的方法。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action必须继承ActionSupport），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。
validate()使用例子：
public void validate(){
if(this.mobile==null || "".equals(this.mobile.trim())){
this.addFiledError("username","手机号不能为空");
}else{
if(!Pattern.compile("^1[358]\\d{9}").matcher(this.mobile.trim()).matches()){
this.addFieldError("mobile","手机号的格式不正确");
}
}
}
验证失败后，请求转发至input视图：
<result name="input">/WEB-INF/page/addUser.jsp</result>
在addUser.jsp页面中使用<s:fielderror/>显示失败信息。
b、通过validateXxx()方法实现，validateXxx()只会校验action中方法名为Xxx的方法。其中Xxx的第一个字母要大写。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action必须继承ActionSupport），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。
validateXxx()方法使用例子：
public String add() throws Exception {
return "success";
}
public void validateAdd(){
if(username==null || "".equals(username.trim())){
this.addFieldError("username","用户名不能为空");
}
}
<result name="input">/WEB-INF/page/addUser.jsp</result>
在addUser.jsp页面中使用<s:fielderror/>显示失败信息。
c、输入校验的流程
1)、类型转换器对请求参数执行类型转换，并把转换后的值赋给action中的属性。
2)、如果在执行类型转换的过程中出现异常，系统会将异常信息保存到ActionContext，conversionError拦截器将异常信息添加到fieldErrors里。不管类型转换是否出现异常，都会进入第3步。
3)、系统通过反射技术先调用action中的validateXxx()方法，Xxx为方法名。
4)、再调用action中的validate()方法。
5)、经过上面4步，如果系统中的fieldErrors存在错误信息（即存放错误信息的集合的size大于0），系统自动将请求转发至名称为input的视图。如果系统中的fieldErrors没有任何错误信息，系统将执行action中的处理方法。
1、基于XML配置方式实现输入校验
a、struts2提供的校验器列表及说明
1)、required：必填校验器，要求field的值不能为null
2)、requiredstring：必填字符串校验器，要求field的值不能为null，并且长度大于0，默认情况下会对字符串去掉前后空格。
3)、stringlength：字符串长度校验器，要求field的值必须在指定的范围内，否则校验失败，minLength参数指定最小长度，maxLength参数指定最大长度，trim参数指定校验field之前是否去除字符串前后的空格。
4)、regex：正则表达式校验器，检查被校验的field是否匹配一个正则表达式，expression参数指定正则表达式，caseSensitive参数指定进行正则表达式匹配时，是否区分大小写，默认值为true。
5)、int：整数校验器，要求field的整数值必须在指定范围内，min指定最小值，max指定最大值。
6)、double：双精度浮点数校验器，要求field的双精度浮点数必须在指定范围内，min指定最小值，max指定最大值。
7)、fieldexpression：字段OGNL表达式校验器，要求field满足一个ognl表达式，expression参数指定ognl表达式，该逻辑表达式基于ValueStack进行求值，返回true时校验通过，否则不通过。
8)、email：邮件地址校验器，要求如果field的值非空，则必须是合法的邮件地址
9)、url：网址校验器，要求如果field的值非空，则必须是合法的url地址。
10)、date：日期校验器，要求field的日期值必须在指定范围内，min指定最小值，max指定最大值。
11)、conversion：转换校验器，指定在类型转换失败时，提示的错误信息。
12)、visitor：用于校验action中的复合属性，它指定一个校验文件用于校验复合属性中的属性。
13)、expression：ognl表达式校验器，expression参数指定ognl表达式，该逻辑表达式基于ValueStack进行求值，返回true时校验通过，否则不通过，该校验器不可用在字段校验器风格的配置中。
b、校验器的使用例子
1)、required必 填校验器
<field-validator type="required">
<message>性别不能为空！</message>
</field-validator>
2)、requiredstring 必填字符串校验器
<field-validator type="requiredstring">
<param name="trim">true</param>
<message>用户名不能为空！</message>
</field-validator>
3)、stringlength 字符串长度校验器
<field-validator type="stringlength">
<param name="maxLength">10</param>
<param name="minLength">2</param>
<param name="trim">true</param>
<message><![CDATA[产品名称应在2-10个字符之间]]></message>
</field-validator>
4)、email 邮件地址校验器
<field-validator type="email">
<message>电子邮件地址无效</message>
</field-validator>
5)、regex 正则表达式校验器
<field-validator type="regex">
<param name="expression"><![CDATA[^1[358]\d{9}$]]></param>
<message>手机号格式不正确！</message>
</field-validator>
c、对action的所有方法进行输入校验
使用基于XML配置方式实现输入校验时，Action必须继承ActionSupport，并且提供校验文件，校验文件和action类放在同一包下，文件的取名格式为：ActionClassName-validation.xml，其中ActionClassName为action的简单类名，-validation为固定写法。如果Action类为com.rlcc.UserAction，那么该文件的取名应为：UserAction-validation.xml。下面是校验文件的模版：
<xml version="1.0" encoding="UTF-8">
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<validators>
<field name="username">
<field-validator type="requiredstring">
<param name="trim">true</param><!--代表向requiredstring校验器的属性trim注入值true，因为该属性的默认值为true，所以这里可以省略不写-->
<message>用户名不能为空!</message>
</field-validator>
</field>
</validators>
<field>指定action中要校验的属性，<field-validator>指定校验器，上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。
<message>为校验失败后的提示信息，如果需要国际化，可以为message指定key属性，key的值为资源文件中的key。在这个校验文件中，对action中字符串类型username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。
附：在编写ActionClassName-validation.xml校验文件时，如果出现不了帮助信息，可以按下面方式解决：
window->preferences->myeclipse->files and editors->xml->xmlcatalog
点“add”，在出现的窗口中的location中选“File system”，然后在xwork-2.1.2解压目录的src\java目录中选择xwork-validator-1.0.3.dtd，回到设置窗口的时候不要急着关闭窗口，应把窗口中的Key Type改为URI。Key改为http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd
d、对指定action方法实现输入校验
当校验文件的取名为ActionClassName-validation.xml时，会对action中的所有处理方法实施输入校验。如果只需要对action中的某个action方法实施校验，那么，校验文件的取名应为：ActionClassName-ActionName-validation.xml，其中ActionName为struts.xml中action的名称。例如：在实际应用中，常有以下配置：
<action name="user_*" class="com.rlcc.action.UserAction" method="{1}">
<result name="success">/WEB-INF/page/message.jsp</result>
<result name="input">/WEB-INF/page/addUser.jsp</result>
</action>
UserAction中有以下两个处理方法：
public String add() throws Exception{
......
}
public String update() throws Exception{
......
}
要对add()方法实施验证，校验文件的取名为：UserAction-user_add-validation.xml
要对update()方法实施验证，校验文件的取名为：UserAction-user_update-validation.xml
e、基于XML校验的一些特点：
当为某个action提供了ActionClassName-validation.xml和ActionClassName-ActionName-validation.xml两种规则的校验文件时，系统按照下面顺序寻找校验文件：
1)、ActionClassName-validation.xml
2)、ActionClassName-ActionName-validation.xml
系统寻找到第一个校验文件时还会继续搜索后面的校验文件，当搜索到所有校验文件时，会把校验文件里的所有校验规则汇总，然会全部应用于action方法的校验。如果两个校验文件中指定的校验规则冲突，则只使用后面文件中的校验规则。
当action继承了另一个action，父类action的校验文件会先被搜索到。
假设UserAction继承BaseAction：
<action name="user" class="com.rlcc.action.UserAction" method="{1}">
</action>
访问上面action，系统先搜索父类的校验文件：BaseAction-validation.xml，BaseAction-user-validation.xml，接着搜索子类的校验文件：UserAction-validation.xml，UserAction-user-validation.xml 应用于上面action的校验规则为这四个文件的总和。
十八、国际化
准备资源文件，资源文件的命名格式如下：
baseName_language_country.properties
baseName_language.properties
baseName.properties
其中baseName是资源文件的基本名，我们可以自定义，但language和country必须是java支持的语言和国家。如：
中国大陆：baseName_zh_CN.properties
美国：baseName_en_US.properties
现在为应用添加两个资源文件：
第一个存放中文：rlcc_zh_CN.properties
内容为：welcome=欢迎您
第二个存放英语（美国）：rlcc_en_US.properties
内容为：welcome=welcome you
对于中文的属性文件，我们编写好后，应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文件。命令的使用方式如下：
native2ascii 源文件.properties 目标文件.properties
国际化提供三种范围的资源文件：全局范围、包范围、action范围
1、配置全局资源与输出国际化信息
当准备好资源文件之后，我们可以在struts.xml中通过struts.custom.i18n.resources常量把资源文件定义为全局资源文件，如下：
<constant name="struts.custom.i18n.resources" value="rlcc"/>
rlcc为资源文件的基本名
1)、我们就可以在页面或在action中访问国际化信息：
a、在JSP页面中使用<s:text name=""/>标签输出国际化信息：
<s:text name="user"/>，name为资源文件的key
b、在action类中，可以继承ActionSupport，使用getText()方法得到国际化信息，该方法的第一个参数用于指定资源文件中的key。
c、在表单标签中，通过key属性指定资源文件中的key，如：
<s:textfield name="realname" key="user"/>
2)、输出带占位符的国际化信息
资源文件中的内容如下：
welcome={0}，欢迎您，您的IP：{1}
在jsp页面中的输出带占位符的国际化信息
<s:text name="welcome">
<s:param><s:property value="realname"/></s:param>
<s:param>学习</s:param>
</s:text>
在Action类中获取带占位符的国际化信息，可以使用getText(String key,String[] args)或getText(String aTextName,List args)方法。
2、配置包范围国际化资源文件
在一个大型应用中，整个应用有大量的内容需要实现国际化，如果我们把国际化的内容都放置在全局资源属性文件中，显然会导致资源文件变的过于庞大、臃肿，不便于维护，这个时候我们可以针对不同模块，使用包范围来组织国际化文件。
方法如下：
在java的包下放置package_language_country.properties资源文件，package为固定写法，处于该包及子包下的action都可以访问该资源。当查找指定key的消息时，系统会先从package资源文件查找，当找不到对应的key时，才会从常量struts.custom.i18n.resources指定的资源文件中寻找。
3、配置Action范围的国际化资源文件
为某个action单独指定资源文件，方法如下：
在Action类所在的路径，放置ActionClassName_language_country.properties资源文件，ActionClassName为action类的简单名称。
当查找指定key的消息时，系统会先从ActionClassName_language_country.properties资源文件查找，如果没有找到对应的key，就会沿着当前包往上查找基本名为package的资源文件，一直找到最顶层包。如果还没有找到对应的key，最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。
4、JSP中直接访问某个资源文件
struts2为我们提供了<s:i18n>标签，使用<s:i18n>标签我们可以在类路径下直接从某个资源文件中获取国际化数据，而无需任何配置：
<s:i18n name="rlcc">
<s:text name="welcome"/>
</s:i18n>
rlcc为类路径下资源文件的基本名。
如果要访问的资源文件在类路径的某个包下，可以这样访问：
<s:i18n name="com/rlcc/i18n/package">
<s:text name="welcome">
<s:param>ruilin</s:param>
</s:text>
</s:i18n>
上面访问com.rlcc.i18n包下基本名为package的资源文件。
struts2有两种类型转换器：
1、局部类型转换器：只对单个Action作用域内起作用
java.util.Date类型的属性可以接收格式为2009-07-20的请求参数。但如果我们需要接收格式为20090720的请求参数时，就必须定义类型转换器，否则struts2无法自动完成类型转换。
import java.util.Date;
public class HelloWorldAction{
private Date createtime;
public Date getCreatetime(){
return createtime;
}
public Date setCreatetime(Date createtime){
this.createtime = createtime;
}
}
相应类型转换器：
public class DateConverter extends DefaultTypeConverter{
@Override
public Object convertValue(Map context,Object value,Class toType){
SimpleDateFormat dateFormat=new SimpleDateFormat("yyyyMMdd");
try{
if(toType==Date.class){//当字符串向Date类型转换时
String[] params = (String[])value;//Request.getParameterValues()
return dateFormat.parse(params[0]);
}
else if (toType==String.class){//当Date转换成字符串时
Date date=(Date)value;
return dateFormat.format(date);
}
}
}
}
将上面的类型转换器注册为局部类型转换器：
在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties。
在properties文件的内容为：
属性名称=类型转换器的全类名
对于本例而言，HelloWorldAction-conversion.properties文件中的内容为：
createtime=com.rlcc.conversion.DateConverter
2、全局类型转换器：整个应用的Action起作用
将上面的类型转换器注册为全局类型转换器：
在WEB-INF/class下放置xwork-conversion.properties文件。在properties文件中的内容为：
待转换的类型=类型转换器的全类名
对于本例而言，xwork-conversion.properties文件中的内容为：
java.util.Date=com.rlcc.conversion.DateConverter
十四、访问或添加request/session/application属性
1、通过ActionContext对象直接访问或者添加
public String scope() throws Exception{
ActionContext ctx = ActionContext.getContext();
ctx.getApplication().put("app","应用范围");//往ServletContext里放入app
ctx.getSession().put("ses","session范围");//往session里放入app
ctx.put("req","request范围");//往request里放入app
return "scope";
}
JSP:
<body>
${applicationScope.app} <br>
${sessionScope.ses} <br>
${requestScope.req} <br>
</body>
2、获取HttpServletRequest/HttpSession/ServletContext/HttpServletResponse对象
方法一，通过ServletActionContext类直接获取：
public String rsa() throws Exception{
HttpServletRequest request=ServletActionContext.getRequest();
ServletContext servletContext=ServletActionContext.getServletContext();
request.getSession();
HttpServletResponse response = ServletActionContext.getResponse();
return "scope";
}
方法二，实现指定接口，由struts框架运行时注入：
public class HelloWorldAction implements ServletRequestAware,ServletResponseAware,ServletContextAware{
private HttpServletRequest request;
private ServletContext servletContext;
private HttpServletResponse response;
public void setServletRequest(HttpServletRequest req){
this.request = req;
}
public void setServletResponse(HttpServletResponse res){
this.response = res;
}
public void setServletContext(ServletContext ser){
this.servletContext = ser;
}
}
注：如果只是往三个作用域里写入信息，则用“1”方式；如果要获取工程的绝对路径、请求信息中的其它信息，则可以用“2”方式。
十五、文件上传
1、单文件上传
第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org下载。
第二步：把form表的enctype设置为：“multipart/form-data”，如下：
<form enctype="multipart/form-data" action="${pageContext.request.contentPath}/xxx.action" method="post">
<input type="file" name="uploadImage">
</form>
第三步：在Action类中添加以下属性，属性uploadImage和表单中文件字段的名称对应：
public class HelloWorldAction{
private File uploadImage; //得到上传的文件
private String uploadImageContentType; //得到文件的类型
private String uploadImageFileName; //得到文件的名称
... //这里省略了属性的getter/setter方法
public String upload() throws Exception{
String realpath=ServletActionContext.getServletContext.getRealPath("/images");
File file = new File(realpath);
if(!file.exists()){
file.mkdirs();
}
FileUtils.copyFile(uploadImage,new File(file,uploadImageFileName));
return "sucess";
}
}
注：一般web只上传下载小文件，网上门户网的大文件上传下载一般都要安装一个插件，通过插件使用socket技术来实现上传下载。也可以实现断点续传，即大文件一般都得通过应用软件来上传，而不是web。
2、多文件上传
第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org下载。
第二步：把form表的enctype设置为：“multipart/form-data”，如下：
<form enctype="multipart/form-data" action="${pageContext.request.contentPath}/xxx.action" method="post">
<input type="file" name="uploadImages">
<input type="file" name="uploadImages">
</form>
第三步：在Action类中添加以下属性，属性uploadImage和表单中文件字段的名称对应：
public class HelloWorldAction{
private File[] uploadImages; //得到上传的文件
private String[] uploadImagesContentType; //得到文件的类型
private String[] uploadImagesFileName; //得到文件的名称
... //这里省略了属性的getter/setter方法
public String upload() throws Exception{
String realpath=ServletActionContext.getServletContext.getRealPath("/images");
File file = new File(realpath);
if(!file.exists()){
file.mkdirs();
}
for(int i=0;i<uploadImages.length;i++){
FileUtils.copyFile(uploadImages[i],new File(file,uploadImagesFileName[i]));
}
return "sucess";
}
}
十六、自定义拦截器
1、要自定义拦截器需要实现com.opensymphony.xwork2.interceptor.interceptor接口：
public class PermissionInterceptor implements Interceptor{
public void destory(){
}
pulbic void init(){
}
public String intercept(ActionInvocation invocation) throws Exception{
System.out.println("进入拦截器");
if(session里存在用户){
String result = invocation.invoke();
} else {
return "logon";
}
//System.out.println("返回值:"+result);
//return result;
}
}
2、拦截器注册
<package name="example" namespace="/example" extends="struts-default">
<interceptors>
<interceptor name="permission" class="com.rlcc.action.PermissionInterceptor"/>
<interceptor-stack name="permissionStack">
<interceptor-ref name="defaultStack"/>
<interceptor-ref name="permission"/>
</interceptor-stack>
<interceptors>
<action name="view_*" class="com.rlcc.HelloWorldAction" method="{1}">
<result name="success">/WEB-INF/page/hello.jsp</result>
<interceptor-ref name="permissionStack"/>
</action>
</package>
因为struts2中如文件上传，数据验证，封装请求参数到action等功能都是由系统默认的defaultStack中的拦截器实现的，所以我们定义的拦截器需要引用系统默认的defaultStack，这样应用才可以使用struts2框架提供的众多功能。
如果希望包下的所有action都使用自定义的拦截器，可以通过<default-interceptor-ref name="permissionStack"/>把拦截器定义为默认拦截器。注意：每个包只能指定一个默认拦截器。另外，一旦我们为该包中的某个action显示指定了某个拦截器，则默认拦截器不会起作用。
十七、输入校验
在struts2中，我们可以实现对action的所有方法进行校验或者对action的指定方法进行校验。
对于输入校验struts2提供了两种实现方法：
* 采用手工编写代码实现。
* 基于xml配置方式实现。
1、手工编写代码实现对action中所有方法输入校验
a、通过重写validate()方法实现，validate()方法会校验action中所有与execute方法签名相同的方法。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action必须继承ActionSupport），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。
validate()使用例子：
public void validate(){
if(this.mobile==null || "".equals(this.mobile.trim())){
this.addFiledError("username","手机号不能为空");
}else{
if(!Pattern.compile("^1[358]\\d{9}").matcher(this.mobile.trim()).matches()){
this.addFieldError("mobile","手机号的格式不正确");
}
}
}
验证失败后，请求转发至input视图：
<result name="input">/WEB-INF/page/addUser.jsp</result>
在addUser.jsp页面中使用<s:fielderror/>显示失败信息。
b、通过validateXxx()方法实现，validateXxx()只会校验action中方法名为Xxx的方法。其中Xxx的第一个字母要大写。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action必须继承ActionSupport），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。
validateXxx()方法使用例子：
public String add() throws Exception {
return "success";
}
public void validateAdd(){
if(username==null || "".equals(username.trim())){
this.addFieldError("username","用户名不能为空");
}
}
<result name="input">/WEB-INF/page/addUser.jsp</result>
在addUser.jsp页面中使用<s:fielderror/>显示失败信息。
c、输入校验的流程
1)、类型转换器对请求参数执行类型转换，并把转换后的值赋给action中的属性。
2)、如果在执行类型转换的过程中出现异常，系统会将异常信息保存到ActionContext，conversionError拦截器将异常信息添加到fieldErrors里。不管类型转换是否出现异常，都会进入第3步。
3)、系统通过反射技术先调用action中的validateXxx()方法，Xxx为方法名。
4)、再调用action中的validate()方法。
5)、经过上面4步，如果系统中的fieldErrors存在错误信息（即存放错误信息的集合的size大于0），系统自动将请求转发至名称为input的视图。如果系统中的fieldErrors没有任何错误信息，系统将执行action中的处理方法。
1、基于XML配置方式实现输入校验
a、struts2提供的校验器列表及说明
1)、required：必填校验器，要求field的值不能为null
2)、requiredstring：必填字符串校验器，要求field的值不能为null，并且长度大于0，默认情况下会对字符串去掉前后空格。
3)、stringlength：字符串长度校验器，要求field的值必须在指定的范围内，否则校验失败，minLength参数指定最小长度，maxLength参数指定最大长度，trim参数指定校验field之前是否去除字符串前后的空格。
4)、regex：正则表达式校验器，检查被校验的field是否匹配一个正则表达式，expression参数指定正则表达式，caseSensitive参数指定进行正则表达式匹配时，是否区分大小写，默认值为true。
5)、int：整数校验器，要求field的整数值必须在指定范围内，min指定最小值，max指定最大值。
6)、double：双精度浮点数校验器，要求field的双精度浮点数必须在指定范围内，min指定最小值，max指定最大值。
7)、fieldexpression：字段OGNL表达式校验器，要求field满足一个ognl表达式，expression参数指定ognl表达式，该逻辑表达式基于ValueStack进行求值，返回true时校验通过，否则不通过。
8)、email：邮件地址校验器，要求如果field的值非空，则必须是合法的邮件地址
9)、url：网址校验器，要求如果field的值非空，则必须是合法的url地址。
10)、date：日期校验器，要求field的日期值必须在指定范围内，min指定最小值，max指定最大值。
11)、conversion：转换校验器，指定在类型转换失败时，提示的错误信息。
12)、visitor：用于校验action中的复合属性，它指定一个校验文件用于校验复合属性中的属性。
13)、expression：ognl表达式校验器，expression参数指定ognl表达式，该逻辑表达式基于ValueStack进行求值，返回true时校验通过，否则不通过，该校验器不可用在字段校验器风格的配置中。
b、校验器的使用例子
1)、required必 填校验器
<field-validator type="required">
<message>性别不能为空！</message>
</field-validator>
2)、requiredstring 必填字符串校验器
<field-validator type="requiredstring">
<param name="trim">true</param>
<message>用户名不能为空！</message>
</field-validator>
3)、stringlength 字符串长度校验器
<field-validator type="stringlength">
<param name="maxLength">10</param>
<param name="minLength">2</param>
<param name="trim">true</param>
<message><![CDATA[产品名称应在2-10个字符之间]]></message>
</field-validator>
4)、email 邮件地址校验器
<field-validator type="email">
<message>电子邮件地址无效</message>
</field-validator>
5)、regex 正则表达式校验器
<field-validator type="regex">
<param name="expression"><![CDATA[^1[358]\d{9}$]]></param>
<message>手机号格式不正确！</message>
</field-validator>
c、对action的所有方法进行输入校验
使用基于XML配置方式实现输入校验时，Action必须继承ActionSupport，并且提供校验文件，校验文件和action类放在同一包下，文件的取名格式为：ActionClassName-validation.xml，其中ActionClassName为action的简单类名，-validation为固定写法。如果Action类为com.rlcc.UserAction，那么该文件的取名应为：UserAction-validation.xml。下面是校验文件的模版：
<xml version="1.0" encoding="UTF-8">
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0.3//EN"
"http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd">
<validators>
<field name="username">
<field-validator type="requiredstring">
<param name="trim">true</param><!--代表向requiredstring校验器的属性trim注入值true，因为该属性的默认值为true，所以这里可以省略不写-->
<message>用户名不能为空!</message>
</field-validator>
</field>
</validators>
<field>指定action中要校验的属性，<field-validator>指定校验器，上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。
<message>为校验失败后的提示信息，如果需要国际化，可以为message指定key属性，key的值为资源文件中的key。在这个校验文件中，对action中字符串类型username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。
附：在编写ActionClassName-validation.xml校验文件时，如果出现不了帮助信息，可以按下面方式解决：
window->preferences->myeclipse->files and editors->xml->xmlcatalog
点“add”，在出现的窗口中的location中选“File system”，然后在xwork-2.1.2解压目录的src\java目录中选择xwork-validator-1.0.3.dtd，回到设置窗口的时候不要急着关闭窗口，应把窗口中的Key Type改为URI。Key改为http://www.opensymphony.com/xwork/xwork-validator-1.0.3.dtd
d、对指定action方法实现输入校验
当校验文件的取名为ActionClassName-validation.xml时，会对action中的所有处理方法实施输入校验。如果只需要对action中的某个action方法实施校验，那么，校验文件的取名应为：ActionClassName-ActionName-validation.xml，其中ActionName为struts.xml中action的名称。例如：在实际应用中，常有以下配置：
<action name="user_*" class="com.rlcc.action.UserAction" method="{1}">
<result name="success">/WEB-INF/page/message.jsp</result>
<result name="input">/WEB-INF/page/addUser.jsp</result>
</action>
UserAction中有以下两个处理方法：
public String add() throws Exception{
......
}
public String update() throws Exception{
......
}
要对add()方法实施验证，校验文件的取名为：UserAction-user_add-validation.xml
要对update()方法实施验证，校验文件的取名为：UserAction-user_update-validation.xml
e、基于XML校验的一些特点：
当为某个action提供了ActionClassName-validation.xml和ActionClassName-ActionName-validation.xml两种规则的校验文件时，系统按照下面顺序寻找校验文件：
1)、ActionClassName-validation.xml
2)、ActionClassName-ActionName-validation.xml
系统寻找到第一个校验文件时还会继续搜索后面的校验文件，当搜索到所有校验文件时，会把校验文件里的所有校验规则汇总，然会全部应用于action方法的校验。如果两个校验文件中指定的校验规则冲突，则只使用后面文件中的校验规则。
当action继承了另一个action，父类action的校验文件会先被搜索到。
假设UserAction继承BaseAction：
<action name="user" class="com.rlcc.action.UserAction" method="{1}">
</action>
访问上面action，系统先搜索父类的校验文件：BaseAction-validation.xml，BaseAction-user-validation.xml，接着搜索子类的校验文件：UserAction-validation.xml，UserAction-user-validation.xml 应用于上面action的校验规则为这四个文件的总和。
十八、国际化
准备资源文件，资源文件的命名格式如下：
baseName_language_country.properties
baseName_language.properties
baseName.properties
其中baseName是资源文件的基本名，我们可以自定义，但language和country必须是java支持的语言和国家。如：
中国大陆：baseName_zh_CN.properties
美国：baseName_en_US.properties
现在为应用添加两个资源文件：
第一个存放中文：rlcc_zh_CN.properties
内容为：welcome=欢迎您
第二个存放英语（美国）：rlcc_en_US.properties
内容为：welcome=welcome you
对于中文的属性文件，我们编写好后，应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文件。命令的使用方式如下：
native2ascii 源文件.properties 目标文件.properties
国际化提供三种范围的资源文件：全局范围、包范围、action范围
1、配置全局资源与输出国际化信息
当准备好资源文件之后，我们可以在struts.xml中通过struts.custom.i18n.resources常量把资源文件定义为全局资源文件，如下：
<constant name="struts.custom.i18n.resources" value="rlcc"/>
rlcc为资源文件的基本名
1)、我们就可以在页面或在action中访问国际化信息：
a、在JSP页面中使用<s:text name=""/>标签输出国际化信息：
<s:text name="user"/>，name为资源文件的key
b、在action类中，可以继承ActionSupport，使用getText()方法得到国际化信息，该方法的第一个参数用于指定资源文件中的key。
c、在表单标签中，通过key属性指定资源文件中的key，如：
<s:textfield name="realname" key="user"/>
2)、输出带占位符的国际化信息
资源文件中的内容如下：
welcome={0}，欢迎您，您的IP：{1}
在jsp页面中的输出带占位符的国际化信息
<s:text name="welcome">
<s:param><s:property value="realname"/></s:param>
<s:param>学习</s:param>
</s:text>
在Action类中获取带占位符的国际化信息，可以使用getText(String key,String[] args)或getText(String aTextName,List args)方法。
2、配置包范围国际化资源文件
在一个大型应用中，整个应用有大量的内容需要实现国际化，如果我们把国际化的内容都放置在全局资源属性文件中，显然会导致资源文件变的过于庞大、臃肿，不便于维护，这个时候我们可以针对不同模块，使用包范围来组织国际化文件。
方法如下：
在java的包下放置package_language_country.properties资源文件，package为固定写法，处于该包及子包下的action都可以访问该资源。当查找指定key的消息时，系统会先从package资源文件查找，当找不到对应的key时，才会从常量struts.custom.i18n.resources指定的资源文件中寻找。
3、配置Action范围的国际化资源文件
为某个action单独指定资源文件，方法如下：
在Action类所在的路径，放置ActionClassName_language_country.properties资源文件，ActionClassName为action类的简单名称。
当查找指定key的消息时，系统会先从ActionClassName_language_country.properties资源文件查找，如果没有找到对应的key，就会沿着当前包往上查找基本名为package的资源文件，一直找到最顶层包。如果还没有找到对应的key，最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。
4、JSP中直接访问某个资源文件
struts2为我们提供了<s:i18n>标签，使用<s:i18n>标签我们可以在类路径下直接从某个资源文件中获取国际化数据，而无需任何配置：
<s:i18n name="rlcc">
<s:text name="welcome"/>
</s:i18n>
rlcc为类路径下资源文件的基本名。
如果要访问的资源文件在类路径的某个包下，可以这样访问：
<s:i18n name="com/rlcc/i18n/package">
<s:text name="welcome">
<s:param>ruilin</s:param>
</s:text>
</s:i18n>
上面访问com.rlcc.i18n包下基本名为package的资源文件。
493
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
