上传文件是很多Web程序都具有的功能。在Struts1.x中已经提供了用于上传文件的组件。而在Struts2中提供了一个更为容易操作的上传文件组件。所不同的是，Struts1.x的上传组件需要一个ActionForm来传递文件，而Struts2的上传组件是一个拦截器（这个拦截器不用配置，是自动装载的）。在本文中先介绍一下如何用struts2上传单个文件，最后介绍一下用struts2上传任意多个文件。

    要用Struts2实现上传单个文件的功能非常容易实现，只要使用普通的Action即可。但为了获得一些上传文件的信息，如上传文件名、上传文件类型以及上传文件的Stream对象，就需要按着一定规则来为Action类增加一些getter和setter方法。

    在Struts2中，用于获得和设置java.io.File对象（Struts2将文件上传到临时路径，并使用java.io.File打开这个临时文件）的方法是getUpload和setUpload。获得和设置文件名的方法是getUploadFileName和setUploadFileName，获得和设置上传文件内容类型的方法是getUploadContentType和setUploadContentType。下面是用于上传的动作类的完整代码：

    在execute方法中的实现代码就很简单了，只是从临时文件复制到指定的路径（在这里是d:\upload）中。上传文件的临时目录的默认值是javax.servlet.context.tempdir的值，但可以通过struts.properties（和struts.xml在同一个目录下）的struts.multipart.saveDir属性设置。Struts2上传文件的默认大小限制是2M（2097152字节），也可以通过struts.properties文件中的struts.multipart.maxSize修改，如struts.multipart.maxSize=2048 表示一次上传文件的总大小不能超过2K字节。

也可以在success.jsp页中通过<s:property>获得文件的属性（文件名和文件内容类型），代码如下：

    <s:property value="uploadFileName"/>

图1

    在本文中给出了用Struts2上传任意多个文件的一个方法，如果哪位读者有更好的方法，请跟贴！

    /** *//**
     * 过滤文件类型
     * @param types 系统所有允许上传的文件类型
     * @return 如果上传文件的文件类型允许上传，返回null，否则返回input字符串
     */

    public String filterType(String[] types) {
        // 取得上传文件的文件类型。
        String fileType = getUploadContentType();
        // 遍历
        for (String type : types) {
            if (type.equals(fileType)) {
                return null;
            }
        }
        return INPUT;
    }

运行图：

    上面方法判断了上传文件的文件类型是否在允许上传文件类型列表中。为了让应用程序可以动态配置允许上传的文件列表，为该Action增加了一个allowTypes的属性，该属性的值列出了所有允许上传的文件类型。为了可以在struts.xml文件中配置allowTypes属性的值，必须在Action类中提供如下代码：

    // 定义该Action允许上传的文件类型
    private String allowTypes;

    // allowTypes属性的setter和getter方法
    public String getAllowTypes() {
        return allowTypes;
    }

    public void setAllowTypes(String allowTypes) {
        this.allowTypes = allowTypes;
    }

下面就可以在是实现该Action的execute方法了，在通过该方法实现文件上传之前，应该先判断上传文件的文件类型是否允许上传，增加类型判断后的execute方法如下：

public String execute() throws Exception {
        // 将允许上传文件类型的字符串以英文逗号（,）分解成字符串数组。
        // 从而判断当前文件类型是否允许上传
        String filterResult = filterType(getAllowTypes().split(","));
        // 如果当前文件类型不允许上传
        if (filterResult != null) {
            ActionContext.getContext().put("typeError", "您要上传的文件类型不正确！");
            return filterResult;
        }

        // 以服务器的文件保存地址和原文件名建立上传文件输出流
        FileOutputStream fos = new FileOutputStream(getSavePath() + "\\"
                + getUploadFileName());
        // 以上传文件建立一个文件上传流
        FileInputStream fis = new FileInputStream(getUpload());
        // 将上传文件的内容写入服务器
        byte[] buffer = new byte[1024];
        int len = 0;
        while ((len = fis.read(buffer)) > 0) {
            fos.write(buffer, 0, len);
        }
        return SUCCESS;
    }

上面的Action类代码非常简单，它包含的execute方法先判断当前文件类型是否是允许上传的文件类型，如果该文件类型不允许上传，则返回input逻辑视图名；只有当该文件的类型是允许上传的文件类型时，才真正执行文件上传逻辑。
为了让文件类型检验失败时能返回input逻辑视图，因此必须为该Action增加input逻辑视图配置，
下面是该Action的配置文件代码。

<?xml version="1.0" encoding="UTF-8"?>
<!-- 指定Struts2配置文件的DTD信息 -->
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts>
 <!-- 指定国际化资源文件的baseName为globalMessages -->
 <constant name="struts.custom.i18n.resources" value="globalMessages"/>
 <!-- 设置该应用使用的解码集 -->
 <constant name="struts.i18n.encoding" value="GBK"/>
 <package name="lee" extends="struts-default">
  <!-- 配置处理文件上传的Action -->
  <action name="upload" class="lee.UploadAction">
   <!-- 通过动态设置allowTypes的属性来动态指定允许上传的文件类型 -->
             <param name="allowTypes">image/bmp,image/png,image/gif,image/jpeg</param>
   <!-- 动态设置Action的属性值 -->
             <param name="savePath">/upload</param>
   <!-- 配置Struts2默认的视图资源 -->
   <result>/succ.jsp</result> 
   <!-- 配置该应用的input逻辑视图 -->
   <result name="input"> /upload.jsp</result>
  </action>
 </package>
</struts>

    通过上面的配置看出，上面文件类型仅能上传各种类型的图片文件，如果试图上传其他类型的文件，系统将转入input逻辑视图，该逻辑视图就是upload.jsp页面，该页面中使用如下代码输出错误提示：
<!-- 使用表达式语言输出错误提示 -->

${requestScope.typeError}

如果试图上传非图片类型的文件，可以看到出错提示，提示用户不要上传非图片类型的文件
通过上面的介绍，我们可以更轻易地完成了文件类型的过滤。
如果需要实现文件大小过滤，与实现文件类型过滤的方法基本相似。虽然在上面的Action类中并没有方法直接获取上传文件的大小，但Action中包含了一个类型为File的属性，该属性封装了文件域对应的文件内容，而File类有一个length()方法，该方法可以返回文件的大小，通过比较该文件的大小和允许上传的文件大小，从而决定是否允许上传该文件。

 拦截器实现文件过滤

    上面手动实现文件过滤的方式虽然简单，但毕竟需要书写大量的过滤代码，不利于程序的高层次解构，而且开发复杂。
Struts2提供了一个文件上传的拦截器，通过配置该拦截器可以更轻松的实现文件过滤。Struts2中文件上传的过滤器是fileUpload，为了让该拦截器起作用，只需要在该Action配置该拦截器引用即可。

配置fileUpload拦截器时，可以为其指定两个参数：
allowedTypes：该参数指定允许上传的文件类型，多个文件类型之间以英文逗号（,）隔开。
maximumSize：该参数指定允许上传的文件大小，单位是字节。

    通过配置fileUpload的拦截器，可以更轻易的实现文件过滤，当文件过滤失败后，系统自动转入input逻辑视图，因此必须为该Action配置名为input的逻辑视图。除此之外，还必须显式地为该Action配置defaultStack的拦截器引用。
通过拦截器来实现文件过滤的配置文件如下：

<?xml version="1.0" encoding="UTF-8"?>
<!-- 指定Struts2配置文件的DTD信息 -->
<!DOCTYPE struts PUBLIC
    "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
    "http://struts.apache.org/dtds/struts-2.0.dtd"> 
<struts>
 <!-- 指定国际化资源文件的baseName为globalMessages -->
 <constant name="struts.custom.i18n.resources" value="globalMessages"/>
 <!-- 设置该应用使用的解码集 -->
 <constant name="struts.i18n.encoding" value="GBK"/>
 <package name="lee" extends="struts-default">
  <!-- 配置处理文件上传的Action -->
  <action name="upload" class="lee.UploadAction">
   <!-- 配置fileUpload的拦截器 -->
             <interceptor-ref name="fileUpload">
    <!-- 配置允许上传的文件类型 -->
                 <param name="allowedTypes">image/bmp,image/png,image/gif,image/jpeg</param>
    <!-- 配置允许上传的文件大小 -->
                 <param name="maximumSize">2000</param> 
             </interceptor-ref> 
             <interceptor-ref name="defaultStack"/>
   <!-- 动态设置Action的属性值 -->
             <param name="savePath">/upload</param>
   <!-- 配置Struts2默认的视图资源 -->
   <result>/succ.jsp</result> 
   <!-- 配置该应用的input逻辑视图 -->
   <result name="input">/upload.jsp</result>
  </action>
 </package>
</struts>

上面的拦截器过滤不仅过滤了文件的类型，也过滤了文件大小。上传文件的类型只能是图片文件，且文件大小不能大于2000字节（当然，我们随时可以更改到更大）。如果我们上传文件的文件太大，系统将转入input的逻辑视图，也就是/upload.jsp页面。

其实，Struts 1.x在此部分已经做得相当不错了。它极大地简化了我们程序员在做国际化时所需的工作，例如，如果您要输出一条国际化的信息，只需在代码包中加入FILE-NAME_xx_XX.properties（其中FILE-NAME为默认资源文件的文件名），然后在struts-config.xml中指明其路径，再在页面用<bean:message>标志输出即可。

不过，所谓“没有最好，只有更好”。Struts 2.0并没有在这部分止步，而是在原有的简单易用的基础上，将其做得更灵活、更强大。

国际化Hello World

下面让我们看一个例子——HelloWorld。这个例子演示如何根据用户浏览器的设置输出相应的HelloWorld。

1. 在Eclipse创建工程配置开发和运行环境（如果对这个步骤有问题，可以参考我早前的文章《为Struts 2.0做好准备》）。
   
2. 在src文件夹中加入struts.properties文件，内容如下：
   
   struts.custom.i18n.resources=globalMessages

   Struts 2.0有两个配置文件，struts.xml和struts.properties都是放在WEB-INF/classes/下。 struts.xml用于应用程序相关的配置 struts.properties用于Struts 2.0的运行时（Runtime）的配置

3. 在src文件夹中加入globalMessages_en_US.properties文件，内容如下：
   
   HelloWorld=Hello World!
4. 在src文件夹中加入globalMessages_zh_CN.properties文件，内容如下：
   
   HelloWorld=你好，世界！

   在此想和大家分享一个不错的编写properties文件的Eclipse插件（plugin），有了它我们在编辑一些简体中文、繁体中文等Unicode文本时，就不必再使用native2ascii编码了。您可以通过Eclipse中的软件升级（Software Update）安装此插件，步骤如下： 1、展开Eclipse的Help菜单，将鼠标移到Software Update子项，在出现的子菜单中点击Find and Install； 2、在Install/Update对话框中选择Search for new features to install，点击Next； 3、在Install对话框中点击New Remote Site； 4、在New Update Site对话框的Name填入“PropEdit”或其它任意非空字符串，在URL中填入http://propedit.sourceforge.jp/eclipse/updates/； 5、在Site to include to search列表中，除上一步加入的site外的其它选项去掉，点击Finsih； 6、在弹出的Updates对话框中的Select the features to install列表中将所有结尾为“3.1.x”的选项去掉（适用于Eclipse 3.2版本的朋友）； 7、点击Finish关闭对话框； 8、在下载后，同意安装，再按提示重启Eclipse，在工具条看到形似vi的按钮表示安装成功，插件可用。此时，Eclpise中所有properties文件的文件名前有绿色的P的图标作为标识。

5. 在WebContent文件夹下加入HelloWorl.jsp文件，内容如下：
   
   <%@ page  contentType="text/html; charset=UTF-8"%>
   <%@taglib prefix="s" uri="/struts-tags"%>
   <html>
   <head>
       <title>Hello World</title>
   </head>
   <body>
       <h2><s:text name="HelloWorld"/></h2>
       <h2><s:property value="%{getText('HelloWorld')}"/></h2>
   </body>
   </html>
6. 发布运行应用程序，在浏览器地址栏中输入http://localhost:8080/Struts2_i18n/HelloWorld.jsp ，出现图1所示页面。
   
   图1 中文输出
7. 将浏览器的默认语言改为“英语（美国）”，刷新页面，出现图2所示页面。
   
   图2 英文输出

资源文件查找顺序

之所以说Struts 2.0的国际化更灵活是因为它可以能根据不同需要配置和获取资源（properties）文件。在Struts 2.0中有下面几种方法：

1. 使用全局的资源文件，方法如上例所示。这适用于遍布于整个应用程序的国际化字符串，它们在不同的包（package）中被引用，如一些比较共用的出错提示；
2. 使用包范围内的资源文件。做法是在包的根目录下新建名的package.properties和package_xx_XX.properties文件。这就适用于在包中不同类访问的资源；
3. 使用Action范围的资源文件。做法为Action的包下新建文件名（除文件扩展名外）与Action类名同样的资源文件。它只能在该Action中访问。如此一来，我们就可以在不同的Action里使用相同的properties名表示不同的值。例如，在ActonOne中title为“动作一”，而同样用title在ActionTwo表示“动作二”，节省一些命名工夫；
4. 使用<s:i18n>标志访问特定路径的properties文件。使用方法请参考我早前的文章《常用的Struts 2.0的标志（Tag）介绍》。在您使用这一方法时，请注意<s:i18n>标志的范围。在<s:i18n name="xxxxx">到</s:i18n>之间，所有的国际化字符串都会在名为xxxxx资源文件查找，如果找不到，Struts 2.0就会输出默认值（国际化字符串的名字）。

上面我列举了四种配置和访问资源的方法，它们的范围分别是从大到小，而Struts 2.0在查找国际化字符串所遵循的是特定的顺序，如图3所示：

假设我们在某个ChildAction中调用了getText("user.title")，Struts 2.0的将会执行以下的操作：

1. 查找ChildAction_xx_XX.properties文件或ChildAction.properties；
2. 查找ChildAction实现的接口，查找与接口同名的资源文件MyInterface.properties；
3. 查找ChildAction的父类ParentAction的properties文件，文件名为ParentAction.properties；
4. 判断当前ChildAction是否实现接口ModelDriven。如果是，调用getModel()获得对象，查找与其同名的资源文件；
5. 查找当前包下的package.properties文件；
6. 查找当前包的父包，直到最顶层包；
7. 在值栈（Value Stack）中，查找名为user的属性，转到user类型同名的资源文件，查找键为title的资源;
8. 查找在struts.properties配置的默认的资源文件，参考例1;
9. 输出user.title。

参数化国际化字符串

许多情况下，我们都需要在动行时（runtime）为国际化字符插入一些参数，例如在输入验证提示信息的时候。在Struts 2.0中，我们通过以下两种方法做到这点：

1. 在资源文件的国际化字符串中使用OGNL，格式为${表达式}，例如：
   
   validation.require=${getText(fileName)} is required
2. 使用java.text.MessageFormat中的字符串格式，格式为{ 参数序号（从0开始）, 格式类形（number | date | time | choice）, 格式样式}，例如：
   
   validation.between=Date must between {0, date, short} and {1, date, short}

1. 使用标志的value0、value1...valueN的属性，如：
   
   <s:text name="validation.required" value0="User Name"/>
2. 使用param子元素，这些param将按先后顺序，代入到国际化字符串的参数中，例如：
   
   <s:text name="validation.required">
      <s:param value="User Name"/>
   </s:text>

让用户方便地选择语言

开发国际化的应用程序时，有一个功能是必不可少的——让用户快捷地选择或切换语言。在Struts 2.0中，通过ActionContext.getContext().setLocale(Locale arg)可以设置用户的默认语言。不过，由于这是一个比较普遍的应用场景（Scenario），所以Struts 2.0为您提供了一个名i18n的拦截器（Interceptor），并在默认情况下将其注册到拦截器链（Interceptor chain）中。它的原理为在执行Action方法前，i18n拦截器查找请求中的一个名为"request_locale"的参数。如果其存在，拦截器就将其作为参数实例化Locale对象，并将其设为用户默认的区域（Locale），最后，将此Locale对象保存在session的名为“WW_TRANS_I18N_LOCALE”的属性中。

下面，我将提供一完整示例演示它的使用方法。

package tutorial;

import java.util.Hashtable;
import java.util.Locale;
import java.util.Map;

publicclass Locales {
   public Map<String, Locale> getLocales() {
       Map<String, Locale> locales =new Hashtable<String, Locale>(2);
       locales.put("American English", Locale.US);
       locales.put("Simplified Chinese", Locale.CHINA);
       return locales;
   }
}

上述代码的原理为，LangSelector.jsp先实例化一个Locales对象，并把对象的Map类型的属性locales赋予下拉列表（select） 。如此一来，下拉列表就获得可用语言的列表。大家看到LangSelector有<s:form>标志和一段Javascript脚本，它们的作用就是在用户在下拉列表中选择了后，提交包含“reqeust_locale”变量的表单到Action。在打开页面时，为了下拉列表的选中的当前区域，我们需要到session取得当前区域（键为“WW_TRANS_I18N_LOCALE”的属性），而该属性在没有设置语言前是为空的，所以通过值栈中locale属性来取得当前区域（用户浏览器所设置的语言）。

可能大家会问为什么一定要通过Action来访问页面呢？ 你可以试一下不用Action而直接用JSP的地址来访问页面，结果会是无论你在下拉列表中选择什么，语言都不会改变。这表示不能正常运行的。其原因为如果直接使用JSP访问页面，Struts 2.0在web.xml的配置的过滤器（Filter）就不会工作，所以拦截器链也不会工作。

注意: 所有的webwork内建的Result类型都实现了com.opensymphony.xwork.Result接口. 这个接口是所有action执行结果的通用接口,不管这个结果是用来显示一个网页还是产生一个email,发送一个JMS消息,等.

Result类型配置中定义了一些类,把它们映射为action配置中可以引用的名字. 也就是为这些类创建便于记忆的键-值对.

...
<result-types>
<result-type name="dispatcher" class="com.opensymphony.webwork.dispatcher.ServletDispatcherResult" default="true"/>
<result-type name="redirect" class="com.opensymphony.webwork.dispatcher.ServletRedirectResult"/>
<result-type name="velocity" class="com.opensymphony.webwork.dispatcher.VelocityResult"/>
<result-type name="chain" class="com.opensymphony.xwork.ActionChainResult"/>
<result-type name="xslt" class="com.opensymphony.webwork.views.xslt.XSLTResult"/>
<result-type name="jasper" class="com.opensymphony.webwork.views.jasperreports.JasperReportsResult"/>
<result-type name="freemarker" class="com.opensymphony.webwork.views.freemarker.FreemarkerResult"/>
<result-type name="httpheader" class="com.opensymphony.webwork.dispatcher.HttpHeaderResult"/>
<result-type name="stream" class="com.opensymphony.webwork.dispatcher.StreamResult"/>
<result-type name="plaintext" class="com.opensymphony.webwork.dispatcher.PlainTextResult" />
</result-types>
...

<include file="webwork-default.xml"/>
<package name="myPackage" extends="default">
<action name="bar" class="myPackage.barAction">
<!-- default result type is "dispatcher" -->
<!-- default result name is "success" -->
<result>foo.jsp</result>
<result name="error">error.jsp</result>
</result>
</action>
</package>

Result类型

Webwork提供了一些com.opensymphony.xwork.Result接口的实现来使你的action可以容易的用户交互.这些Result类型包括:

• Chain Result - 用于 Action Chaining
• Dispatcher Result - 用于 JSP 整合
• FreeMarker Result - 用于 FreeMarker 整合
• HttpHeader Result - 用于控制特殊的HTTP行为
• JasperReports Result - 用于 JasperReports 整合
• Redirect Result - 用于直接跳转到例外的URL
• Redirect Action Result - 用于直接跳转到另外的action
• Stream Result - 用于向浏览器返回一个InputStream (一般用于文件下载)
• Velocity Result - 用于 Velocity 整合
• XSL Result - 用于 XML/XSLT 整合
• PlainText Result - 用于显示某个页面的原始的文本 (例如 jsp, html 等)

Result定义在xwork xml配置文件(xwork.xml)中的action标签里。如果location参数是result标签的唯一的参数，你可以这样简化:

<action name="bar" class="myPackage.barAction">
<result name="success" type="dispatcher">
<param name="location">foo.jsp</param>
</result>
</action>

或者

<action name="bar" class="myPackage.barAction">
<result name="success" type="dispatcher">foo.jsp</result>
</action>

如果你扩展了webwork-default.xml, 那么默认的返回类型是"dispatcher". 同样,如果你没有指定result的名字,默认将是"success". 就是说你可以如下简化:

<action name="bar" class="myPackage.barAction">
<result>foo.jsp</result>
</action>

注意 : Parse属性允许的location参数作为表达式.例如你可以这样用:

<result name="success" type="redirect">/displayCart.action?userId=${userId}</result>

注意 : 你也可以指定全局Result以便在多个action中使用. 当要为很多不同的action添加相同的结果是这样会节省时间. Result标签和全局Result的更多信息,参见Result配置部分.

• commons-logging-1.0.4.jar
• freemarker-2.3.8.jar
• ognl-2.6.11.jar
• struts2-core-2.0.11.jar
• xwork-2.0.4.jar

            要获得上述对象，关键Struts 2中com.opensymphony.xwork2.ActionContext类。我们可以通过它的静态方法getContext()获取当前Action的上下文对象。有了这个对象我们想获得其他几个对象就好办了

            ActionContext ctx = ActionContext.getContext();     Map session = ctx.getSession();     细心的朋友可以发现这里的session是个map对象在Struts2中底层的session都被封装成了Map类型我们可以直接操作这个map 进行对session的写入和读取操作而不用去直接操作HttpSession对象

            另外，org.apache.struts2.ServletActionContext作为辅助类（Helper Class），可以帮助您快捷地获得这几个对象。

            HttpServletRequest request = ServletActionContext.getRequest();     HttpServletResponse response = ServletActionContext.getResponse();     HttpSession session = request.getSession();     如果你只是想访问session的属性（Attribute），你也可以通过ActionContext.getContext().getSession()获取或添加session范围（Scoped）的对象。

            2、IoC方式（这种方式在tapestry中也是这样实现的）     要使用IoC方式，我们首先要告诉IoC容器（Container）想取得某个对象的意愿，通过实现相应的接口做到这点。具体实现

 1public class IoCServlet extends ActionSupport implements SessionAware,
 2        ServletRequestAware, ServletResponseAware {
 3    private String message;
 4    private Map att;
 5    private HttpServletRequest request;
 6    private HttpServletResponse response;
 7
 8    public String getMessage() {
 9        return message;
10    }
11
12    publicvoid setSession(Map att) {
13        this.att = att;
14    }
15
16    publicvoid setServletRequest(HttpServletRequest request) {
17        this.request = request;
18    }
19
20    publicvoid setServletResponse(HttpServletResponse response) {
21        this.response = response;
22    }
23
24    public String execute() {
25        att.put("msg", "Hello World from Session!");
26
27        HttpSession session = request.getSession();
28
29        StringBuffer sb = new StringBuffer("Message from request: ");
30        sb.append(request.getParameter("msg"));
31        sb.append("     Response Buffer Size: ");
32        sb.append(response.getBufferSize());
33        sb.append("     Session ID: ");
34        sb.append(session.getId());
35
36        message = sb.toString();
37        return SUCCESS;
38    }
39}

            在struts.xml的action中配置拦截器     <interceptor-ref name="servletConfig"></interceptor-ref>

<s:radio list=""></s:radio>-----单选按钮
<s:reset></s:reset>-----重置按钮