Struts2是一个优秀的MVC框架,大大下降了各个层之间的耦合度,具备很好的扩展性。从本篇开始咱们学习Struts2的基本用法,本篇主要包括如下内容:html
Struts2的下载安装web
理解整个框架的运行流程apache
自定义实现Actionsession
自定义配置处理结果app
1、下载和安装Struts2
登陆Apache官网 htt p:// stru ts.apac he.org /dow nload. cgi#str uts2 31 63 下载最新版本的Struts,固然建议下载2.3版本的,由于2.5版本刚出来,有些示例应用并非很全。解压压缩包,获得Struts2的源码及示例代码。框架
apps目录中主要是官方提供的Struts2的实例代码,对于咱们的学习是颇有用的。docs中主要是有关Struts2的相关文档内容。lib目录中主要存放了有关Struts2的核心类库,以及第三方插件库。src中包含了Struts2的所有源代码。jsp
2、理解Struts2的运行流程
下面演示一个完整的使用Struts2的实例,目的不是具体的代码,重点在于理解整个框架的运做流程。首先咱们须要从apps目录中的struts2-blank示例项目中拷贝出整个lib目录。(这是使用Struts2最基本的jar包,不必从Struts2的lib中一个一个找,由于你也不知道哪些是必需的),咱们将他们导入到咱们的项目中。ide
这是整个Struts2的请求和响应流程,下面看具体代码中是如何体现的。函数
//web.xml,首先在web.xml中添加以下代码,拦截全部请求,即全部请求如今所有归Struts2框架管了<filter> <filter-name>struts</filter-name> <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class></filter><filter-mapping> <filter-name>struts</filter-name> <url-pattern>/*</url-pattern></filter-mapping>
//编写Action充当控制器public class LoginAction extends ActionSupport { private String username; private String password; public String getUsername(){ return this.username; } public void setUsername(String s){ this.username = s; } public String getPassword(){ return this.password; } public void setPassword(String s){ this.password = s; } public String execute() throws Exception{ if(getUsername().equals("walker")&&getPassword().equals("yam")){ return SUCCESS; } return ERROR; } }
//新建Struts.xml文件用于配置框架<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"><struts> <package name="walker" extends="struts-default"> <action name="login" class="MyPackage.LoginAction"> <result name="error">/error.jsp</result> <result name="success">/index.jsp</result> </action> </package></struts>
/*login.jsp*/<html> <head> <title>login</title> </head> <body> <form method="post" action="login"> 姓名:<input type="text" name="username" /><br /> 密码:<input type="password" name="password" /><br /> <input type="submit" value="提交"/> </form> </body></html>
咱们访问login.jsp页面,工具
提交以后会请求URL为login的页面,框架拦截器拦截,搜索Struts.xml中该URL所对应的Action控制器,转向具体的控制器,在咱们写的LoginAction控制器中,咱们获取表单提交的参数并作简单判断,返回字符串success或者error给核心拦截器。核心拦截器读取Struts.xml中的配置查找控制器返回的字符串对应的具体视图位置,forward视图页面响应用户。
这就是一个简单的Struts2框架的请求和响应过程,能够看到整个框架的核心是主拦截器和各类控制器Action,下面咱们具体看看控制器的相关知识。
3、自定义实现Action
在Action中使用实例变量来封装请求的参数,正如上面的例子所示:咱们在login.jsp页面提交的username和password两个参数,对应于LoginAction中的两个参数,在核心拦截器跳转LoginAction时,将两个请求参数自动赋值给LoginAction的两个实例变量。须要注意的是,对于LoginAction中的这两个实例变量,是须要提供setter和geter方法的,咱们的核心拦截器在跳转LoginAction的时候也是经过setter方法来对具体的实例参数进行赋值的。
咱们想要自定义xxxAction控制器,须要继承Action接口,并实现其中的方法。
public interface Action { String SUCCESS = "success"; String NONE = "none"; String ERROR = "error"; String INPUT = "input"; String LOGIN = "login"; String execute() throws Exception; }
咱们能够看到在Action接口中定义了几个经常使用的字符串,这些字符串会被用于对应物理视图位置,详细的内容后文介绍。此处有一个execute方法,这个方法就相似于咱们JavaSE中的main方法,一旦核心拦截器拦截请求跳转到Action页面,会默认执行execute方法。细心的读者可能发现,上述的例子中并无继承Action接口,而是继承了ActionSupport类。其实ActionSupport类仍是继承了Action接口并实现了execute方法,只是ActionSupport类还为咱们默认的实现了一些其余的工具函数,方便咱们使用,因此基本上在自定义Action的时候会继承ActionSupport类来减轻编码难度。
Struts2中的Action没有任何和Servlet API耦合的地方,也就是在Action控制器中没有关于任何可直接操做Servlet API的接口调用。对于各个模块之间的分离,Struts仍是作的很优秀的。那咱们在Action控制器中无法直接操做Servlet的一些对象,例如:request,response等,可是Struts2框架提供了一个工具类,能够为咱们提供这些对象。ActionContext:
static ThreadLocal<ActionContext> actionContext = new ThreadLocal();//经过静态工厂建立ActionContext实例对象public static ActionContext getContext() { return (ActionContext)actionContext.get(); }//以map的形式设置application范围内的共享数据public void setApplication(Map<String, Object> application)//获取application范围内的共享数据public Map<String, Object> getApplication()//以map的形式设置session范围内的共享数据public void setSession(Map<String, Object> session)//获取session范围内的共享数据public Map<String, Object> getSession()//获取request范围内的指定的参数值public Object get(String key)//向request范围内添加一个key-value的参数public void put(String key, Object value)//获取request的全部请求参数public Map<String, Object> getParameters()//向request范围内添加一批请求参数public void setParameters(Map<String, Object> parameters)
咱们每每经过ActionContext的静态方法,经过本地线程ThreadLocal获取ActionContext实例,此ActionContext封装了有关Servlet操做的各类API调用方法。咱们看一个简单的使用:
public class LoginAction extends ActionSupport { private String username; private String password; public String getUsername(){ return this.username; } public void setUsername(String s){ this.username = s; } public String getPassword(){ return this.password; } public void setPassword(String s){ this.password = s; } public String execute() throws Exception{ if(getUsername().equals("walker")&&getPassword().equals("yam")){ ActionContext ac = ActionContext.getContext(); ac.put("login","登陆成功"); return SUCCESS; } return ERROR; } }
<html> <head> <title></title> </head> <body> <p><%=request.getAttribute("login")%></p> <h1>this is the index page</h1> </body></html>
结果以下:
以上咱们演示了如何经过ActionContext 这个工具类来完成对Servlet API的调用。其实还可使用ServletActionContext这个工具类来直接获取到原Servlet的pageContext,request,response等对象。具体的你们能够自行研究。
4、Action的配置
以上咱们完成了对xxxAction控制器的编写,可是若是想要咱们的核心拦截器可以在用户请求URL时,找到对应的Action控制器,咱们须要学会在Struts.xml中配置。以前咱们介绍过,web.xml是用来配置整个web应用的,那么咱们的struts.xml就是用来配置整个框架的。struts.xml应该被建立并放置在类的加载文件夹中,使用IDE的话,就建立在src文件夹下,在编译的时候会被拷贝到WEB-INF/classes中。
对于上述的示例,该struts.xml中的内容以下:
<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.3//EN" "http://struts.apache.org/dtds/struts-2.3.dtd"><struts> <package name="walker" extends="struts-default"> <action name="login" class="MyPackage.LoginAction"> <result name="error">/error.jsp</result> <result name="success">/index.jsp</result> </action> </package></struts>
这里的头部的一些东西不必本身敲,依然从官方给的示例中拷贝便可。至于元素Struts中的内容才是须要本身添加配置的。除去根元素,咱们看到的第一个元素是package ,在Struts中使用包来配置Action,也就是全部的Action都必须被配置在一个包下面,固然一个包中也是能够配置多个Action的。
package元素中能够配置如下属性:
name:该属性指定了该包的惟一标识,是必须属性
extends:该属性指定了该包能够继承别的包,固然别的包中的全部Action这里都是可用的了,非必须属性
namespace:该属性指定了该包下的全部Action的命名空间,主要用于区分同名的Action,非必须属性
abstract:指定了该包是一个抽象的包,抽象的包中是不能定义Action的,可是能够有大量的类型定义、拦截器定义等
从上面给出的Struts.xml中,咱们能够看出来,该包继承了struts-default包,这是struts2-core-2.3.32.3.jar 中的文件,部份内容以下:
被声明为抽象包以后,其中就定义了一堆拦截器和类型,具体的咱们后面介绍,此处只须要知道,咱们能够经过包的继承了来继承其余包中的一些Action获取拦截器。因为该包是配置普通Action的基础,因此通常咱们在自定义package的时候会继承该包。
接下来咱们简单看看namespace的使用,咱们在Struts.xml中能够定义多个包,每一个包下面也是能够定义多个Action的,那么若是某两个不一样的包下面出现同名的Action,框架就天然没法选择调用哪一个Action来处理请求。若是咱们指定了命名空间,那么在请求该包下的Action的时候,就须要带上命名空间的值,这样就能够避免这种冲突。具体看以下例子:
<package name="walker" extends="struts-default" namespace="a"> <action name="login" class="MyPackage.LoginAction"> <result name="error">/error.jsp</result> <result name="success">/index.jsp</result> </action> </package>
<package name="yam" extends="struts-default" namespace="b"> <action name="login" class="MyPackage.LoginAction"> <result name="error">/error.jsp</result> <result name="success">/index.jsp</result> </action> </package>
咱们看这两个包,他们下面配置了相同的Action,可是当时他们具备不一样的命名空间,因此不会产生冲突。例如:咱们请求walker包下的login action的URL为:
/a/login
而yam包下的login action的请求URL为:
/b/login
以上咱们演示package包下的一些属性的做用,须要注意一点的是:若是没有指定namespace的值,则该包下的全部Action都处于默认的命名空间下,此处默认的命名空间和 namespace="/" 是有区别的,后者表示该包处于根命名空间下,而前者中则包含了全部没有指定namespace值的包。若是框架在根命名空间或者别的命名空间下找不到指定的Action,则会前往默认命名空间下查找指定了Action。