struts2学习笔记

1.定义国际化文件

   如果资源文件中有非西欧字符必须用native2ascii命令来处理该文件。

   文件必须保存在WEB-INF/classes下。

   资源文件命名规则是：name_语言代码_国家代码.properties

2.输出国际化信息

 

   struts2提供了两种输出国际化信息的方法：

  <1>:<S:text name="messageKey">

  <2>:<S:property value="%{getText("messageKey")}"/>

 

3.数据校验  

（1）ActionSupport类提供了数据初步验证的方法：String void validate(),通过AddFileldError（属性名，提示信息）来      增加错误信息，其中为了实现国际化，在addfileldError（属性名，getText（"国际化资源名字"））来实现国际化。

      界面通过<s:fielderror></s:fielderror>标签来获取错误信息。

（2）通过增加配置文件来实现数据校验。struts2提供了许多的校验器，分为表单域校验器和非表单域校验器。

      本应用主要使用了requiredstring校验器，该校验器是一个必填校验器——指定某个表单域必须输入。
下面是校验规则的定义文件：

<?xml version="1.0" encoding="GBK"?>
<!-- 指定校验规则文件的DTD信息 -->
<!DOCTYPE validators PUBLIC "-//OpenSymphony Group//XWork Validator 
1.0.2//EN" 
"http://www.opensymphony.com/xwork/xwork-validator-1.0.2.dtd



">
<!-- 校验规则定义文件的根元素 -->
<validators>
<!-- 校验第一个表单域：username -->
<field name="username">
<!-- 该表单域必须填写 -->
 <field-validator type="requiredstring">
<!-- 如果校验失败，显示user.required对应的信息 -->
 <message key="user.required"/>
 </field-validator>
 </field>
<!-- 校验第二个表单域：password -->
 <field name="password">
 <field-validator type="requiredstring">
<!-- 如果校验失败，显示pass.required对应的信息 -->
 <message key="pass.required"/>
 </field-validator>
 </field>
</validators>  

定义完该校验规则文件后，该文件的命名应该遵守如下规则：
ActionName-validation.xml：其中ActionName就是需要校验的Action的类名。
因此上面的校验规则文件应该命名为“LoginAction-validation.xml”，且该文件应该与Action类的class文件位于同一个路径下。

 

 

4. struts.properties 里的属性值知多少

 

 

struts.properties文件是一个标准的Properties文件，该文件包含了系列的key-value对象，每个key就是一个Struts 2属性，该key对应的value就是一个Struts 2属性值。

      struts.properties文件通常放在Web应用的WEB-INF/classes路径下。实际上，只要将该文件放在Web应用的CLASSPATH路径下，Struts 2框架就可以加载该文件。

 

     其实，struts.properties文件的内容均可在struts.xml中以<constant name="" value=""></constant> 加载。推荐使用struts.xml中配置常量。

     也可以通过web.xml中, 不过这种方式定义常量不推荐使用，降低了web.xml的可读性。

<init-param>

<param-name></param-name>

<param-value></param-value>

</init-param>

 

配置参数详细列表：

struts.configuration
    该属性指定加载Struts 2配置文件的配置文件管理器。该属性的默认值是org.apache.Struts2.config.DefaultConfiguration，这是 Struts 2默认的配置文件管理器。如果需要实现自己的配置管理器，开发者则可以实现一个实现Configuration接口的类，该类可以自己加载Struts 2配置文件。

struts.locale
指定Web应用的默认Locale。

struts.i18n.encoding
     指定Web应用的默认编码集。该属性对于处理中文请求参数非常有用，对于获取中文请求参数值，应该将该属性值设置为GBK或者GB2312。
提示：当设置该参数为GBK时，相当于调用HttpServletRequest的setCharacterEncoding方法。

struts.objectFactory
    指定Struts 2默认的ObjectFactory Bean，该属性默认值是spring。

struts.objectFactory.spring.autoWrite
     指定Spring框架的自动装配模式，该属性的默认值是name，即默认根据Bean的name属性自动装配。

struts.objectFactory.spring.useClassCache
      该属性指定整合Spring框架时，是否缓存Bean实例，该属性只允许使用true和false两个属性值，它的默认值是true。通常不建议修改该属性值。

struts.objectTypeDeterminer

    该属性指定Struts 2的类型检测机制，通常支持tiger和notiger两个属性值。

struts.multipart.parser

     该属性指定处理 multipart/form-data的MIME类型（文件上传）请求的框架，该属性支持cos、pell和jakarta等属性值，即分别对应使用 cos的文件上传框架、pell上传及common-fileupload文件上传框架。该属性的默认值为jakarta。
注意：如果需要使用cos或者pell的文件上传方式，则应该将对应的JAR文件复制到Web应用中。例如，使用cos上传方式，则需要自己下载cos框架的JAR文件，并将该文件放在WEB-INF/lib路径下。

struts.multipart.saveDir

     该属性指定上传文件的临时保存路径，该属性的默认值是javax.servlet.context.tempdir。

struts.multipart.maxSize

     该属性指定Struts 2文件上传中整个请求内容允许的最大字节数。

struts.custom.properties

     该属性指定Struts 2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文件的文件名以英文逗号（,）隔开。

struts.mapper.class

    指定将HTTP请求映射到指定 Action的映射器，Struts 2提供了默认的映射器：org.apache.struts2.dispatcher.mapper.DefaultActionMapper。默认映射 器根据请求的前缀与Action的name属性完成映射。

struts.action.extension

     该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts 2处理。如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。

struts.serve.static

     该属性设置是否通过JAR文件提供静态内容服务，该属性只支持true和false属性值，该属性的默认属性值是true。

struts.serve.static.browserCache

     该属性设置浏览器是否缓存静态内容。当应用处于开发阶段时，我们希望每次请求都获得服务器的最新响应，则可设置该属性为false。

struts.enable.DynamicMethodInvocation

     该属性设置Struts 2是否支持动态方法调用，该属性的默认值是true。如果需要关闭动态方法调用，则可设置该属性为false。

struts.enable.SlashesInActionNames

     该属性设置Struts 2是否允许在Action名中使用斜线，该属性的默认值是false。如果开发者希望允许在Action名中使用斜线，则可设置该属性为true。

struts.tag.altSyntax

     该属性指定是否允许在Struts 2标签中使用表达式语法，因为通常都需要在标签中使用表达式语法，故此属性应该设置为true，该属性的默认值是true。

struts.devMode

     该属性设置Struts 2应用是否使用开发模式。如果设置该属性为true，则可以在应用出错时显示更多、更友好的出错提示。该属性只接受true和flase两个值，该属性的默认值是false。

通常，应用在开发阶段，将该属性设置为true，当进入产品发布阶段后，则该属性设置为false。

struts.i18n.reload

该属性设置是否每次HTTP请求到达时，系统都重新加载资源文件。该属性默认值是false。在开发阶段将该属性设置为true会更有利于开发，但在产品发布阶段应将该属性设置为false。
提示：开发阶段将该属性设置了true，将可以在每次请求时都重新加载国际化资源文件，从而可以让开发者看到实时开发效果；产品发布阶段应该将该属性设置为false，是为了提供响应性能，每次请求都需要重新加载资源文件会大大降低应用的性能。

struts.ui.theme

     该属性指定视图标签默认的视图主题，该属性的默认值是xhtml。

struts.ui.templateDir

     该属性指定视图主题所需要模板文件的位置，该属性的默认值是template，即默认加载template路径下的模板文件。

struts.ui.templateSuffix

     该属性指定模板文件的后缀，该属性的默认属性值是ftl。该属性还允许使用ftl、vm或jsp，分别对应FreeMarker、Velocity和JSP模板。

struts.configuration.xml.reload

该属性设置当struts.xml文件改变后，系统是否自动重新加载该文件。该属性的默认值是false。

struts.velocity.configfile

     该属性指定Velocity框架所需的velocity.properties文件的位置。该属性的默认值为velocity.properties。

struts.velocity.contexts

     该属性指定Velocity框架的Context位置，如果该框架有多个Context，则多个Context之间以英文逗号（,）隔开。

struts.velocity.toolboxlocation

     该属性指定Velocity框架的toolbox的位置。

struts.url.http.port

     该属性指定Web应用所在的监听端口。该属性通常没有太大的用户，只是当Struts 2需要生成URL时（例如Url标签），该属性才提供Web应用的默认端口。

struts.url.https.port

     该属性类似于struts.url.http.port属性的作用，区别是该属性指定的是Web应用的加密服务端口。

struts.url.includeParams

     该属性指定Struts 2生成URL时是否包含请求参数。该属性接受none、get和all三个属性值，分别对应于不包含、仅包含GET类型请求参数和包含全部请求参数。

struts.custom.i18n.resources

     该属性指定Struts 2应用所需要的国际化资源文件，如果有多份国际化资源文件，则多个资源文件的文件名以英文逗号（,）隔开。

struts.dispatcher.parametersWorkaround

     对于某些Java EE服务器，不支持HttpServlet Request调用getParameterMap()方法，此时可以设置该属性值为true来解决该问题。该属性的默认值是false。对于 WebLogic、Orion和OC4J服务器，通常应该设置该属性为true。

struts.freemarker.manager.classname

     该属性指定Struts 2使用的FreeMarker管理器。该属性的默认值是org.apache.struts2.views.freemarker.FreemarkerManager，这是Struts 2内建的FreeMarker管理器。

struts.freemarker.wrapper.altMap

     该属性只支持true和false两个属性值，默认值是true。通常无需修改该属性值。

struts.xslt.nocache

     该属性指定XSLT Result是否使用样式表缓存。当应用处于开发阶段时，该属性通常被设置为true；当应用处于产品使用阶段时，该属性通常被设置为false。

struts.configuration.files

5. struts.xml中的配置信息     

<1>包的配置：sturts2的配置文件是从上到下处理的，所以父包应该在子包前面定义。

   

包的属性 name |extends | namespace |abstract

struts2的配置文件是从上到下处理的，所以父包应该在子包前面。

抽象包不能有Action的定义。

如果没有为包指定命名空间，包使用默认的命名空间””

当某个包指定命名空间后包下所有的Action处理的URL应该是命名空间+ACTION名。

命名空间只有一个级别。

 

<2>引入多个类似struts.xml文件

通过<include file="struts-xxx.xml"/>来导入

 

 

6. struts.xml中<result name="" type=""/>其中type的几种类型：

下面列出 struts2 内建支持的结果类型如下：

chain ： Action 链式处理的结果类型，也就是将结果转发到这个 action 中。

chart ：整合 JFreeChart 的结果类型

dispatcher ：用于整合 JSP 的结果类型，此类型是struts2默认的

freemarker ：用于整合 freemarker 结果类型。

httpheader ：用于控制特殊的 HTTP 行为的结果类型。

jasper ：用于 JasperReports 整合的结果类型

jsf ：用于整合 JSF 后的结果类型

redirect ：实际上 dispatcher 和 redirect 的区别就是在于转发和重定向的区别。

redirect-action ：用于直接 redirect action 。

stream ：用于向浏览器返回一个 Inputstream （用于文件下载）

tiles ：用于整合 Tiles 后的结果类型。

velocity ：用于整合 Velocity 的结果类型。

xslt ：用于整合 XML/XSLT 的结果类型。

plaintext ：用于显示某个页面的源代码。

 

 

plaintext 、 redirect 以及 redirect-action 的配置分别如下：

<result type=”plaintext”>

       <param name=”location”>/welcome.jsp</param>

       <!— 设置字符集编码 -->

       <param name=”charset”>gb2312</param>

</result>

 

<result type=”redirect”>

       /welcome.jsp

</result>

 

<result type=” redirect-action”>

       <!— 指定 action 的命名空间 -->

       <param name=”namespace”>/ss</param>

<!— 指定 action 的名字 -->

       <param name=”actionName”>login </param>

</result>

 

在请求结果中使用 ONGL 表达式

 

例子：

<result type=”redirect”>edit.action?skillName=${currentSkill.name}</result>

 

对于上面的表达式语法，要求 action 中必须包含 currentSkill 属性，并且 currentSkill 属性必须包含 name 属性，否则 ${currentSkill.name} 表达式值为 null 。