在本教程中使用的工具和程序库的版本如下:
开发工具: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