Struts2开发手册.ppt

《Struts2开发手册.ppt》由会员分享，可在线阅读，更多相关《Struts2开发手册.ppt（55页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、Struts2开发手册开发Struts2依赖的jar到http:/struts.apache.org/download.cgi#struts2014下载，目前最新版为。下载完后解压文件，开发struts2应用需要依赖的jar文件在解压目录的lib文件夹下。不同的应用需要的JAR包是不同的。下面给出了开发Struts 2程序最少需要的JAR。struts2-core-2.0.x.jar:Struts 2框架的核心类库xwork-2.0.x.jar:XWork类库，Struts 2在其上构建ognl-2.6.x.jar:对象图导航语言（Object Graph Navigation Languag

2、e），Struts 2框架使用的一种表达式语言freemarker-2.3.x.jar:Struts 2的UI标签的模板使用FreeMarker编写commons-logging-1.0.x.jar:ASF出品的日志包，Struts 2框架使用这个日志包来支持Log4J和JDK 1.4+的日志记录。还有一种最省事的做法是：还有一种最省事的做法是：如果不需要跟第三方框架集成，把不带-plugin结尾的jar文件都添加入类路径。如果需要跟第三方框架集成，这时候还需要加入对应的-plugin jar文件。例如跟spring集成，还需要再加入struts2-spring-plugin-2.x.x.ja

3、r.Struts2的启动配置在struts1.x中，struts框架是通过Servlet启动的。在struts2中，struts框架是通过Filter启动的。他在web.xml中的配置如下：struts2 struts2 /*在FilterDispatcher的init()方法中将会读取类路径下默认的配置文件struts.xml完成初始化操作。注意：struts2读取到struts.xml的内容后，会将内容封装进javabean对象并存放在内存中，对于用户每次请求的处理将使用内存中的数据，而不会每次请求都读取struts.xml文件Struts2的配置文件Struts2默认的配置文件为stru

4、ts.xml，FilterDispatcher过滤器在初始化时将会在WEB-INF/classes下寻找该文件，该文件的配置模版如下：第一个Struts2应用Struts2默认的配置文件为struts.xml，FilterDispatcher过滤器在初始化时将会在WEB-INF/classes下寻找该文件，该文件的配置模版如下：/WEB-INF/page/hello.jsp 第一个Struts2应用例子中使用到的类如下：package;public class HelloWorldActionprivate String message;public String getMessage()re

5、turn message;public void setMessage(String message)this.message=message;public String execute()throws Exceptionthis.message=我的第一个struts2应用;return success;第一个Struts2应用例子中使用到的/WEB-INF/page/hello.jsp如下：第一个struts2应用$message 可以使用EL表达式访问Action中的属性。在Struts.xml配置包/WEB-INF/page/hello.jsp 在struts2框架中使用包来管理Act

6、ion，包这个概念和java中的类包是非常类似的，它主要用于管理一组业务功能相关的action。在实际应用中，我们应该把一组业务功能相关的Action放在同一个包下。配置包时必须指定name属性，如果其他包要继承该包，必须通过该属性进行引用。包的namespace属性用于定义该包的命名空间。该属性可以不配置，对本例而言，如果不指定该属性，默认的命名空间为“”（空字符串）。当某个包指定了命名空间后，该包下所有的Action处理的URL应该是：namespace+Action的名称。对于本例而言，名为helloworld的action处理的URL为：/test/helloworld注意：当在指定的

7、命名空间下找不到Action时，会到默认命名空间里寻找Action。意思是说：如果存在/test/helloworld的请求，并且/test命名空间下没有名为helloworld的action，则默认命名空间下名为helloworld的action将会处理该请求。如果默认命名空间下也没有名为helloworld的action，这时候会出现错误。通常每个包都应该继承struts-default包，struts-default包是由struts内置的，它定义了struts2内置的众多拦截器和Result类型。从请求中把请求参数封装到action、文件上传和数据验证等众多功能都是通过这些内置的拦截器

8、实现的。当包继承了struts-default包才能使用struts2提供的这些功能。struts-default包是在文件中的struts-default.xml中定义。struts-default.xml也是Struts2默认配置文件。Struts2每次都会自动加载 struts-default.xml文件。包还可以通过abstract=“true”定义为抽象包，抽象包中不能包含action。在Struts.xml配置Action/WEB-INF/page/hello.jsp 在struts1中，通过path属性指定访问该action的URL路径。在struts2中，情况就不是这样了，访问

9、struts2中的action的URL路径由两部份组成：包的命名空间+action的名称，例如访问上面例子中名为helloworld的Action的URL路径为：/test/helloworld(注意：完整路径为：http:/localhost:端口/内容路径/test/helloworld.action)。如果没有为action指定class，默认是ActionSupport。而ActionSupport的execute()方法默认处理就是返回一个success字符串。method属性用于指定action中的那个方法，如果没有指定默认执行action中的execute()方法。在Struts

10、.xml配置Action的result/WEB-INF/page/hello.jspresult配置类似于struts1中的forward，但struts2中提供了多种结果类型，如：dispatcher(默认值)、redirect、redirectAction、plainText。下面是redirectAction 结果类型的例子，如果重定向的action中同一个包下：helloworld如果重定向的action在别的命名空间下：helloworld/test如果没有指定result的name属性，默认值为success。在result中还可以使用$属性名表达式，表达式里的属性名对应actio

11、n中的属性。如下：view.jsp?id=$id指定需要Struts 2处理的请求后缀FilterDispatcher是Struts 2框架的核心控制器，它负责拦截由/*指定的所有用户请求，当用户请求到达时，该Filter会过滤用户请求。默认情况下，如果用户请求的路径以.action结尾，该请求将被转入Struts 2框架处理，否则该请求将略过Struts 2框架的处理。默认处理的后缀是可以通过常量”“进行修改的，如下面配置Struts 2只处理以.do为后缀的请求路径：如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。如：Struts2的处理流程FilterDispatche

12、rInterceptorActionResultJsp/html用户请求Struts2内置的一些拦截器或用户自定义拦截器用户编写的action类，类似struts1中的Action类似struts1中的forward响应指定多个配置文件在大部分应用里，随着应用规模的增加，系统中Action数量也大量增加，导致struts.xml配置文件变得非常臃肿。为了避免struts.xml文件过于庞大、臃肿，提高struts.xml文件的可读性，我们可以将一个struts.xml配置文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。下面的struts.xml通过元素指定多个配置文件

13、：通过这种方式，我们就可以将Struts 2的Action按模块配置在多个配置文件中。为Action的属性注入值public class HelloWorldActionprivate String savePath;public String getSavePath()return savePath;public void setSavePath(String savePath)this.savePath=savePath;./images/WEB-INF/page/hello.jsp上面通过节点为action的savePath属性注入“/images”动态方法调用如果Action中存在多个

14、方法时，我们可以使用!+方法名调用指定方法。如下：public class HelloWorldActionprivate String message;.public String execute()throws Exceptionthis.message=我的第一个struts2应用;return success;public String other()throws Exceptionthis.message=第二个方法;return success;假设访问上面action的URL路径为：/struts/test/helloworld.action要访问action的other()方法

15、，我们可以这样调用：/struts/test/helloworld!other.action通常不建议大家使用动态方法调用，我们可以通过常量关闭动态方法调用。使用通配符定义action/WEB-INF/page/hello.jsppublic class HelloWorldActionprivate String message;.public String execute()throws Exceptionthis.message=我的第一个struts2应用;return success;public String other()throws Exceptionthis.message=

16、第二个方法;return success;要访问other()方法，可以通过这样的URL访问：/test/helloworld_other.action全局结果当多个action中都使用到了相同result，这时我们应该把result定义为全局结果。struts1中提供了全局forward，struts2中也提供了相似功能：/message.jsp定义常量常量可以在struts.xml或struts.properties中配置，建议在struts.xml中配置，两种配置方式如下：struts.xml struts.properties=do通常,struts2按如下搜索顺序加载struts2常

17、量:struts-default.xmlstruts-plugin.xmlstruts.xmlstruts.propertiesweb.xml如果在多个文件中配置了同一个常量,则后一个文件中配置的常量值会覆盖前面文件中配置的常量值.常用的常量 文件上传第一步：在第一步：在WEB-INF/lib下加入、。这两个文件可以从下加入、。这两个文件可以从http:/下载。下载。第二步：把第二步：把form表的表的enctype设置为：设置为：“multipart/form-data“，如下：如下：第三步：在第三步：在Action类中添加以下属性，类中添加以下属性，属性红色部分对应于表单中文件字段的名称属

18、性红色部分对应于表单中文件字段的名称：public class HelloWorldAction private File uploadFile;/得到上传的文件 private String uploadFileContentType;/得到文件的类型 private String uploadFileFileName;/得到文件的名称 /这里略省了属性的getter/setter方法 public String upload()throws ExceptionString realpath=ServletActionContext.getServletContext().getRealPa

19、th(/images);File file=new File(realpath);if(!file.exists()file.mkdirs();FileUtils.copyFile(uploadFile,new File(file,uploadFileFileName);return success;在request/session/application中访问或添加属性public String scope()throws Exception ActionContext ctx=ActionContext.getContext();ctx.getApplication().put(app,应

20、用范围);/往ServletContext里放入app ctx.getSession().put(ses,session范围);/往session里放入ses ctx.put(req,request范围);/往request里放入req return scope;JSP:$applicationScope.app$sessionScope.ses$requestScope.req 获取HttpServletRequest/HttpSession/ServletContext/HttpServletResponse对象方法一，通过ServletActionContext.类直接获取：public

21、 String rsa()throws ExceptionHttpServletRequest request=ServletActionContext.getRequest();ServletContext servletContext=ServletActionContext.getServletContext();request.getSession()HttpServletResponse response=ServletActionContext.getResponse();return scope;方法二，实现指定接口，由struts框架运行时注入：public class Hel

22、loWorldAction implements ServletRequestAware,ServletResponseAware,ServletContextAwareprivate HttpServletRequest request;private ServletContext servletContext;private HttpServletResponse response;public void setServletRequest(HttpServletRequest req)this.request=req;public void setServletResponse(Http

23、ServletResponse res)this.response=res;public void setServletContext(ServletContext ser)this.servletContext=ser;自定义类型转换器下面的action中使用到了枚举类型Gender，当需要将请求参数注入到gender属性时，我们必须定义转换器，否则struts2无法自动完成类型转换。public class HelloWorldAction private Gender gender;public Gender getGender()return gender;public void se

24、tGender(Gender gender)this.gender=gender;public enum Gender MAN,WOMEN自定义类型转换器下面定义了一个针对Gender类型的类型转换器：public class GenderConverter extends DefaultTypeConverter Overridepublic Object convertValue(Map context,Object value,Class toType)if(toType=Gender.class)/当字符串向Gender类型转换时String params=(String)value;

25、return Gender.valueOf(params0);else if(toType=String.class)/当Gender转换成字符串时Gender gender=(Gender)value;return gender.toString();return null;将上面的类型转换器注册为局部类型转换器：在Action类所在的包下放置ActionClassName-conversion.properties文件，ActionClassName是Action的类名，后面的-conversion.properties是固定写法，对于本例而言，文件的名称应为HelloWorldActio

26、n-conversion.properties。在properties文件中的内容为：属性名称=类型转换器的全类名对于本例而言，HelloWorldAction-conversion.properties文件中的内容为：gender=自定义类型转换器将上面的类型转换器注册为全局类型转换器：在WEB-INF/classes下放置xwork-conversion.properties文件。在properties文件中的内容为：待转换的类型=类型转换器的全类名对于本例而言，xwork-conversion.properties文件中的内容为：=自定义拦截器要自定义拦截器需要实现接口：public c

27、lass PermissionInterceptor implements Interceptor private static final long serialVersionUID public void destroy()public void init()public String intercept(ActionInvocation invocation)throws Exception (进入拦截器);String result=invocation.invoke();(返回值:+result);return result;自定义拦截器 /WEB-INF/page/hello.js

28、p因为struts2中如文件上传，数据验证，封装请求参数到action等功能都是由系统默认的defaultStack中的拦截器实现的，所以我们定义的拦截器需要引用系统默认的defaultStack，这样应用才可以使用struts2框架提供的众多功能。如果希望包下的所有action都使用自定义的拦截器，可以通过把拦截器定义为默认拦截器。注意：每个包只能指定一个默认拦截器。另外，一旦我们为该包中的某个action显式指定了某个拦截器，则默认拦截器不会起作用。输入校验输入校验有两种实现方法:1.手工编写代码实现。2.基于XML配置方式实现。手工编写代码实现输入校验通过重写validate()或val

29、idateXxx()方法实现，validate()方法会校验action中所有与execute方法签名相同的方法。validateXxx()只会校验action中方法名为Xxx的方法。其中Xxx的第一个字母要大写。当某个数据校验失败时，我们应该调用addFieldError()方法往系统的fieldErrors添加校验失败信息（为了使用addFieldError()方法，action可以继承ActionSupport），如果系统的fieldErrors包含失败信息，struts2会将请求转发到名为input的result。在input视图中可以通过显示失败信息。validate()使用例子：使

30、用例子：Overridepublic void validate()if(username=null&.equals(username.trim()this.addFieldError(username,用户名不能为空用户名不能为空);validateXxx()方法使用例子：方法使用例子：public String add()throws Exceptionreturn success;public void validateAdd()if(username=null&.equals(username.trim()this.addFieldError(username,用户名不能为空用户名不能

31、为空);验证失败后，请求转发至验证失败后，请求转发至input视图：视图：/WEB-INF/page/addUser.jsp在在addUser.jsp页面中使用页面中使用显示失败信息。显示失败信息。输入校验的流程1。类型转换器对请求参数执行类型转换，并把转换后的值赋给action中的属性。2。如果在执行类型转换的过程中出现异常，系统会将异常信息保存到ActionContext，conversionError拦截器将异常信息封装到fieldError里，然后执行第3步。如果类型转换没有出现异常，则直接进入第3步。3。系统通过反射技术调用action中的validateXxx()方法，Xxx为方法

32、名。4。调用action中的validate()方法。5。经过上面4步，如果系统中的fieldErrors存在错误信息（即存放错误信息的集合的size大于0)，系统自动将请求转发至名称为input的视图。如果系统中的fieldErrors没有任何错误信息，系统将执行action中的处理方法。基于XML配置方式实现输入校验 true 用户名不能为空!在这个校验文件中，对action中字符串类型的username属性进行验证，首先要求调用trim()方法去掉空格，然后判断用户名是否为空。该文件需要和action类放在同一个包下，文件的取名应遵守ActionClassName-validation.

33、xml规则，其中ActionClassName为action的简单类名，-validationl为固定写法。如果Action类为，那么该文件的取名应为：UserAction-validation.xml。基于XML配置方式实现输入校验 true 用户名不能为空!指定action中要校验的属性，指定校验器，为校验失败后的提示信息,如果需要国际化，可以为message指定key属性，key的值为属性文件中的key。上面指定的校验器requiredstring是由系统提供的，系统提供了能满足大部分验证需求的校验器，这些校验器的定义可以在中的下的default.xml中找到。基于XML配置方式实现输入

34、校验系统提供的校验器如下：required(必填校验器,要求field的值不能为null)requiredstring(必填字符串校验器,要求field的值不能为null,并且长度大于0,默认情况下会对字符串去前后空格)stringlength(字符串长度校验器,要求field的值必须在指定的范围内,否则校验失败,minLength参数指定最小长度,maxLength参数指定最大长度,trim参数指定校验field之前是否去除字符串前后的空格)regex(正则表达式校验器,检查被校验的field是否匹配一个正则表达式.expression参数指定正则表达式,caseSensitive参数指定进

35、行正则表达式匹配时,是否区分大小写,默认值为true)int(整数校验器,要求field的整数值必须在指定范围内,min指定最小值,max指定最大值)double(双精度浮点数校验器,要求field的双精度浮点数必须在指定范围内,min指定最小值,max指定最大值)fieldexpression(字段OGNL表达式校验器,要求field满足一个ognl表达式,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过)email(邮件地址校验器,要求如果field的值非空,则必须是合法的邮件地址)url(网址校验器,要求如果fi

36、eld的值非空,则必须是合法的url地址)date(日期校验器,要求field的日期值必须在指定范围内,min指定最小值,max指定最大值)conversion(转换校验器,指定在类型转换失败时,提示的错误信息)visitor(用于校验action中的复合属性,它指定一个校验文件用于校验复合属性中的属性)expression(OGNL表达式校验器,expression参数指定ognl表达式,该逻辑表达式基于ValueStack进行求值,返回true时校验通过,否则不通过,该校验器不可用在字段校验器风格的配置中)基于XML配置方式实现输入校验required 必填校验器 性别不能为空!requi

37、redstring 必填字符串校验器 true 用户名不能为空!stringlength：字符串长度校验器102true基于XML配置方式实现输入校验int：整数校验器1150年龄必须在1-150之间字段OGNL表达式校验器 0文件不能为空基于XML配置方式实现输入校验email：邮件地址校验器电子邮件地址无效regex：正则表达式校验器 手机号格式不正确!基于XML配置方式实现输入校验当校验文件的取名为ActionClassName-validation.xml时，会对 action中的所有处理方法实施输入验证。如果你只需要对action中的某个处理方法实施验证，那么，校验文件的取名应为:A

38、ctionClassName-ActionName-validation.xml，其中ActionName为struts.xml中为action配置的名称。例如：在实际应用中，常有以下配置：/WEB-INF/page/message.jsp/WEB-INF/page/addUser.jspUserAction中有以下两个处理方法：public String add()throws Exception .public String update()throws Exception .要对add()方法实施验证，校验文件的取名为：UserAction-user_add-validation.xml

39、要对update()方法实施验证，校验文件的取名为：UserAction-user_update-validation.xml基于XML配置方式实现输入校验当为某个action提供了ActionClassName-validation.xml和ActionClassName-ActionName-validation.xml两种规则的校验文件时，系统按下面顺序寻找校验文件：1。AconClassName-validation.xml2。ActionClassName-ActionName-validation.xml系统寻找到第一个校验文件时还会继续搜索后面的校验文件，当搜索到所有校验文件时，

40、会把校验文件里的所有校验规则汇总，然后全部应用于处理方法的校验。如果两个校验文件中指定的校验规则冲突，则只使用后面文件中的校验规则。当action继承了另一个action，父类action的校验文件会先被搜索到。假设UserAction继承BaseAction，UserAction在struts.xml的配置如下：.访问上面名为user的action，系统先搜索到BaseAction-validation.xml，BaseAction-user-validation.xml，接着搜索到UserAction-validation.xml，UserAction-user-validation.xm

41、l。校验规则是这四个文件的总和。国际化准备资源文件，资源文件的命名格式如下：baseName_language_country.propertiesbaseName_language.propertiesbaseName.properties其中baseName是资源文件的基本名，我们可以自定义，但language和country必须是java支持的语言和国家。如：中国大陆：baseName_zh_CN.properties美国：baseName_en_US.properties对于中文的属性文件，我们编写好后，应该使用jdk提供的native2ascii命令把文件转换为unicode编码的文

42、件。命令的使用方式如下：native2ascii 源文件.properties 目标文件.properties配置全局资源与输出国际化信息现在两个资源文件：第一个存放中文：itcast_zh_CN.properties内容为：user=黎明第二个存放英语（作为默认语言）：itcast.properties内容为：user=liming使用上面的资源文件，在struts.xml中使用常量加载全局资源文件如下：itcast为资源文件的基本名。l在JSP页面中使用标签输出国际化信息：，name为属性文件中的keyl在Action类中，可以继承ActionSupport，使用getText()方法，该

43、方法的第一个参数用于指定属性文件中的key。l在表单标签中，通过key属性指定属性文件中的key，如：国际化输出带占位符的国际化信息属性文件中的内容如下：welcome=0,你好,欢迎来到1在jsp页面中输出带占位符的国际化信息 传智播客在Action类中获取带占位符的国际化信息，可以使用getText(String key,String args)或getText(String aTextName,List args)方法。国际化包范围资源文件在一个大型应用中，整个应用有大量的内容需要实现国际化，我们可以针对不同模块、不同的action来组织国际化文件。在java的包下放置package_l

44、anguage_country.properties资源文件，package为固定写法，处于该包及子包下的action都可以访问该资源。当查找指定key的消息时，系统会先从package资源文件查找，当找不到对应的key时，才会从常量指定的资源文件中寻找。使用标签指定从某个特定的资源文件中取数据 指定在从messageResource取资源国际化Action范围资源文件我们也可以为某个action单独指定资源文件，方法如下：在Action类所在的路径，放置ActionClassName_language_country.properties资源文件，ActionClassName为action

45、类的简单名称。当查找指定key的消息时，系统会先从ActionClassName_language_country.properties资源文件查找，如果没有找到对应的key，然后沿着当前包往上查基本名为package 的资源文件，一直找到最顶层包。如果还没有找到对应的key，最后会从常量指定的资源文件中寻找。国际化JSP中直接访问某个资源文件使用标签指定直接从某个特定的资源文件中取数据 Itcast为类路径下资源文件的基本名。如果要访问类路径下某个包下的资源文件，如下：小张 上面访问包下基本名为package的资源文件。OGNL表达式语言OGNL是Object Graphic Navigat

46、ion Language（对象图导航语言）的缩写，它是一个开源项目。Struts 2框架使用OGNL作为默认的表达式语言。相对EL表达式，它提供了平时我们需要的一些功能，如：l支持对象方法调用，如xxx.sayHello()；l支持类静态的方法调用和值访问，表达式的格式为类全名（包括包路径）方法名|值名，例如：java.lang.Stringformat(foo%s,bar)或cn.itcast.ConstantAPP_NAME；l操作集合对象。OGNL表达式语言标准的OGNL会设定一个根对象（root对象）。假设使用标准OGNL表达式来求值（不使用Struts 2的OGNL表达式），如果OG

47、NL上下文（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，如果要访问的属性属于根对象，则可以省略命名空间，直接访问该属性。OGNL表达式语言Struts 2中的OGNL Context

48、是ActionContext，结构示意图如下:ValueStack(根对象)OGNL ContextparametersrequestsessionapplicationattrOGNL表达式语言由于ValueStack(值栈)是Struts 2中OGNL的根对象，如果用户需要访问值栈中的对象，则可以直接通过下面的代码访问ValueStack(值栈)中的属性：$foo/获得值栈中的foo属性如果访问其他Context中的对象，由于不是根对象，在访问时，需要加#前缀。lapplication对象对象：用于访问ServletContext，例如#application.userName或者#app

49、licationuserName，相当于调用Servlet的getAttribute(username)。lsession对象对象：用来访问HttpSession，例如#session.userName或者#sessionuserName，相当于调用session.getAttribute(userName)。lrequest对象对象：用来访问HttpServletRequest属性（attribute）的Map，例如#request.userName或者#requestuserName，相当于调用request.getAttribute(userName)。lparameters对象对象：用

50、于访问HTTP的请求参数，例如#parameters.userName或者#parametersuserName，相当于调用request.getParameter(username)。lattr对象对象：用于按page-request-session-application顺序访问其属性。OGNL表达式语言如果需要一个集合元素的时候（例如List对象或者Map对象），可以使用OGNL中同集合相关的表达式。使用如下代码直接生成一个List对象：生成一个Map对象：=Set标签用于将某个值放入指定范围。scope：指定变量被放置的范围，该属性可以接受application、session、req