首页 > 代码库 > Struts2基本配置详解
Struts2基本配置详解
Struts2配置文件加载顺序
struts2 配置文件由核心控制器加载 StrutsPrepareAndExecuteFilter (预处理,执行过滤)
init_DefaultProperties(); // [1] ---------- org/apache/struts2/default.properties init_TraditionalXmlConfigurations(); // [2] --- struts-default.xml,struts-plugin.xml,struts.xml init_LegacyStrutsProperties(); // [3] --- 自定义struts.properties init_CustomConfigurationProviders(); // [5] ----- 自定义配置提供 init_FilterInitParameters() ; // [6] ----- web.xml init_AliasStandardObjects() ; // [7] ---- Bean加载
default.properties 该文件保存在 struts2-core-2.3.7.jar 中 org.apache.struts2包里面 (常量的默认值)
struts-default.xml 该文件保存在 struts2-core-2.3.7.jar (Bean、拦截器、结果类型 )
struts-plugin.xml 该文件保存在struts-Xxx-2.3.7.jar (在插件包中存在 ,配置插件信息 )
struts.xml 该文件是web应用默认的struts配置文件
struts.properties 该文件是Struts的默认配置文件 (配置常量 )
web.xml 该文件是Web应用的配置文件 (配置常量 )
后加载文件中struts2 常量会覆盖之前加载文件的常量内容
Struts2的Action配置
<!--配置例子--> <package name="default" namespace="/" extends="struts-default"> <action name="hello" class="com.yzu.HelloAction" method="say"> <result name="good">/hello.jsp</result> </action> </package>
1)配置<package>元素(struts2 围绕package进行Action的相关配置 )
配置package三个常用属性 :<package name="default" namespace="/" extends="struts-default">
name 包名称,在struts2的配置文件文件中 包名不能重复 ,name并不是真正包名,只是为了管理Action
namespace 和 <action>的name属性,决定 Action的访问路径 (以/开始 )
extends 继承哪个包,通常开发中继承 struts-default 包 (struts-default包在 struts-default.xml定义 ),继承struts-default包后,可以使用 包中定义拦截器和结果类型
abstrace 它可以取值为true/false,如果为true,代表这个包是用于被继承的。
2)<action>元素配置
<action name="hello" class="com.yzu.HelloAction" method="say">
name 就是action的一个名称,它是唯一的(在同包内) 它与package中的namespace确定了访问action的路径。
class Action类的全名
method 要访问的Action类中的方法的名称,方法无参数 ,返回值为String.
例如 :
<package name="default" namespace="/user" extends="struts-default">
<action name="hello" class="cn.itcast.struts2.demo1.HelloAction">
访问路径 /user/hello.action
3) <result> 用于确定返回结果类型
name 它与action中的方法返回值做对比,确定跳转路径。
4) 关于action配置其它细节:
1.关于默认值问题
namespace的默认值是""
class的默认值是 com.opensymphony.xwork2.ActionSupport
method的默认值是 execute
name的默认值是 "success"
2.关于访问action的路径问题
<!--例如action的配置如下--> <package name="default" namespace="/" extends="struts-default"> <action name="hello" class="cn.itcast.action.DefaultAction"> <result>/hello.jsp</result> </action> </package>
当我们输入:http://localhost:8080/struts2_1/a/b/c/hello也访问到了action。
原因:struts2中的action被访问时,它会首先查找
1.namespace="/a/b/c" action的name=hello 没有.
2.namespace="/a/b action的name=hello 没有
3.namespace="/a" action的name=hello 没有
4.namespace="/" action的name=hello 查找到了.
如果最后也查找不到,会报404错误.
3.默认的action。
解决客户端访问Action不存在的问题 ,客户端访问Action, Action找不到,默认Action 就会执行
<default-action-ref name="action的名称" />
4.action的默认处理类
在action配置时,如果class不写。默认情况下是 com.opensymphony.xwork2.ActionSupport。如果设置了
<default-class-ref class="cn.itcast.action.DefaultAction"/>
默认处理action请求的的处理类就为class指定的类。
Struts2的常量配置
1) struts2 默认常量 在 default.properties 中配置
2) 开发者自定义常量
struts.xml
格式 : <constant name="struts.devMode" value="http://www.mamicode.com/true" />
struts.properties
格式 : struts.devMode = true
web.xml
格式 :
<filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class> <init-param> <param-name>struts.devMode</param-name> <param-value>true</param-value> </init-param> </filter>
3) 常用常量
<constant name="struts.i18n.encoding" value="http://www.mamicode.com/UTF-8"/> ----- 相当于request.setCharacterEncoding("UTF-8"); 解决post请求乱码
<constant name="struts.action.extension" value="http://www.mamicode.com/action"/> --- 访问struts2框架Action访问路径 扩展名
struts.action.extension=action,, 默认以.action结尾扩展名 和 不写扩展名 都会分发给 Action
<constant name="struts.serve.static.browserCache" value="http://www.mamicode.com/false"/> false不缓存,true浏览器会缓存静态内容,产品环境设置true、开发环境设置false
<constant name="struts.devMode" value="http://www.mamicode.com/true" /> 提供详细报错页面,修改struts.xml后不需要重启服务器
4) struts2 配置文件分离
<include file="struts-part1.xml"/> 将struts2 配置文件 拆分
Action
Action书写的的三种格式
1.创建一个POJO类
简单的Java对象(Plain Old Java Objects):指的是没有实现任何接口,没有继承任何父类(除了Object)
优点:无耦合。缺点:所以工作都要自己实现。
在struts2框架底层是通过反射来操作:
struts2框架 读取struts.xml 获得 完整Action类名
obj = Class.forName("完整类名").newInstance();
Method m = Class.forName("完整类名").getMethod("execute"); m.invoke(obj); 通过反射 执行 execute方法
2.创建一个类,实现Action接口. com.opensymphony.xwork2.Action
优点:耦合低。提供了五种结果视图,定义了一个行为方法。缺点:所有工作都要自己实现。
public static final String SUCCESS = "success"; // 数据处理成功 (成功页面) public static final String NONE = "none"; // 页面不跳转 return null; 效果一样 public static final String ERROR = "error"; // 数据处理发送错误 (错误页面) public static final String INPUT = "input"; // 用户输入数据有误,通常用于表单数据校验 (输入页面) public static final String LOGIN = "login"; // 主要权限认证 (登陆页面)
3.创建一个类,继承自ActionSupport类. com.opensymphony.xwork2.ActionSupport(ActionSupport类实现了Action接口)
优点:表单校验、错误信息设置、读取国际化信息三个功能都支持。缺点:耦合度高。
在开发中,第三种使用的比较多.
action的访问
1.通过设置method的值,来确定访问action类中的哪一个方法
<action name="book_add" class="cn.itcast.action.BookAction" method="add"></action>
当访问的是book_add,这时就会调用BookAction类中的add方法。
2.使用通配符来简化配置
1.在struts.xml文件中
<action name="*_*" class="cn.itcast.action.{1}Action" method="{2}"></action>
2.在jsp页面上
<a href="${pageContext.request.contextPath}/Book_add">book add</a><br> <a href="${pageContext.request.contextPath}/Book_update">book update</a><br> <a href="${pageContext.request.contextPath}/Book_delete">book delete</a><br> <a href="${pageContext.request.contextPath}/Book_search">book search</a><br>
当点击book add时,这时的路径是Book_add,那么对于struts.xml文件中.第一个*就是Book,第二个*就是add,对于{1}Action---->BookAction,对于method={2}--->method=add
使用通配符来配置注意事项:
1.必须定义一个统一的命名规范。
2.不建议使用过多的通配符,阅读不方便。
动态方法调用
在struts.xml文件中
<action name="book" class="cn.itcast.action.BookAction"></action>
访问路径: http://localhost/struts2_day01_2/book!add时,就访问到了BookAction类中的add方法。对于book!add 这就是动态方法调用。
注意:struts2框架支持动态方法调用,是因为在default.properties配置文件中设置了动态方法调用为true.
struts.enable.DynamicMethodInvocation = true
在struts2框架中获取servlet api
对于struts2框架,不建议直接使用servlet api,在struts2中获取servlet api有三种方式:
1.通过ActionContext来获取(注意:通过ActionContext获取的不是真正的Servlet api,而是一个Map集合)
1.获取一个ActionContext对象。
ActionContext context=ActionContext.getContext();
2.获取servlet api
1.context.getApplication()
2.context.getSession()
3.context.getParameter();---得到的就相当于request.getParameterMap()
4.context.put(String,Object) 相当于request.setAttribute(String,String);
2.注入方式获取(这种方式是真正的获取到了servlet api)
1.要求action类必须实现提定接口。
ServletContextAware : 注入ServletContext对象
ServletRequestAware :注入 request对象
ServletResponseAware : 注入response对象
2.重定接口中的方法。
private HttpServletRequest request;
3.声明一个web对象,使用接口中的方法的参数对声明的web对象赋值(例如要获取HttpServletRequest)
public void setServletRequest(HttpServletRequest request) { this.request = request; }
扩展:分析其实现(是使用struts2中的一个interceptor完成的)
<interceptor name="servletConfig" class="org.apache.struts2.interceptor.ServletConfigInterceptor"/>
if (action instanceof ServletRequestAware) { //判断action是否实现了ServletRequestAware接口 HttpServletRequest request = (HttpServletRequest) context.get(HTTP_REQUEST); //得到request对象. ((ServletRequestAware) action).setServletRequest(request);//将request对象通过action中重写的方法注入。 }
3.通过ServletActionContext获取
在ServletActionContext中方法都是static(静态方法没有线程问题,ThreadLocal )。
ServletActionContext.getRequest() : 获得request对象 (session)
ServletActionContext.getResponse() : 获得response 对象
ServletActionContext.getServletContext() : 获得ServletContext对象
Result结果类型
结果页面跳转类型
type 作用:是用于定义跳转方式
对于type属性它的值有以下几种(在struts-default.xml文件中定义了type可以取的值):
<result-type name="chain" class="com.opensymphony.xwork2.ActionChainResult"/> <result-type name="dispatcher" class="org.apache.struts2.dispatcher.ServletDispatcherResult" default="true"/> <result-type name="freemarker" class="org.apache.struts2.views.freemarker.FreemarkerResult"/> <result-type name="httpheader" class="org.apache.struts2.dispatcher.HttpHeaderResult"/> <result-type name="redirect" class="org.apache.struts2.dispatcher.ServletRedirectResult"/> <result-type name="redirectAction" class="org.apache.struts2.dispatcher.ServletActionRedirectResult"/> <result-type name="stream" class="org.apache.struts2.dispatcher.StreamResult"/> <result-type name="velocity" class="org.apache.struts2.dispatcher.VelocityResult"/> <result-type name="xslt" class="org.apache.struts2.views.xslt.XSLTResult"/> <result-type name="plainText" class="org.apache.struts2.dispatcher.PlainTextResult" />
常用值: chain dispatcher redirect redirectAction stream
dispatcher:它代表的是请求转发,也是默认值。它一般用于从action跳转到页面。
chain:它也相当于请求转发。它一般情况下用于从一个action跳转到另一个action。
redirect:它代表的是重定向 它一般用于从action跳转到页面
redirectAction: 它代表的是重定向 它一般用于从action跳转另一个action。
stream:代表的是服务器端返回的是一个流,一般用于下载。
局部结果页面与全局结果页面
<action name="result" class="cn.itcast.struts2.demo6.ResultAction"> <!-- 局部结果 当前Action使用 --> <result name="success">/demo6/result.jsp</result> </action> <global-results> <!-- 全局结果 当前包中 所有Action都可以用--> <result name="success">/demo6/result.jsp</result> </global-results>
Struts2基本配置详解