Struts2 convention-plugin 使用笔记

最近有在学习struts2  ，之前虽然使用过，但是也只是使用，struts2 的很多功能根本就没去了解过，现在决定学习一下，暂不要求有多深入。所以如果您需要的是一个高级教程，那么请转车。。。此次列车不去那里。

系统环境如下

• eclipse 3.6
• tomcat 6
• JDK 6
• Ubuntu 12.04 LTS

struts 版本为2.3.4.1，在 struts2的官方文档中讲到

[sql]  view plain copy

1. The Convention Plugin is bundled with Struts since 2.1 and replaces the Codebehind Plugin and Zero Config plugins.  

在struts2.1 之后，已经使用Convention Plugin替换了CodeBehind,如果您使用的版本与我使用的版本不一致的话，请注意这里的区别以及由此引起的配置差异。

需要使用Jar包如下（在struts2的lib包下都有，粘贴复制就OK了）

• asm-3.3.jar
• asm-commons-3.3.jar
• commons-fileupload-1.2.2.jar
• commons-io-2.0.1.jar
• commons-lang3-3.1.jar
• freemarker-2.3.19.jar
• javassist-3.11.0.GA.jar
• ognl-3.0.5.jar
• struts2-convention-plugin-2.3.4.1.jar
• struts2-core-2.3.4.1.jar
• xwork-core-2.3.4.1.jar

这些是我发现的最少包配置，至少我在删除这些包的时候，总会出现各种各样的错误的。也许你长的比较帅气（性感）  struts会卖你面子不报错的 

这里要注意javassist-3.11.0.GA.jar   这个包，如果删除这个包程序会报错无法启动，因为ongl这个包依赖它，而其他的某一个包依赖ongl，所以这两个包是不能删掉的。

首先用eclipse 新建一个 动态web项目 这一步不需要多说，相信大家都会的，不会的话那么、这个、那个，你去百度一下吧.新建完成后，将以上各包复制进WEB-INF 下面的lib包下，build path。

在src目录下新建一个xml，我这里名字叫做struts.xml

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <!DOCTYPE struts PUBLIC  
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"  
4.     "http://struts.apache.org/dtds/struts-2.0.dtd">  
5. <struts>  
6.     <constant name="struts.convention.classes.reload" value="true" />    
7.     <constant name="struts.devMode" value="true" />  
8. <!-- Convention Plugin  扫描注解时候的跟路径，根据你的项目包结构做出改变 -->  
9.  <constant name="struts.convention.package.locators.basePackage" value="struts"/>    
10. <!--Convention Plugin  扫描注解的最基础包   我这里actions包存放的是项目的action   
11. Convention Plugin默认会去扫描所以继承了ActionSupport 和名字以Action结尾的文件并将其作为一个Action；这两个配置非必须，我发现我就算将其注释掉后程序依然可以运行。  
12.  -->  
13.     <constant name="struts.convention.package.locators" value="actions"/>     
14. </struts>  

如果需要可以新建一个struts.properties文件，根据文档来讲，和struts.xml 是差不多的，

[html]  view plain copy

1. All properties can also be set using Constant Configuration in an XML configuration file.  

，这个文件提供以K-V模式配置，

在WEB-INF 下的web.xm文件我的配置如下

[html]  view plain copy

1. <?xml version="1.0" encoding="UTF-8"?>  
2. <web-app id="WebApp_ID" version="2.5"  
3.     xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
4.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">  
5.     <display-name>Struts</display-name>  
6.     <filter>  
7.                <!-- 注意这个filterclass  ，-->  
8.                 <filter-name>action</filter-name>  
9.         <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>  
10.                 <!-- 如果你的struts版本<2.1.3  那么请使用 这个filter<span class="code-tag">                  <filter-class></span>org.apache.struts2.dispatcher.FilterDispatcher<span class="code-tag"></filter-class></span> 
11.  -->  
12.   
13.  <!-- 这里也是定义action所在包，我将其注释掉程序可以运行，不过如果你的包结构比较复杂，还是建议将这个配置上 <init-param><param-name>actionPackage</param-name><param-value>struts.action</param-value></init-param> --></filter><filter-mapping><filter-name>action</filter-name><url-pattern>/*</url-pattern></filter-mapping><jsp-config><taglib><taglib-uri>/s</taglib-uri><taglib-location>/WEB-INF/struts-tags.tld</taglib-location></taglib></jsp-config><welcome-file-list><welcome-file>index.html</welcome-file><welcome-file>index.htm</welcome-file><welcome-file>index.jsp</welcome-file><welcome-file>default.html</welcome-file><welcome-file>default.htm</welcome-file><welcome-file>default.jsp</welcome-file></welcome-file-list></web-app>  

在web-inf 文件下新建一个  struts-tags.tld （名字随便，但是注意在web.xml中   tablib配置中的taglib-location要和你起的名字一致，路径也要一致）。打开struts-tags.tld将struts2-core-2.3.4.1.jar下META-INF 下struts-tags.tld的文件内容复制到你新建的struts-tags.tld ，当然，你也可以不用新建，直接将这个文件复制到WEB-INF下面。 之所以配置taglib，这样的JSP在使用struts标签时候，就不需要去链接远程路径了。

到此，基本工作基本完成了，这是最简单的配置，如果你有需要，那么就去按照你i的需求进行配置。配置方法参见struts的doc。

那么开始编写我们的action，我这里将其命名为IndexAction。代码很简单，只是返回一个字符串“Hello Struts”。代码如下：

[java]  view plain copy

1. package struts.actions;  
2.   
3. import org.apache.struts2.convention.annotation.Action;  
4. import org.apache.struts2.convention.annotation.Result;  
5. import org.apache.struts2.convention.annotation.ResultPath;  
6.   
7. import com.opensymphony.xwork2.ActionSupport;  
8.   
9. @ResultPath(value="/")  
10. public class IndexAction extends ActionSupport {  
11.   
12.     private String message;  
13.   
14.     public String getMessage() {  
15.         return message;  
16.     }  
17.   
18.     public void setMessage(String message) {  
19.         this.message = message;  
20.     }  
21.   
22.     /** 
23.      * , 
24.      */  
25.     @Action(value = "index", results = { @Result(name = SUCCESS, location = "index.jsp")})  
26.     public String index() {  
27.         this.setMessage("Hello Struts");  
28.         return SUCCESS;  
29.     }  
30.   
31. }  

代码很简单，相信大家都看得懂，这里需要注意的是一点 ：@ResultPath的配置，Convention Plugin在默认情况下，会去WEB-INF/content  下查找你的result，使用@ResultPath配置，可以改变这个路径。比如在我的代码中，回去/下面查找index.jsp文件，如果将@ResultPath注释掉，你会得到一个404的错误。还有一个方式，就是你可以在result的location中这样写/index.jsp，  这样配置和代码中的配置结果是一样的。

下面就是我们的index.jsp了，同样很简单，代码如下：

[html]  view plain copy

1. <%@ page language="java" contentType="text/html; charset=UTF-8"  
2.     pageEncoding="UTF-8"%>  
3. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">  
4. <!--  引入struts 标签库  -->  
5.  <%@taglib prefix="s" uri="/s" %>  
6. <html>  
7. <head>  
8. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">  
9. <title>Insert title here</title>  
10. </head>  
11. <body>  
12. <s:property value="message"/>  
13. </body>  
14. </html>  

这样就OK了，将项目部署到tomcat中，启动tomcat，打开浏览器访问 http://ip:port/appName/index.action   你会不会看到hello Struts呢？ 如果不会，那么检查一下你的代码吧。。。。

在这里再说一个问题，由于在struts.xml中将devMode设置为true了，如果你改变了JAVA代码，或者其他需要重新部署的操作，都会报一个错误，不知道是为什么，暂时还没去仔细研究。