springMVC整理（三）

• 自定义类型转换器，个人认为是来补充包，框架所提供的不足的地方。例如，在字符串转换成日期的里面，2018/12/12可以转化，但是2018-12-12就不能自动转化，于是乎可以自己补充。
  使用方法：

  第一步:定义一个类,实现 Converter 接口,该接口有两个泛型。
  public interface Converter<S, T> {//S:表示接受的类型,T:表示目标类型
  	/**
  	* 实现类型转换的方法
  	*/
  	@Nullable
  	T convert(S source);
  }
  /**
  * 自定义类型转换器
  * @author 黑马程序员
  * @Company http://www.ithiema.com
  * @Version 1.0
  */
  public class StringToDateConverter implements Converter<String, Date> {
  	/**
  	* 用于把 String 类型转成日期类型
  	*/
  	@Override
  	public Date convert(String source) {
  		DateFormat format = null;
  		try {
  			if(StringUtils.isEmpty(source)) {
  				throw new NullPointerException("请输入要转换的日期");
  		}
  			format = new SimpleDateFormat("yyyy-MM-dd");
  			Date date = format.parse(source);
  			return date;
  		} catch (Exception e) {
  			throw new RuntimeException("输入日期有误");
  		}
  	}
  }
  
  第二步:在 spring 配置文件中配置类型转换器。
  spring 配置类型转换器的机制是,将自定义的转换器注册到类型转换服务中去。
  <!-- 配置类型转换器工厂 -->
  <bean id="converterService"		class="org.springframework.context.support.ConversionServiceFactoryBean">
  	<!-- 给工厂注入一个新的类型转换器 -->
  	<property name="converters">
  		<array>
  			<!-- 配置自定义类型转换器 -->
  			<bean class="com.itheima.web.converter.StringToDateConverter"></bean>
  		</array>
  	</property>
  </bean>
  
  第三步:在 annotation-driven 标签中引用配置的类型转换服务
  <!-- 引用自定义类型转换器 -->
  <mvc:annotation-driven	conversion-service="converterService"></mvc:annotation-driven>
  

• 常用注解

  • RequestParam

    • 使用说明

      • 作用:
        把请求中指定名称的参数给控制器中的形参赋值。

      • 属性:
        value:请求参数中的名称。
        required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。

      • 使用示例

        jsp 中的代码:
        <!-- requestParams 注解的使用 -->
        <a href="springmvc/useRequestParam?name=test">requestParam 注解</a>
        
        控制器中的代码:
        /**
        * requestParams 注解的使用
        * @param username
        * @return
        */
        @RequestMapping("/useRequestParam")
        public String useRequestParam(@RequestParam("name")String username,@RequestParam(value="age",required=false)Integer age){
        	System.out.println(username+","+age);
        	return "success";
        }
        

  • RequestBody

    • 使用说明

      • 作用:
        用于获取请求体内容。直接使用得到是 key=value&key=value…结构的数据。
        get 请求方式不适用。

      • 属性:
        required:是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值
        为 false,get 请求得到是 null。

      • 使用示例

        post 请求 jsp 代码:
        <!-- request body 注解 -->
        <form action="springmvc/useRequestBody" method="post">
        	用户名称:<input type="text" name="username" ><br/>
        	用户密码:<input type="password" name="password" ><br/>
        	用户年龄:<input type="text" name="age" ><br/>
        	<input type="submit" value=" 保存 ">
        </form>
        
        get 请求 jsp 代码:
        <a href="springmvc/useRequestBody?body=test">requestBody 注解 get 请求</a>
        
        控制器代码:
        /**
        * RequestBody 注解
        * @param user
        * @return
        */
        @RequestMapping("/useRequestBody")
        public String
        useRequestBody(@RequestBody(required=false) String body){
        	System.out.println(body);
        	return "success";
        }
        

  • RequestBody 和 RequestParam的区别RequestParam的使用范围小，但是使用起来更方便，能够分开，并且绑定。RequestBody则使用范围大，但是不太方便。
    在提交的数据中有：表单格式，xml格式，json格式，pdf格式，等等。
    其中，只有表单能用后者，但是呢吧，还不是说只要是表单就能用后者，比如用表单提交的是文件。其余格式则都能用前者接受，详情见这

  • PathVaribale

    • 使用说明

      • 作用:
        用于绑定 url 中的占位符。例如:请求 url 中 /delete/{id},这个{id}就是 url 占位符。url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。

      • 属性:
        value:用于指定 url 中占位符名称。
        required:是否必须提供占位符。

      • 使用示例

        jsp 代码:
        <!-- PathVariable 注解 -->
        <a href="springmvc/usePathVariable/100">pathVariable 注解</a>
        
        控制器代码:
        /**
        * PathVariable 注解
        * @param user
        * @return
        */
        @RequestMapping("/usePathVariable/{id}")
        public String
        usePathVariable(@PathVariable("id") Integer id){
        	System.out.println(id);
        	return "success";
        }
        
        ```java
        
        

  • CookieValue

    • 使用说明

      • 作用:
        用于把指定 cookie 名称的值传入控制器方法参数。在Controller端接收。

      • 属性:
        value:指定 cookie 的名称。
        required:是否必须有此 cookie。

      • 使用示例

        jsp 中的代码:
        <!-- CookieValue 注解 -->
        <a href="springmvc/useCookieValue">绑定 cookie 的值</a>
        控制器中的代码:
        /**
        * Cookie 注解注解
        * @param user
        * @return
        */
        @RequestMapping("/useCookieValue")
        public String
        useCookieValue(@CookieValue(value="JSESSIONID",required=false)String cookieValue{
        	System.out.println(cookieValue);
        	return "success";
        }
        
        

  • ModelAttribute

    • 使用说明

    • 作用:
      该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。
      出现在方法上,表示当前方法会在控制器的方法执行之前,先执行。它可以修饰没有返回值的方法,也可以修饰有具体返回值的方法。
      出现在参数上,获取指定的数据给参数赋值。

    • 注意：当同一个controller中有任意一个方法被@ModelAttribute注解标记，页面请求只要进入这个控制器，不管请求哪个方法，均会先执行被@ModelAttribute标记的方法，且多个被@ModelAttribute标记的方法都会被执行，且按照从上往下执行，最后进入被请求的方法。

    • 属性:
      value:用于获取数据的 key。key 可以是 POJO 的属性名称,也可以是 map 结构的 key。

    • 应用场景:
      当表单提交数据不是完整的实体类数据时,保证没有提交数据的字段使用数据库对象原来的数据。也可用来做初始化。
      例如:
      我们在编辑一个用户时,用户有一个创建信息字段,该字段的值是不允许被修改的。在提交表单数
      据是肯定没有此字段的内容,一旦更新会把该字段内容置为 null,此时就可以使用此注解解决问题。

    • 使用示例

      	基于 POJO 属性的基本使用:
      	jps 代码:
      	<!-- ModelAttribute 注解的基本使用 -->
      	<a href="springmvc/testModelAttribute?username=test">测试 modelattribute</a>
      	
      	控制器代码:
      	/**
      	* 被 ModelAttribute 修饰的方法
      	* @param user
      	*/
      	@ModelAttribute
      	public void showModel(User user) {
      		System.out.println("执行了 showModel 方法"+user.getUsername());
      	}
      	/**
      	* 接收请求的方法
      	* @param user
      	* @return
      	*/
      	@RequestMapping("/testModelAttribute")
      	public String testModelAttribute(User user) {
      		System.out.println("执行了控制器的方法"+user.getUsername());
      		return "success";
      	}
      	```
      
      

  • SessionAttribute

    • 使用说明

      • 作用:
        用于多次执行控制器方法间的参数共享。

      • 属性:
        value:用于指定存入的属性名称
        type:用于指定存入的数据类型。

      • 使用示例

        jsp 中的代码:
        <!-- SessionAttribute 注解的使用 -->
        <a href="springmvc/testPut">存入 SessionAttribute</a>
        <hr/>
        <a href="springmvc/testGet">取出 SessionAttribute</a>
        <hr/>
        <a href="springmvc/testClean">清除 SessionAttribute</a>
        
        控制器中的代码:
        /**
        * SessionAttribute 注解的使用
        */
        @Controller("sessionAttributeController")
        @RequestMapping("/springmvc")
        @SessionAttributes(value ={"username","password"},types={Integer.class})
        public class SessionAttributeController {
        /**
        * 把数据存入 SessionAttribute
        * @param model
        * @return
        * Model 是 spring 提供的一个接口,该接口有一个实现类 ExtendedModelMap
        * 该类继承了 ModelMap,而 ModelMap 就是 LinkedHashMap 子类
        */
        @RequestMapping("/testPut")
        public String testPut(Model model){
        	model.addAttribute("username", "泰斯特");
        	model.addAttribute("password","123456");
        	model.addAttribute("age", 31);
        	//跳转之前将数据保存到 username、password 和 age 中,因为注解@SessionAttribute 中有几个参数
        	return "success";
        }
        @RequestMapping("/testGet")
        public String testGet(ModelMap model){
        	System.out.println(model.get("username")+";"+model.get("password")+";"+model.get("age"));
        	return "success";
        }
        @RequestMapping("/testClean")
        public String complete(SessionStatus sessionStatus){
        	sessionStatus.setComplete();
        	return "success";
        }