struts2学习笔记

1. 类型转换：
	
	* 从页面中获取对应的内容
		
		* 在动作类action中，声明与页面中表单name属性的值同名的属性
		* 提供get和set方法
		* struts2框架就会通过反射机制，从页面中获取对应的内容
		
	* struts2框架不能把页面中获取到的字符串类型转换成任何类型
	
	* 当struts2框架不能把页面中获取到的字符串类型进行转换时，就需要自定义类型转换器
	
	* 自定义类型转换器：
		
		* 要么实现TypeConverter接口或者继承TypeConverter接口的某个实现类，我们继承DefaultTypeConverter类
		
		* 重写convertValue(Object value, Class toType){}方法
		
			* 参数"value"：要转换的值
			* 参数"toType"：要转换的类型
			
		* 具体代码实现：
			if(value==null){
				return false;
			}
			
			if(toType==null){
				return false;
			}
			
			if(toType!=java.util.Date.class){
				return false;
			}
			
			if(value instanceof java.lang.String[]){
				String [] str = (String[])value;
				
				if(str[0]!=null&&str[0].length()>0){
					
					try {
						SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd");
						
						return sdf.parse(str[0]);
						
					} catch (ParseException e) {
						/*
						 *  在struts2框架里，自定义的类型转换器，
						 *  如果我们不手动抛出异常，struts2框架只捕获异常，但是并不抛出。
						 *  所以框架就会认为类型转换器转换成功，转向成功页面。
						 */
						throw new RuntimeException(e);
						
					}
				}
			}
		
		* 两种注册方式：
			* 基于字段的(局部)
				
				* 在动作类action同目录下，创建一个名为"UserAction-conversion.properties"的资源文件
					* UserAction为动作类action的名称
					* "-conversion.properties"是固定写法
				
				* 其内容配置如下：
					createTime=cn.itcast.converter.DateConverter
				
			* 基于类的(全局)
				
				* 在src目录下，创建一个名为"xwork-conversion.properties"的资源文件
					* 该资源文件的名称是固定的
				
				* 其内容配置如下：
					java.util.Date=cn.itcast.converter.DateConverter
		
		* 如果在页面中输入一个不正确的值的时候，不手动抛出异常，页面依然转向成功页面
			/*
			 *  在struts2框架里，自定义的类型转换器，
			 *  如果我们不手动抛出异常，struts2框架只捕获异常，但是并不抛出。
			 *  所以框架就会认为类型转换器转换成功，转向成功页面。
			 */
		
		* 配置修改错误提示信息为中文
			
			* 在动作类action同目录下，创建一个名为"converter.properties"的资源文件
			
			* 该资源文件配置如下：
				
				* 针对所有字段：
					xwork.default.invalid.fieldvalue=类型转换失败 "{0}".
				
				* 针对某个字段：
					invalid.fieldvalue.createTime=出生日期转换失败
			
			* 在struts.xml文件进行配置：
				<constant name="struts.custom.i18n.resources" 
						value="cn.itcast.converter.converter">
				</constant>
		
2. struts2框架的文件上传：
	* 单文件上传：
		* 在动作类action中声明相关属性：
			* 在动作类action中，要声明与页面中表单name属性同名的属性，同名的属性的类型时File类型；
			* 在动作类action中，要声明[同名的属性]ContentType，类型时String类型；
			* 在动作类action中，要声明[同名的属性]FileName，类型时String类型
			* 给所有属性提供get和set方法
		* 在业务方法中，处理文件上传：
			* 获取要上传文件的路径，保存的位置
			* 在目标文件夹内，创建一个与上传文件同名的文件
			* 通过FileUtils工具类提供copyFile()方法，将临时文件内容拷贝到目标文件夹下的那个同名的文件
		* 设置上传文件的总大小
			* 在struts.xml文件中，<constant name="struts.multipart.maxSize" value="2097152000"></constant>
		* 设置上传文件的大小、类型和扩展名：
			* 在自定义的配置文件中，在action标签下：
				<!-- 配置拦截器的参数，这里是文件上传拦截器 -->
				<interceptor-ref name="defaultStack">
	              	<!-- 
	              		配置文件上传拦截器的参数
	              			* 与定义参数的顺序无关
	              			* 允许的类型(allowedTypes)和允许的扩展名(allowedExtensions)必须保持一致
	              	 -->
	              	<!-- 
	              		* 配置上传文件的大小
	              			* struts.xml文件中配置的是上传文件的总大小
	              			* 这里配置的是上传文件的单个大小
	              	 -->
	              	<param name="fileUpload.maximumSize">20971520</param>
	              	<!-- 配置上传文件允许的类型，如果配置多个值的话，用","隔开 -->
	              	<param name="fileUpload.allowedTypes">text/plain,application/msword</param>
	              	<!-- 配置上传文件的扩展名，如果配置多个值的话，用","隔开 -->
	              	<param name="fileUpload.allowedExtensions">.txt</param>
	            </interceptor-ref>
	         * 自定义上传文件的错误提示信息：
	         	* 在动作类action同目录下，创建一个名为fileuploadmessage.properties资源文件(名为自定义)
	         	* 改资源文件配置如下：
	         		struts.messages.error.uploading=Error uploading: {0}
					struts.messages.error.file.too.large=File too large: {0} "{1}" "{2}" {3}
					struts.messages.error.content.type.not.allowed=Content-Type not allowed: {0} "{1}" "{2}" {3}
					struts.messages.error.file.extension.not.allowed=File extension not allowed: {0} "{1}" "{2}" {3}
		
		
	* 多文件上传：
		* 所有流程于配置都与单文件上传一致。
		* 需要注意的是：
			* 在页面中，虽然是多文件上传，但是页面中表单的name属性的值必须保持一致；
			* 在动作类action中声明的相关属性，类型改成数组；
			* 在业务方法中，相关处理流程改成单文件上传的循环。
		
3. struts2手动验证：
	* 首先要从页面中获取对应的标签name属性的值，在动作类action中声明同名的属性，提供get和set方法
	
	* 要继承ActionSupport类或者实现Validateable接口
	
	* 重写Validateable接口的validate()方法
		* 前提是：要保证setUsername()、validate()、login()方法要按照这个先后顺序执行
	
	* 如果登录失败，如何处理：
		* this.addFieldError( key, value);
			* key：错误提示字段
			* value：错误提示信息
	
	* 什么时候才是验证通过？
		* 验证通过：1、map集合不存在；2、map集合存在并为空
		* 验证不通过：map集合存在并且不为空
	
	* 分析需求：
		* 用户名不能为null ,""
		* 密码不能为null, "" ，并且密码的长度6-12之间 
	
	* 针对所有业务方法进行验证还是针对某个指定业务方法进行验证？
		* 重写的validate()方法，针对所有业务方法进行验证
		* 重写的validate()方法加上要验证的指定的业务方法名(业务方法名的首字母大写)，实现针对某个指定的业务方法进行验证
			* 为什么要这样进行拼接？因为struts2框架底层拼接，如果不这样写，底层就找不到对应方法名
	
struts2框架验证(xml方式):
	* 首先要从页面中获取对应的标签name属性的值，在动作类action中声明同名的属性，提供get和set方法
	
	* 创建一个xml格式验证文件：
		* 命名方式：ActionClassName-validation.xml，ActionClassName指的是动作类action的名称
		* <validators>标签：根元素
		* field：指定action中要校验的属性，实际上就是页面中表单的name属性的值
			* name：指定页面中表单的name属性的值
		* field-validator：指定验证规则
			* type：指定验证规则名称，
					struts2框架提供的验证规则放在xwork-core-xxx.jar
					下的com\opensymphony\xwork2\validator\validators
					的default.xml配置文件。
		* param：向底层的验证规则传递的参数
		* message：验证失败时，提供的错误提示信息
	
	* 如果要对指定方法进行验证的话：
		* xml验证文件的命名方式：ActionClassName-ActionName-validation.xml，
								ActionName对应的是struts.xml文件对应的action标签的name属性的值
	
	
4. 如何自定义拦截器：
	* 所有的拦截器都需要实现Interceptor接口或者继承Interceptor接口的扩展实现类
	
	* 要重写init()、intercept()、destroy()方法
	
		* init()是在struts2框架运行时执行，在拦截器的生命周期中只执行一次，可以做必要的内容的初始化工作
		
		* intercept()，是每一次请求就执行一次，做相关处理工作。
		
			* intercept()方法接收一个ActionInvocation接口的实例
			
			* 通过这个接口的实例，可以获取以下内容
			：
				//cn.itcast.aop.UserAction@15b5783，动作类的对象
				System.out.println("invocation.getAction() : "+invocation.getAction());
				
				//cn.itcast.aop.UserAction@15b5783，与invocation.getAction()方法获取的是同一的对象
				System.out.println("invocation.getProxy().getAction() : "+invocation.getProxy().getAction());
				
				//userAction_save，自定义配置文件中的action标签的name属性的值
				System.out.println("invocation.getProxy().getActionName() : "+invocation.getProxy().getActionName());
				
				//save，对应动作类指定要执行的方法名
				System.out.println("invocation.getProxy().getMethod() : "+invocation.getProxy().getMethod());
				
				//	/aop，自定义配置文件中的package标签的namespace属性的值
				System.out.println("invocation.getProxy().getNamespace() : "+invocation.getProxy().getNamespace());
				
		* destroy()是在拦截器销毁前执行，在拦截器的声明周期中只执行一次。
		
	* 在struts.xml配置文件中，进行注册
		* 在配置文件中的package标签下，进行相关配置：
		
		<interceptors>
			<!-- 声明自定义的拦截器 -->
			<interceptor name="expessionInterceptor" class="cn.itcast.aop.ExpessionInterceptor" />
			
			<!-- 声明自定义拦截器栈 -->
			<interceptor-stack name="expessionStack">
                <interceptor-ref name="defaultStack"/>
                
                <!-- 配置使用自定义拦截器 -->
                <interceptor-ref name="expessionInterceptor"/>
                
            </interceptor-stack>
		</interceptors>
		
		<!-- 配置修改struts2框架运行时，默认执行的是自定义拦截器栈 -->
		<default-interceptor-ref name="expessionStack" />
	
5. 模型驱动：
	* 要从页面中获取表单元素的值，需要在动作类中声明与页面元素同名的属性。导致动作类中既有javabean又有业务方法。
	
	* 将javabean和业务方法进行分离：
		* 将重新创建一个javabean，将javabean的内容放置其中。
		* 动作类action中只留业务方法
	
	* 在动作类中声明的javabean无法从页面中获取同名的属性
	
	* 需要使用struts2框架提供"ModelDriven(模型驱动)"
		
		* 实现ModelDriven这个接口
		
		* 重写getModel()方法，返回该javabean的实例
		
		* 代码如下：
			public class UserAction extends ActionSupport implements ModelDriven<User> {

				private User user = new User();
				
				public User getModel() {
					return user;
				}
			
				public String add(){
					System.out.println("UserAction ************* add()");
					return "add";
				}
				
				public String save(){
					System.out.println("UserAction ************* save()");
					
					return "success";
				}
			}
		
		* 模型驱动的原理：
			
			* 在不使用模型驱动的时候，之所以在动作类中获取不到对应的属性的原因：
				* 在ValueStack中没有对应javabean的所有属性
				
			* 模型驱动的作用，就是将javabean的实例压入对象栈的栈顶，从而可以获取到对应的属性的值


6. 页面回显技术：
	* 通过模型驱动，在动作类action中，可以获取到页面中元素的值
	
	//方法一
	* 通过javabean实例的set()方法，将新的内容set到javabean中，从而放置在页面对应元素中
		user.setUsername(newUser.getUsername());
		user.setTel(newUser.getTel());
		user.setDes(newUser.getDes());
	
	//方法二
	* 首先将值栈中，旧的javabean的内容，删除掉
	* 然后将新的内容压入到值栈中的栈顶
		ValueStack valueStack = ServletActionContext.getContext().getValueStack();
		valueStack.pop();
		valueStack.push(newUser);


7. 处理表单重复提交：
	
	* 在页面中增加一个隐藏域：<s:token></s:token>
	
	* 创建一个struts.xml的配置文件，具体配置如下：
		<!-- 配置默认执行的拦截器栈，增加令牌拦截器 -->
		<interceptors>
			<interceptor-stack name="tokenStack">
				<interceptor-ref name="defaultStack" />
				<interceptor-ref name="token" >
					<!-- 配置令牌拦截器，拦截的方法名，如果配置多个方法时，用","隔开 -->
					<param name="includeMethods">save,update</param>
				</interceptor-ref>
			</interceptor-stack>
		</interceptors>
		
		<default-interceptor-ref name="tokenStack" />
	
	* 在struts.xml配置文件中，增加一个result结果类型：
		<!-- 配置表单重复提交后，要转向到的页面 -->
		<result name="invalid.token">/model/error.jsp</result>
	
	* 在表单重复提交后，要转向到的页面中通过<s:actionerror>获取struts2框架底层提供错误提示信息
	
	* 将struts2框架底层提供错误提示信息改成中文：
		
		* 在与动作类action同级目录下，创建名为"token.properties"的资源文件，文件内容如下：
			struts.messages.invalid.token=表单重复提交，请刷新后重试！