struts2笔记（3）

关于回显：

如果是int型，默认就会回显为0，如果不想让回显，则Integer就好

//**************************************声明式验证**************************************

如果配置文件xml没有提示，需要重新关联tdt：

windows-preferences-xml-xml catalog，看里面有没有要关联的tdt，如果有，先移除再添加。add:

key type : uri

key : tdt路径

然后从fire system中找

1). 验证分为两种:

    > 声明式验证*
    
        >> 对哪个 Action 或 Model 的那个字段进行验证
        >> 使用什么验证规则
        >> 如果验证失败, 转向哪一个页面, 显示是什么错误消息
    
    > 编程式验证
    
2). 声明式验证的 helloworld

I.  先明确对哪一个 Action 的哪一个字段进行验证: age
II. 编写配置文件: 
    > 把 struts-2.3.15.3appsstruts2-blankWEB-INFclassesexample 下的 Login-validation.xml 文件复制到
    当前 Action 所在的包下. 
    > 把该配置文件改为: 把  Login 改为当前 Action 的名字. 
    > 编写验证规则: 参见 struts-2.3.15.3/docs/WW/docs/validation.html 文档即可.
    > 在配置文件中可以定义错误消息: 
    
    <field name="age">
         <field-validator type="int">
             <param name="min">20</param>
             <param name="max">50</param>
             <message>^^Age needs to be between ${min} and ${max}</message>
         </field-validator>
     </field>
     
     > 该错误消息可以国际化吗. 可以
     
     <message key="error.int"></message>. 
     
            再在 国际化资源文件 中加入一个键值对: error.int=^^^Age needs to be between ${min} and ${max}
    
III. 若验证失败, 则转向 input 的那个 result. 所以需要配置 name=input 的 result
     <result name="input">/validation.jsp</result>
     
IV. 如何显示错误消息呢 ?      

    > 若使用的是非 simple, 则自动显示错误消息.
    > 若使用的是 simple 主题, 则需要 s:fielderror 标签或直接使用 EL 表达式(使用 OGNL)
    
    ${fieldErrors.age[0] } 
    OR
    <s:fielderror fieldName="age"></s:fielderror>*

3). 注意: 若一个 Action 类可以应答多个 action 请求, 多个 action 请求使用不同的验证规则, 怎么办 ?

    > 为每一个不同的 action 请求定义其对应的验证文件: ActionClassName-AliasName-validation.xml（AliasName=actionname）
    
    > 不带别名的配置文件: ActionClassName-validation.xml 中的验证规则依然会发生作用. 可以把各个 action 公有的验证规则
    配置在其中. 但需要注意的是, 只适用于某一个 action 的请求的验证规则就不要这里再配置了. 
    
4). 声明式验证框架的原理:

    > Struts2 默认的拦截器栈中提供了一个 validation 拦截器
    
    > 每个具体的验证规则都会对应具体的一个验证器. 有一个配置文件把验证规则名称和验证器关联起来了. 而实际上验证的是那个验证器. 
    该文件位于 com.opensymphony.xwork2.validator.validators 下的 default.xml
    
    <validator name="required" class="com.opensymphony.xwork2.validator.validators.RequiredFieldValidator"/>

5). 短路验证: 若对一个字段使用多个验证器, 默认情况下会执行所有的验证. 若希望前面的验证器验证没有通过, 后面的就不再验证, 可以使用短路验证

        <!-- 设置短路验证: 若当前验证没有通过, 则不再进行下面的验证 -->
        <field-validator type="conversion" short-circuit="true">
            <message>^Conversion Error Occurred</message>
        </field-validator>

        <field-validator type="int">
            <param name="min">20</param>
            <param name="max">60</param>
            <message key="error.int"></message>
        </field-validator>    
        
6). 若类型转换失败, 默认情况下还会执行后面的拦截器, 还会进行 验证. 可以通过修改 ConversionErrorInterceptor 源代码的方式使
当类型转换失败时, 不再执行后续的验证拦截器, 而直接返回 input 的 result

        Object action = invocation.getAction();
        if (action instanceof ValidationAware) {
            ValidationAware va = (ValidationAware) action;

            if(va.hasFieldErrors() || va.hasActionErrors()){
                return "input";
            }
        }    
        
7). 关于非字段验证: 不是针对于某一个字段的验证. 

    <validator type="expression">
        <param name="expression"><![CDATA[password==password2]]></param>
        <message>Password is not equals to password2</message>
    </validator>
     
          显示非字段验证的错误消息, 使用 s:actionerror 标签:  <s:actionerror/>
          
8). 不同的字段使用同样的验证规则, 而且使用同样的响应消息 ?

error.int=${getText(fieldName)} needs to be between ${min} and ${max}

age=u5E74u9F84
count=u6570u91CF       

详细分析参见  PPT 159.  

9). 自定义验证器:

I.   定义一个验证器的类

    > 自定义的验证器都需要实现 Validator. 
    > 可以选择继承 ValidatorSupport 或 FieldValidatorSupport 类
    > 若希望实现一个一般的验证器, 则可以继承 ValidatorSupport
    > 若希望实现一个字段验证器, 则可以继承 FieldValidatorSupport
    
    > 具体实现可以参考目前已经有的验证器. 
    
    > 若验证程序需要接受一个输入参数, 需要为这个参数增加一个相应的属性

II.  在配置文件中配置验证器

    > 默认情况下下, Struts2 会在 类路径的根目录下加载 validators.xml 文件. 在该文件中加载验证器.
         该文件的定义方式同默认的验证器的那个配置文件: 位于 com.opensymphony.xwork2.validator.validators 下的 default.xml
         
    > 若类路径下没有指定的验证器, 则从 com.opensymphony.xwork2.validator.validators 下的 default.xml 中的验证器加载     

III. 使用: 和目前的验证器一样. 

IV. 示例代码: 自定义一个 18 位身份证验证器    

Struts2 的验证

短路验证：

如果一个输入会导致多个错误提示，这个时候我们想要的是，显示一个错误，如果这个错误解决了还有错误，则显示下面的错误，这个时候就用到了短路验证。

<validator  …/> 元素和 <field-validator  …/> 元素可以指定一个可选的 short-circuit 属性，该属性指定该验证器是否是短验证器，默认值为 false。

对同一个字段内的多个验证器，如果一个短路验证器验证失败，其他验证器不会继续校验

如果不想要某种验证，比如验证拦截器，可以修改上个拦截器的源码，不让走下面的拦截器，直接返回某个result

比如验证两次密码相同：

首先继承validationAware，有input这个result，在页面上有<s:actionerror/>  来显示，有验证的xml文件。

他不是字段验证，而是非字段验证，是actionerrors,所以需要在页面上加上<s:actionerror/>  才会出现错误提示

自定义验证器，参考其他已经有的验证器就行

自定义一个 18 位身份证验证器
1、编写验证器类
2、在 validators.xml 文件中进行注册
3、在验证配置文件中使用

**************************************声明式验证**************************************//

//**************************************文件的上传下载**************************************

表单要作的准备如下：

要想使用 HTML 表单上传一个或多个文件
须把 HTML 表单的 enctype 属性设置为 multipart/form-data
须把 HTML 表单的method 属性设置为 post
需添加 <input type=“file”> 字段.

<s:form action="" method="post" enctype="multipart/form-data">
    <s:file name="ppt" label="pptFile"></s:file>
    <s:textfield name="desc" label="desc"></s:textfield>
    <s:submit></s:submit>
</s:form>

 文件上传和下载或许可以有这样的用途：

动态加载数据，或者提供热更，比如需要更换数据的时候，我就从指定路径去搜索文件，我上传文件覆盖即可。

ServletContext servletContext = ServletActionContext.getServletContext();
String dir = servletContext.getRealPath("/files/" + fileName);//根目录下的文件

1. 文件的上传:

1). 表单需要注意的 3 点

2). Struts2 的文件上传实际上使用的是 Commons FileUpload 组件, 所以需要导入

commons-fileupload-1.3.jar
commons-io-2.0.1.jar

3). Struts2 进行文件上传需要使用 FileUpload 拦截器

4). 基本的文件的上传: 直接在 Action 中定义如下 3 个属性, 并提供对应的 getter 和 setter

//文件对应的 File 对象
private File [fileFieldName];
//文件类型
private String [fileFieldName]ContentType;
//文件名
private String [fileFieldName]FileName;

5). 使用 IO 流进行文件的上传即可. 

6). 一次传多个文件怎么办 ?

若传递多个文件, 则上述的 3 个属性, 可以改为 List 类型! 多个文件域的 name 属性值需要一致. 

7). 可以对上传的文件进行限制吗 ? 例如扩展名, 内容类型, 上传文件的大小 ? 若可以, 则若出错, 显示什么错误消息呢 ? 消息可以定制吗 ? 

可以的!

可以通过配置 FileUploadInterceptor 拦截器的参数的方式来进行限制

maximumSize (optional) - 默认的最大值为 2M. 上传的单个文件的最大值

allowedTypes (optional) - 允许的上传文件的类型. 多个使用 , 分割

allowedExtensions (optional) - 允许的上传文件的扩展名. 多个使用 , 分割.

注意: 在 org.apache.struts2 下的 default.properties 中有对上传的文件总的大小的限制. 可以使用常量的方式来修改该限制

struts.multipart.maxSize=2097152

定制错误消息. 可以在国际化资源文件中定义如下的消息:

struts.messages.error.uploading - 文件上传出错的消息

struts.messages.error.file.too.large - 文件超过最大值的消息

struts.messages.error.content.type.not.allowed - 文件内容类型不合法的消息

struts.messages.error.file.extension.not.allowed - 文件扩展名不合法的消息

问题: 此种方式定制的消息并不完善. 可以参考 org.apache.struts2 下的 struts-messages.properties, 可以提供更多的定制信息.

2. 文件的下载:

1). Struts2 中使用 type="stream" 的 result 进行下载即可

2). 具体使用细节参看 struts-2.3.15.3-all/struts-2.3.15.3/docs/WW/docs/stream-result.html

3). 可以为 stream 的 result 设定如下参数

contentType: 结果类型
contentLength: 下载的文件的长度
contentDisposition: 设定 Content-Dispositoin 响应头. 该响应头指定接应是一个文件下载类型, 一般取值为  attachment;filename="document.pdf".

inputName: 指定文件输入流的 getter 定义的那个属性的名字. 默认为 inputStream

bufferSize: 缓存的大小. 默认为 1024
allowCaching: 是否允许使用缓存 
contentCharSet: 指定下载的字符集 

4). 以上参数可以在 Action 中以 getter 方法的方式提供!

3. 表单的重复提交问题

1). 什么是表单的重复提交

    > 在不刷新表单页面的前提下: 
        >> 多次点击提交按钮
        >> 已经提交成功, 按 "回退" 之后, 再点击 "提交按钮".
        >> 在控制器响应页面的形式为转发情况下，若已经提交成功, 然后点击 "刷新(F5)"
        
    > 注意:
        >> 若刷新表单页面, 再提交表单不算重复提交
        >> 若使用的是 redirect 的响应类型, 已经提交成功后, 再点击 "刷新", 不是表单的重复提交
        
2). 表单重复提交的危害:              

3). Struts2 解决表单的重复提交问题:

I. 在 s:form 中添加 s:token 子标签

    > 生成一个隐藏域
    > 在 session 添加一个属性值
    > 隐藏域的值和 session 的属性值是一致的. 
    
II. 使用 Token 或 TokenSession 拦截器. 

    > 这两个拦截器均不在默认的拦截器栈中, 所以需要手工配置一下
    > 若使用 Token 拦截器, 则需要配置一个 token.valid 的 result
    > 若使用 TokenSession 拦截器, 则不需要配置任何其它的 result
    
III. Token VS TokenSession

    > 都是解决表单重复提交问题的
    > 使用 token 拦截器会转到 token.valid 这个 result
    > 使用 tokenSession 拦截器则还会响应那个目标页面, 但不会执行 tokenSession 的后续拦截器，不会执行目标action方法. 就像什么都没发生过一样!
    
IV. 可以使用 s:actionerror 标签来显示重复提交的错误消息. 
该错误消息可以在国际化资源文件中覆盖. 该消息可以在 struts-messages.properties 文件中找到

struts.messages.invalid.token=^^The form has already been processed or no token was supplied, please try again.

4. 自定义拦截器

1). 具体步骤

I. 定义一个拦截器的类

    > 可以实现 Interceptor 接口
    > 继承 AbstractInterceptor 抽象类

II. 在 struts.xml 文件配置.    

    <interceptors>
            
        <interceptor name="hello" class="com.atguigu.struts2.interceptors.MyInterceptor"></interceptor>
        
    </interceptors>
    
    <action name="testToken" class="com.atguigu.struts2.token.app.TokenAction">
        <interceptor-ref name="hello"></interceptor-ref>
        <interceptor-ref name="defaultStack"></interceptor-ref>
        <result>/success.jsp</result>
        <result name="invalid.token">/token-error.jsp</result>
    </action>
    
III. 注意: 在自定义的拦截器中可以选择不调用 ActionInvocation 的 invoke() 方法. 那么后续的拦截器和 Action 方法将不会被调用.
Struts 会渲染自定义拦截器 intercept 方法返回值对应的 result

**************************************文件的上传下载**************************************//