第一个简单的程序——Struts 2 官方文档翻译（Struts 2官方文档中文版）

这个教程旨在教大家如何如何安装框架和创建一个简单的程序

Struts 2框架用起来很简单，这个教程假设你已经掌握如下J2EE技术：

Java

Filters, JSP, and Tag Libraries

JavaBeans

HTML and HTTP

Web Containers (such as Tomcat)

XML

Java需求

Struts 2 需要Servlet API 2.4或更高，JSP 2.0或更高和Java 5或更高

我们的第一个程序

为了开始使用Struts 2 我们将用ant建立一个web 应用程序，然后我们将用Maven建立同样的一个程序。

你可以从Google Code - http://code.google.com/p/struts2-examples/downloads/list下载所有的例子。

在下面选择一个你熟悉的技术（Ant或Maven）

Ant

你可以下载这个完整的例子,Basic_Struts_Ant下载地址上面已经说了。下载完了后解压缩，得到 Basic_Struts2_Ant这个目录，里面有Readme.txt它介绍了如何建立和运行这个程序。

为了建立这个程序你需要下载Struts 2并将其jar包加入到你的Classpath。下载入口Struts 2

Step 1 - 创建一个基本的Web程序

在你的java IDE 里面创建一个Web application project命名为Basic_Struts2_Ant，下面是截图

Step 2 - 添加一个index.jsp

添加一个简单的index.jsp页面，他的title是Basic Struts 2 Application - Welcome，他的内容是Welcome to Struts 2!
然后在eclipse中运行该项目

Step 3 - 添加Struts 2的jar文件到Class Path

我们添加Struts 2最小需求的jar包。我们将把这些jar包拷贝到WEB-INF\lib这个文件夹中。

找到并拷贝这些文件

1. asm-x.x.jar

2. asm-commons-x.x.jar

3. asm-tree-x.x.jar

4. commons-fileupload-X.X.X.jar

5. commons-io-X.X.X.jar

6. commons-lang3-X.X.X.jar

7. commons-fileupload-X.X.X.jar

8. freemarker-X.X.X.jar

9. javassist-X.X.X.jar

10. ognl-X.X.X.jar

11. struts2-core-X.X.X.X.jar

12. xwork-core-X.X.X.jar

从上面的文件你可能看出Struts 2的核心jar包依赖一些其他的jar包。当我们在接下来的教程中需要添加额外的Struts 2功能时，我们将需要添加额外的Struts 2jar包和和其他的依赖jar包。 

Step 4 - 添加日志系统

这个例子程序我们用log4j，你要去下载log4j的jar包并且拷贝到WEB-INF/lib中。下载log4j

配置log4j.xml在src文件夹中。你可以从下载的例子中拷贝一份。它包含如下内容

Step 5 - 添加Struts 2 Servlet Filter

为了要Struts 2 框架在你的web应用中工作，你需要在web.xml文件中添加Servlet Filter类和Filter mappingr。下面是你要添加的内容。

struts2
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter


struts2
/*

Step 6 - 创建struts.xml文件

Struts 2 可以用XML配置文件或者注解。我们用XML配置文件，注意文件名称为struts.xml并且要放在src目录下面（struts.xml文件必须在web程序class path的根下面）
这个配置文件告诉框架，如果URL以index.action结尾，这个请求将被转发到index.jsp。
更多关于struts.xml配置信息前往这里

/index.jsp

Step 7 - 构建和运行程序

在eclispe中运行项目（记得重启tomcat），浏览http://localhost:8080/Basic_Struts2_Ant/index.action
在eclipse的控制台将看到有日志信息输出。