首页  ·  知识 ·  编程语言
Struts2教程
佚名  本站原创  Java  编辑:dezai  图片来源:网络
在本教程中使用的工具和程序库的版本如下: 开发工具:MyEclipse6 Web服务器:Tomcat6

在本教程中使用的工具和程序库的版本如下:


    开发工具:MyEclipse6

    Web服务器:Tomcat6

    Struts版本:Struts2.0.11.1

    JDK版本:JDK1.5.0_12

    J2EE版本:Java EE5.0

    在本系列教程中Web工程的上下文路径都是struts2,如果在Web根目录有一个index.jsp文件,则访问路径如下:

    http://localhost:8080/struts2/index.jsp

    由于MyEclipse6目前并不支持Struts2,所以我们需要到struts.apache.org去下载Struts2安装包。要想正常使用Struts2,至少需要如下五个包(可能会因为Struts2的版本不同,包名略有差异,但包名的前半部是一样的)。

    struts2-core-2.0.11.1.jar

    xwork-2.0.4.jar

    commons-logging-1.0.4.jar

    freemarker-2.3.8.jar

    ognl-2.6.11.jar

    Struts2虽然在大版本号上是第二个版本,但基本上在配置和使用上已经完全颠覆了Struts1.x的方式(当然,Struts2仍然是基于MVC模式的,也是动作驱动的,可能这是唯一没变的东西)。Struts2实际上是在Webwork基础上构建起来的MVC框架。我们从Struts2的源代码中可以看到,有很多都是直接使用的xwork(Webwork的核心技术)的包。既然从技术上来说Struts2是全新的框架,那么就让我们来学习一下这个新的框架的使用方法。

    如果大家使用过Struts1.x,应该对建立基于Struts1.x的Web程序的基本步骤非常清楚。让我们先来回顾一下建立基于Struts1.x的Web程序的基本步骤。

    1. 安装Struts。由于Struts的入口点是ActionServlet,所以得在web.xml中配置一下这个Servlet。

    2. 编写Action类(一般从org.apache.struts.action.Action类继承)。

    3. 编写ActionForm类(一般从org.apache.struts.action.ActionForm类继承),这一步不是必须的,如果要接收客户端提交的数据,需要执行这一步。

    4. 在struts-config.xml文件中配置Action和ActionForm。

    5. 如果要采集用户录入的数据,一般需要编写若干JSP页面,并通过这些JSP页面中的form将数据提交给Action。

    下面我们就按着编写struts1.x程序的这五步和struts2.x程序的编写过程一一对应,看看它们谁更“酷”。下面我们来编写一个基于Struts2的Web程序。这个程序的功能是让用户录入两个整数,并提交给一个Struts Action,并计算这两个数的代数和,如果代码和为非负数,则跳转到positive.jsp页面,否则跳转到negative.jsp页面。

    【第1步】 安装Struts2

    这一步对于Struts1.x和Struts2都是必须的,只是安装的方法不同。Struts1的入口点是一个Servlet,而Struts2的入口点是一个过滤器(Filter)。因此,Struts2要按过滤器的方式配置。下面是在web.xml中配置Struts2的代码:


<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>


    【第2步】 编写Action类

    这一步和Struts1.x也必须进行。只是Struts1.x中的动作类必须从Action类中继承,而Struts2.x的动作类需要从com.opensymphony.xwork2.ActionSupport类继承。下面是计算两个整数代码和的Action类,代码如下:


packageaction;
importcom.opensymphony.xwork2.ActionSupport;
publicclassFirstActionextendsActionSupport
{
privateintoperand1;
privateintoperand2;
publicStringexecute()throwsException
{
if(getSum()>=0) //如果代码数和是非负整数,跳到positive.jsp页面
{
return"positive";
}
else //如果代码数和是负整数,跳到negative.jsp页面
{
return"negative";
}
}
publicintgetOperand1()
{
returnoperand1;
}
publicvoidsetOperand1(intoperand1)
{
System.out.println(operand1);
 this.operand1=operand1;
}
publicintgetOperand2()
{
returnoperand2;
} 
publicvoidsetOperand2(intoperand2)
{
System.out.println(operand2);
this.operand2=operand2;
}
publicintgetSum()
{
returnoperand1+operand2; //计算两个整数的代码数和
}
}

    从上面的代码可以看出,动作类的一个特征就是要覆盖execute方法,只是Struts2的execute方法没有参数了,而Struts1.x的execute方法有四个参数。而且execute方法的返回值也不同的。Struts2只返回一个String,用于表述执行结果(就是一个标志)。上面代码的其他部分将在下面讲解。
【第3步】 编写ActionForm类

    在本例中当然需要使用ActionForm了。在Struts1.x中,必须要单独建立一个ActionForm类(或是定义一个动作Form),而在Struts2中ActionForm和Action已经二合一了。从第二步的代码可以看出,后面的部分就是应该写在ActionForm类中的内容。所以在第2步,本例的ActionForm类已经编写完成(就是Action类的后半部分)。

    【第4步】 配置Action类

    这一步struts1.x和struts2.x都是必须的,只是在struts1.x中的配置文件一般叫struts-config.xml(当然也可以是其他的文件名),而且一般放到WEB-INF目录中。而在struts2.x中的配置文件一般为struts.xml,放到WEB-INF"classes目录中。下面是在struts.xml中配置动作类的代码:


<?xmlversion="1.0"encoding="UTF-8"?> <!DOCTYPEstrutsPUBLIC "-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <packagename="struts2"namespace="/mystruts" extends="struts-default"> <actionname="sum"class="action.FirstAction"> <resultname="positive">/positive.jsp</result> <resultname="negative">/negative.jsp</result> </action> </package> </struts>


    在<struts>标签中可以有多个<package>,第一个<package>可以指定一个Servlet访问路径(不包括动作名),如“/mystruts”。extends属性继承一个默认的配置文件“struts-default”,一般都继承于它,大家可以先不去管它。<action>标签中的name属性表示动作名,class表示动作类名。

    <result>标签的name实际上就是execute方法返回的字符串,如果返回的是“positive”,就跳转到positive.jsp页面,如果是“negative”,就跳转到negative.jsp页面。在<struts>中可以有多个<package>,在<package>中可以有多个<action>。我们可以用如下的URL来访问这个动作:

    http://localhost:8080/struts2/mystruts/sum.action

    注:Struts1.x的动作一般都以。do结尾,而Struts2是以。action结尾。

    【第5步】 编写用户录入接口(JSP页面)

    1. 主界面(sum.jsp)

    在Web根目录建立一个sum.jsp,代码如下:


%@pagelanguage="java"import="java.util.*"pageEncoding="GBK"%> <%@taglibprefix="s"uri="/struts-tags"%> <html> <head> <title>输入操作数</title> </head> <body> 求代数和 <br/> <s:formaction="mystruts/sum.action"> <s:textfieldname="operand1"label="操作数1"/> <s:textfieldname="operand2" label="操作数2"/> <s:submitvalue="代数和"/> </s:form> </body> </html>


    在sum.jsp中使用了Struts2带的tag.在Struts2中已经将Struts1.x的好几个标签库都统一了,在Struts2中只有一个标签库/struts-tags.这里面包含了所有的Struts2标签。但使用Struts2的标签大家要注意一下。在<s:form>中最好都使用Struts2标签,尽量不要用HTML或普通文本,大家可以将sum.jsp的代码改为如下的形式,看看会出现什么效果:


... ...  求代数和 <br/> <s:form action="mystruts/sum.action" >操作数1:<s:textfield name="operand1" /><br/>操作数2:<s:textfield name="operand1" /><br/> <s:submit value="代数和" /> </s:form> ... ...


    提示一下,在<s:form>中Struts2使用<table>定位。

    2. positive.jsp


%@pagelanguage="java"import="java.util.*"pageEncoding="GBK"%> <%@taglibprefix="s"uri="/struts-tags"%> <html><head> <title>显示代数和</title></head><body> 代数和为非负整数<h1><s:propertyvalue="sum"/></h1></body> </html>


    3. negative.jsp


%@pagelanguage="java"import="java.util.*"pageEncoding="GBK"%> <%@taglibprefix="s"uri="/struts-tags"%><html><head> <title>显示代数和</title></head><body> 代数和为负整数<h1><s:propertyvalue="sum"/></h1></body> </html>


    这两个jsp页面的实现代码基本一样,只使用了一个<s:property>标签来显示Action类中的sum属性值。<s:property>标签是从request对象中获得了一个对象中得到的sum属性,如我们可以使用如下的代码来代替<s:property value=“sum”/>:


<%com.opensymphony.xwork2.util.OgnlValueStack ovs =(com.opensymphony.xwork2.util.OgnlValueStack)request.getAttribute("struts.valueStack");out.println(ovs.findString("sum"));%>


    启动Tomcat后,在IE中输入如下的URL来测试这个例子:

    http://localhost:8080/struts2/sum.jsp
在很多Web应用中,为了完成不同的工作,一个HTML form标签中可能有两个或多个submit按钮,如下面的代码所示:


<!--[if !supportLineBreakNewLine]-->
<htmlaction="…" method="post">
……
<inputtype="submit"value="保存"/>
<inputtype="submit"value="打印"/>
</html>


    由于在<form>中的多个提交按钮都向一个action提交,使用Struts2 Action的execute方法就无法判断用户点击了哪一个提交按钮。如果大家使用过Struts1.x就会知道在Struts1.2.9之前的版本需要使用一个LookupDispatchAction动作来处理含有多个submit的form.但使用LookupDispatchAction动作需要访问属性文件,还需要映射,比较麻烦。从Struts1.2.9开始,加入了一个EventDispatchAction动作。这个类可以通过java反射来调用通过request参数指定的动作(实际上只是判断某个请求参数是不存在,如果存在,就调用在action类中和这个参数同名的方法)。使用EventDispatchAction必须将submit的name属性指定不同的值以区分每个submit.而在Struts2中将更容易实现这个功能。

    当然,我们也可以模拟EventDispatchAction的方法通过request获得和处理参数信息。但这样比较麻烦。在Struts2中提供了另外一种方法,使得无需要配置可以在同一个action类中执行不同的方法(默认执行的是execute方法)。使用这种方式也需要通过请求参来来指定要执行的动作。请求参数名的格式为

    action!method.action

    注:由于Struts2只需要参数名,因此,参数值是什么都可以。

    下面我就给出一个实例程序来演示如何处理有多个submit的form:

    【第1步】实现主页面(more_submit.jsp)

%@pagelanguage="java"import="java.util.*"pageEncoding="GBK"%><%@taglibprefix="s"uri="/struts-tags"%><html> <head><title>MyJSP'hello.jsp'startingpage</title> </head>  <body><s:formaction="submit.action"><s:textfieldname="msg"label="输入内容"/> <s:submitname="save"value="保存"align="left"method="save"/><s:submitname="print"value="打印"align="left"method="print"/> </s:form> </body></html>

    在more_submit.jsp中有两个submit:保存和打印。其中分别通过method属性指定了要调用的方法:save和print.因此,在Action类中必须要有save和print方法。
第2步】实现Action类(MoreSubmitAction)

    packageaction;


importjavax.servlet.http.*;
importcom.opensymphony.xwork2.ActionSupport;
importorg.apache.struts2.interceptor.*;
publicclassMoreSubmitActionextendsActionSupportimplementsServletRequestAware
{
privateStringmsg;
privatejavax.servlet.http.HttpServletRequestrequest;
//获得HttpServletRequest对象
publicvoidsetServletRequest(HttpServletRequestrequest)
{
this.request=request;
}
//处理savesubmit按钮的动作
publicStringsave()throwsException
{
request.setAttribute("result","成功保存["+msg+"]");
return"save";
}
//处理printsubmit按钮的动作
publicStringprint()throwsException
{
request.setAttribute("result","成功打印["+msg+"]");
return"print";
}
publicStringgetMsg()
{
returnmsg;
}
publicvoidsetMsg(Stringmsg)
{
this.msg=msg;
}
}

    上面的代码需要注意如下两点:

    save和print方法必须存在,否则会抛出java.lang.NoSuchMethodException异常。

    Struts2 Action动作中的方法和Struts1.x Action的execute不同,只使用Struts2 Action动作的execute方法无法访问request对象,因此,Struts2 Action类需要实现一个Struts2自带的拦截器来获得request对象,拦截器如下:

    org.apache.struts2.interceptor. ServletRequestAware
【第3步】配置Struts2 Action

    struts.xml的代码如下:


<?xmlversion="1.0"encoding="UTF-8"?><!DOCTYPEstrutsPUBLIC"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN""http://struts.apache.org/dtds/struts-2.0.dtd"><struts><packagename="demo"extends="struts-default"><actionname="submit" class="action.MoreSubmitAction"><resultname="save">/result.jsp</result><resultname="print">/result.jsp</result></action></package></struts>

    【第4步】编写结果页(result.jsp)

%@pagepageEncoding="GBK"%><html> <head><title>提交结果</title> </head> <body><h1>${result}</h1> </body></html>

    在result.jsp中将在save和print方法中写到request属性中的执行结果信息取出来,并输出到客户端
使用<include>标签重用配置文件

    在Struts2中提供了一个默认的struts.xml文件,但如果package、action、interceptors等配置比较多时,都放到一个struts.xml文件不太容易维护。因此,就需要将struts.xml文件分成多个配置文件,然后在struts.xml文件中使用<include>标签引用这些配置文件。这样做的优点如下:

    结构更清晰,更容易维护配置信息。

    配置文件可以复用。如果在多个Web程序中都使用类似或相同的配置文件,那么可以使用<include>标签来引用这些配置文件,这样可以减少工作量。

    假设有一个配置文件,文件名为newstruts.xml,代码如下:


<?xmlversion="1.0"encoding="UTF-8"?>
<!DOCTYPEstrutsPUBLIC
"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">
<struts>
<packagename="demo"extends="struts-default">
<actionname="submit" class="action.MoreSubmitAction">
<resultname="save">
/result.jsp
</result>
<resultname="print">
/result.jsp
</result>
</action>
</package>
</struts>


    则struts.xml引用newstruts.xml文件的代码如下:


<?xmlversion="1.0"encoding="UTF-8"?><!DOCTYPEstrutsPUBLIC"-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN""http://struts.apache.org/dtds/struts-2.0.dtd"><struts><includefile="newstruts.xml"/><packagename="test"extends="struts-default">……</package></struts>


    大家要注意一下,用<include>引用的xml文件也必须是完成的struts2的配置。实际上<include>在引用时是单独解析的xml文件,而不是将被引用的文件插入到struts.xml文件中。

    action的别名

    在默认情况下,Struts2会调用动作类的execute方法。但有些时候,我们需要在一个动作类中处理不同的动作。也就是用户请求不同的动作时,执行动作类中的不同的方法。为了达到这个目的,可以在<action>标签中通过method方法指定要指行的动作类的方法名,并且需要为不同的动作起不同的名子(也称为别名)。如下面代码所示:


<?xmlversion="1.0"encoding="UTF-8"?><!DOCTYPEstrutsPUBLIC "-//ApacheSoftwareFoundation//DTDStrutsConfiguration2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"><struts><packagename="demo"extends="struts-default"><actionname="test" class="action.MyAction">……</action><actionname="my" class="action.MyAction"method="my">……</action></package></struts>


    上面代码的两个动作的class属性都指向同一个类,name为这个类起了两个动作别名:test和my.在动作my中,使用了method属性指定要要运行的方法名为my.

    在MyAction类中必须要有my方法,代码如下:


packageaction;importcom.opensymphony.xwork2.ActionSupport;publicclassMyActionextendsActionSupport{……publicStringexecute()throwsException{//处理test动作的代码}publicStringmy()throwsException{ //处理my动作的代码}……}


    除了在struts.xml中配置别名,还可以通过请求参数来描述指定动作(并不需要在struts.xml中配置)。请求参数的格式如下:

    http://localhost:8080/contextPath/actionName!method.action

    关于通过请求指定动作的详细内容,请参阅笔者写的《Struts2教程2:处理一个form多个submit》。
为action指定参数

    在struts2中还可以为action指定一个或多个参数。大家还记着struts1.x是如何设置的action参数不? 在struts1.x中可以使用<action>标签的parameter属性为其指定一个action参数,如果要指定多个,就只能通过逗号(,)或其他的分隔符将不同的参数隔开。而在struts2中可以通过<param>标签指定任意多个参数。代码如下:


<actionname="submit" class="action.MyAction"><paramname="param1">value1</param><paramname="param2">value2</param><resultname="save">/result.jsp</result> ……</action>


    当然,在action中读这些参数也非常简单,只需要象获取请求参数一样在action类中定义相应的setter方法即可(一般不用定义getter方法)。如下面的代码将读取param1和param2参数的值:


packageaction;
importcom.opensymphony.xwork2.ActionSupport;
publicclassMyActionextendsActionSupport
{
privateStringparam1;
privateStringparam2;
publicStringexecute()throwsException
{
System.out.println(param1+param2);
}
publicvoidsetParam1(Stringparam1)
{
this.param1=param1;
}
publicvoidsetParam2(Stringparam2)
{
this.param2=param2;
}
……
}


    当struts2在调用execute之前,param1和param2的值就已经是相应参数的值了,因此,在execute方法中可以直接使用param1和param2.

    选择result类型

    在默认时,标签的type属性值是“dispatcher”(实际上就是转发,forward)。开发人员可以根据自己的需要指定不同的类型,如redirect、stream等。如下面代码所示:


<result name="save"type="redirect">  /result.jsp</result>


    这此result-type可以在struts2-core-2.0.11.1.jar包或struts2源代码中的struts-default.xml文件中找到,在这个文件中找到<result-types>标签,所有的result-type都在里面定义了。代码如下:


<result-types> <result-typename="chain"class="com.opensymphony.xwork2.ActionChainResult"/> <result-typename="dispatcher"class="org.apache.struts2.dispatcher.ServletDispatcherResult"default="true"/> <result-typename="freemarker"class="org.apache.struts2.views.freemarker.FreemarkerResult"/> <result-typename="httpheader"class="org.apache.struts2.dispatcher.HttpHeaderResult"/> <result-typename="redirect"class="org.apache.struts2.dispatcher.ServletRedirectResult"/> <result-typename="redirectAction"class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/> <result-typename="stream"class="org.apache.struts2.dispatcher.StreamResult"/> <result-typename="velocity"class="org.apache.struts2.dispatcher.VelocityResult"/> <result-typename="xslt"class="org.apache.struts2.views.xslt.XSLTResult"/> <result-typename="plainText"class="org.apache.struts2.dispatcher.PlainTextResult"/> <!--DeprecatednameformscheduledforremovalinStruts2.1.0.ThecamelCaseversionsarepreferred.Seeww-1707--> <result-typename="redirect-action"class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/> <result-typename="plaintext"class="org.apache.struts2.dispatcher.PlainTextResult"/></result-types>


    全局result

    有很多时候一个<result>初很多<action>使用,这时可以使用<global-results>标签来定义全局的<result>,代码如下:


<struts><packagename="demo"extends="struts-default"><global-results><resultname="print">/result.jsp</result></global-results><actionname="submit"class="action.MoreSubmitAction"> ……</action><actionname="my"class="action.MoreSubmitAction"method="my">……</action></package></struts>


    如果<action>中没有相应的<result>,Struts2就会使用全局的<result>。

本文作者:佚名 来源:本站原创
CIO之家 www.ciozj.com 微信公众号:imciow
   
免责声明:本站转载此文章旨在分享信息,不代表对其内容的完全认同。文章来源已尽可能注明,若涉及版权问题,请及时与我们联系,我们将积极配合处理。同时,我们无法对文章内容的真实性、准确性及完整性进行完全保证,对于因文章内容而产生的任何后果,本账号不承担法律责任。转载仅出于传播目的,读者应自行对内容进行核实与判断。请谨慎参考文章信息,一切责任由读者自行承担。
延伸阅读