SpringMVC(一)---执行流程图,请求参数绑定

SpringMvc的入门

搭建

1.导入SpringMvc依赖
<dependencies>
    <!--spring-webmvc依赖-->
    <dependency>
      <groupId>org.springframework</groupId>
      <artifactId>spring-webmvc</artifactId>
      <version>5.1.8.RELEASE</version>
    </dependency>
  </dependencies>

2.在web.xml上配置中央控制器
<!--配置springMVC框架的中央控制器DispatcherServlet
		作用：
		   1.拦截所有请求，最后将请求给到自己开发的控制器去处理
		   2.解析springMVC.xml配置文件，创建三大组件
		拦截路径：*.do
		   原因：不拦截静态资源（.html/.css/.js/...）和jsp资源， 这里暂时使用*.do以后会优化
		创建时间点：这个Servlet修改默认创建时间变成启动时创建
		   servlet默认创建时间点：默认第一次访问的时候
		   修改为启动时创建：<load-on-startup>1<load-on-startup>
		   为什么修改？答：在保证在控制器创建前就先创建中央控制器
	-->
	<servlet>
		<servlet-name>DispatcherServlet</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<!--通过私有参数加载解析springMVC.xml配置文件-->
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>classpath:springMVC.xml</param-value>
		</init-param>
		<!--配置启动时创建-->
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>DispatcherServlet</servlet-name>
		<url-pattern>*.do</url-pattern>
	</servlet-mapping>

引入模糊匹配原则:
路径模糊匹配用法：分为前缀匹配与后缀匹配
前缀匹配要求：以“/”开头，*结尾， eg: /abc/*
后缀匹配要求：以“*”开头，以“.扩展名”结尾   eg: *.do

3.编写控制器
使控制器类通过IOC创建对象
注解方式必须使用@Controller(注:不能使用@Servcie/@Repository/@Component)
package com.itheima.controller.a_hello;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * @author 黑马程序员
 */
@Controller  //注意：控制器对象的创建必须使用@Controller，不可以使用@Component/@Repository/@Service
public class HelloController {

    /*
    * 处理请求的方法
    * 1）处理提交的请求地址：http://localhost:8080/项目路径/资源路径
    *    eg:http://localhost:8080/项目路径/hello.do
    * 2）映射请求地址路径/hello.do 进行处理请求
    *    @RequestMapping("/hello.do")  处理中央控制器传递过来的指定路径请求
    * 3）响应视图名字
    *    作用：利用springMVC框架将视图名字解析为一个页面地址，返回给浏览器显示
    *    解析页面地址需要配置springMVC.xml配置文件配置视图解析器
    *       视图解析器配置前缀： /pages/
    *       视图解析器配置后缀   .jsp
    *    视图名字：success, 解析视图页面地址：http://localhost:8080/项目路径/pages/success.jsp
    * */
    @RequestMapping("/hello.do")//这里的do可以省略
    public String hello(){
        System.out.printf("进入hello方法...");
        return "success";
    }
}

4.配置spring的三大组件
1)开启IOC注解扫描,创建控制器对象
    <context:component-scan base-package="com.itheima.controller"></context:component-scan>
 
2)配置springMVC框架三大组件
2.1)视图解析器,目的更改控制方法返回视图名字解析视图页面地址
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

2.2)处理映射器和处理适配器
<mvc:annotation-driven></mvc:annotation-driven>
需要配置mvc相对应的xmlns属性


分析
1. RequestMappingHandlerMapping 处理器映射器

   作用：<font color=red>找方法</font>，根据请求url地址，找到控制器中处理请求的方法。HelloController.hello()

2. RequestMappingHandlerAdapter 处理器适配器

   作用：根据处理器映射器解析的结果，找到处理请求的方法，<font color=red>执行方法</font>。

3. InternalResourceViewResolver 视图解析器

   作用：根据处理器适配器执行的结果，交给视图解析器处理准备（渲染）页面，<font color=red>展现视图页面</font>。

---

流程简图

执行流程图

@RequestMapping注解使用[重点]

package com.itheima.controller.b_requestMapping;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

/**
 * @RequestMapping
 *    1）介绍：进行路径映射到指定的控制器方法
 * 
 *    2）编写位置：
 *       第一个位置：控制器的类上
 *           eg: @RequestMapping("/order")  访问路径：/项目路径/order/save.do
 *           eg: @RequestMapping("/user")  访问路径：/项目路径/user/save.do
 *           作用：用于区别不同的控制器或模块功能
 *       第二个位置：控制器的方法上
 *          @RequestMapping("/save.do")
 * 
 *    3）编写方式：
 *          @RequestMapping("/save.do")
 *          @RequestMapping("/save")   【推荐】方便，可读性好，注意请求路径中的.do不可以省略
 *          @RequestMapping("save.do")
 *          @RequestMapping("save")
 * 
 *    4）注解对象的常用属性：
 *          属性：value
 *          属性：path
 *             value与path属性功能一样，都是设置映射的资源路径
 *          属性：method
 *             用于设置处理请求方法的类型
 *             method = RequestMethod.GET  用于处理get请求
 *                支持4种请求处理GET/POST/PUT/DELETE
 *                简写注解 GetMapping("/save")  处理get请求
 *                简写注解 PutMapping("/save")  处理get请求
 *                简写注解 DeleteMapping("/save")  处理get请求
 *                简写注解 PostMapping("/save")  处理get请求
 *          属性：produces
 *             介绍：英文翻译“生产”
 *             作用：与@ResponseBody注解一起使用设置返回json字符串类型与码表,可以解决json字符串中文乱码
 *              @ResponseBody： 注解功能是将方法的返回值转换为json字符串
 *             格式：produces = "application/json;charset=utf-8"
 */
@Controller
@RequestMapping("/order")
public class OrderController {

    @RequestMapping(value = "/save",method = {RequestMethod.GET,RequestMethod.POST})
    public String save(){
        System.out.println("保存订单成功！");
        return "success";
    }
}

---

请求参数的绑定,简单类型作为参数

  /*
    * 请求路径并传递请求参数数据：/项目路径/user/save.do?name=播仔&age=20
    * springMVC简单类型请求数据接收规则：
    *       1.请求参数名与控制器方法的参数名要一致，并且参数值的数据类要兼容
    *       2.简单类型推荐使用包装类型
    *         如果是非包装类型，请求参数没有传递会发生异常:
    *               Optional int parameter 'age' is present but cannot be translated
    *               into a null value due to being declared as a primitive type
    *         如果是保证类型，请求参数没有传递会接收到null
    * */

请求参数的绑定,pojo类型的封装

      /*注意：请求提交的参数名 与 User对象的字段名保持一致*/

请求参数的绑定,复合pojo类型的封装

       /*注意：请求提交的参数名 与 User对象的字段名保持一致*/
       请求时提交的name需要书写规则为(内嵌类名.属性名)
   
 eg:   所在省份：<input type="text" name="address.province"><br/>
       所在城市：<input type="text" name="address.city"><br/>

list集合封装

	   封装成list集合,请求时的书写规则应该是和简单java对象类的字段名保存一致
	   按照索来输入
	        
	eg:所在户口省份：<input type="text" name="addresses[0].province"><br/>
	   所在户口城市：<input type="text" name="addresses[0].city"><br/>
	   现居住省份：<input type="text" name="addresses[1].province"><br/>
	   现居住城市：<input type="text" name="addresses[1].city"><br/> 
 

map集合封装

    	/*注意：请求提交的参数名 与 User对象的字段名保持一致*/
    	
    	简单的java对象的字段为"addressMap".
    eg:所在户口省份：<input type="text" name="addressMap['hk'].province"><br/>
       所在户口城市：<input type="text" name="addressMap['hk'].city"><br/>
       现居住省份：<input type="text" name="addressMap['now'].province"><br/>
       现居住城市：<input type="text" name="addressMap['now'].city"><br/>

---

请求参数绑定 解决参数乱码

Spring提供了统一的编码过滤器，解决提交数据中文乱码问题。

过滤器：CharacterEncodingFilter

写在web.xml中
<!--配置spring提供乱码解决的过滤器-->
<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <!--设置post提交请求中文使用的码表-->
    <init-param>
        <param-name>encoding</param-name>
        <param-value>utf-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/* </url-pattern>
    
</filter-mapping>


可以直接应用

请求参数绑定,@RequestParam实现参数绑定

应用在请求参数名称与方法形参不一致,建立请求参数与方法形参的映射关系

/*
    * @RequestParam
    *    作用：用于请求参数名与方法参数名不一致的时候封装数据
    *    需求：请求地址，/项目路径/user/query.do?name=123
    *    由于方法参数名username,想接收参数name数据，使用@RequestParam("name"),获取数据给username赋值
    *
    *    常用注解属性：required
    *         格式：required=true  或  false, 默认值为true
    *               true, 设置当前属性必须赋值，否则发生错误
    *               false,可以不赋值, 值为null
    *    常用注解属性：defaultValue
    *         格式：defaultValue="默认值"
    *         作用：如果请求参数没有传递，设置默认值
    *         应用场景：分页请求，浏览器前端会传递当前页curPage,每页大小pageSize
    *                   如果不传递，一般设置默认值
    *
    *    注意：使用@RequestParam注意必须赋值，否则要设置required=false 或 给出默认值
    *
    * */
    @RequestMapping("/query")
    public String  query(@RequestParam(value="name",required = false) String username,
                         @RequestParam(defaultValue = "1") Integer curPage,
                         @RequestParam(defaultValue = "3") Integer pageSize){
        System.out.println(username);
        System.out.println("curPage:"+curPage);
        System.out.println("pageSize:"+pageSize);
        return "success";
    }

---

请求参数绑定,自定义类型转换器

自定义类型转换器，实现把请求参数值转换为指定的类型。

例子:把字符串自动转换为日期对象

先在springMvc配置中配置转换工厂
```java
</bean>

    <!--3.2 将自定义类型转换器加入到springMVC类型转换器工厂中-->
    <bean id="conversionServiceFactoryBean" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <ref bean="stringToDateConverter"></ref>
            </set>
        </property>
    </bean>
</beans>

  <!--3.配置String转换为Date的自定义类型创建器-->
    <!--3.1 创建自定义类型转换器对象-->
    <bean id="stringToDateConverter" class="com.itheima.converter.StringToDateConverter"></bean>
    
 <!--2.2 处理器映射器和处理器适配器， 3.3更新springMVC类型转换器工厂-->
    <mvc:annotation-driven conversion-service="conversionServiceFactoryBean"></mvc:annotation-driven>
一步不能少

写一个类，实现Converter接口

package com.itheima.converter;

import org.springframework.core.convert.converter.Converter;
import org.springframework.util.StringUtils;

import java.text.ParseException;
import java.text.SimpleDateFormat;
import java.util.Date;

/**
 * Converter<String, Date>  :   springMVC提供的转换器接口
 *      含义：将String类型转换为Date类型
 */
public class StringToDateConverter implements Converter<String, Date> {
    @Override
    public Date convert(String s) {
        if(StringUtils.isEmpty(s)){
            //StringUtils.isEmpty(s) spring框架提供的工具类，判断字符串是否为null或空字符串
            return null;
        }
        try {
            Date date = new SimpleDateFormat("yyyy-MM-dd").parse(s);
            return date;
        } catch (ParseException e) {
            e.printStackTrace();
            throw  new RuntimeException(e);
        }
    }
}

 /**
     * @RequestBody 获取请求体的数据（post提交的数据）
     * 应用场景： 前端通过请求体传递json字符串给服务器端 ，后端会将页面的json字符串转换为Java对象
     */
    @RequestMapping("/body")
    public String body(@RequestBody String requestBody){

        try {
            System.out.println("requestBody:"+ URLDecoder.decode(requestBody,"utf-8"));
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
            throw  new RuntimeException(e);
        }
        return "success";
    }

---

springmvc底层执行原理
``
在启动的时候springmvc已经扫描了所有的注解，收集了方法和路径，存到了一个map集合里，然后跟请求路径一匹配，就找到方法了，

执行方法的原理：反射执行。

视图展现原理：将得到的返回字符串，进行拼接，最后进行转发跳转。

织梦为马,我爱你