Struts 2 学习笔记 - HelloWorld

- 日理万妓 2021-09-10 04:36 447阅读 0赞

到写本文为止，Struts的最新版本是 2.0.6。Struts 2.0.6的下载地址是：[http://struts.apache.org/download.cgi\#struts206][http_struts.apache.org_download.cgi_struts206]。 为了方便，可以选择下载Full发布包：[http://mirrors.sirium.net/pub/apache/struts/binaries/struts-2.0.6-all.zip][http_mirrors.sirium.net_pub_apache_struts_binaries_struts-2.0.6-all.zip]。struts自带有几个有用的范例，我们可以拿来学习研究一下。本文就是参考子apps目录中的blank项目。

本HelloWorld的需求很简单，只是可以通过英语和汉语两种语言来显示HelloWorld。当然，这不是自动翻译。只是在不同的环境中，读取不同的字符串。

这是Struts2的入门的第一个范例。是在eclipse 3.2.2 + myeclipse 5.2.2环境下开发的。读者可能会问，myeclipse不是自带有struts吗？是的。Myeclipse为了方便开发员，带有struts 1.1和1.2。但是没有Struts 2的开发包。Myeclipse是个很有用的东西，Myeclipse对开发和部署web站点，编辑xml文件，jsp标记很有帮助，因此，我在这提到myeclipse。这不是为myeclipse做广告。当然，你也可以使用eclipse中其他web开发插件。

开发HelloWorld项目的基本步骤是：

[1. 建立web项目][1. _web]

[2. 导入Struts 2库文件][2. _Struts 2]

[3. 修改web.xml文件][3. _web.xml]

[4. 建立index.html文件。][4. _index.html]

[5. HelloWorld.jsp文件][5. HelloWorld.jsp]

[6. Action文件][6. Action]

[7. 建立Struts配置文件][7. _Struts]

[8. properties配置文件][8. properties]

### 1. 建立web项目 ###

新建的的web项目名称是：jeff-struts2-helloworld。

![clip_image002.jpg][]

图表 1

Myeclipse产生一些目录结构。下图是在该项目完成时的目录结构。

![clip_image004.jpg][]

图表 2

### 2. 导入Struts 2库文件 ###

![clip_image006.jpg][]

图表 3

这5个文件是必须的。在struts网站下载下来文件包里面。把这5个文件导入到WEB-INF/lib目录里。这5个文件自动的加入到构建路径中了。

### 3. 修改web.xml文件 ###

1  <? xml version="1.0" encoding="UTF-8" ?>   
  2   < web-app  version ="2.4"  xmlns ="http://java.sun.com/xml/ns/j2ee"   
  3      xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance"   
  4      xsi:schemaLocation ="http://java.sun.com/xml/ns/j2ee   
  5      http://java.sun.com/xml/ns/j2ee/web-app\_2\_4.xsd" >   
  6    
  7       < welcome-file-list >   
  8           < welcome-file > index.html </ welcome-file >   
  9       </ welcome-file-list >   
 10    
 11       < filter >   
 12           < filter-name > Struts 2 </ filter-name >   
 13           < filter-class > org.apache.struts2.dispatcher.FilterDispatcher </ filter-class >   
 14       </ filter >   
 15    
 16       < filter-mapping >   
 17           < filter-name > Struts 2 </ filter-name >   
 18           < url-pattern > /\* </ url-pattern >   
 19       </ filter-mapping >   
 20   </ web-app >   
 21

在web.xml文件中，首先建立首页文件（index.html），这样方便访问。然后加入一个过滤器（filter），过滤器类是：org.apache.struts2.dispatcher.FilterDispatcher 。Struts 2是通过FilterDispatcher这个过滤器（filter）来实现的。

### 4. 建立index.html文件。     ###

1  <! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" >   
  2   < html  xmlns ="http://www.w3.org/1999/xhtml" >   
  3     < head >   
  4       < title > index.html </ title >   
  5       < meta  http-equiv ="refresh"  content ="0;URL=example/HelloWorld.action"   />       
  6     </ head >   
  7      
  8     < body >   
  9       < p > Loading ![dot.gif][]  </ p >   
 10     </ body >   
 11   </ html >   
 12

index.html文件只是用于导向作用。这里有个规则："Link actions not pages."。意思是说：通过action来访问web，而不是jsp文件。所以，我在index.html导向dao一个HelloWorld.action，而不是HelloWorld.jsp。

### 5. HelloWorld.jsp文件 ###

1  <% @ page language = " java "  contentType = " text/html; charset=utf-8 "  pageEncoding = " UTF-8 " %>   
  2   <% @ taglib prefix = " s "  uri = " /struts-tags " %>   
  3    
  4   <? xml version="1.0" encoding="utf-8"  ?>   
  5   <! DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd" >   
  6   < html  xmlns ="http://www.w3.org/1999/xhtml" >   
  7       < head >   
  8           < meta  http-equiv ="Content-Type"  content ="text/html; charset=utf-8"   />   
  9           < title >< s:text  name ="helloworld.message" ></ s:text >   
 10           </ title >   
 11       </ head >   
 12       < body >   
 13           < h2 >   
 14               < s:property  value ="message"   />   
 15           </ h2 >   
 16           < ul >   
 17               < li >   
 18                   < s:url  id ="url"  action ="HelloWorld" >   
 19                       < s:param  name ="request\_locale" > en </ s:param >   
 20                   </ s:url >   
 21                   < s:a  href ="$\{url\}" > English </ s:a >   
 22               </ li >   
 23               < li >   
 24                   < s:url  id ="url"  action ="HelloWorld" >   
 25                       < s:param  name ="request\_locale" > zh </ s:param >   
 26                   </ s:url >   
 27                   < s:a  href ="$\{url\}" > Chinese </ s:a >   
 28               </ li >   
 29           </ ul >   
 30       </ body >   
 31   </ html >   
 32

在实际的项目中，页面的内容可能会比较复杂，可以用dreaweaver来先用静态的文本来填充布局，然后，再用struts 标记来代替这些文本。新建的html和jsp文件，尽可能的遵循xhtml的标准。

在文件的开头，为了使用struts 2标记，必须有这样的一行：

<% @ taglib prefix = " s "  uri = " /struts-tags " %>

在struts 2 中使用文本有两种方法：本项目都采用了，这也是为了演示Struts 2的功能。

从properties配置文件中读取。如：<s:text name="helloworld.message" /> 就会从properties中读取配置文件中helloworld.message这个配置。

从bean的属性中读取。如：<s:property value="message" />，这就会从本页面相关的上下文中查找到message这个属性并显示出来。

<s:url />和<s:a />标记，在这里不打算详细介绍。

### 6. Action文件 ###

在本项目中，ExampleSupport类继承自ActionSupport类，HelloWorld又继承自ExampleSupport类。在这里ExampleSupport类没有做任何事情。但在实际的项目中，可以把项目中其他Action所需的公共的内容，写在ExampleSupport类中。我这里是尽可能的按**项目**的方式开发，而完全是按照**玩具**的方式开发。

ExampleSupport.java文件

1  package  jeff.struts2.helloworld;  
 2    
 3   import  com.opensymphony.xwork2.ActionSupport;  
 4    
 5   public   class  ExampleSupport  extends  ActionSupport \{  
 6  \}  
 7

HelloWorld.java文件

1 ![None.gif][] package  jeff.struts2.helloworld;  
  2 ![None.gif][]  
  3 ![ExpandedBlockStart.gif][]![ContractedBlock.gif][] public   class  HelloWorld  extends  ExampleSupport  ![dot.gif][] \{  
 4![InBlock.gif][]      
 5![InBlock.gif][]    private String message;  
 6![InBlock.gif][]  
 7![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public String getMessage() ![dot.gif][]\{  
 8![InBlock.gif][]        return message;  
 9![ExpandedSubBlockEnd.gif][]    \}  
10![InBlock.gif][]  
11![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public void setMessage(String message) ![dot.gif][]\{  
12![InBlock.gif][]        this.message = message;  
13![ExpandedSubBlockEnd.gif][]    \}  
14![InBlock.gif][]  
15![InBlock.gif][]    @Override  
16![ExpandedSubBlockStart.gif][]![ContractedSubBlock.gif][]    public String execute() throws Exception ![dot.gif][]\{      
17![InBlock.gif][]        setMessage(getText("helloworld.message"));  
18![InBlock.gif][]        return SUCCESS;  
19![ExpandedSubBlockEnd.gif][]    \}  
20![InBlock.gif][]  
21![ExpandedBlockEnd.gif][]\}   
 22 ![None.gif][]

### 7. 建立Struts配置文件 ###

在struts2-core-2.0.6.jar文件中，有struts-2.0.dtd文件。Struts就是通过该文件来验证struts配置文件的。在本项目中，有两个配置文件：struts.xml文件和example.xml文件。

struts.xml文件：

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    
  6   < struts >   
  7       < constant  name ="struts.enable.DynamicMethodInvocation"  value ="false" ></ constant >   
  8       < constant  name ="struts.devMode"  value ="true" ></ constant >   
  9        
 10       < include  file ="example.xml" ></ include >   
 11    
 12   </ struts >   
 13

example.xml文件

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    
  6   < struts >   
  7       < package  name ="example"  namespace ="/example"  extends ="struts-default" >   
  8           < action  name ="HelloWorld"  class ="jeff.struts2.helloworld.HelloWorld" >   
  9               < result > /example/HelloWorld.jsp </ result >   
 10           </ action >   
 11       </ package >   
 12   </ struts >   
 13

在这里，我再说一句：本项目尽可能的按**项目**的方式开发，而完全是按照**玩具**的方式开发。因为在实际项目中，Struts要配置的内容可能有很多，为了方便编辑和维护struts配置文件，把struts.xml文件拆分成多个文件，然后在struts.xml文件中用<include file />标记把这些配置文件加载进来。

### 8. properties配置文件 ###

我喜欢在页面每加入一个需要该配置文件中的配置时，就往package.properties中加入一项。在适当的时候，再来把package.properties文件翻译成不同语言的配置文件。

package.properties

helloworld.message = Struts is up and running ![dot.gif][]

package\_en.properties

helloworld.message = Struts is up and running ![dot.gif][]

package\_zh.properties

helloworld.message = Struts/u5df2/u7ecf/u642d/u5efa/u597d/u4e86/uff0c/u5e76/u5207/u5728/u8fd0/u884c/u2026/u2026

不能在中文的pakcage\_zh.properties配置文件中，直接写汉字。在eclipse中有插件，可以直接转换。Sun公司的jdk自带有个工具转换，叫做native2ascii。我在eclipse中配置了一个外部工具，工具配置如下：

![clip_image008.jpg][]

图表 4

native2ascii的命令格式是这样的：native2ascii sourcefile desitationfile。这个工具配置用到了一个技巧。就是在package\_zh文件（注意：该文件没有扩展名）中写汉字，然后运行该工具，就生成了package\_zh.properites文件。每次改动package\_zh文件，并要部署项目前，先运行一下该工具。

package\_zh文件的内容如下：

helloworld.message = Struts已经搭建好了，并切在运行 ……

转自：[http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html][http_www.blogjava.net_jeff-lau_archive_2007_05_21_118914.html]

[http_struts.apache.org_download.cgi_struts206]: http://struts.apache.org/download.cgi#struts206
[http_mirrors.sirium.net_pub_apache_struts_binaries_struts-2.0.6-all.zip]: http://mirrors.sirium.net/pub/apache/struts/binaries/struts-2.0.6-all.zip
[1. _web]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527021
[2. _Struts 2]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527022
[3. _web.xml]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527023
[4. _index.html]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527024
[5. HelloWorld.jsp]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527025
[6. Action]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527026
[7. _Struts]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527027
[8. properties]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html#_Toc167527028
[clip_image002.jpg]: /images/20210720/72e10e39e97847c0bcef653758605b2c.png
[clip_image004.jpg]: /images/20210720/e1eae05997d94eac8c46038b4c190dd7.png
[clip_image006.jpg]: /images/20210720/fd7e5a082aab44cb86e2e3d256761639.png
[dot.gif]: /images/20210720/deb52e27c9724f3fb5a87ac119296d0b.png
[None.gif]: /images/20210720/9bd5f6f531dd4232abc79ae17e43d5d4.png
[ExpandedBlockStart.gif]: http://www.blogjava.net/Images/OutliningIndicators/ExpandedBlockStart.gif
[ContractedBlock.gif]: http://www.blogjava.net/Images/OutliningIndicators/ContractedBlock.gif
[InBlock.gif]: /images/20210720/efede0e0a0524aeda4e9cc24d857b2a5.png
[ExpandedSubBlockStart.gif]: http://www.blogjava.net/Images/OutliningIndicators/ExpandedSubBlockStart.gif
[ContractedSubBlock.gif]: http://www.blogjava.net/Images/OutliningIndicators/ContractedSubBlock.gif
[ExpandedSubBlockEnd.gif]: /images/20210720/bed62368cb914cfba048ecbc9a52cb8e.png
[ExpandedBlockEnd.gif]: /images/20210720/280153d5da084b5296892f0d5ddf62a9.png
[clip_image008.jpg]: /images/20210720/723bb255621140b3b61fbfc86bbe7e06.png
[http_www.blogjava.net_jeff-lau_archive_2007_05_21_118914.html]: http://www.blogjava.net/jeff-lau/archive/2007/05/21/118914.html