Microsoft Word - 第5章.doc

Transcription

1 第 5 章 解密 Struts 之核心文件 在第 4 章中简单介绍了 Java Web 开发的三大框架之一的 Struts 2 框架的一些基本概念及其开发的流程 在 Struts 2 项目开发中, 有一个重要的过程就是其配置文件的配置 本章将介绍 Struts 核心配置文件的具体作用及其配置方式, 然后介绍 Struts 2 框架中的另一种文件 Action 类文件, 本章的主要内容如下 : 配置文件 web.xml 配置文件 struts.properties 配置文件 struts.xml Action 类文件 5.1 Struts 配置文件之 web.xml 本节介绍 Struts 2 框架中的 web.xml 配置文件, 先介绍该文件的主要作用, 然后对该文件中的关键元素进行分析 web.xml 文件中包含了大量的标签元素, 这些元素都对应着各自不同的功能 web.xml 文件中的元素种类繁多, 但读者不需要记住所有的, 只需要掌握一些常用的标签元素即可 web.xml 的主要作用 不管是基于 MVC 框架的 struts 2 框架, 还是基于 Servlet 的纯 JSP 工程, 只要开发者想要开发 Java Web 的程序, 就不得不学习 web.xml 文件的相关知识 所以,web.xml 是 Struts 2 框架中一个非常重要的配置文件, 对 Web 应用中一些初始信息进行了配置 Struts 2 框架要先依赖于过滤器 FilterDispatcher 来截获 Web 程序的 HTTP 请求, 再做进一步的处理 这就必须在 web.xml 文件中来配置 FilterDispatcher 过滤器 web.xml 除了用来配置过滤器外, 还可以用来配置 <session-config> 会话时间 欢迎页 错误页 监听器 控制器等等 web.xml 文件中含有一系列标签元素, 这些标签元素代表了不同的功能, 读者需要掌握其中一些基本的用法 web.xml 文件中可以包含哪些元素是由其对应的 Schema 文件来定义的 因此, 必须在每个 web.xml 文件的根元素 web-app 中指定其 Schema 文件的版本 web.xml 的 Schema 文件由 Sun 公司定义 01 <?xml version="1.0" encoding="utf-8"?> 02 <web-app id="webapp_9" version="2.4" xmlns="

2 第 2 篇表现层框架 Struts 技术 xml/ns/j2ee" 03 xmlns:xsi=" 04 xsi:schemalocation=" </web-app> 在上面代码的第 1 行定义了 XML 文件的版本和编码方式, 接着在 <web-app> </web-app> 标签中 ( 即第 2~6 行 ) 指明了 Schema 文件的来源 当需要添加其他标签时, 应该将其加入到 <web-app></web-app> 标签之间 ( 即第 5 行省略部分 ) web.xml 关键元素分析 下面对 web.xml 中的常用元素做一下介绍 1.welcome-file-list 和 welcome-file 元素 在访问一个网站时, 用户看到的第一个页面就是欢迎页面 通常, 欢迎页面都在 web.xml 中指定, 但在一个 Web 工程中 web.xml 并不是必须存在的 随着 Web 应用的功能越来越复杂,web.xml 逐渐变得日益重要, 因此, 一般在 Eclipse 中创建动态 Web 工程时都让其为我们自动生成一个 web.xml 文件 如果在访问 Web 应用时, 只指定了一个根名, 而没有指定具体的页面或 Action, 那么 Tomcat 就会查看 web.xml 中是否指定了欢迎页面, 如果指定了, 则访问此欢迎页面 ; 否则, Tomcat 默认会去查找 index.html 和 index.jsp 页面 ; 如果这两个页面也不存在, 就会报错 在 web.xml 文件中, welcome-file-list 和 welcome-file 元素就是用来指定欢迎页面的, welcome-file-list 元素可以包含多个 welcome-file 元素, 每个 welcome-file 元素指定一个欢迎页面 如下代码所示 : <welcome-file-list> <!-- 欢迎页面 --> <welcome-file>a.jsp</welcome-file> <welcome-file>b.jsp</welcome-file> </welcome-file-list> 在上面代码中,Tomcat 会按顺序来查找欢迎页面, 即如果 Web 应用中存在 a.jsp, 则它就是欢迎页面, 否则继续查找 b.jsp 2.filter 和 filter-mapping 元素 filter 元素用于声明一个过滤器, 使用该元素可以同时拦截多个请求的 URL filter-mapping 元素用来指定与过滤器关联的 URL, 代码如下 : <!-- 定义 Filter--> <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字, 不能为空 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter.strutspreparea ndexecutefilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> 124

3 第 5 章解密 Struts 之核心文件 <filter-mapping> <filter-name>struts2</filter-name> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> 上面代码中 <url-pattern></url-pattern> 标签中的 /* 表明该过滤器可以拦截所有的 HTTP 请求 3.error-page 元素 虽然 Struts 框架提供了通用的错误处理机制, 但是并不能保证对所有错误和异常都能进行处理 如果 Struts 框架不能处理某种错误, 就会把它抛给 Web 容器来处理 默认情况下,Web 容器会将原始的错误信息返回给用户浏览器, 如 HTTP404 错误 如果不希望用户看到原始的错误信息, 就可以在 web.xml 文件的 error-page 元素中进行配置 还可以通过配置 error-page 元素来捕获 Java 异常, 此时需要设置 exception-type 子元素来指定 Java 异常类 error-page 元素用来指定错误处理页面 可以通过配置错误码元素 error-code 以避免用户直接看到原始错误信息 还可以配置异常类型元素 exception-type 来指定 Java 中的异常类, 代码如下 : <!-- 配置异常页 --> <error-page> <error-code>404</error-code> <!-- 指定错误代码 --> <location>/error.jsp</location> <!-- 如果发生 HTTP404 错误, 则返回 location 子元素中指定的文件 --> </error-page> <!-- 下面代码段和上面代码段效果一样 --> <!-- 配置 error-page 元素用于捕获 Java 异常 --> <error-page> <exception-type>java.lang.exception<exception-type><!-- 指定 Java 异常类 --> <location>/error.jsp<location> </error-page> 4.listener 元素 该元素用来注册监听器类, 并使用子元素 listener-class 指定监听程序的完整限定类名, 下面的代码设置了监听器, 用于初始化 Spring 框架 : <!-- 监听器 --> <listener> <listener-class>org.springframework.web.context.contextloaderlistener </listener-class> </listener> 5.session-config 元素 该元素用来指定会话过期时间, 下面代码表示会话时间超过 30 分钟,session 对象里面存放的值会自动失效 : <!-- 会话时间配置 --> <session-config> 125

4 第 2 篇表现层框架 Struts 技术 <session-timeout>30</session-timeout> </session-config> 通常, 该元素用在需要记录用户登录状态的时间的应用中, 将用户登录的关键信息放入 session 对象中 如果用户登录的时间超过配置的时间, 该信息就会丢失, 这样用户就需要重新登录 因此, 使用该元素可以保证用户的登录安全 6.init-param 元素 该元素用来定义参数, 在 web.xml 中可以有多个 init-param 元素 下面的代码使用 init-param 元素设置了常量 : <!-- 配置常量 --> <init-param> <param-name> struts.i18n.encoding </param-name> <param-value> UTF-8</param-value> </init-param> 例 5-1 本例说明 web.xml 配置文件的使用方式 (1) 首先在 Eclipse 中创建一个新工程 ErrorPage, 将 Struts 2 框架所需的支持库添加到 WEB-INF 目录下的 lib 文件夹中 在 WEB-INF 目录下创建 web.xml 文件, 打开 web.xml 并写入如下代码 : <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_9" version="2.4" xmlns=" xmlns:xsi=" xsi:schemalocation=" <!-- 定义 Filter--> <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字, 不能为空 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts 2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> <filter-mapping> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> <!-- 欢迎页面 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <!-- 错误 404 页面 --> <error-page> <error-code>404</error-code> <location>/error.jsp</location> </error-page> </web-app> (2) 在 WebContent 目录下创建 index.jsp error.jsp 文件, 分别打开并编写代码, 核心代码如下 126

5 第 5 章解密 Struts 之核心文件 index.jsp 核心代码 : <body> <!--a 标签 --> <s:a action="hello">hello</s:a> </body> error.jsp 核心代码 : <body> <!-- 控制文本水平居中 --> <center> <h4>the page you request is not existing!</h4> </center> </body> (3) 运行程序, 结果如图 5.1 所示, 单击链接后, 出现如图 5.2 所示的页面 图 5.1 例 5-1 运行结果 图 5.2 单击链接后 在这个例子中, 由于没有配置 struts.xml 等文件, 单击链接时会发生错误, 其错误码是 404, 根据 web.xml 文件中的配置, 会转到 error.jsp 页面 读者需要注意的是, 当 Web 应用程序运行过程中出错时, 会有对应的 HTTP 状态码与出现的错误相匹配,Web 服务器根据状态码就会返回相应的页面 此处由于在 web.xml 中配置了 404 错误的错误处理页面为 error.jsp, 所以会转到 error.jsp; 否则, 会转到 Web 服务器定义的 404 页面 404 错误码表示用户访问的页面不存在, 除此以外还有其他一些常用的 HTTP 状态码如下所示 : 200: 服务器成功返回网页 404: 请求的网页不存在 503: 服务不可用 403:Forbidden( 禁止 ), 服务器拒绝请求 408:Request Timeout( 请求超时 ), 服务器等候请求时发生超时 413:Request Entity Too Large( 请求实体过大 ), 服务器无法处理请求, 因为请求实体过大, 超出服务器的处理能力 414:Request-URI Too Long( 请求的 URI 过长 ), 请求的 URI( 通常为网址 ) 过长, 服务器无法处理 415:Unsupported Media Type( 不支持的媒体类型 ), 请求的格式不受请求页面的支持 416:Requested Range Not Satisfiable( 请求范围不符合要求 ), 如果页面无法提供请求的范围, 则服务器会返回此状态代码 127

6 第 2 篇表现层框架 Struts 技术 417:Expectation Failed( 未满足期望值 ), 服务器未满足 期望 请求标头字段的要求 500:Internal Server Error( 服务器内部错误 ), 服务器遇到错误, 无法完成请求 501:Not Implemented( 尚未实施 ), 服务器不具备完成请求的功能 例如, 服务器无法识别请求方法时可能会返回此代码 502:Bad Gateway( 错误网关 ), 服务器作为网关或代理, 从上游服务器收到无效响应 503:Service Unavailable( 服务不可用 ), 服务器目前无法使用 ( 由于超载或停机维护 ) 通常, 这只是暂时状态 504:Gateway Timeout( 网关超时 ), 服务器作为网关或代理, 但是没有及时从上游服务器收到请求 505:HTTP Version Not Supported(HTTP 版本不受支持 ), 服务器不支持请求中所用的 HTTP 协议版本 5.2 Struts 配置文件之 struts.properties 在 5.1 节介绍了 Struts 2 框架中的一个配置文件 web.xml, 本节将介绍 Struts 2 中的 struts.properties 配置文件 先介绍 struts.properties 文件的主要作用, 然后对文件中的关键元素进行详细分析 在 Struts 工程的开发中, 需要用到大量的属性, 这些属性大多在默认的配置文件中已经配置好, 但根据用户需求的不同, 开发的要求也不同, 可能需要更改这些属性值, 改变这些属性值的方法就是在 struts.properties 文件中来配置即可 struts.properties 的主要作用 struts.properties 是 Struts 2 框架中一个重要的配置文件, 程序员可以通过它来管理 Struts 2 框架中定义的大量常量 struts.properties 文件是一个标准的 properties 文件, 其格式是 key-value 对, 即每个 key 对应一个 value,key 表示的是 Struts 2 框架中的常量, 而 value 则是其常量值 struts.properties 文件必须放到 Web 应用下的类加载路径下才能使用, 即 WEB-INF/classes 路径下 在 Eclipse 中, 由于编译时,Eclipse 会自动将 src 路径下的 struts.properties 文件编译后放到 WEB-INF classes 路径下, 所以, 通常直接将其放到 src 路径下就可以了 前面说过,struts.properties 是一个 key-value 文件, 所以其格式比较简单, 下面是 struts.properties 文件的代码片段 : ### 设置默认编码集为 UTF-8 格式 struts.i18n.encoding=utf-8 ### 设置使用开发模式 struts.devmode=true ### 设置默认的 local 为 en_us struts.locale=en_us 128

7 第 5 章解密 Struts 之核心文件 struts.properties 关键元素分析 下面介绍一些常用的 Struts 2 常量 : struts.i18n.encoding: 该常量指定了 Web 应用中的默认编码集 通常, 由于使用中文字符集, 将其设置为 UTF-8 struts.devmode: 该常量指定 Struts 2 是否使用开发模式 当值设为 true 时, 表示使用开发模式, 可以在应用程序出错时显示更详细的出错提示 其默认值为 false 通常, 在开发阶段, 建议使用开发模式 ; 当产品发布后, 则可将该常量设置为 false struts.configuration: 该常量指定 Struts 2 框架的配置管理器, 如果程序员要开发自己的配置管理器, 需实现一个 Configuration 接口的类, 该类会自己加载 Struts 2 配置文件 struts.locale: 该常量指定 Web 应用的默认 Locale, 默认的 Locale 是 en_us struts.action.extension: 该常量指定由 Struts 2 处理的请求后缀 程序员可以根据需要设置, 默认的后缀是 action, 要设置多个请求后缀时要用逗号隔开 struts.tag.altsyntax: 该常量指定是否在 Struts 2 标签中使用表达式语法, 一般设置为 true struts.ui.theme: 该常量指定视图中 Struts 2 标签默认的主题, 默认值是 xhtml struts.custom.i18n.resources: 该常量指定 Web 应用所需要的国际化资源文件, 多个文件名用逗号隔开 struts.custom.properties: 该常量指定加载附加的配置文件的位置 struts.enable.dynamicmethodinvocation: 该常量指定 Struts 2 框架是否支持动态方法调用, 默认值为 true, 如果要关闭动态方法调用, 设置该常量为 false struts.i18n.reload: 该常量指定国际化信息是否自动加载, 默认值为 true, 如果不自动加载国际化信息, 则设置该常量为 false struts.url.http.port: 该常量指定 Web 应用的端口 以上只对一部分常用的常量进行了介绍, 读者如果想了解更多 Struts 2 常量的内容, 可以查阅相关资料 5.3 Struts 配置文件之 struts.xml 在 5.2 节中介绍了 struts.xml 配置文件, 本节将介绍 Struts 2 框架中的 struts.xml 配置文件, 先介绍 struts.xml 文件的主要作用, 然后对该文件中的关键元素进行分析 实际上, 在开发 Struts 项目的过程中,struts.xml 文件的使用频率和 web.xml 文件差不多, 二者都在 Struts 项目中得到了广泛的运用 所以,struts.xml 文件是开发 Struts 项目所必须掌握的 struts.xml 的主要作用 和 struts.properties 一样,struts.xml 也是 Struts 2 框架中一个重要的配置文件, 其存放 129

8 第 2 篇表现层框架 Struts 技术 路径和 struts.properties 一样, 位于 WEB-INF/classes 路径下 struts.xml 文件主要用来配置 Action 和 HTTP 请求的对应关系, 以及配置逻辑视图和物理视图资源的对应关系 但除了这些功能之外,struts.xml 文件还有一些额外的功能, 如配置常量 导入其他配置文件等 相比 struts.properties 文件格式,struts.xml 文件配置的格式复杂得多 下面的代码是 struts.xml 文件最基本的配置 : <!-- 必不可少的 --> <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <!--struts 根元素 --> <struts> <!-- 配置包 default, 命名空间为 / --> <package name="default" namespace="/" extends="struts-default"> <!-- 配置名为 NN 的 Action, 实现类为 XXXAction--> <action name="nn" class=" XXXAction"> <result>/yy.jsp</result> <!-- 返回 YY.jsp --> </action> </package> </struts> 在上面代码中,<struts../> 是根标签, 所有其他的标签都放在 <struts></struts> 中间 ; package 元素定义了一个包, 在 Struts 2 框架中, 用包来组织 Action 和拦截器等, 每个包都是零个或多个拦截器以及 Action 所组成的集合 ;action 元素定义了一个 Action 和其对应的类 ;result 元素定义了 Action 返回结果对应的 JSP 视图 struts.xml 关键元素分析 下面对 struts.xml 的相关内容进行详细介绍 1. 几个重要的元素 (1)package 元素 package 元素用来配置包 在 Struts 2 框架中, 包是一个独立的单位, 通过 name 属性 来唯一标识包 还可以通过指定 extends 属性让一个包继承另一个包,extends 属性值就是 被继承包的 name 属性值, 继承包可以从被继承包那里继承到拦截器 Action 等 此外,Struts 2 还提供了 abstract 属性, 表示该包是一个抽象包, 抽象包中不能有 Action 的定义 package 元素的属性如表 5.1 所示 表 5.1 package 元素属性 属性 说 明 name 这是一个必须属性, 标识包的名字, 以便在其他包中被引用 extends 可选属性, 指定该包继承自其他包 namespace 可选属性, 指定命名空间, 标识此包下的 Action 的访问路径 abstract 可选属性, 指定该包为抽象包 130

9 第 5 章解密 Struts 之核心文件 在表 5.1 中可以看到,package 元素有一个 namespace 属性, 该属性可以指定包对应的命名空间 由于在一个 Web 应用中可能出现同名的 Action 并存的情况, 为了避免命名冲突, 只要使同名 Action 位于不同的 namespace 下就可以了 如果 package 元素没有指定 namespace 属性, 则其下定义的所有 Action 都处于默认的命名空间下 下面以一个示例来说明 package 命名空间属性的用法 : <!-- 配置名为 A 的包, 继承了 struts-default, 命名空间为默认的命名空间 --> <package name="a " extends="struts-default"> <action name="login" class="com.action.loginaction"> <result name="login_success">/login_success.jsp</result> </action> </package> <!-- 配置名为 B 的包, 继承了 struts-default, 命名空间为 "/"--> <package name="b" namespace="/" extends="struts-default"> <action name="exit" class="com.action.exit Action"> <result name="exit_success">/exit_success.jsp</result> </action> </package> <!-- 配置名为 C 的包, 继承了 struts-default, 命名空间为 "/info"--> <package name="c" namespace="/info" extends="struts-default"> <action name="stu" class="com.action.stu Action"> <result name="stu_info">/stu_info.jsp</result> </action> </package> 在上面代码中, 配置了两个包 :A 和 B 对于包 A, 由于没指定命名空间, 则其命名空间为默认命名空间 ; 对于包 B, 其命名空间是根命名空间 ; 对于包 C, 其命名空间则是 info 当包指定命名空间后, 该包所包含的 Action 处理的 URL 应该就是命名空间 +Action 名 即包 A 下名为 login 的 Action 处理的 URL 是 包 B 下名为 exit 的 Action 处理的 URL 是 包 C 下名为 stu 的 Action 处理的 URL 是 其中 8080 是笔者的 Tomcat 服务器的端口号 对于 URL 中指定的 Action,Struts 2 是按一定的顺序来查找的 如果要访问 /C/stu_info.action,Struts 2 框架首先查找 /C 命名空间里名为 stu_info 的 Action, 如果该命名空间里找到对应的 Action, 则使用其对应的 Action 来处理请求 ; 否则,Struts 2 框架到默认命名空间查找名为 stu_info 的 Action, 如果找到, 则使用其对应的 Action 来处理请求 ; 如果两个命名空间里都找不到名为 stu_info 的 Action, 则系统出现错误 另外, 读者有两个要注意的地方 : 第一, 根命名空间和普通命名空间中的 Action 的查找是一样的, 即如果有请求 /stu_info.action, 则先查找根命名空间下的 Action, 如果不存在对应的 Action, 则查找默认命名空间里的 Action 第二, 对于多级别的命名空间,Struts 2 框架在最底层的命名空间里查找后, 如果不存在相应的 Action, 则会同样到默认命名空间里查找, 而不是到上一级命名空间里查找 即如果请求为 /A/A_Login/login.action 时,Struts 2 框架首先到 /A/A_Login 的命名空间里查找名为 login 的 Action, 如果找不到对应的 Action, 则会到默认命名空间里查找, 而不是到 /A 的命名空间里查找 (2)action 元素 Struts 2 框架通过 Action 对象来处理 HTTP 请求, 该请求的 URL 地址对应的 Action 即 131

10 第 2 篇表现层框架 Struts 技术 配置在 action 元素中, 如下代码所示 : <action name="useraction" class=" com.action.useraction"> <result>/user.jsp</result> </action> action 元素除了有 name 和 class 属性外, 还有 method 和 converter 属性, 表 5.2 列出了 action 元素的各个属性 表 5.2 action 元素属性 属性 说 明 name 这是一个必须属性, 标识 Acton, 指定了该 Action 所处理的请求的 URL class 可选属性, 指定 Action 对象对应的实现类 method 可选属性, 指定请求 Action 时调用的方法 converter 可选属性, 指定类型转换器的类 在配置 action 元素时, 如果没有指定 class 属性值, 则其默认值为类 com.opensymphony.xwork2.actionsupport, 该默认类会使用默认的处理方法 execute() 来处理请求 实际上,execute() 方法不会做任何处理而直接返回 success 值 在配置 action 元素时, 如果指定 method 属性值, 则该 Action 可以调用 method 属性中指定的方法, 而不是默认的 execute() 法 (3)result 元素当调用 Action 方法处理结束返回后, 下一步就是使用 result 元素来设置返回给浏览器的视图 配置 result 元素时常需指定 name 和 type 两个属性 name 属性对应从 Action 方法返回的值, success 为其默认值 type 属性指定结果类型, 默认的类型是 dispatcher,struts 2 支持的结果类型如表 5.3 所示 表 5.3 Struts2 支持的结果类型 结果类型 说 明 dispatcher 将请求 forward( 转发 ) 到指定的 JSP 页面 redirect 将请求重定向到指定的视图资源 chain 处理 Action 链 freemarker 指定使用 Freemarker 模板作为视图 httpheader 控制特殊的 HTTP 行为 redirect-action 直接跳转到其他 Action stream 向浏览器返回一个 InputStream( 一般用于文件下载 ) velocity 指定使用 velocity 模板作为视图 xslt 用于 XML/XSLT 整合 plaintext 显示某个页面的原始代码 读者需要注意的是 dispatcher 和 redirect 的区别, 也就是转发和重定向的区别, 重定向会丢失所有的请求参数, 而且会丢失 Action 的处理结果 此处先介绍 redirect 和 redirect-action 这两种结果类型, 其他一些常用类型会在后续章节进行介绍 1 redirect 类型 redirect 结果类型与 dispatcher 结果类型刚好是相反的, 初学者在使用时容易将它们混 132

11 第 5 章解密 Struts 之核心文件 淆 dispatcher 结果类型表示将 HTTP 请求转发到指定的 JSP 资源,redirect 结果类型则是将请求重定向到 JSP 资源, 而重定向的结果则会丢失所有的请求参数和 Action 的处理结果 2 redirect-action 类型 redirect-action 结果类型主要用于当一个 Action 处理结束后, 将请求重定向到另一个 Action 它和 redirect 结果类型一样, 会重新生成一个新请求, 而且 Action 处理结果及请求的所有参数都会丢失, 只是 redirect-action 结果类型生成的请求是一个 Action, 而 redirect 结果类型生成的请求是一个 JSP 资源 例 5-2 本例说明 redirect-action 结果类型的用法 (a) 在 Eclipse 创建一个 Java Web 项目, 将 Struts 2 框架所需的支持库添加到 WEB- INF 目录下的 lib 文件夹中, 然后在 WEB-INF 目录下添加 web.xml 文件, 并在其中注册过滤器和欢迎页面 web.xml 文件代码如下所示 : <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_9" version="2.4" xmlns=" xml/ns/j2ee" xmlns:xsi=" xsi: schemalocation=" <!-- 定义 Filter--> <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字, 不能为空 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts 2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> <filter-mapping> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> <!-- 欢迎页面 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app> (b) 在 src 目录下创建包 com.action, 在该包下创建 LoginAction.java 和 UserAction.java 文件, 这两个文件的代码如下所示 LoginAction.java 代码如下 : package com.action; import com.opensymphony.xwork2.actionsupport; public class LoginAction extends ActionSupport{ private static final long serialversionuid = 1L; // 重载 execute() 方法, 返回 SUCCESS public String execute() throws Exception { return SUCCESS; //redirect() 方法, 返回 ERROR public String redirect() throws Exception { return ERROR; 133

12 第 2 篇表现层框架 Struts 技术 UserAction.java 代码如下 : package com.action; import com.opensymphony.xwork2.actionsupport; public class UserAction extends ActionSupport{ private static final long serialversionuid = 1L; // 重载 execute() 方法, 返回 SUCCESS public String execute() throws Exception { // TODO Auto-generated method stub return SUCCESS; (c) 在 src 目录下创建 struts.xml 文件, 代码如下 : <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <!-- 配置包 default, 该包继承了 struts-default --> <package name="default" extends="struts-default"> <!-- 配置名为 login 的 Action, 实现类为 LoginAction --> <action name="login" class="com.action.loginaction"> <!--redirectaction 返回类型 --> <result type="redirectaction"> <param name="actionname">userlogin</param> <!--Action 名参数 -> <param name="namespace">/user</param> <!-- 命名空间参数 --> </result> <!-- 返回值为 error,redirectaction 类型, 重定向到名为 error 的 Action--> <result name="error" type="redirectaction">error</result> </action> <!-- 配置名为 error 的 Action --> <action name="error"> <result>/error.jsp</result> </action> </package> <!-- 配置名为 user 的包, 命名空间为 /user--> <package name="user" extends="struts-default" namespace="/user"> <!-- 配置名为 userlogin 的 Action--> <action name="userlogin" class="com.action.useraction"> <result>/hello.jsp</result> </action> </package> </struts> (d) 在 WebContent 目录下创建文件 index.jsp hello.jsp 和 error.jsp, 核心代码如下所示 index.jsp 文件核心代码如下 : <body> <center> <s:a action="login">login</s:a><br/> <s:a action="login!redirect.action">redirect</s:a> </center> </body> hello.jsp 文件核心代码如下 : 134

13 第 5 章解密 Struts 之核心文件 <body> <center> <h2>hello</h2> </center> </body> error.jsp 文件核心代码如下 : <body> <center> <h2>error</h2> </center> </body> (e) 运行程序, 结果如图 5.3 所示, 单击 login 链接后, 返回如图 5.4 所示的页面 ; 单击 redirect 链接后, 返回如图 5.5 所示的页面 图 5.3 例 5-2 运行结果 图 5.4 单击 login 链接后 图 5.5 单击 redirect 链接后 135

14 第 2 篇表现层框架 Struts 技术 在这个例子中, 读者应该注意到 redirect 结果类型的运用有两种方式 : 一是直接在 <result> 标签后添加 Action 名称, 二是运用 <param> 标签的方式来指定 Action 这两种方式都可以达到同样的效果, 可以根据需要选用 (4)include 元素该元素用来在一个 struts.xml 配置文件中包含其他的配置文件 默认情况下, 当查找 Action 时,Struts 2 框架只会加载 struts.xml 配置文件, 但是当系统规模增大到一定的程度时, 系统中的 Action 数量也会大大增加, 这将会导致一个 struts.xml 配置文件中包含大量的 Action, 显然不方便开发者进行编辑 通过 <include../> 标签, 可以将 Action 以模块的方式来加以管理, 即将存在相关性的 Action 放到同一个 xml 文件中, 然后通过在 struts.xml 文件中配置 <include../> 标签来将它们组合在一起 使用 include 元素的 struts.xml 文件片段如下所示 : 136 <struts> <include file="a.xml"/> <include file="b.xml"/> <include file="c.xml"/> <include file="d.xml"/> </struts> 需要注意的是, 这些模块化的 xml 文件也必须是标准的 Struts 2 配置文件, 即必须包含头信息以及根元素等 通常,Struts 2 框架的所有配置文件都放在 WEB-INF/classes 路径下, 由于 struts.xml 文件中配置了 <include../> 标签, 则可以将其对应包含的文件信息加载进来 (5)global-results 元素该元素配置包中的全局结果, 其代码示例如下所示 在该代码示例中配置了一个全局结果, 这个全局结果的作用范围为包下面所有 Action 当一个 Action 处理用户请求后返回时, 会首先在该 Action 本身的局部结果中进行搜索, 如果局部结果中没有对应的结果, 则会查找全局结果 <struts> <!-- 配置包 default, 命名空间为 / --> <package name="default" namespace="/" extends="struts-default"> <!-- 全局结果 --> <glabal-results> <result name= success >/SUCCESS.jsp</result> </global-result> <!-- 配置名为 user 的 Action --> <action name="user" class="com.action.useraction"> <result name="hello">/hello.jsp</result> <!-- 返回 hello --> </action> </package> </struts> (6)default-action-ref 元素该元素用来配置默认的 Action, 即如果 Struts 2 找不到对应的 Action 时, 就会使用默认的 Action 来处理用户请求 <!-- 默认 Action 为 defaultaction--> <default-action-ref name="defaultaction"/> <action name="defaultaction" class="com.action.xxxaction">

15 第 5 章解密 Struts 之核心文件 <result../> </action> 在以上代码中,default-action-ref 元素仅有一个 name 属性, 该 name 属性指向一个 Action, 这个 Action 将成为默认的 Action 2.Action 的动态调用 (DMI) 在前面介绍的标签的使用中,Action 对象对 URL 请求的处理都是调用其默认的 execute() 方法, 对于单一的业务逻辑请求, 这种方式或许适合 但是, 在实际的项目开发中, 业务请求的类型的方法是多种多样的, 即对同一个 Action 可能有不同的请求, 通过创建多个 Action 能够解决这个问题, 但是会使程序更复杂, 且要编写更多的代码 如果请求的方式有很多种, 可以在 execute() 方法中通过判断请求的业务逻辑类型来转发到相应的处理方法中, 这也是一种解决方案 Struts 2 提供了这种包含多个处理逻辑的 Action 处理方式, 即 DMI(Dynamic Method Invocation, 动态方法调用 ) 通过动态请求 Action 对象中的方法, 可以实现对某一业务逻辑的处理 DMI 处理方式是通过请求 Action 对象中的一个具体的方法来实现动态的操作 具体说就是, 在请求 Action 的 URL 地址后加上请求方法字符串, 与 Action 对象中的方法进行匹配 其中,Action 对象名称和方法之间用! 隔开 即如果在 struts.xml 文件中配置了名为 user 的 Action, 为了请求 change() 方法, 请求方式应表示为 /user!change.action 例 5-3 本例创建一个工程来说明 DMI 的使用 (1) 在 Eclipse 中创建一个 Java Web 项目 DMIDemo, 将 Struts 2 框架所需的支持库添 加到 WEB-INF 目录下的 lib 文件夹中, 然后在 WEB-INF 目录下添加 web.xml 文件, 并在其中注册过滤器和欢迎页面 web.xml 文件代码如下所示 : <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_9" version="2.4" xmlns=" xml/ns/j2ee" xmlns:xsi=" xsi:schemalocation=" <!-- 定义 Filter--> <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字, 不能为空 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts 2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> <filter-mapping> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> <!-- 欢迎页面 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app> 137

16 第 2 篇表现层框架 Struts 技术 (2) 在 src 目录下创建 com.action 包, 并在该包中创建类 UserAction, 其代码如下 : package com.action; import com.opensymphony.xwork2.actionsupport; public class UserAction extends ActionSupport{ private static final long serialversionuid=1l; private String info; //info 属性 //info 属性的 getter 方法 public String getinfo() { return info; //info 属性的 setter 方法 public void setinfo(string info) { this.info = info; // 重载 execute() 方法 public String execute() throws Exception { info="hello,world"; return "hello"; //update() 方法, 更新 info 属性 public String update()throws Exception{ info="ok,updated"; return "update"; (3) 在 WebContent 目录下创建 index.jsp hello.jsp 和 update.jsp 文件 index.jsp 文件 : <body> <center> <a href="user">hello</a><br> <a href="user!update.action">update</a> </center> </body> hello.jsp 文件 : <body> <center> <s:property value="info"/> </center> </body> update.jsp 文件 : <body> <center> <s:property value="info"/> </center> </body> (4) 在 src 目录下创建 struts.xml 文件 <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> 138

17 第 5 章解密 Struts 之核心文件 <!-- 配置包 default, 继承 struts-default--> <package name="default" namespace="/" extends="struts-default"> <!-- 配置名为 login 的 Action, 实现类为 com.action.useraction --> <action name="user" class="com.action.useraction"> <result name="hello">/hello.jsp</result> <!-- 返回 hello.jsp --> <result name="update">/update.jsp</result> <!-- 返回 update. jsp--> </action> </package> </struts> (5) 运行程序, 结果如图 5.6 图 5.7 和图 5.8 所示 图 5.6 test2 工程 图 5.7 单击 hello 页面 图 5.8 单击 update 页面 139

18 第 2 篇表现层框架 Struts 技术 注意 : 在单击 update 链接后, 请求交给 update() 方法进行处理, 这时浏览器的地址栏变为 由上例可以看到,Action 请求的处理方式并非一定要通过 execute() 方法来处理, 使用 DMI 方式常常更加方便灵活 实际上, 在现实的项目开发中, 可以将同模块的一些请求封装在同一个 Action 中, 使用 DMI 方式来处理不同的请求 3. 通配符 在实际的项目开发中, 会出现多个 Action 定义的绝大部分都是相同的情况, 这时就会产生大量冗余 对于这种情况,Struts 2 也给出了相应的解决方法, 即使用通配符 这种配置方式可以通过一定的命名约定来配置 Action 对象, 以达到简化定义的效果 在 struts.xml 文件中, 通配符主要指的是 * ** 和 \ 通配符 * 匹配 0 个或多个字符但不包含 / ; 通配符 ** 匹配 0 个或多个字符包含 / ; 通配符 \ 则是一个转义字符, 即匹配字符 \ 时, 用 \\ 来匹配 具体说明如表 5.4 所示 表 5.4 通配符说明 通配符 说 明 * 匹配 0 个或多个字符除了 / ** 匹配 0 个或多个字符包含 / \character 转义字符, \\ 匹配 \ ; \* 匹配 * 通配符 * 通常用在 <action> 标签的 name 属性中, 而在 class name 属性及 result 元素中使用 {N 的形式来代表前面第 N 个 * 所匹配的字符串,{0 来代表 URL 请求的整个 Action 字符串 下面举例来说明通配符的使用, 示例代码如下 : <package name="login" extends="struts-default"> <!-- 使用 * 通配符, 第一个 * 表示调用方法, 第二个 * 表示 Action --> < action name="*_*" class="com.coderdream.action.{2action" method="{1"> < result name="success">/{0suc.jsp </result> < /action> </package> 在上面的代码中, 当 URL 请求是 /update_login.action 时,<action> 的 name 属性中第一个 * 匹配 update, 第二个 * 匹配 Login, 所以对应的会调用 LoginAction 类中的 update() 方法 在结果映射中的记号是 {0, 则该记号会被整个 URL 代替, 所以返回页面是 update_loginsuc.jsp 读者需要注意的是 URL 请求时的匹配顺序, 即当有多个 Action 能和 URL 请求匹配时, 最后会调用哪个 Action 在 Struts 2 框架中, 在查找匹配的 Action 时, 首先会查找完全匹配的 Action, 然后会按照匹配的 Action 在 struts.xml 文件中出现的顺序来匹配, 即最前面的匹配的 Action 会被调用 例如,struts.xml 文件中配置了 3 个 Action, 其 name 属性值分别是 XAction *Action 和 *, 如果请求是 XAction, 则不管 name 属性值是 XAction 的 Action 出现的前后顺序, 都会调用该 Action 中对应的方法 ; 如果请求 YAction, 则会根据 name 属性值为 *Action 和 * 的这两个 Action 出现的顺序, 来决定最后调用的 Action 140

19 第 5 章解密 Struts 之核心文件 在 Struts 2 框架应用中, 通配符有一个常用的使用方式, 如下代码所示 : <!-- 不管调用哪个 Action, 默认返回名为 Action 名的 JSP--> < action name="*_*"> < result >{0.jsp </result> < /action> 上面代码中的 Action 没有指定 class 属性, 则该 Action 会使用 ActionSupport 类来处理请求 ( 后面会详细讲解 ), 而该 Action 类会直接返回 success 字符串, 则指定的 JSP 资源就是 {0.jsp 所代表的 JSP 资源 该 Action 的含义是不管请求哪个 Action, 都会返回与该 Action 名字相同的 JSP 页面 通过这种方式, 避免了用户直接访问系统的 JSP 页面, 而必须通过 Struts 2 框架来处理请求 4. 常量配置 在 5.2 节介绍过使用 struts.properties 文件来配置常量, 实际上, 在 struts.xml 中也能配置常量, 其配置方式如下代码所示 : <struts> <constant name="struts.i18n.encoding" value="utf-8" /> <!-- 配置默认编码集为 UTF-8 --> </struts> 上面代码配置了常量 struts.i18n.encoding, 指定其值为 UTF-8 struts.properties 文件能配置的常量都可以在 struts.xml 文件中用 <constant> 标签来配置 常量除了通过 struts.xml 文件和 struts.properties 文件来配置以外, 还可以通过 web.xml 文件来配置 下面代码使用了 web.xml 来配置常量 : <filter> <filter-name>struts2</filter-name> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> <!-- 配置默认编码集为 UTF-8 --> <init-param> <param-name>struts.i18n.encoding</param-name> <param-value>utf-8</param-value> </init-param> </filter> 上面的代码同样配置了常量 struts.i18n.encoding, 指定其值为 UTF-8 读者需要注意的是, 在 web.xml 文件中配置常量时,<init-param> 标签必须放在 <filter> 标签下 通常情况下,struts.properties struts.xml 和 web.xml 这 3 个文件都可用来配置常量, 但开发时一般的常量配置方式都是在 struts.xml 文件中来进行, 而不是在 struts.properties 文件或是 web.xml 文件中 在 Struts 2 框架中, 常量不仅仅存在于 struts.properties struts.xml 和 web.xml 这 3 个文件中, 还存在于一些支持 Struts 2 框架的 jar 包中, 如 struts-plugin.xml 文件以及 struts-default.xml 文件, 这些文件中都可以进行常量配置 通常,Struts 2 框架加载常量的顺序如下 : (1)struts-default.xml: 在 struts-core jar 文件中 (2)struts-plugin.xml: 在 struts-xxx jar 等 Struts 2 插件 jar 文件中 141

20 第 2 篇表现层框架 Struts 技术 (3)struts.xml (4)struts.properties (5)web.xml 在加载常量的过程中, 如果同一个常量出现在多个文件中, 则后者会覆盖前者的常量值 常量的配置方式是多种多样的, 但是都需要指定其 name 和对应的 value 5.4 Struts 之 Action 类文件 在前面介绍了 Struts 框架中的核心配置文件, 而在 Struts 项目开发中和这些核心配置文件同样重要的文件就是 Action 类文件 如果说,struts.xml struts.properties 和 web.xml 文件搭建起了 Struts 项目的结构, 那么 Action 类文件就实现了具体的业务逻辑处理,Action 类文件才是真正实现业务逻辑的文件 本节将详细介绍 Action 类文件的相关内容, 包括 Action 类的构造所需要的基类或接口 Action 类方法的实现所需访问的数据对象以及异常处理的配置, 并通过多个实例来讲解 Action 类的定义和具体使用方法 Action 接口和 ActionSupport 基类 在 Struts 2 框架中 Action 是其主要的业务逻辑处理对象,Struts 2 框架通过自动调用 Action 类的方法来实现相应的事件处理 一般的, 每个 Action 类都定义在一个单独的文件中, 实现不同的业务逻辑处理可以通过向该 Action 类中添加不同的方法来实现 因此, Action 类文件是 Struts 2 框架中非常重要的文件 下面来介绍 Action 类的构造所需要的 ActionSupport 基类以及 Action 接口 Struts 2 框架提供了一个 Action 接口, 该接口定义了 Struts 2 的 Action 类的实现规范 public interface Action{ public static final String ERROR="error"; public static final String SUCCESS="success"; public static final String INPUT="input"; public static final String LOGIN="login"; public static final String NONE="now"; public String execute() throws Exception; 由 Action 接口定义可以看到, 该接口定义了 5 个字符串常量和一个 execute() 方法 每个 Action 类都必须包含一个 execute() 方法, 该方法返回一个字符串 而接口中定义的 5 个常量用来统一 execute() 方法返回的值 实际上,ActionSupport 类实现了 Action 接口, 它是一个默认的 Aciton 实现类, 提供了很多默认方法, 包括数据校验方法 获取国际化信息方法等 实际应用中, 程序员定义的 Action 类都会继承 ActionSupport 类而不是实现 Action 接口, 这可以大大简化程序员的编码过程 值得一提的是, 由于自定义的 Action 类继承了 ActionSupport 类, 因此必须定义一个 142

21 第 5 章解密 Struts 之核心文件变量 serialversionuid 这是因为 ActionSupport 类实现了 Serializable 接口, 任何实现 Serializable 接口的类都必须声明变量 serialversionuid, 如下所示 : private static final long serialversionuid=1l; Action 与 Servlet API Struts 2 框架中的 Action 与 Servlet 是完全松耦合的, 这使得 Action 类更加方便进行测试 但对于 Web 应用来说,Servlet API 是不可忽略的 在 Java Web 应用中, HttpServletRequest HttpSession 和 ServletContext 这 3 个接口是最经常访问的 ( 这 3 个接口分别对应 JSP 内置对象中的 request session 和 application) 在 Struts 2 框架中访问 Servlet API 有如下几种方法 1. 通过 ActionContext 类访问 Strut 2 框架提供 ActionContext 类来访问 Servlet API, 几个常用方法如下 : void put(string key, Object value): 将 key-value 对放入 ActionContext 中, 模拟 Servlet API 中的 HttpServletRequest 的 setattribute() 方法 Object get(object key): 通过参数 key 来查找当前 ActionContext 中的值 Map getapplication(): 返回一个 Application 级的 Map 对象 Static ActionContext getcontext() : 获得当前线程的 ActionContext 对象 Map getparameters(): 返回一个包含所有 HttpServletRequest 参数信息的 Map 对象 Map getsession(): 返回一个 Map 类型的 HttpSession 对象 void put(object key,object value): 向当前 ActionContext 对象中存入名值对信息 void setapplication(map application): 设置 Application 上下文 void setsession(map session): 设置一个 Map 类型的 Session 值 要访问 Servlet API, 可以通过如下方式进行访问 : ActionContext context=actioncontext.getcontext(); context.put("name", "tom"); context.getapplication().put("name", "tom"); context.getsession().put("namme", "tom"); 在上面代码中, 通过 ActionContext 类中的方法调用, 分别在 request application 和 session 中放入了 ("name", "tom") 对 可以看到, 通过 ActionContext 类, 可以非常简单地访问 JSP 内置对象的属性 例 5-4 本例示范如何通过 ActionContext 类来访问 Servlet API (1) 在 Eclipse 创建一个 Java Web 项目 ActionContextDemo, 将 Struts 2 框架所需的支持库添加到 WEB-INF 目录下的 lib 文件夹中, 然后在 WEB-INF 目录下添加 web.xml 文件, 并在其中注册过滤器和欢迎页面, 代码如下所示 : <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_9" version="2.4" xmlns=" xml/ns/j2ee" xmlns:xsi=" xsi:schemalocation=" <!-- 定义 Filter--> 143

22 144 第 2 篇表现层框架 Struts 技术 <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字, 不能为空 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts 2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> <filter-mapping> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> <!-- 欢迎页面 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app> (2) 在 src 目录下创建包 com.action, 在该包下创建 UserAction.java 类文件, 代码如下所示 : package com.action; import com.opensymphony.xwork2.actioncontext; import com.opensymphony.xwork2.actionsupport; public class UserAction extends ActionSupport{ private static final long serialversionuid = 1L; // 重载 execute() 方法 public String execute() throws Exception { ActionContext context=actioncontext.getcontext(); // 得到 ActionContext 实例 // 将 (name,"request:tom") 到 ActionContext 中 context.put("name", "request:tom"); // 得到 application 并将 (name,"application:tom") 放入 context.getapplication().put("name","application:tom"); // 得到 session 并将 (name,"session:tom") 放入 context.getsession().put("name", "session:tom"); return "hello"; // 返回 hello (3) 在 src 目录下创建 struts.xml 文件, 代码如下所示 : <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <!-- 配置包 default, 继承 struts-default --> <package name="default" namespace="/" extends="struts-default"> <!-- 配置名为 hello 的 Action, 实现类为 UserAction--> <action name="hello" class="com.action.useraction"> <result name="hello" >/hello.jsp</result> <!-- 返回 hello.jsp--> </action> </package> </struts> (4) 在 WebContent 目录下创建 index.jsp 和 hello.jsp 文件 index.jsp 文件核心代码 :

23 第 5 章解密 Struts 之核心文件 <body> <center> <s:a action="hello">hello</s:a> </center> </body> hello.jsp 文件核心代码 : <body> <center> ${applicationscope.name<br/> ${sessionscope.name<br/> ${requestscope.name </center> </body> (5) 运行该程序, 其结果如图 5.9 所示, 单击链接后结果如图 5.10 所示 图 5.9 例 5-4 运行结果 图 5.10 单击链接结果 由图 5.10 可以看到, 在 Action 中放入的 name-value 对都被取出来了, 这就证明 ActionContext 能够和 Servlet API 打交道 2. 通过特定接口访问 Struts 2 框架提供了 ActionContext 类来访问 Servlet API, 虽然这种方法可以访问 Servlet API, 但是无法直接访问到其实例 为了在 Action 中直接访问 Servlet API, 可以通过下面几个接口来实现 : ServletRequestAware: 实现该接口后, 可以直接访问 HttpServletRequest 实例 ServletResponseAware: 实现该接口后, 可以直接访问 HttpServletResponse 实例 ServletContextAware: 实例该接口后, 可以直接访问 ServletContext 实例 下面举一个 ServletContextAware 接口的例子, 来介绍如何在 Action 中访问 ServletContext 实例 : public class LoginAction implements Action, ServletContextAware{ private ServletContext context; //ServletContext 实例 //setter 方法 public void setservletcontext(servletcontext ctx) { context=ctx; public String execute() throws Exception { context.setattribute("user", "jim"); // 将 ( user,"jim") 放入 ActionContext 中 145

24 return SUCCESS; 第 2 篇表现层框架 Struts 技术 在上面代码中, 自定义的 LoginAction 类实现了 Action 和 ServletContextAware 接口 需要注意的是,LoginAction 类定义中必须实现 setservletcontext() 和 execute() 方法 通过 setservletcontext() 方法, 可以得到 ServletContext 的实例, 这是在调用 execute() 或其他自定义方法之前就调用的, 然后在 execute() 方法中, 就可以访问 ServletContext 的属性内容 通过 ServletContextAware 的例子, 读者应该可以猜到其他类似接口的用法 实际上, 如果一个 Action 实现了 ServletRequestAware 接口, 则必须实现 setservletrequest() 方法, 通过它来访问 HttpServletRequest 对象 ; 如果一个 Aciton 实现了 ServletResponseAware 接口, 则必须实现 setservletresponse() 方法, 通过它来访问 HttpServletResponse 对象 3. 通过 ServletActionContext 访问为了直接访问 Servlet API,Struts 2 框架还提供了 ServletActionContext 类, 该类的几个常用方法如下 : HttpServletResponse org.apache.struts2.servletactioncontext.getresponse() : 获得 HttpServletResponse 对象 HttpServletRequest org.apache.struts2.servletactioncontext.getrequest() : 获得 HttpServletRequest 对象 ServletContext org.apache.struts2.servletactioncontext.getservletcontext() : 获得 ServletContext 对象 通过 ServletActionServlet 方法的调用, 可以轻松获得相应的 JSP 内置对象,Action 能够更简单方便地访问 Servlet API ModelDriven 接口 用户在提交 HTTP 请求时, 一般有两种方式, 即 Get 方式和 Post 方式 ( 当然还有其他方式, 但不常用 ) Get 方式用来获取查询相关信息, 即向服务器索取数据, 而 Post 方式则用来更新信息, 即向服务器提交数据 通常情况下, 用 Get 方式向服务器查询信息时, 其附带的信息较少, 可以使用 Servlet API 来一一获取, 但当用 Post 方式提交数据时, 往往数据量大, 如果仍然用 Servlet API 的方式来一一获取数据, 代码就显得过于臃肿, 而且会降低程序员的工作效率 这时候,Struts 2 框架的强大作用就显现出来了 Struts 2 框架提供了 ModelDriven 接口, 对于实现了该接口的 Action 来说, 只需定义相应的 Model,Struts 2 框架就会自动将用户提交的 HTTP 信息赋给相应的 Model ModelDriven 接口的使用方式如以下代码所示 : 146 public class XxxAction extends ActionSupport implements ModelDriven <XXModel>{ private static final long serialversionuid = 1L; private XXModel x=new XXModel(); // 创建要使用的对象实例 //getter 方法, 必须实现 public XXModel getmodel() {

25 第 5 章解密 Struts 之核心文件 return x; public String execute() throws Exception { return SUCCESS; 上面代码中 XxxAction 类继承了 ModelDriven 接口, 这样用户提交的关于 XXModel 类的信息, 就会直接放入 x 对象中 读者需要注意的是 XXModel 对象必须实例化, 且 getmodel() 方法必须重写 例 5-5 本例示范 ModelDriven 接口的使用方式 (1) 使用 Eclipse 创建一个 Java Web 项目 ModelDrivenDemo, 将 Struts 2 框架所需的支持库添加到 WEB-INF 目录下的 lib 文件夹中, 然后在 WEB-INF 目录下添加 web.xml 文件, 并在其中注册过滤器和欢迎页面 <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_9" version="2.4" xmlns=" xml/ns/j2ee" xmlns:xsi=" xsi:schemalocation=" <!-- 定义 Filter--> <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts 2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> <filter-mapping> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> <!-- 欢迎页面 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app> (2) 在 src 目录下创建 com.action 包, 在该包下创建 LoginAction.java 文件 package com.action; import com.model.usermodel; import com.opensymphony.xwork2.actioncontext; import com.opensymphony.xwork2.actionsupport; import com.opensymphony.xwork2.modeldriven; public class LoginAction extends ActionSupport implements ModelDriven<UserModel>{ private static final long serialversionuid = 1L; private UserModel user=new UserModel(); // 创建 UserModel 实例 //getter 方法, 必须实现 public UserModel getmodel() { return user; // 重载 execute 方法 public String execute() throws Exception { 147

26 第 2 篇表现层框架 Struts 技术 ActionContext context=actioncontext.getcontext(); // 得到 ActionContext 实例 context.put("user", user); // 将 ("user",user) 放入 ActionContext 中 return SUCCESS; (3) 在 src 目录下创建 com.model 包, 在该包下创建 UserModel.java 文件 package com.model; public class UserModel { private String name; //name 属性 private String age; //age 属性 private String address; //address 属性 private String telephone; //telephone 属性 //name 属性的 getter 和 setter 方法 public String getname() { return name; public void setname(string name) { this.name = name; //age 属性的 getter 和 setter 方法 public String getage() { return age; public void setage(string age) { this.age = age; //address 属性的 getter 和 setter 方法 public String getaddress() { return address; public void setaddress(string address) { this.address = address; //telephone 属性的 getter 和 setter 方法 public String gettelephone() { return telephone; public void settelephone(string telephone) { this.telephone = telephone; (4) 在 src 目录下创建 struts.xml 文件 <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <!-- 配置 default 包 --> <package name="default" namespace="/" extends="struts-default"> <!-- 配置名为 user 的 Action, 实现类为 com.action.loginaction --> <action name="user" class="com.action.loginaction"> <result name="success" >/success.jsp</result> <!-- 返回 success.jsp--> </action> 148

27 第 5 章解密 Struts 之核心文件 </package> </struts> (5) 在 WebContent 目录下创建 index.jsp 和 success.jsp 文件 index.jsp 文件核心代码 : <body> <center> <!-- 定义表单 --> <s:form action="user"> <s:textfield label="name" name="name" /> <!-- 定义文本框 --> <s:textfield label="age" name="age" /> <s:textfield label="telephone" name="telephone" /> <s:textfield label="address" name="address" /> <s:submit/> <!-- 提交按钮 --> </s:form> </center> </body> success.jsp 文件核心代码 : <body> <center> <!-- 控制文本水平居中 --> <s:property value="#user.name"/><br/> <s:property value="#user.age"/><br/> <s:property value="#user.telephone"/><br/> <s:property value="#user.address"/><br/> </center> </body> (6) 运行该程序, 其结果如图 5.11 所示, 输入信息, 提交后显示如图 5.12 所示的页面 图 5.11 例 5-5 运行结果 图 5.12 提交后 ModelDriven 是一个经常在开发中用到的接口, 它大大简化了开发的时间, 对于开发者来说, 这是一个不可多得的福音 异常处理 读者可能遇到这样的情况, 在开发 Java Web 应用程序的时候, 由于程序的开发不太完善, 导致用户在使用的过程中出现程序崩溃的情况, 结果是在浏览器上面显示一大堆用户无法看懂的东西 对于商业应用来说, 这可能意味着成千上万的损失 Struts 2 框架的异常 149

28 150 第 2 篇表现层框架 Struts 技术 处理机制对于这种情况提供了有效的支持 Struts 2 框架的异常处理机制是十分成熟的, 只需简单的配置就可以实现 一般情况下, 开发者希望实现这样的功能 : 当处理用户请求时, 如果出现了异常, 就会转入指定的错误视图资源 ; 如果出现了另一种异常, 则系统会转入另一个指定的错误视图资源 下面的代码就实现了这种功能 : public class XXXAction extends ActionSupport{ private static final long serialversionuid = 1L; // 错误抛出异常 public String execute() throws Exception { try { return SUCCESS; catch (SQLException e) { e.printstacktrace(); return ERROR; //SQL 异常, 返回 ERROR catch (InvalidInputException e) { e.printstacktrace(); return ERROR; //InvalidInput 异常, 返回 ERROR catch(exception1 e1){ return result1; // 自定义异常 e1, 返回 result1 catch(exception2 e2){ return result2; // 自定义异常 e2, 返回 result2 上面的代码虽然可以满足我们提出的要求, 但实际上, 这种实现方式并不实用 上述代码是通过 try-catch 方式来捕获异常的, 当异常比较简单 种类较少时, 这种方式是可行的 但在企业级应用中, 由于系统的规模常常非常大, 如果仍采用 try-catch 方式来捕获异常, 将会降低代码的可维护性 Struts 2 框架提供了自己的异常处理机制, 只需在 struts.xml 文件中配置异常处理即可, 而不需要在 Action 方法中来捕捉异常 Struts 2 框架在 struts.xml 文件中配置异常通常有两种方式 : 全局异常配置和局部异常配置 分别通过 <global-exception-mappings../> 标签和 <exception-mapping../> 标签来配置 Struts 2 框架在 struts.xml 文件中配置异常的代码如下所示 : <struts> <package name="default"> <!-- 全局结果 --> <global-results> <result name="exception">/exception.jsp</result> <!-- 返回结果 Excetpion.jsp --> <result name="sqlexception">/sqlexception.jsp</result><!-- 返回结果 SQLExcetpion.jsp --> </global-results> <!-- 全局异常映射 --> <global-exception-mappings> <!--SQL 异常映射 --> <exception-mapping exception="java.sql.sqlexception" result= "SQLException"/> <!-- 一般异常 --> <exception-mapping exception="java.lang.exception" result= "Exception"/> </global-exception-mappings>

29 第 5 章解密 Struts 之核心文件... <action name="dataaccess" class="com.action.dataaccess"> <exception-mapping exception="com.action.securityexception" result="login"/> <result name="login" >/loginexception.jsp </result> <result>/dataaccess.jsp</result> </action>... </package> </struts> 上面的 struts.xml 文件中配置了 3 个异常, 其中 java.sql.sqlexception 和 java.lang. Exception 是全局异常,com.action.SecurityException 是局部异常 异常的 result 属性指的是当 Action 出现该异常时, 系统返回 result 属性值对应的名称 需要注意的是, 全局异常会对所有的 Action 起作用, 而局部异常只对其所在的 Action 其作用 出现异常后, 一般会在 JSP 页面中输出异常信息, 通常使用下面两种方式来输出异常信息 : <s:property value="exception.message"/>: 输出异常对象信息 <s:property value="exceptionstack"/>: 输出异常堆栈信息 例 5-6 本例示范 Struts 2 框架异常处理的配置 (1) 在 Eclipse 中创建一个 Java Web 项目 ExceptionDemo, 将 Struts 2 框架所需的支持库添加到 WEB-INF 目录下的 lib 文件夹中, 然后在 WEB-INF 目录下添加 web.xml 文件, 并在其中注册过滤器和欢迎页面 <?xml version="1.0" encoding="utf-8"?> <web-app id="webapp_9" version="2.4" xmlns=" ns/j2ee" xmlns:xsi=" xsi: schemalocation=" <!-- 定义 Filter--> <filter> <filter-name>struts2</filter-name> <!-- 指定 Filter 的名字, 不能为空 --> <!-- 指定 Filter 的实现类, 此处使用的是 Struts 2 提供的过滤器类 --> <filter-class>org.apache.struts2.dispatcher.ng.filter. StrutsPrepareAndExecuteFilter</filter-class> </filter> <!-- 定义 Filter 所拦截的 URL 地址 --> <filter-mapping> <!--Filter 的名字, 该名字必须是 filter 元素中已声明过的过滤器名字 --> <filter-name>struts2</filter-name> <url-pattern>/*</url-pattern> <!-- 定义 Filter 负责拦截的 URL 地址 --> </filter-mapping> <!-- 欢迎页面 --> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> </web-app> (2) 在 src 目录下创建 com.action 包, 在该包下创建 UserAction.java 和 Security Exception.java 文件, 代码如下所示 UserAction.java 文件代码如下 : package com.action; 151

30 第 2 篇表现层框架 Struts 技术 import com.opensymphony.xwork2.actionsupport; public class UserAction extends ActionSupport{ private static final long serialversionuid = 1L; private String name; //name 属性 private String age; //age 属性 private String tel; //tel 属性 //name 属性的 getter setter 方法 public String getname() { return name; public void setname(string name) { this.name = name; //age 属性的 getter setter 方法 public String getage() { return age; public void setage(string age) { this.age = age; //tel 属性的 getter setter 方法 public String gettel() { return tel; public void settel(string tel) { this.tel = tel; public String execute() throws Exception { // 根据输入值进行检测是否符合要求 if(!getname().equals("tom")) { throw new SecurityException("wrong name!!!!!!"); else if(!getage().equals("20")) { throw new Exception("wrong age!!!!!"); else if(!gettel().equals(" ")) { throw new java.sql.sqlexception(); else { return SUCCESS; 152 SecurityException.java 文件代码如下 : package com.action; public class SecurityException extends Exception{ private static final long serialversionuid = 1L; // 构造方法 public SecurityException() { super(); private String message; // 属性 message, 用于记录错误消息 public SecurityException(String messa ge){

31 第 5 章解密 Struts 之核心文件 this.message = message; public String getmessage() { return message; (3) 在 src 目录下创建文件 struts.xml <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" " <struts> <!-- 配置包 default --> <package name="default" namespace="/" extends="struts-default"> <!-- 全局结果 --> <global-results> <result name="exception">/exception.jsp</result> <!-- 返回 Exception.jsp --> <result name="sqlexception">/sqlexception.jsp</result> <!-- 返回 SQLException.jsp --> </global-results> <!-- 全局异常映射 --> <global-exception-mappings> <!--Sql 异常 --> <exception-mapping exception="java.sql.sqlexception" result= "SQLException"/> <!-- 一般异常 --> <exception-mapping exception="java.lang.exception" result= "Exception"/> </global-exception-mappings> <!-- 配置名为 user 的 Action, 实现类为 com.action.useraction --> <action name="user" class="com.action.useraction"> <!-- 异常结果已设 --> <exception-mapping exception="com.action.securityexception" result="login"/> <result name="login" >/loginexception.jsp </result> <!-- 返回结果 login--> <result>/success.jsp</result> <!-- 返回结果 success--> </action> </package> </struts> ( 4 ) 在 WebContent 目录下创建 index.jsp Exception.jsp SQLException.jsp loginexception.jsp 和 success.jsp 文件, 代码如下所示, 其中 Exception.jsp SQLException.jsp 和 loginexception.jsp 文件代码相同 index.jsp 文件核心代码如下 : <body> <center> <!-- 定义表单 --> <s:form action="user"> <s:textfield label="name" name="name"/> <!-- 定义文本框 --> <s:textfield label="age" name="age" /> <s:textfield label="tel" name="texl"/> <s:submit></s:submit> <!-- 提交按钮 --> </s:form> 153

32 第 2 篇表现层框架 Struts 技术 </center> </body> Exception.jsp SQLException.jsp loginexception.jsp 文件核心代码如下 : <body> <center> <h2> <s:property value="exception.message"/> <s:property value="exceptionstack"/> </h2> </center> </body> success.jsp 文件核心代码如下 : <body> <h2> success </h2> </body> (5) 运行程序, 其结果如图 5.13 所示, 输入信息, 若不符合 Action 中的处理要求, 则产生如图 5.14 所示的结果, 若符合要求, 则进入 success.jsp 页面 图 5.13 例 5-6 运行结果 图 5.14 异常处理结果 154

33 第 5 章解密 Struts 之核心文件 5.5 本章小结 本章主要介绍了 Struts 2 框架中核心配置文件的作用及其具体配置 Action 类文件的具体格式以及访问 servlet API 的几种方法 web.xml struts.properties 以及 struts.xml 三大配置文件, 构成了 Struts 2 框架的配置基础, 其中 web.xml 文件主要是配置初始信息 过滤器等,struts.properties 主要进行常量的配置, 而 struts.xml 则主要进行 Action 的配置 这三个核心配置文件都可以配置常量, 如表 5.5 所示 表 5.5 三大配置文件的常量配置方式文件代码 <init-param> <param-name> struts.i18n.encoding </param-name> web.xml <param-value> UTF-8</param-value> </init-param> struts.properties struts.i18n.encoding=utf-8 struts.xml <constant name="struts.i18n.encoding" value="utf-8" /> 1.web.xml web.xml 文件是 Struts 2 框架中的一个重要配置文件, 是不可缺少的 其最重要的就是过滤器的配置, 这是其最常用的配置 2.struts.properties struts.properties 文件主要用来配置常量, 由于常量可以在 web.xml 或 struts.xml 中配置, 所以该文件有时可以略去不配置 实际上,Struts 2 框架按如下顺序来加载常量 : struts-default.xml: 在 struts-core jar 文件中 struts-plugin.xml: 在 struts-xxx jar 等 Struts 2 插件 jar 文件中 struts.xml struts.properties web.xml 上述是 Struts 2 框架搜索常量的顺序, 当同一个文件出现多个文件中时, 后出现的常量值会覆盖前面的值 3.struts.xml struts.xml 文件是 Struts 2 框架中最核心的配置文件, 是不可缺少的 读者应该注意其 Action package result 以及通配符等的配置方式 4.Action 类文件 Action 类是 Struts 2 框架中很重要的一个组成部分, 具体的业务逻辑都是它来进行处理的 读者须注意在 Action 中访问 Servlet API 的方法以及 ModelDriven 接口的使用 155