Spring MVC__@RequestMapping注解、获取请求参数、域对象共享数据、视图、Restful

一、@RequestMapping注解

1、@RequestMapping注解的功能

从注解名称上我们可以看到， @RequestMapping 注解的作用就是将请求和处理请求的控制器方法关联起来，建立映射关系
SpringMVC 接收到指定的请求，就会来找到在映射关系中对应的控制器方法来处理这个请求

2、@RequestMapping注解的位置

@RequestMapping 标识一个类：设置映射请求的请求路径的初始信息
@RequestMapping 标识一个方法：设置映射请求请求路径的具体信息

@Controller 
@RequestMapping("/test") 
public class RequestMappingController { 
 
    //此时请求映射所映射的请求的请求路径为：/test/testRequestMapping
    @RequestMapping("/testRequestMapping")                          
    public String testRequestMapping(){ 
        return "success"; 
    } 
 
}

3、@RequestMapping注解的value属性

@RequestMapping 注解的 value 属性通过请求的请求地址匹配请求映射
@RequestMapping 注解的 value 属性是一个字符串类型的数组，表示该请求映射能够匹配多个请求地址所对应的请求
@RequestMapping 注解的 value 属性必须设置，至少通过请求地址匹配请求映射

<a th:href="@{/testRequestMapping}">
    测试@RequestMapping的value属性-- >/testRequestMapping
</a>
<br> 
<a th:href="@{/test}">
    测试@RequestMapping的value属性-->/test
</a>
<br>

@RequestMapping( value = {"/testRequestMapping", "/test"} )
public String testRequestMapping(){ 
    return "success"; 
}

4、@RequestMapping注解的method属性

@RequestMapping 注解的 method 属性通过请求的请求方式（ get 或 post ）匹配请求映射
@RequestMapping 注解的 method 属性是一个 RequestMethod 类型的数组，表示该请求映射能够匹配多种请求方式的请求
若当前请求的请求地址满足请求映射的 value 属性，但是请求方式不满足 method 属性，则浏览器报错405： Request method ‘POST’ not supported

<a th:href="@{/test}">
    测试@RequestMapping的value属性-->/test
</a>
<br> 
<form th:action="@{/test}" method="post"> 
    <input type="submit"> 
</form>

@RequestMapping( 
    value = {"/testRequestMapping", "/test"}, 
    method = {RequestMethod.GET, RequestMethod.POST} 
)
public String testRequestMapping(){ 
    return "success"; 
}

注：
1 、对于处理指定请求方式的控制器方法， SpringMVC 中提供了 @RequestMapping 的派生注解
处理 get 请求的映射 -->@GetMapping
处理 post 请求的映射 -->@PostMapping
处理 put 请求的映射 -->@PutMapping
处理 delete 请求的映射 -->@DeleteMapping
2 、常用的请求方式有 get ， post ， put ， delete
但是目前浏览器只支持 get 和 post ，若在 form 表单提交时，为 method 设置了其他请求方式的字符 串（put 或 delete ），则按照默认的请求方式 get 处理
若要发送 put 和 delete 请求，则需要通过 spring 提供的过滤器 HiddenHttpMethodFilter ，在
RESTful 部分会讲到

5、@RequestMapping注解的params属性（了解）

@RequestMapping 注解的 params 属性通过请求的请求参数匹配请求映射
@RequestMapping 注解的 params 属性是一个字符串类型的数组，可以通过四种表达式设置请求参数和请求映射的匹配关系

• “param” ：要求请求映射所匹配的请求必须携带 param 请求参数
• “!param” ：要求请求映射所匹配的请求必须不能携带 param 请求参数
• “param=value” ：要求请求映射所匹配的请求必须携带 param 请求参数且 param=value
• “param!=value” ：要求请求映射所匹配的请求必须携带 param 请求参数但是 param!=value

<a th:href="@{/test(username='admin',password=123456)">
    测试@RequestMapping的 params属性-->/test
</a>
<br>

@RequestMapping( 
    value = {"/testRequestMapping", "/test"} ,
    method = {RequestMethod.GET, RequestMethod.POST} ,
    params = {"username","password!=123456"} 
)
public String testRequestMapping(){ 
    return "success"; 
}

注：
若当前请求满足 @RequestMapping 注解的 value 和 method 属性，但是不满足 params 属性，此时页面回报错400 ： Parameter conditions “username, password!=123456” not met for actual request parameters: username={admin}, password={123456}

6、@RequestMapping注解的headers属性（了解）

@RequestMapping 注解的 headers 属性通过请求的请求头信息匹配请求映射
@RequestMapping 注解的 headers 属性是一个字符串类型的数组，可以通过四种表达式设置请求头信息和请求映射的匹配关系

• “header” ：要求请求映射所匹配的请求必须携带 header 请求头信息
• “!header” ：要求请求映射所匹配的请求必须不能携带 header 请求头信息
• “header=value” ：要求请求映射所匹配的请求必须携带 header 请求头信息且 header=value
• “header!=value” ：要求请求映射所匹配的请求必须携带 header 请求头信息且 header!=value

若当前请求满足 @RequestMapping 注解的 value 和 method 属性，但是不满足 headers 属性，此时页面显示404 错误，即资源未找到

7、SpringMVC支持ant风格的路径

• ？：表示任意的单个字符
• *：表示任意的 0 个或多个字符
• ** ：表示任意的一层或多层目录
  注意：在使用 ** 时，只能使用 /**/xxx 的方式

8、SpringMVC支持路径中的占位符（重点）

• 原始方式： /deleteUser?id=1
• rest 方式： /deleteUser/1

SpringMVC 路径中的占位符常用于 RESTful 风格中，当请求路径中将某些数据通过路径的方式传输到服务器中，就可以在相应的@RequestMapping 注解的 value 属性中通过占位符 {xxx} 表示传输的数据，在通过@PathVariable 注解，将占位符所表示的数据赋值给控制器方法的形参

<a th:href="@{/testRest/1/admin}">
    测试路径中的占位符-->/testRest
</a>
<br>

@RequestMapping("/testRest/{id}/{username}") 
public String testRest(@PathVariable("id") String id, @PathVariable("username") String username){ 
    System.out.println("id:"+id+",username:"+username); 
    return "success"; 
}
//最终输出的内容为-->id:1,username:admin

二、SpringMVC获取请求参数

1、通过ServletAPI获取

将 HttpServletRequest 作为控制器方法的形参，此时 HttpServletRequest 类型的参数表示封装了当前请求的请求报文的对象

@RequestMapping("/testParam") 
//形参表示当前请求
public String testParam(HttpServletRequest request){ 
    String username = request.getParameter("username"); 
    String password = request.getParameter("password"); 
    System.out.println("username:"+username+",password:"+password);             
    return "success"; 
}

2、通过控制器方法的形参获取请求参数

在控制器方法的形参位置，设置和请求参数同名的形参，当浏览器发送请求，匹配到请求映射时，在DispatcherServlet中就会将请求参数赋值给相应的形参

<a th:href="@{/testParam(username='admin',password=123456)}">
    测试获取请求参数-- >/testParam
</a>
<br>

@RequestMapping("/testParam") 
public String testParam(String username, String password){
    System.out.println("username:"+username+",password:"+password);          
    return "success"; 
}

注：

• 若请求所传输的请求参数中有多个同名的请求参数，此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
  • 若使用字符串数组类型的形参，此参数的数组中包含了每一个数据
  • 若使用字符串类型的形参，此参数的值为每个数据中间使用逗号拼接的结果

3、@RequestParam

@RequestParam 是将请求参数和控制器方法的形参创建映射关系
@RequestParam 注解一共有三个属性：

• value ：指定为形参赋值的请求参数的参数名
• required ：设置是否必须传输此请求参数，默认值为 true
  • 若设置为 true 时，则当前请求必须传输 value 所指定的请求参数，若没有传输该请求参数，且没有设置defaultValue属性，则页面报错 400 ： Required String parameter ‘xxx’ is not present ；
  • 若设置为false ，则当前请求不是必须传输 value 所指定的请求参数，若没有传输，则注解所标识的形参的值为null
• defaultValue ：不管 required 属性值为 true 或 false ，当 value 所指定的请求参数没有传输或传输的值为 “” 时，则使用默认值为形参赋值’

4、@RequestHeader

@RequestHeader 是将请求头信息和控制器方法的形参创建映射关系
@RequestHeader 注解一共有三个属性： value 、 required 、 defaultValue ，用法同 @RequestParam

5、@CookieValue

@CookieValue 是将 cookie 数据和控制器方法的形参创建映射关系
@CookieValue 注解一共有三个属性： value 、 required 、 defaultValue ，用法同 @RequestParam

6、通过POJO获取请求参数

可以在控制器方法的形参位置设置一个实体类类型的形参，此时若浏览器传输的请求参数的参数名和实体类中的属性名一致，那么请求参数就会为此属性赋值

<form th:action="@{/testpojo}" method="post"> 
    用户名：<input type="text" name="username"><br> 
    密码：<input type="password" name="password"><br> 
    性别：<input type="radio" name="sex" value="男">男
        <input type="radio" name="sex" value="女">女<br> 
    年龄：<input type="text" name="age"><br> 
    邮箱：<input type="text" name="email"><br> 
    <input type="submit"> 
</form>

@RequestMapping("/testpojo") 
public String testPOJO(User user){ 
    System.out.println(user); 
    return "success"; 
}
//最终结果-->User{id=null, username='张三', password='123', age=23, sex='男', email='123@qq.com'}

7、解决获取请求参数的乱码问题

解决获取请求参数的乱码问题，可以使用 SpringMVC 提供的编码过滤器 CharacterEncodingFilter ，但是必须在web.xml 中进行注册

<!--配置编码过滤器-->
<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <init-param>
        <param-name>forceResponseEncoding</param-name>
        <param-value>true</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

注：
SpringMVC 中处理编码的过滤器一定要配置到其他过滤器之前，否则无效

三、域对象共享数据

1、使用ServletAPI向request域对象共享数据

@RequestMapping("/testServletAPI") 
public String testServletAPI(HttpServletRequest request){ 
    request.setAttribute("testScope", "hello,servletAPI"); 
    return "success"; 
}

2、使用ModelAndView向request域对象共享数据

@RequestMapping("/testModelAndView") 
public ModelAndView testModelAndView(){ 
    /**
      * ModelAndView有Model和View的功能 
      * Model主要用于向请求域共享数据 
      * View主要用于设置视图，实现页面跳转 
     */ 
    ModelAndView mav = new ModelAndView(); 
    //向请求域共享数据 
    mav.addObject("testScope", "hello,ModelAndView"); 
    //设置视图，实现页面跳转 
    mav.setViewName("success"); 
    return mav; 
}

3、使用Model向request域对象共享数据

@RequestMapping("/testModel") 
public String testModel(Model model){ 
    model.addAttribute("testScope", "hello,Model");
    return "success"; 
}

4、使用map向request域对象共享数据

@RequestMapping("/testMap") 
public String testMap(Map<String, Object> map){ 
    map.put("testScope", "hello,Map"); 
    return "success"; 
}

5、使用ModelMap向request域对象共享数据

@RequestMapping("/testModelMap") 
public String testModelMap(ModelMap modelMap){ 
    modelMap.addAttribute("testScope", "hello,ModelMap"); 
    return "success"; 
}

6、Model、ModelMap、Map的关系

Model、ModelMap、Map类型的参数其实本质上都是 BindingAwareModelMap 类型的

public interface Model{}
public class ModelMap extends LinkedHashMap<String, Object> {}
public class ExtendedModelMap extends ModelMap implements Model {}
public class BindingAwareModelMap extends ExtendedModelMap {}

7、向session域共享数据

@RequestMapping("/testSession") 
public String testSession(HttpSession session){ 
    session.setAttribute("testSessionScope", "hello,session"); 
    return "success"; 
}

8、向application域共享数据

@RequestMapping("/testApplication") 
public String testApplication(HttpSession session){ 
    ServletContext application = session.getServletContext();
    application.setAttribute("testApplicationScope", "hello,application");          
    return "success"; 

四、SpringMVC的视图

SpringMVC 中的视图是 View 接口，视图的作用渲染数据，将模型 Model 中的数据展示给用户
SpringMVC 视图的种类很多，默认有转发视图和重定向视图
当工程引入 jstl 的依赖，转发视图会自动转换为 JstlView
若使用的视图技术为 Thymeleaf ，在 SpringMVC 的配置文件中配置了 Thymeleaf 的视图解析器，由此视图解析器解析之后所得到的是ThymeleafView

1、ThymeleafView

当控制器方法中所设置的视图名称没有任何前缀时，此时的视图名称会被 SpringMVC 配置文件中所配置的视图解析器解析，视图名称拼接视图前缀和视图后缀所得到的最终路径，会通过转发的方式实现跳转

@RequestMapping("/testHello") 
public String testHello(){ 
    return "hello"; 
}

2、转发视图

SpringMVC 中默认的转发视图是 InternalResourceView
SpringMVC 中创建转发视图的情况：

• 当控制器方法中所设置的视图名称以 “forward:” 为前缀时，创建 InternalResourceView 视图，此时的视图名称不会被SpringMVC 配置文件中所配置的视图解析器解析，而是会将前缀 “forward:” 去掉，剩余部分作为最终路径通过转发的方式实现跳转
• 例如 “forward:/” ， “forward:/employee”

@RequestMapping("/testForward") 
public String testForward(){ 
    return "forward:/testHello"; 
}

注：在SpringMVC中，如果你用的是jsp的话，因为我们不设置任何的前缀，它也是一个转发的效果。所以SpringMVC中有一个默认的转发视图InternalResourceView

在SpringMVC.xml中的配置：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/templates/"></property>
    <property name="suffix" value=".jsp"></property>
</bean>

3、重定向视图

SpringMVC 中默认的重定向视图是 RedirectView

• 当控制器方法中所设置的视图名称以==“redirect:” 为前缀时，创建 RedirectView 视图，此时的视图名称不会被SpringMVC 配置文件中所配置的视图解析器解析，而是会将前缀 “redirect:” 去掉，剩余部分作为最终路径通过重定向的方式实现跳转==
• 例如 “redirect:/” ， “redirect:/employee”

@RequestMapping("/testRedirect") 
public String testRedirect(){ 
    return "redirect:/testHello"; 
}

注：
重定向视图在解析时，会先将 redirect: 前缀去掉，然后会判断剩余部分是否以 / 开头，若是则会自动拼接上下文路径

4、视图控制器view-controller

当控制器方法中，仅仅用来实现页面跳转，即只需要设置视图名称时，可以将处理器方法使用 view-controller标签进行表示（在springmvc.xml中）

<!--
    path：设置处理的请求地址 
    view-name：设置请求地址所对应的视图名称 
--> 
<mvc:view-controller path="/testView" view-name="success"></mvc:view-controller>
<mvc:annotation-driven />

注：
当 SpringMVC 中设置任何一个 view-controller 时，其他控制器中的请求映射将全部失效，此时需要在SpringMVC 的核心配置文件中设置开启 mvc 注解驱动的标签：<mvc:annotation-driven />

七、RESTful

1、RESTful简介

REST：Representational State Transfer，表现层资源状态转移

• 资源
  资源是一种看待服务器的方式，即，将服务器看作是由很多离散的资源组成。每个资源是服务器上一个可命名的抽象概念。因为资源是一个抽象的概念，所以它不仅仅能代表服务器文件系统中的一个文件、数据库中的一张表等等具体的东西，可以将资源设计的要多抽象有多抽象，只要想象力允许而且客户端应用开发者能够理解。与面向对象设计类似，资源是以名词为核心来组织的，首先关注的是名词。一个资源可以由一个或多个URI 来标识。 URI 既是资源的名称，也是资源在 Web 上的地址。对某个资源感兴趣的客户端应用，可以通过资源的URI 与其进行交互
• 资源的表述
  资源的表述是一段对于资源在某个特定时刻的状态的描述。可以在客户端 服务器端之间转移（交换）。资源的表述可以有多种格式，例如 HTML/XML/JSON/ 纯文本 / 图片 / 视频 / 音频等等。资源的表述格式可以通过协商机制来确定。请求- 响应方向的表述通常使用不同的格式
• 状态转移
  状态转移说的是：在客户端和服务器端之间转移（ transfer ）代表资源状态的表述。通过转移和操作资源的表述，来间接实现操作资源的目的

2、RESTful的实现

具体说，就是 HTTP 协议里面，四个表示操作方式的动词： GET 、 POST 、 PUT 、 DELETE 。
它们分别对应四种基本操作： GET 用来获取资源， POST 用来新建资源， PUT 用来更新资源， DELETE用来删除资源。
REST 风格提倡 URL 地址使用统一的风格设计，从前到后各个单词使用斜杠分开，不使用问号键值对方式携带请求参数，而是将要发送给服务器的数据作为 URL 地址的一部分，以保证整体风格的一致性

3、HiddenHttpMethodFilter

由于浏览器只支持发送 get 和 post 方式的请求，那么该如何发送 put 和 delete 请求呢？
SpringMVC 提供了HiddenHttpMethodFilter 帮助我们将 POST 请求转换为 DELETE 或 PUT 请求
HiddenHttpMethodFilter 处理 put 和 delete 请求的条件：

• 当前请求的请求方式必须为 post
• 当前请求必须传输请求参数 _method

满足以上条件， HiddenHttpMethodFilter 过滤器就会将当前请求的请求方式转换为请求参数_method 的值，因此请求参数 _method 的值才是最终的请求方式
在 web.xml 中注册 HiddenHttpMethodFilter：

<!--配置处理请求方式put和delet1e的HiddenHttpMethodFilter-->
<filter>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>HiddenHttpMethodFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

注：

• 目前为止， SpringMVC 中提供了两个过滤器： CharacterEncodingFilter 和HiddenHttpMethodFilter
• 在 web.xml 中注册时，必须先注册 CharacterEncodingFilter ，再注册 HiddenHttpMethodFilter
  原因：
  • 在 CharacterEncodingFilter 中通过request.setCharacterEncoding(encoding) 方法设置字符集的
  • request.setCharacterEncoding(encoding)方法要求前面不能有任何获取请求参数的操作
  • 而HiddenHttpMethodFilter恰恰有一个获取请求方式的操作：String paramValue = request.getParameter(this.methodParam);