Struts2 讲师：黎活明 北京传智播客教育 www.itcast.cn
开发Struts2依赖的jar 到http://struts.apache.org/download.cgi#struts2014下载struts-2.x.x-all.zip，目前最新版为2.1.6。下载完后解压文件，开发struts2应用需要依赖的jar文件在解压目录的lib文件夹下。不同的应用需要的JAR包是不同的。下面给出了开发Struts 2程序最少需要的JAR。 struts2-core-2.x.x.jar :Struts 2框架的核心类库 xwork-2.x.x.jar :XWork类库，Struts 2在其上构建 ognl-2.6.x.jar :对象图导航语言（Object Graph Navigation Language），Struts 2框架使用的一种表达式语言 freemarker-2.3.x.jar :Struts 2的UI标签的模板使用FreeMarker编写 commons-logging-1.1.x.jar :ASF出品的日志包，Struts 2框架使用这个日志包来支持Log4J和JDK 1.4+的日志记录。 Commons-fileupload 拷进去 还有一种最省事的做法是： 如果不需要跟第三方框架集成，把不带-plugin结尾的jar文件都添加入类路径即可。如果需要跟第三方框架集成，这时候还需要加入对应的-plugin jar文件。例如跟spring集成，需要加入struts2-spring-plugin-2.x.x.jar. 北京传智播客教育 www.itcast.cn
Struts2的启动配置 在struts1.x中， struts框架是通过Servlet启动的。在struts2中，struts框架是通过Filter启动的。他在web.xml中的配置如下： <filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.FilterDispatcher</filter-class> </filter> <filter-mapping> <url-pattern>/*</url-pattern> </filter-mapping> 在FilterDispatcher的init()方法中将会读取类路径下默认的配置文件struts.xml完成初始化操作。 注意：struts2读取到struts.xml的内容后，会将内容封装进javabean对象并存放在内存中，对于用户每次请求的处理将使用内存中的数据，而不是每次请求都读取struts.xml文件 北京传智播客教育 www.itcast.cn
Struts2的配置文件 Struts2默认的配置文件为struts.xml ，FilterDispatcher过滤器在初始化时将会在WEB-INF/classes下寻找该文件，该文件的配置模版如下： <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> </struts> 北京传智播客教育 www.itcast.cn
第一个Struts2应用 Struts2默认的配置文件为struts.xml ，FilterDispatcher过滤器在初始化时将会在WEB-INF/classes下寻找该文件，该文件的配置模版如下： <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <package name="itcast" namespace="/test" extends="struts-default"> <action name="helloworld" class="cn.itcast.action.HelloWorldAction"> <result name="success">/WEB-INF/page/hello.jsp</result> </action> </package> </struts> 北京传智播客教育 www.itcast.cn
第一个Struts2应用 例子中使用到的cn.itcast.action.HelloWorldAction类如下： package cn.itcast.action; public class HelloWorldAction{ private String message; public String getMessage() { return message; } public void setMessage(String message) { this.message = message; public String execute() throws Exception{ this.message = "我的第一个struts2应用"; return "success"; 北京传智播客教育 www.itcast.cn
第一个Struts2应用 例子中使用到的/WEB-INF/page/hello.jsp如下： <%@ page language="java" pageEncoding="UTF-8"%> <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>第一个struts2应用</title> </head> <body> ${message } <br> </body> </html> 可以使用EL表达式访问Action中的属性。 北京传智播客教育 www.itcast.cn
在Struts.xml配置包 <package name="itcast" namespace="/test" extends="struts-default"> <action name="helloworld" class="cn.itcast.action.HelloWorldAction"> <result name="success">/WEB-INF/page/hello.jsp</result> </action> </package> 在struts2框架中使用包来管理Action，包的作用和java中的类包是非常类似的，它主要用于管理一组业务功能相关的action。在实际应用中，我们应该把一组业务功能相关的Action放在同一个包下。 配置包时必须指定name属性，如果其他包要继承该包，必须通过该属性进行引用。 包的namespace属性用于定义该包的命名空间。该属性可以不配置，对本例而言，如果不指定该属性，默认的命名空间为“”（空字符串）。 通常每个包都应该继承struts-default包， struts-default包是由struts内置的，它定义了struts2内部的众多拦截器和Result类型。Struts2很多核心的功能都是通过这些内置的拦截器实现的。如：从请求中把请求参数封装到action、文件上传和数据验证等等都是通过拦截器实现的。当包继承了struts-default包才能使用struts2提供的这些功能。 struts-default包是在struts2-core-2.x.x.jar文件中的struts-default.xml中定义。 struts-default.xml也是Struts2默认配置文件。 Struts2每次都会自动加载 struts-default.xml文件。 包还可以通过abstract=“true”定义为抽象包，抽象包中不能包含action。 北京传智播客教育 www.itcast.cn
在Struts.xml配置Action <package name="itcast" namespace="/test" extends="struts-default"> <action name="helloworld" class="cn.itcast.action.HelloWorldAction"> <result name="success">/WEB-INF/page/hello.jsp</result> </action> </package> 在struts1中，通过path属性指定访问该action的URL路径。在struts2中，情况就不是这样了，访问struts2中的action的URL路径由两部份组成：包的命名空间+action的名称，例如访问上面例子中名为helloworld的Action的URL路径为：/test/helloworld (注意：完整路径为：http://localhost:端口/内容路径/test/helloworld.action)。 如果没有为action指定class，默认是ActionSupport。而ActionSupport的execute() 方法默认处理就是返回一个success字符串。method属性用于指定action中的那个方法，如果没有指定默认执行action中的execute() 方法。 北京传智播客教育 www.itcast.cn
Action名称的搜索顺序 1．获得请求路径的URI，例如url是：http://server/struts2/path1/path2/path3/test.action 2．首先寻找namespace为/path1/path2/path3的package，如果存在这个package，则在这个package中寻找名字为test的action，如果不存在这个package则转步骤3； 3．寻找namespace为/path1/path2的package，如果存在这个package，则在这个package中寻找名字为test的action，如果不存在这个package，则转步骤4； 4．寻找namespace为/path1的package，如果存在这个package，则在这个package中寻找名字为test的action，如果仍然不存在这个package，就去默认的namaspace的package下面去找名字为test的action，如果还是找不到，页面提示找不到action。 北京传智播客教育 www.itcast.cn
在Struts.xml配置Action的result <action name="helloworld" class="cn.itcast.action.HelloWorldAction"> <result name="success">/WEB-INF/page/hello.jsp</result> </action> result配置类似于struts1中的forward，但struts2中提供了多种结果类型，如： dispatcher(默认值)、 redirect 、 redirectAction 、 plainText。 下面是redirectAction 结果类型的例子，如果重定向的action中同一个包下： <result type="redirectAction">helloworld</result> 如果重定向的action在别的命名空间下： <result type="redirectAction"> <param name="actionName">helloworld</param> <param name="namespace">/test</param> </result> 如果没有指定result的name属性，默认值为success。 在result中还可以使用${属性名}表达式，表达式里的属性名对应action中的属性。如下： <result type="redirect">view.jsp?id=${id}</result> 北京传智播客教育 www.itcast.cn
指定需要Struts 2处理的请求后缀 FilterDispatcher是Struts 2框架的核心控制器，它负责拦截由<url-pattern>/*</url-pattern>指定的所有用户请求，当用户请求到达时，该Filter会过滤用户请求。默认情况下，如果用户请求的路径以.action结尾，该请求将被转入Struts 2框架处理，否则该请求将略过Struts 2框架的处理。 默认处理的后缀是可以通过常量”struts.action.extension“进行修改的，如下面配置Struts 2只处理以.do为后缀的请求路径： <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <constant name="struts.action.extension" value="do"/> </struts> 如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。如： <constant name="struts.action.extension" value="do,go"/> 北京传智播客教育 www.itcast.cn
Struts2的处理流程 FilterDispatcher Interceptor Action Result Jsp/html 用户请求 FilterDispatcher Interceptor Struts2内置的一些拦截器或用户自定义拦截器 Action 用户编写的action类，类似struts1中的Action Result 类似struts1中的forward 响应 Jsp/html 北京传智播客教育 www.itcast.cn
指定多个配置文件 在大部分应用里，随着应用规模的增加，系统中Action数量也大量增加，导致struts.xml配置文件变得非常臃肿。为了避免struts.xml文件过于庞大、臃肿，提高struts.xml文件的可读性，我们可以将一个struts.xml配置文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。下面的struts.xml通过<include>元素指定多个配置文件： <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <include file="struts-user.xml"/> <include file="struts-order.xml"/> </struts> 通过这种方式，我们就可以将Struts 2的Action按模块配置在多个配置文件中。 北京传智播客教育 www.itcast.cn
为Action的属性注入值 上面通过<param>节点为action的savePath属性注入“/images” public class HelloWorldAction{ private String savePath; public String getSavePath() { return savePath; } public void setSavePath(String savePath) { this.savePath = savePath; ...... <package name="itcast" namespace="/test" extends="struts-default"> <action name="helloworld" class="cn.itcast.action.HelloWorldAction" > <param name="savePath">/images</param> <result name="success">/WEB-INF/page/hello.jsp</result> </action> </package> 上面通过<param>节点为action的savePath属性注入“/images” 北京传智播客教育 www.itcast.cn
动态方法调用 如果Action中存在多个方法时，我们可以使用!+方法名调用指定方法。如下： public class HelloWorldAction{ private String message; .... public String execute() throws Exception{ this.message = "我的第一个struts2应用"; return "success"; } public String other() throws Exception{ this.message = "第二个方法"; 假设访问上面action的URL路径为： /struts/test/helloworld.action 要访问action的other() 方法，我们可以这样调用： /struts/test/helloworld!other.action 通常不建议大家使用动态方法调用，我们可以通过常量struts.enable.DynamicMethodInvocation关闭动态方法调用。 <constant name="struts.enable.DynamicMethodInvocation" value="false"/> 北京传智播客教育 www.itcast.cn
使用通配符定义action <package name="itcast" namespace="/test" extends="struts-default"> <action name="helloworld_*" class="cn.itcast.action.HelloWorldAction" method="{1}"> <result name="success">/WEB-INF/page/hello.jsp</result> </action> </package> public class HelloWorldAction{ private String message; .... public String execute() throws Exception{ this.message = "我的第一个struts2应用"; return "success"; } public String other() throws Exception{ this.message = "第二个方法"; 要访问other()方法，可以通过这样的URL访问：/test/helloworld_other.action 北京传智播客教育 www.itcast.cn
全局结果 当多个action中都使用到了相同result，这时我们应该把result定义为全局结果。struts1中提供了全局forward，struts2中也提供了相似功能： <package ....> <global-results> <result name="message">/message.jsp</result> </global-results> </package> 北京传智播客教育 www.itcast.cn
定义常量 常量可以在struts.xml或struts.properties中配置，建议在struts.xml中配置，两种配置方式如下： <constant name="struts.action.extension" value="do"/> </struts> struts.properties struts.action.extension=do 通常,struts2按如下搜索顺序加载struts2常量: struts-default.xml struts-plugin.xml web.xml 如果在多个文件中配置了同一个常量,则后一个文件中配置的常量值会覆盖前面文件中配置的常量值. 北京传智播客教育 www.itcast.cn
常用的常量 北京传智播客教育 www.itcast.cn <!-- 指定默认编码集,作用于HttpServletRequest的setCharacterEncoding方法 和freemarker 、velocity的输出 --> <constant name="struts.i18n.encoding" value="UTF-8"/> <!-- 该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。 如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。 --> <constant name="struts.action.extension" value="do"/> <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 --> <constant name="struts.serve.static.browserCache" value="false"/> <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 --> <constant name="struts.configuration.xml.reload" value="true"/> <!-- 开发模式下使用,这样可以打印出更详细的错误信息 --> <constant name="struts.devMode" value="true" /> <!-- 默认的视图主题 --> <constant name="struts.ui.theme" value="simple" /> <!– 与spring集成时，指定由spring负责action对象的创建 --> <constant name="struts.objectFactory" value="spring" /> <!–该属性设置Struts 2是否支持动态方法调用，该属性的默认值是true。如果需要关闭动态方法调用，则可设置该属性为false。 --> <constant name="struts.enable.DynamicMethodInvocation" value="false"/> 北京传智播客教育 www.itcast.cn
请求参数接收 在Action类中定义与请求参数同名属性，便能够使struts2自动接收请求参数并赋予同名属性。 北京传智播客教育 www.itcast.cn
文件上传 北京传智播客教育 www.itcast.cn 第一步：在WEB-INF/lib下加入commons-fileupload-1.2.1.jar、commons-io-1.3.2.jar。这两个文件可以从http://commons.apache.org/下载。 第二步：把form表的enctype设置为：“multipart/form-data“，如下： <form enctype="multipart/form-data" action="${pageContext.request.contextPath}/xxx.action" method="post"> <input type="file" name="uploadFile"> </form> 第三步：在Action类中添加以下属性，属性红色部分对应于表单中文件字段的名称： public class HelloWorldAction{ private File uploadFile;//得到上传的文件 private String uploadFileContentType;//得到文件的类型 private String uploadFileFileName;//得到文件的名称 //这里略省了属性的getter/setter方法 public String upload() throws Exception{ String realpath = ServletActionContext.getServletContext().getRealPath("/images"); File file = new File(realpath); if(!file.exists()) file.mkdirs(); FileUtils.copyFile(uploadFile, new File(file, uploadFileFileName)); return "success"; } 北京传智播客教育 www.itcast.cn
访问或添加request/session/application属性 public String scope() throws Exception{ ActionContext ctx = ActionContext.getContext(); ctx.getApplication().put("app", "应用范围");//往ServletContext里放入app ctx.getSession().put("ses", "session范围");//往session里放入ses ctx.put("req", "request范围");//往request里放入req return "scope"; } JSP: <body> ${applicationScope.app} <br> ${sessionScope.ses}<br> ${requestScope.req}<br> </body> 北京传智播客教育 www.itcast.cn
获取HttpServletRequest / HttpSession / ServletContext / HttpServletResponse对象 方法一，通过ServletActionContext.类直接获取： public String rsa() throws Exception{ HttpServletRequest request = ServletActionContext.getRequest(); ServletContext servletContext = ServletActionContext.getServletContext(); request.getSession() HttpServletResponse response = ServletActionContext.getResponse(); return "scope"; } 方法二，实现指定接口，由struts框架运行时注入： public class HelloWorldAction implements ServletRequestAware, ServletResponseAware, ServletContextAware{ private HttpServletRequest request; private ServletContext servletContext; private HttpServletResponse response; public void setServletRequest(HttpServletRequest req) { this.request=req; public void setServletResponse(HttpServletResponse res) { this.response=res; public void setServletContext(ServletContext ser) { this.servletContext=ser; 北京传智播客教育 www.itcast.cn
自定义类型转换器 下面的action中使用到了枚举类型Gender，当需要将请求参数注入到gender属性时，我们必须定义转换器，否则struts2无法自动完成类型转换。 public class HelloWorldAction { private Gender gender; public Gender getGender() { return gender; } public void setGender(Gender gender) { this.gender = gender; public enum Gender { MAN,WOMEN 北京传智播客教育 www.itcast.cn
自定义类型转换器 北京传智播客教育 www.itcast.cn 下面定义了一个针对Gender类型的类型转换器： public class GenderConverter extends DefaultTypeConverter { @Override public Object convertValue(Map context, Object value, Class toType) { if(toType == Gender.class){//当字符串向Gender类型转换时 String[] params = (String[]) value; return Gender.valueOf(params[0]); }else if(toType == String.class){//当Gender转换成字符串时 Gender gender = (Gender) value; return gender.toString(); } return null; 将上面的类型转换器注册为局部类型转换器： 在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldAction-conversion.properties 。在properties文件中的内容为： 属性名称=类型转换器的全类名 对于本例而言， HelloWorldAction-conversion.properties文件中的内容为： gender= cn.itcast.conversion.GenderConverter 北京传智播客教育 www.itcast.cn
自定义类型转换器 将上面的类型转换器注册为全局类型转换器： 在WEB-INF/classes下放置xwork-conversion.properties文件 。在properties文件中的内容为： 待转换的类型=类型转换器的全类名 对于本例而言， xwork-conversion.properties文件中的内容为： cn.itcast.action.Gender= cn.itcast.conversion.GenderConverter 北京传智播客教育 www.itcast.cn
自定义拦截器 要自定义拦截器需要实现com.opensymphony.xwork2.interceptor.Interceptor接口： public class PermissionInterceptor implements Interceptor { private static final long serialVersionUID = -5178310397732210602L; public void destroy() { } public void init() { public String intercept(ActionInvocation invocation) throws Exception { System.out.println("进入拦截器"); if(session里存在用户){ String result = invocation.invoke(); }else{ return “logon”; //System.out.println("返回值:"+ result); //return result; 北京传智播客教育 www.itcast.cn
自定义拦截器 <package name="itcast" namespace="/test" extends="struts-default"> <interceptors> <interceptor name=“permission" class="cn.itcast.aop.PermissionInterceptor" /> <interceptor-stack name="permissionStack"> <interceptor-ref name="defaultStack" /> <interceptor-ref name=" permission " /> </interceptor-stack> </interceptors> <action name="helloworld_*" class="cn.itcast.action.HelloWorldAction" method="{1}"> <result name="success">/WEB-INF/page/hello.jsp</result> <interceptor-ref name="permissionStack"/> </action> </package> 因为struts2中如文件上传，数据验证，封装请求参数到action等功能都是由系统默认的defaultStack中的拦截器实现的，所以我们定义的拦截器需要引用系统默认的defaultStack，这样应用才可以使用struts2框架提供的众多功能。 如果希望包下的所有action都使用自定义的拦截器，可以通过<default-interceptor-ref name=“permissionStack”/>把拦截器定义为默认拦截器。注意：每个包只能指定一个默认拦截器。另外，一旦我们为该包中的某个action显式指定了某个拦截器，则默认拦截器不会起作用。 北京传智播客教育 www.itcast.cn
输入校验 输入校验有两种实现方法: 1. 手工编写代码实现。 2. 基于XML配置方式实现。 北京传智播客教育 www.itcast.cn
手工编写代码实现输入校验 通过重写validate()或validateXxx()方法实现， validate()方法会校验action中所有与execute方法签名相同的方法。 validateXxx()只会校验action中方法名为Xxx的方法。其中Xxx的第一个字母要大写。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport ），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过<s:fielderror/>显示失败信息。 validate()使用例子： @Override public void validate() { if(username==null && "".equals(username.trim())) this.addFieldError("username", "用户名不能为空"); } validateXxx()方法使用例子： public String add() throws Exception{ return "success"; public void validateAdd(){ 验证失败后，请求转发至input视图： <result name="input">/WEB-INF/page/addUser.jsp</result> 在addUser.jsp页面中使用<s:fielderror/>显示失败信息。 北京传智播客教育 www.itcast.cn
输入校验的流程 1。类型转换器对请求参数执行类型转换，并把转换后的值赋给action中的属性。 2。如果在执行类型转换的过程中出现异常，系统会将异常信息保存到ActionContext，conversionError拦截器将异常信息封装到fieldErrors里，然后执行第3步。如果类型转换没有出现异常，则直接进入第3步。 3。系统通过反射技术调用action中的validateXxx()方法，Xxx为方法名。 4。调用action中的validate()方法。 5。经过上面4步，如果系统中的fieldErrors存在错误信息（即存放错误信息的集合的size大于0)，系统自动将请求转发至名称为input的视图。如果系统中的fieldErrors没有任何错误信息，系统将执行action中的处理方法。 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 Action类需要继承ActionSupport，然后提供校验文件，如下： <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 1.0//EN" "http://www.opensymphony.com/xwork/xwork-validator-1.0.dtd"> <validators> <field name="username"> <field-validator type="requiredstring"> <param name="trim">true</param> <message>用户名不能为空!</message> </field-validator> </field> </validators> 在这个校验文件中，对action中字符串类型的username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。该文件需要和action类放在同一个包下，文件的取名应遵守ActionClassName-validation.xml规则，其中ActionClassName为action的简单类名，-validation为固定写法。如果Action类为cn.itcast.action.UserAction，那么该文件的取名应为：UserAction-validation.xml。 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 <field name="username"> <field-validator type="requiredstring"> <param name="trim">true</param> <message>用户名不能为空!</message> </field-validator> </field> <field>指定action中要校验的属性，<field-validator>指定校验器，<message>为校验失败后的提示信息,如果需要国际化，可以为message指定key属性，key的值为属性文件中的key。 上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在xwork-2.x.jar中的com.opensymphony.xwork2.validator.validators下的default.xml中找到。 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 系统提供的校验器如下： required (必填校验器,要求field的值不能为null) requiredstring (必填字符串校验器,要求field的值不能为null,并且长度大于0,默认情况下会对字符串去前后空格) stringlength(字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength参数指定最小长度,maxLength参数指定最大长度,trim参数指定校验field之前是否去除字符串前后的空格) regex(正则表达式校验器,检查被校验的field是否匹配一个正则表达式.expression参数指定正则表达式,caseSensitive参数指定进行正则表达式匹配时,是否区分大小写,默认值为true) int(整数校验器,要求field的整数值必须在指定范围内,min指定最小值,max指定最大值) double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值) fieldexpression(字段OGNL表达式校验器,要求field满足一个ognl表达式,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过) email(邮件地址校验器,要求如果field的值非空,则必须是合法的邮件地址) url(网址校验器,要求如果field的值非空,则必须是合法的url地址) date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值) conversion(转换校验器,指定在类型转换失败时,提示的错误信息) visitor(用于校验action中的复合属性,它指定一个校验文件用于校验复合属性中的属性) expression(OGNL表达式校验器,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过,该校验器不可用在字段校验器风格的配置中) 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 required 必填校验器 <field-validator type="required"> <message>性别不能为空!</message> </field-validator> requiredstring 必填字符串校验器 <field-validator type="requiredstring"> <param name="trim">true</param> <message>用户名不能为空!</message> stringlength：字符串长度校验器 <field-validator type="stringlength"> <param name="maxLength">10</param> <param name="minLength">2</param> <message><![CDATA[产品名称应在1-10个字符之间]]></message> 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 int：整数校验器 <field-validator type="int"> <param name="min">1</param> <param name="max">150</param> <message>年龄必须在1-150之间</message> </field-validator> 字段OGNL表达式校验器 <field name="imagefile"> <field-validator type="fieldexpression"> <param name="expression"><![CDATA[imagefile.length() > 0]]></param> <message>文件不能为空</message> </field> 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 email：邮件地址校验器 <field-validator type="email"> <message>电子邮件地址无效</message> </field-validator> regex：正则表达式校验器 <field-validator type="regex"> <param name="expression"><![CDATA[^13\d{9}$]]></param> <message>手机号格式不正确!</message> 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 当校验文件的取名为ActionClassName-validation.xml时，会对 action中的所有处理方法实施输入验证。如果你只需要对action中的某个处理方法实施验证，那么，校验文件的取名应为:ActionClassName-ActionName-validation.xml，其中ActionName为struts.xml中为action配置的名称。例如：在实际应用中，常有以下配置： <action name="user_*" class="cn.itcast.action.UserAction" method="{1}"> <result name="success">/WEB-INF/page/message.jsp</result> <result name="input">/WEB-INF/page/addUser.jsp</result> </action> UserAction中有以下两个处理方法： public String add() throws Exception{ .... } public String update() throws Exception{ 要对add()方法实施验证，校验文件的取名为： UserAction-user_add-validation.xml 要对update()方法实施验证，校验文件的取名为： UserAction-user_update-validation.xml 北京传智播客教育 www.itcast.cn
基于XML配置方式实现输入校验 当为某个action提供了ActionClassName-validation.xml和ActionClassName-ActionName-validation.xml两种规则的校验文件时，系统按下面顺序寻找校验文件： 1。AconClassName-validation.xml 2。ActionClassName-ActionName-validation.xml 系统寻找到第一个校验文件时还会继续搜索后面的校验文件，当搜索到所有校验文件时，会把校验文件里的所有校验规则汇总，然后全部应用于处理方法的校验。如果两个校验文件中指定的校验规则冲突，则只使用后面文件中的校验规则。 当action继承了另一个action，父类action的校验文件会先被搜索到。假设UserAction继承BaseAction， UserAction在struts.xml的配置如下： <action name="user" class="cn.itcast.action.UserAction" method="{1}"> ..... </action> 访问上面名为user的action，系统先搜索到BaseAction-validation.xml， BaseAction-user-validation.xml，接着搜索到UserAction-validation.xml， UserAction-user-validation.xml。校验规则是这四个文件的总和。 北京传智播客教育 www.itcast.cn
国际化 准备资源文件，资源文件的命名格式如下： baseName_language_country.properties baseName_language.properties baseName.properties 其中baseName是资源文件的基本名，我们可以自定义，但language和country必须是java支持的语言和国家。如： 中国大陆： baseName_zh_CN.properties 美国： baseName_en_US.properties 对于中文的属性文件，我们编写好后，应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文件。命令的使用方式如下： native2ascii 源文件.properties 目标文件.properties 北京传智播客教育 www.itcast.cn
配置全局资源与输出国际化信息 在JSP页面中使用<s:text name=“”/>标签输出国际化信息： 现在两个资源文件： 第一个存放中文：itcast_zh_CN.properties 内容为：user=黎明 第二个存放英语（作为默认语言）： itcast.properties 内容为： user=liming 使用上面的资源文件，在struts.xml中使用常量加载全局资源文件如下： <constant name="struts.custom.i18n.resources" value="itcast" /> itcast为资源文件的基本名。 在JSP页面中使用<s:text name=“”/>标签输出国际化信息： <s:text name=“user”/>，name为属性文件中的key 在Action类中，可以继承ActionSupport，使用getText()方法，该方法的第一个参数用于指定属性文件中的key。 在表单标签中，通过key属性指定属性文件中的key，如： <s:textfield name="realname" key="user"/> 北京传智播客教育 www.itcast.cn
国际化—输出带占位符的国际化信息 属性文件中的内容如下： welcome={0},你好,欢迎来到{1} 在jsp页面中输出带占位符的国际化信息 <s:text name="welcome"> <s:param><s:property value="realname"/></s:param> <s:param>传智播客</s:param> </s:text> 在Action类中获取带占位符的国际化信息，可以使用getText(String key, String[] args)或getText(String aTextName, List args)方法。 北京传智播客教育 www.itcast.cn
国际化—包范围资源文件 在一个大型应用中，整个应用有大量的内容需要实现国际化，我们可以针对不同模块、不同的action来组织国际化文件。 在java的包下放置package_language_country.properties资源文件，package为固定写法，处于该包及子包下的action都可以访问该资源。当查找指定key的消息时，系统会先从package资源文件查找，当找不到对应的key时，才会从常量struts.custom.i18n.resources指定的资源文件中寻找。 使用<s:i18n>标签指定从某个特定的资源文件中取数据 <s:i18n name="messageResource"> <s:text name="helloWorld"></s:text> </s:i18n> 指定在从messageResource取资源 北京传智播客教育 www.itcast.cn
国际化—Action范围资源文件 我们也可以为某个action单独指定资源文件，方法如下： 在Action类所在的路径，放置ActionClassName_language_country.properties资源文件，ActionClassName为action类的简单名称。 当查找指定key的消息时，系统会先从ActionClassName_language_country.properties资源文件查找，如果没有找到对应的key，然后沿着当前包往上查基本名为package 的资源文件，一直找到最顶层包。如果还没有找到对应的key，最后会从常量struts.custom.i18n.resources指定的资源文件中寻找。 北京传智播客教育 www.itcast.cn
国际化—JSP中直接访问某个资源文件 使用<s:i18n>标签指定直接从某个特定的资源文件中取数据 <s:i18n name="itcast"> <s:text name=“welcome”/> </s:i18n> Itcast为类路径下资源文件的基本名。 如果要访问类路径下某个包下的资源文件，如下： <s:i18n name=“cn/itcast/action/package"> <s:text name="welcome"> <s:param>小张</s:param> </s:text> 上面访问cn.itcast.action包下基本名为package的资源文件。 北京传智播客教育 www.itcast.cn
OGNL表达式语言 OGNL是Object Graphic Navigation Language（对象图导航语言）的缩写，它是一个开源项目。 Struts 2框架使用OGNL作为默认的表达式语言。 相对EL表达式，它提供了平时我们需要的一些功能，如： 支持对象方法调用，如xxx.sayHello()； 支持类静态的方法调用和值访问，表达式的格式为@[类全名（包括包路径）]@[方法名 | 值名]，例如：@java.lang.String@format('foo %s', 'bar')或@cn.itcast.Constant@APP_NAME； 操作集合对象。 北京传智播客教育 www.itcast.cn
OGNL表达式语言 标准的OGNL会设定一个根对象（root对象）。假设使用标准OGNL表达式来求值（不使用Struts 2的OGNL表达式），如果OGNL上下文（OgnlContext Map类型）有两个对象：foo对象，在OgnlContext中名称为foo；bar对象，在OgnlContext中名称为bar。同时foo对象被设置为根对象（root）。则利用下面的OGNL表达式求值： #foo.blah // 返回foo.getBlah() #bar.blah //返回bar.getBlah() blah //返回foo.getBlah() ，因为foo为根对象 访问Ognl Context中的对象需要使用#符号标注命名空间，如#bar，如果要访问的属性属于根对象，则可以省略命名空间，直接访问该属性。 北京传智播客教育 www.itcast.cn
OGNL表达式语言 ValueStack(值栈,它是根对象) parameters request OGNL Context session Struts 2中的OGNL Context是ActionContext，结构示意图如下: ValueStack(值栈,它是根对象) parameters request OGNL Context session application attr 北京传智播客教育 www.itcast.cn
OGNL表达式语言 由于ValueStack(值栈)是Struts 2中OGNL的根对象，如果用户需要访问值栈中的对象，则可以直接通过下面的代码访问ValueStack(值栈)中的属性： ${foo} //获得值栈中的foo属性 如果访问其他Context中的对象，由于不是根对象，在访问时，需要加#前缀。 application对象：用于访问ServletContext，例如#application.userName或者#application['userName']，相当于调用Servlet的getAttribute("username")。 session对象：用来访问HttpSession，例如#session.userName或者#session['userName']，相当于调用session.getAttribute("userName")。 request对象：用来访问HttpServletRequest属性（attribute）的Map，例如#request.userName或者#request['userName']，相当于调用request.getAttribute("userName")。 parameters对象：用于访问HTTP的请求参数，例如#parameters.userName或者#parameters['userName']，相当于调用request.getParameter("username")。 attr对象：用于按page->request->session->application顺序访问其属性。 北京传智播客教育 www.itcast.cn
OGNL表达式语言 如果需要一个集合元素的时候（例如List对象或者Map对象），可以使用OGNL中同集合相关的表达式。 <s:set name="list" value="{'zhangming','xiaoi','liming'}" /> <s:iterator value="#list" id="n"> <s:property value="n"/><br> </s:iterator> 生成一个Map对象： <s:set name="foobar" value="#{'foo1':'bar1', 'foo2':'bar2'}" /> <s:iterator value="#foobar" id="n" status="st"> <s:property value="key"/>=<s:property value="value"/><br> Set标签用于将某个值放入指定范围。 scope：指定变量被放置的范围，该属性可以接受application、session、request、 page或action。如果没有设置该属性，则默认放置在OGNL Context中。 value：赋给变量的值.如果没有设置该属性,则将ValueStack栈项的值赋给变量。 北京传智播客教育 www.itcast.cn
OGNL表达式语言 对于集合类型，OGNL表达式可以使用in和not in两个元素符号。其中，in表达式用来判断某个元素是否在指定的集合对象中；not in判断某个元素是否不在指定的集合对象中，如下所示。 in表达式： <s:if test="'foo' in {'foo','bar'}"> 在 </s:if> <s:else> 不在 </s:else> not in表达式： <s:if test="'foo' not in {'foo','bar'}"> 北京传智播客教育 www.itcast.cn
OGNL表达式语言 除了in和not in之外，OGNL还允许使用某个规则获得集合对象的子集，常用的有以下3个相关操作符。 ?：获得所有符合逻辑的元素。 ^：获得符合逻辑的第一个元素。 $：获得符合逻辑的最后一个元素。 例如代码： <s:iterator value="books.{?#this.price > 35}"> <s:property value="title" /> - $<s:property value="price" /><br> </s:iterator> 在上面代码中，直接在集合后紧跟.{}运算符表明用于取出该集合的子集，{}内的表达式用于获取符合条件的元素，本例的表达式用于获取集合中价格大于35的书集合。 public class BookAction extends ActionSupport { private List<Book> books; .... @Override public String execute() { books = new LinkedList<Book>(); books.add(new Book("A735619678", "spring", 67)); books.add(new Book("B435555322", "ejb3.0", 45)); } 北京传智播客教育 www.itcast.cn
property标签 default：可选属性，如果需要输出的属性值为null，则显示该属性指定的值 <s:set name="name" value="'kk'" /> <s:property value="#name"/> default：可选属性，如果需要输出的属性值为null，则显示该属性指定的值 escape：可选属性，指定是否格式化HTML代码。 value：可选属性，指定需要输出的属性值，如果没有指定该属性，则默认输出ValueStack栈顶的值。 id：可选属性，指定该元素的标识 北京传智播客教育 www.itcast.cn
iterator标签 iterator标签用于对集合进行迭代，这里的集合包含List、Set和数组。 <s:set name="list" value="{'zhangming','xiaoi','liming'}" /> <s:iterator value="#list" id="name" status="st"> <font color=<s:if test="#st.odd">red</s:if><s:else>blue</s:else>> <s:property value="name"/></font><br> </s:iterator> value：可选属性，指定被迭代的集合，如果没有设置该属性，则使用ValueStack栈顶的集合。 id：可选属性，指定集合里元素的id。 status：可选属性，该属性指定迭代时的IteratorStatus实例。该实例包含如下几个方法： int getCount()，返回当前迭代了几个元素。 int getIndex()，返回当前迭代元素的索引。 boolean isEven()，返回当前被迭代元素的索引是否是偶数 boolean isOdd()，返回当前被迭代元素的索引是否是奇数 boolean isFirst()，返回当前被迭代元素是否是第一个元素。 boolean isLast()，返回当前被迭代元素是否是最后一个元素。 北京传智播客教育 www.itcast.cn
if/elseif/else标签 <s:set name="age" value="21" /> <s:if test="#age==23"> 23 </s:if> <s:elseif test="#age==21"> 21 </s:elseif> <s:else> 都不等 </s:else> 北京传智播客教育 www.itcast.cn
url标签 <s:url action="helloworld_add" namespace="/test"><s:param name="personid" value="23"/></s:url> 生成类似如下路径： /struts/test/helloworld_add.action?personid=23 红色部分为内容路径。 “%”符号的用途是在标志的属性为字符串类型时，计算OGNL表达式的值。 <s:set name="myurl" value="'http://www.foshanshop.net'"/> <s:url value="#myurl" /><br> <s:url value="%{#myurl}" /> 输出结果： #myurl http://www.foshanshop.net 北京传智播客教育 www.itcast.cn
表单标签_checkboxlist复选框 <s:checkboxlist name="list" list="{'Java','.Net','RoR','PHP'}" value="{'Java','.Net'}"/> 生成如下html代码： <input type="checkbox" name="list" value="Java" checked="checked"/><label>Java</label> <input type="checkbox" name="list" value=".Net" checked="checked"/><label>.Net</label> <input type="checkbox" name="list" value="RoR"/><label>RoR</label> <input type="checkbox" name="list" value="PHP"/><label>PHP</label> 如果集合为MAP <s:checkboxlist name="map" list="#{1:'瑜珈用品',2:'户外用品',3:'球类',4:'自行车'}" listKey="key" listValue="value" value="{1,2,3}"/> <input type="checkbox" name="map" value="1" checked="checked"/><label>瑜珈用品</label> <input type="checkbox" name="map" value="2" checked="checked"/><label>户外用品</label> <input type="checkbox" name="map" value="3" checked="checked"/><label>球类</label> <input type="checkbox" name="map" value="4"/><label>自行车</label> 北京传智播客教育 www.itcast.cn
表单标签_checkboxlist复选框 如果集合里存放的是javabean <% Person person1 = new Person(1,"第一个"); Person person2 = new Person(2,"第二个"); List<Person> list = new ArrayList<Person>(); list.add(person1); list.add(person2); request.setAttribute("persons",list); %> <s:checkboxlist name="beans" list="#request.persons" listKey="personid" listValue="name"/> Personid和name为Person的属性 生成如下html代码： <input type="checkbox" name=“beans" value="1"/><label>第一个</label> <input type="checkbox" name=“beans" value="2"/><label>第二个</label> 北京传智播客教育 www.itcast.cn
表单标签_radio单选框 该标签的使用和checkboxlist复选框相同。 如果集合里存放的是javabean(personid和name为Person的属性) <s:checkboxlist name="beans" list="#request.persons" listKey="personid" listValue="name"/> 生成如下html代码： <input type="radio" name="beans" id="beans1" value="1"/><label>第一个</label> <input type="radio" name="beans" id="beans2" value="2"/><label>第二个</label> 如果集合为MAP <s:radio name="map" list="#{1:'瑜珈用品',2:'户外用品',3:'球类',4:'自行车'}" listKey="key" listValue="value“ value="1"/> <input type="radio" name="map" id="map1" value="1"/><label for="map1">瑜珈用品</label> <input type="radio" name="map" id="map2" value="2"/><label for="map2">户外用品</label> <input type="radio" name="map" id="map3" value="3"/><label for="map3">球类</label> <input type="radio" name="map" id="map4" value="4"/><label for="map4">自行车</label> 如果集合为list <s:radio name="list" list="{'Java','.Net'}" value="'Java'"/> <input type="radio" name="list" checked="checked" value="Java"/><label>Java</label> <input type="radio" name="list" value=".Net"/><label>.Net</label> 北京传智播客教育 www.itcast.cn
表单标签_select下拉选择框 <s:select name="list" list="{'Java','.Net'}" value="'Java'"/> <select name="list" id="list"> <option value="Java" selected="selected">Java</option> <option value=".Net">.Net</option> </select> <s:select name="beans" list="#request.persons" listKey="personid" listValue="name"/> <select name="beans" id="beans"> <option value="1">第一个</option> <option value="2">第二个</option> <s:select name="map" list="#{1:'瑜珈用品',2:'户外用品',3:'球类',4:'自行车'}" listKey="key" listValue="value" value="1"/> <select name="map" id="map"> <option value="1" selected="selected">瑜珈用品</option> <option value="2">户外用品</option> <option value="3">球类</option> <option value="4">自行车</option> 北京传智播客教育 www.itcast.cn
<s:token />标签 <s:token />标签防止重复提交，用法如下： <s:form action="helloworld_other" method="post" namespace="/test"> <s:textfield name="person.name"/><s:token/><s:submit/> </s:form> 第二步： <action name="helloworld_*" class="cn.itcast.action.HelloWorldAction" method="{1}"> <interceptor-ref name="defaultStack" /> <interceptor-ref name="token" /> <result name="invalid.token">/WEB-INF/page/message.jsp</result> <result>/WEB-INF/page/result.jsp</result> </action> 以上配置加入了“token”拦截器和“invalid.token”结果，因为“token”拦截器在会话的token与请求的token不一致时，将会直接返回“invalid.token”结果。 在debug状态,控制台出现下面信息,是因为Action中并没有struts.token和struts.token.name属性,我们不用关心这个错误： 严重: ParametersInterceptor - [setParameters]: Unexpected Exception caught setting 'struts.token' on 'class xxx: Error setting expression 'struts.token' with value '[Ljava.lang.String;@39f16f' 严重: ParametersInterceptor - [setParameters]: Unexpected Exception caught setting 'struts.token.name' 北京传智播客教育 www.itcast.cn