一、从1.X升级到2.X需要做以下事情：
1、改变你的taglib声明中的URI。
 <% at taglib uri="http://struts-menu.sf.net/tag" prefix="menu" %>
2、改变<plug-in>,使用新的包名"net.sf.navigator." 。
 <plug-in className="net.sf.navigator.menu.MenuPlugIn">
3、改变你的menu-config.xml文件，使用新的包名"net.sf.navigator." 。
 <Displayer name="Simple"
   type="net.sf.navigator.displayer.SimpleMenuDisplayer"/>

二、快速开始：
1、下载最新的struts-menu版本；
2、解包到本地目录；
3、下载Tomcat或者其它Servlet容器；
4、把struts-menu.war包放入Tomcat安装目录的wabapps目录下，并重启Tomcat服务。
5、打开htpp://localhost:8080/struts-menu/

三、把Struts Menu整合到你的应用程序中：
Struts Menu能够被轻易的整合到你的Struts应用程序中，它也可以整合到一个非Struts的应用程序中，但是我不喜欢这样做，所以在此没有提供相应的教程。这里将一步步的带你整合这个标签库。
你需要把struts-menu.jar放到你的WEB-INF/lib目录下。然后使用URI标签声明你的JSP文件中想使用的这个标签库。
如果使用Struts Menu 2.1，你还需要 Jakarta's Standard Tag Library JAR包放入你的WEB-INF/lib目录下。下载地址：http://ibiblio.org/maven/taglibs/jars/standard-1.0.4.jar，这个文件包括例程WAR包文件和二进制发布包。
1、放入struts-menu.jar包到你的应用程序的WEB-INF/lib目录中。
2、在你的struts-config.xml文件中加入plug-in设置。
 <plug-in className="net.sf.navigator.menu.MenuPlugIn">
   <set-property property="menuConfig"
     value="/WEB-INF/menu-config.xml"/>
 </plug-in>
3、你将需要在你的应用程序的/WEB-INF/menu-config.xml文件中定义你的菜单，这里提供一个简单的片断：
 <Menu name="contactMenu" title="Contact" location="?Contact">
   <Item name="email" title="E-Mail" location="?EMail"/>
   <Item name="phone" title="Phone" location="?Phone"/>
 </Menu>
　　更多全面的例程，请查看应用程序的web/WEB-INF目录中的menu-config.xml文件，你可以截取一段作为你需要的菜单。完整的属性列表，可以查看MenuBase class's javadocs（http://struts-menu.source......avigator/menu/MenuBase.html）。
4、在你的JSP文件的顶部加入taglib声明：
 <% at taglib uri="http://struts-menu.sf.net/tag" prefix="menu" %>
5、在你的JSP文件中要放置菜单的位置加入taglib代码：
 <menu:useMenuDisplayer name="TabbedMenu"
   bundle="org.apache.struts.action.MESSAGE">
   <menu:displayMenu name="Home"/>
   <menu:displayMenu name="About"/>
 </menu:useMenuDisplayer>
　　属性name="TabbedMenu"被定义在menu-config.xml文件的顶部：
 <Displayer name="TabbedMenu"
   type="net.sf.navigator.displayer.TabbedMenuDisplayer"/>

(译注：其实到此步即可在你的JSP文件中添加相应的菜单了，只不过是没有结合Velocity。在menu-config.xml文件的头部可以定义多个Displayer，每个Displayer都有name和type属性，name属性与JSP文件中menu:useMenuDisplayer标签的name属性相对应，即表明使用何种样式，具体的样式定义便在type属性中定义，type属性中是一个class。在menu-config.xml文件中的菜单定义中的name属性则与JSP文件中的menu:displayMenu标签的name属性相对应。)

使用定制的Velocity模版实施你的菜单，你需要整合Velocity到你的WEB应用程序中。如果需要这样做的话，请完成下面的步骤：
1、确定你的menu-config.xml文件有“Velocity”的displayer定义：
 <Displayer name="Velocity"
     type="net.sf.navigator.displayer.VelocityMenuDisplayer"/>
2、加入Velocity的JARs包到你的WEB-INF/lib目录中，下载velocity-1.4-rc1.jar（http://www.ibiblio.org/ma......y/jars/velocity-1.4-rc1.jar）和velocity-tools-view-1.0.jar（http://www.ibiblio.org/ma......velocity-tools-view-1.0.jar）。
3、加入globalMacros.vm（http://cvs.sourceforge.net/viewcvs.py/*checkout*/struts-menu/navigator/web/WEB-INF/classes/globalMacros.vm?content-type=text%2Fplain&rev=1.1（右键另存为））到你的WEB-INF/lib目录中。
4、改变你的JSP文件中displayer的值为“Velocity”，“config”属性指向一个文件（如config="/templates/tabs.html"）或者如果tabs.htm在你的WEB-INF/classes目录中的话，则可设config="tabs.html"。

这里提供了一些使用Velocity的displayer例子，可在sample application（http://demo.raibledesigns.com/struts-menu/index.jsp）中查看。它总是在你的菜单需要的时候显示CSS，JavaScript和图像文件。下面有一些在当前的Struts Menu中用到的Velocity模版的例子的链接：
 CoolMenus: Demo（http://demo.raibledesigns......menu/velocity-coolmenu4.jsp）,
  　 Template（http://struts-menu.sourceforge.net/templates/coolmenus.html）
 NiceTabs: Demo, Template
 Tabs: Demo, Template
 XTree: Demo, Template

所有相关的有用的文件如果你需要的话都可以在下面的站点上下载：
 Images （http://struts-menu.sourceforge.net/menu-images/）
 Stylesheets （http://struts-menu.sourceforge.net/styles/）
 Scripts （http://struts-menu.sourceforge.net/scripts/）
 Templates （http://struts-menu.sourceforge.net/templates/）

更多的基于roles的显示/隐藏菜单的信息，请查看FAQs（http://struts-menu.sourceforge.net/faq.html）。

四、在Struts之外使用Struts Menu:
在2.2版中，Menu Repository能够使用MenuContextListener载入：
 <!--
    - Loads the menu-config.xml for struts-menu at startup,
    - by default from "/WEB-INF/menu-config.xml".
    - To override this, add a context-param named "menuConfigLocation"
    - web.xml file.
    -->
 <listener>
     <listener-class>net.sf.navigator.menu.MenuContextListener</listener-class>
 </listener>

或者如果你使用Spring，甚至更容易。仅仅需要加入下面的部分到你的applicationContext.xml文件中：
 <bean id="menu" class="net.sf.navigator.menu.MenuLoader">
   <property name="menuConfig">
     <value>/WEB-INF/menu-config.xml</value>
   </property>
 </bean>
 <!-- The menuConfig property is an optional attribute.  It is set to
     /WEB-INF/menu-config.xml by default. -->
感谢Dan Luputan提供MenuLoader类的源代码。

五、从源文件编译：
要从源文件编译这个项目，执行下面的步骤：
1、下载并安装Maven（http://maven.apache.org/）；
2、创建一个环境变量MAVEN＿HOME指出你的Maven的安装目录，然后添加$MAVEN_HOME/bin到你的PATH变量中；
3、操纵这个目录你可以扩展源代码，执行“maven.jar”创建target/struts-menu.jar。

要展开struts-menu例程，需要下面的步骤：
1、下载和安装Tomcat；
2、创建一个环境变量CATALINA＿HOME指出你的Tomcat的安装目录；
3、执行“maven deploy”把应用程序展开到Tomcat中；
4、打开http://localhost:8080/struts-menu在你喜爱的浏览器中。

如果你喜欢使用Eclipse开发项目，请参考此份开发向导（http://struts-menu.sourceforge.net/devguide.html）。

 Struts 2为大家提供了不少常用的很酷的表单标志，简化了我们程序员的工作。不过，由于这些都是新标志，大家可能在使用上还存在不少疑问。本文将就朋友们的回复、留言或Email上的问题，分别对这些酷标志进行讲述。

表单标志使用小技巧

Struts 2的表单标志在输出（render）HTML时，使用了模板的概念，增加了复杂性（因为它不像Struts 1.x的表单标志，它通常都是一个标志对应HTML的一个元素），因此大家在使用时，需要一些技巧：

1. Struts 2的UI标志的表单标志默认是以表格布局，按钮是右对齐的。如果你不喜欢此风格，你可以简单地将<s:form />标志的“theme”属性设为“simple”，然后用以往的做法自已布局表单元素（注意：此法有利有弊，弊就是当你将“theme”属性设为“simple”时，表单标志以最简单方式输出HTML，所以你可能失去一些默认输出提供的便利，如：友好的错误信息的显示，或客户端的表单验证等）。当然更好的做法是通过CSS或自定义主题（theme）然后应用到整个应用程序，这样可以获得一致的页面风格，加强用户体验（我会在以后的文章对此进行讲解）；
2. 当你在页面上加入某些标志（如：<s:doubleselect />等）时，应该通过action来访问页面，而不是通过*.jsp的URL直接访问。

下面我将分别对这些标志进行讲述：

1、<s:checkboxlist />

大家对<s:checkboxlist />的最大的疑问可能是：“如何在默认情况下，选中某些checkbox？”

答案其实很简单，只需要将其“value”属性设为你的要选中的值，如以代码所示：

分布运行应用程序，在浏览器中键入：http://localhost:8080/Struts2_CoolTags/checkboxlist.jsp，出现如下图所示页面：

清单2 checkboxlist.jsp页面

2、<s:doubleselect />

大家看Struts 2的showcase的例子，<s:doubleselect />的用法如下所示：

很多朋友问：“上面的‘list’属性只有两个值，如果我有三个或更多的值，‘doublelist’属性应该如何设定呢？”

我建议的做法是先定义一个Map类型的对象，键为“list”的集合，值则为“doubleList”的集合，然后“doubleList”的OGNL写成“#myMap[top]”，如以下代码所示：

分布运行应用程序，在浏览器中键入：http://localhost:8080/Struts2_CoolTags/doubleselect.action，出现如下图所示页面：

清单5 doubleselect.jsp页面

3、<s: token />

这个标志可能大家不常用，不过本人认为它还是挺有用的。在使用Struts 1.x时，因为跳转通常是用Forward（而不是Redirect）实现的，所以当用户完成请求后，按“F5”刷新页面时，就会重新提交上次的请求，这样经常会出错。要解决这个问题，<s:token />可以帮你忙。

实现原理

在页面加载时，<s: token />产生一个GUID（Globally Unique Identifier，全局唯一标识符）值的隐藏输入框如：

同时，将GUID放到会话（session）中；在执行action之前，“token”拦截器将会话token与请求token比较，如果两者相同，则将会话中的token删除并往下执行，否则向actionErrors加入错误信息。如此一来，如果用户通过某种手段提交了两次相同的请求，两个token就会不同。

具体实现

首先看一下Action的代码：

package tutorial;

import com.opensymphony.xwork2.ActionSupport;

public class CoolTagAction extends ActionSupport {    
   private static final long serialVersionUID = 6820659617470261780L;
   
   private String message;
       
   public String getMessage() {
       return message;
   }

   public void setMessage(String message) {
       this.message = message;
   }
   
   @Override
   public String execute() {
       System.out.println("Executing action, your message is " + message);
       return SUCCESS;
   }    
}

以上代码一目了然，再看看JSP的写法：

JSP也很简单，就是加入<s:token />标志。接下来是Actoin配置的XML片段：

以上XML片段值注意的是加入了“token”拦截器和“invalid.token”结果，因为“token”拦截器在会话token与请求token不一致时，将会直接返回“invalid.token”结果。

发布运行应用程序，在浏览器中键入：http://localhost:8080/Struts2_CoolTags/token.jsp，出现如下图所示页面：

清单10 正常显示的token.jsp页面

随便填点东西并提交页面，一切正常返回以上页面，然后按“F5”刷新页面，在弹出的对话框中点击“Retry”，出现如下图所示页面：

清单11 重复提交出错显示

4、<s:datetimepicker />、<s:optiontransferselect />和<s:updownselect />

这几个标志的使用相对简单，所以我想小举一例即可，以下是JSP的代码：

发布运行应用程序，在浏览器中键入：http://localhost:8080/Struts2_CoolTags/others.jsp，出现如下图所示页面：

清单13 其它表单标志页面

总结

Struts 2在标志上的确比Struts 1.x丰富了许多，同时模板机制也给程序员带来不少方便（如果你不太喜欢个性化的风格）。另外，Struts 2还有一些AJAX（如<s: autocompleter />等）的标志和非表单的UI标志（如<s: tree />等），我会在以后的文章中讲述其使用。

Struts2提供了对不同种类返回结果的支持，常见的有JSP，FreeMarker，Velocity等。

Struts2支持的不同类型的返回结果为：

名字	说明
Chain Result	用来处理Action链
Dispatcher Result	用来转向页面，通常处理JSP
FreeMarker Result	处理FreeMarker模板
HttpHeader Result	用来控制特殊的Http行为
Redirect Result	重定向到一个URL
Redirect Action Result	重定向到一个Action
Stream Result	向浏览器发送InputSream对象，通常用来处理文件下载
Velocity Result	处理Velocity模板
XLS Result	处理XML/XLST模板
PlainText Result	显示原始文件内容，例如文件源代码
S2PLUGINS:Tiles Result	结合Tile使用

另外第三方的Result类型还包括JasperReports Plugin，专门用来处理JasperReport类型的报表输出。

在struts-default.xml文件中已经有了对于所有类型Result的定义：

<result-types>

    <result-type name="chain"

             class="com.opensymphony.xwork2.ActionChainResult"/>

    <result-type name="dispatcher"

             class="org.apache.struts2.dispatcher.ServletDispatcherResult"

             default="true"/>

    <result-type name="freemarker"

             class="org.apache.struts2.views.freemarker.FreemarkerResult"/>

    <result-type name="httpheader"

             class="org.apache.struts2.dispatcher.HttpHeaderResult"/>

    <result-type name="redirect"

             class="org.apache.struts2.dispatcher.ServletRedirectResult"/>

    <result-type name="redirectAction"

             class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>

    <result-type name="stream"

             class="org.apache.struts2.dispatcher.StreamResult"/>

    <result-type name="velocity"

             class="org.apache.struts2.dispatcher.VelocityResult"/>

    <result-type name="xslt"

             class="org.apache.struts2.views.xslt.XSLTResult"/>

    <result-type name="plainText"

             class="org.apache.struts2.dispatcher.PlainTextResult" />

    <!-- Deprecated name form scheduled for removal in Struts 2.1.0.

         The camelCase versions are preferred. See ww-1707 -->

    <result-type name="redirect-action"

             class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/>

    <result-type name="plaintext"

             class="org.apache.struts2.dispatcher.PlainTextResult" />

</result-types>

从上述代码中可以看出在不指定Result类型的时候使用dispatcher类型。

定义一个Result值，

<result name="success" type="dispatcher">

    <param name="location">/ThankYou.jsp</param>

</result>

由于type默认值是dispatcher，所以这里不需要定义，另外name的默认值为success所以这里也不需要定义。

上述代码可以简写为：

<result>

    <param name="location">/ThankYou.jsp</param>

</result>

另外location参数也可以直接卸载result标签内部，所以上述代码的最简单的写法为：

<result>/ThankYou.jsp</result>

我们也可以定义多个不同的Result

<action name="Hello">

 <result>/hello/Result.jsp</result>

 <result name="error">/hello/Error.jsp</result>

 <result name="input">/hello/Input.jsp</result>

</action>

上述代码的含义为，名字为Hello的Action有三个返回结果，并且都是dispatcher类型（默认类型），这三个返回值的名字分别为success（默认值），error，input，对应的页面的路径分别为/hello/Result.jsp，/hello/Error.jsp，/hello/Input.jsp。

有些时候我们需要一个定义在全局的Result，这个时候我们可以在package内部定义全局的Result，例如：

<global-results>

 <result name="error">/Error.jsp</result>

 <result name="invalid.token">/Error.jsp</result>

 <result name="login" type="redirect-action">Logon!input</result>

</global-results>

动态返回结果

有些时候，只有当Action执行完璧的时候我们才知道要返回哪个结果，这个时候我们可以在Action内部定义一个属性，这个属性用来存储Action执行完璧之后的Result值，例如：

private String nextAction; 

public String getNextAction() {

    return nextAction;

}

在strutx.xml配置文件中，我们可以使用${nextAction}来引用到Action中的属性，通过${nextAction}表示的内容来动态的返回结果，例如：

<action name="fragment" class="FragmentAction">

 <result name="next" type="redirect-action">${nextAction}</result>

</action>

上述Action的execute方法返回next的时候，还需要根据nextAction的属性来判断具体定位到哪个Action。

在strutx.xml配置文件中，我们可以使用method=""来设置调用类的哪个方法，这样就可以在一个JAVA类中使用不同的方法来实现不同的功能,就无需每个功能写一类了,例如：

<action name="fragment" class="FragmentAction" method="add">

      <result>/success.jsp</result>

</action>

表达式语言主要有以下几大好处：

避免(MyType) request.getAttribute()和myBean.getMyProperty()之类的语句，使页面更简洁；
支持运算符（如+-*/），比普通的标志具有更高的自由度和更强的功能；
简单明了地表达代码逻辑，使用代码更可读与便于维护。
Struts 2中的表达式语言
Struts 2支持以下几种表达式语言：

OGNL（Object-Graph Navigation Language），可以方便地操作对象属性的开源表达式语言；
JSTL（JSP Standard Tag Library），JSP 2.0集成的标准的表达式语言；
Groovy，基于Java平台的动态语言，它具有时下比较流行的动态语言（如Python、Ruby和Smarttalk等）的一些起特性；
Velocity，严格来说不是表达式语言，它是一种基于Java的模板匹配引擎，具说其性能要比JSP好。
Struts 2默认的表达式语言是OGNL，原因是它相对其它表达式语言具有下面几大优势：

支持对象方法调用，如xxx.doSomeSpecial()；
支持类静态的方法调用和值访问，表达式的格式为@[类全名（包括包路径）]@[方法名 |   值名]，例如：@java.lang.String@format('foo %s', 'bar')或@tutorial.MyConstant@APP_NAME；
支持赋值操作和表达式串联，如price=100, discount=0.8, calculatePrice()，这个表达式会返回80；
访问OGNL上下文（OGNL context）和ActionContext；
操作集合对象。
OGNL的用法
OGNL是通常要结合Struts 2的标志一起使用，如<s:property value="xx" />等。大家经常遇到的问题是#、%和$这三个符号的使用。下面我想通过例子讲述这个问题：

首先新建名为Struts2_OGNL的Web工程，配置开发环境。之前很多朋友在使用Struts 2的过程中都遇到乱码问题。当然乱码问题由来已久，而且涉及多方面的知识，所以并非三言两语可以说明白，而且互联网上也已经有很多这方便的文章，大家可以Google一下。不过，如果你在开发的过程，多注意一下，避免乱码问题也不难。乱码多数是由于编码与解码所使用的方式不同造成的，所以我建议大家将编码方式都设为“utf-8”，如<%@   page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>。另外，在配置web.xml时使用ActionContextCleanUp过滤器（Filter），如下面代码所示：

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_9" version="2.4"
     xmlns="http://java.sun.com/xml/ns/j2ee"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

     <display-name>Struts 2 OGNL</display-name>
    
     <filter>
         <filter-name>struts-cleanup</filter-name>
         <filter-class>
             org.apache.struts2.dispatcher.ActionContextCleanUp
         </filter-class>
     </filter>
    
     <filter-mapping>
         <filter-name>struts-cleanup</filter-name>
         <url-pattern>/*</url-pattern>
     </filter-mapping>
    
     <filter>
         <filter-name>struts2</filter-name>
         <filter-class>
             org.apache.struts2.dispatcher.FilterDispatcher
         </filter-class>
     </filter>

     <filter-mapping>
         <filter-name>struts2</filter-name>
         <url-pattern>/*</url-pattern>
     </filter-mapping>

     <welcome-file-list>
         <welcome-file>index.html</welcome-file>
     </welcome-file-list>

</web-app>清单1 WebContent/WEB-INF/web.xml
“#”主要有三种用途：

访问OGNL上下文和Action上下文，#相当于ActionContext.getContext()；下表有几个ActionContext中有用的属性：   名称 作用 例子
parameters 包含当前HTTP请求参数的Map #parameters.id[0]作用相当于request.getParameter("id")
request 包含当前HttpServletRequest的属性（attribute)的Map #request.userName相当于request.getAttribute("userName")
session 包含当前HttpSession的属性（attribute）的Map #session.userName相当于session.getAttribute("userName")
application 包含当前应用的ServletContext的属性（attribute）的Map #application.userName相当于application.getAttribute("userName")
attr 用于按request > session > application顺序访问其属性（attribute） #attr.userName相当于按顺序在以上三个范围（scope）内读取userName属性，直到找到为止

用于过滤和投影（projecting)集合，如books.{?#this.price<100}；
构造Map，如#{'foo1':'bar1', 'foo2':'bar2'}。
下面让我们它们的具体写法，首先是Action类代码：

package tutorial.action;

import java.util.LinkedList;
import java.util.List;
import java.util.Map;

import javax.servlet.ServletContext;
import javax.servlet.http.HttpServletRequest;

import org.apache.struts2.interceptor.ServletRequestAware;
import org.apache.struts2.interceptor.SessionAware;
import org.apache.struts2.util.ServletContextAware;

import tutorial.model.Book;

import com.opensymphony.xwork2.ActionSupport;

public class OgnlAction extends ActionSupport implements ServletRequestAware, SessionAware, ServletContextAware   {
     private static final long serialVersionUID = 1L;
    
     private HttpServletRequest request;
     private Map<String, String> session;
     private ServletContext application;
     private List<Book> books;
            
     public void setServletRequest(HttpServletRequest request) {
         this.request = request;    
     }

     @SuppressWarnings("unchecked")
     public void setSession(Map session) {
         this.session = session;        
     }

     public void setServletContext(ServletContext application) {
         this.application = application;
     }
    
     public List<Book> getBooks() {
         return books;
     }

     @Override
     public String execute() {
         request.setAttribute("userName", "Max From request");
         session.put("userName", "Max From session");
         application.setAttribute("userName", "Max From application");
        
         books = new LinkedList<Book>();
         books.add(new Book("978-0735619678", "Code Complete, Second Edition", 32.99));
         books.add(new Book("978-0596007867", "The Art of Project Management", 35.96));
         books.add(new Book("978-0201633610", "Design Patterns: Elements of Reusable Object-Oriented Software", 43.19));
         books.add(new Book("978-0596527341", "Information Architecture for the World Wide Web: Designing Large-Scale Web Sites", 25.19));
         books.add(new Book("978-0735605350", "Software Estimation: Demystifying the Black Art", 25.19));
        
         return SUCCESS;
     }
}清单2 src/tutorial/action/OgnlAction.java

以上代码分别在request、session和application的范围内添加“userName”属性，然后再在JSP页面使用OGNL将其取回。我还创建了Book对象的列表用于演示“用于过滤和投影（projecting)集合”的功能，至于Book的代码大家可以在我前一文章《在Struts 2中实现CRUD》看到。

下面是Ognl.jsp的代码，内容如下：

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
     <title>Struts OGNL Demo</title>
</head>
<body>    
     <h3>访问OGNL上下文和Action上下文</h3>
     <p>parameters: <s:property value="#parameters.userName" /></p>
     <p>request.userName: <s:property value="#request.userName" /></p>
     <p>session.userName: <s:property value="#session.userName" /></p>
     <p>application.userName: <s:property value="#application.userName" /></p>
     <p>attr.userName: <s:property value="#attr.userName" /></p>
     <hr />
     <h3>用于过滤和投影（projecting)集合&