SpringMVC入门及系列教程（三）-请求的映射（详细）

灰太狼 2022-06-07 10:25 219阅读 0赞

一、前两篇博文介绍了SpringMVC的环境搭建、一个基本B/S请求处理过程及响应过程的处理、也介绍了在B/S结果中一个请求周期概念，也强调了请求周期的重要性，下面我们利用如下图片再次回顾一下请求周期  
![这里写图片描述][SouthEast]  
所以一个请求周期中，首先需要客户端浏览器单击连接发送一个请求，然后在服务器端接收当前请求以及处理当前请求，然后响应给客户端一个结果的过程。

二、本片博文将详细介绍在SpringMVC中怎样接收请求以及接收请求中的参数  
1、关于请求的映射，请求的映射是一个请求周期中最为重要的一个步骤，我们可以思考下如下场景，在客户端浏览器中有很多个连接请求，当请求者点击不同请求时，服务器端应该提供对应的控制器（JavaEE中的Servlet的功能），我们可以狭义的理解为一个请求对应一个控制器，比如我们平常上网时浏览新闻时，页面上会有体育新闻、娱乐新闻、军事新闻等连接

当单击体育新闻（a连接 <a href="?">体育新闻</a> ）时将请求提交给A控制器；  
当单击娱乐新闻（b连接 <a href="?">娱乐新闻</a> ）时将请求提交给B控制器；  
当单击军事新闻（c连接 <a href="?">军事新闻</a> ）时将请求提交给C控制器。

那么请求的映射即为在当单击体育新闻时怎样将请求提交给A控制而不是提交给B控制器呢？这个控制过程既需要使用请求映射的知识。在JavaEE中的源码案例

页面链接代码：
    <a href="newsSports">体育新闻</a>
    
    Servlet代码：
    @WebServlet("/newsSports")
    public class NewsSports extends HttpServlet {
    	private static final long serialVersionUID = 1L;
    	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    	}
    	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    	}
    
    }

2、SpringMVC中的请求映射也通过相关注解（Annotation）完成：  
2.1、首先看下控制器注解，在SpringMVC中所有的控制器都必须使用@Controller注解，即在控制器类的上面添加这个注解即可标准本类是控制器组件，在SpringMVC语法中要求可以接收客户端请求的类必须是控制器类才有这样的功能，所以我们需要先了解控制器注解

比如，如下UserAction的类即为一个控制器组件，因为其上有@Controller注解

@Controller
    public class UserAction {}

2.2、SpringMVC中最关键一个注解@RequestMapping ，用于注解映射请求的URL。@RequestMapping可以写在  
方法前也可以写在类前，我们先来理解写在方法上，这个方法的功能有点类似javaEE中的doGet方法或者doPost方法，只不过在SpringMVC中这个方法的定义更为灵活，现阶段对只要这个方法的返回值是一个String类型即可，方面名称不限，至于String类型的返回值的意义，和请求的映射没有关系，所以在后续博文中详细介绍。比如当单击体育新闻链接时期望将请求提交给如下处理方法接收

public String showNews(){
    		return "success";
    	}

好的，下面我们来编写映射的URL，比较简单只需要在本方法上面加上@RequestMapping注解即可

@RequestMapping("/newsSports")
    	public String showNews(){
    		System.out.println("UserAction.showNews() is running......");
    		return "success";
    	}

这样一来，当单击<a href=“showSports”>体育新闻</a> 连接时，showNews方法就开始运行了。请自己在页面上加入连接代码测试

客户端页面的运行效果  
![这里写图片描述][SouthEast 1]

单击体育新闻后的页面效果  
![这里写图片描述][SouthEast 2]

以及控制器源码  
![这里写图片描述][SouthEast 3]

3、通过以上案例大家对注解@RequestMapping有了初步理解，下面将详细接收注解的使用，@RequestMapping注解中有多个属性：value、method、params、headers等属性  
如图：  
![这里写图片描述][SouthEast 4]

--------------------

①、value属性：在@RequestMapping没有定义任何属性名时，例如上面案例中的@RequestMapping("/newsSports")，默认即为value属性的值，即@RequestMapping("/newsSports")和@RequestMapping(value="/newsSports")的写法相同功能的。同时我们可以看到value属性的是String类型的一维数组，也就是value属性的值可以有多个。线面看案例：

页面效果  
![这里写图片描述][SouthEast 5]

根页面请求对应的控制器代码  
![这里写图片描述][SouthEast 6]

value属性总结：  
1）、@RequestMapping只有一个value属性，并且value属性值只有一个的话，可以省略value属性名，直接写value属性值即可。  
2）、如果value属性值有多个的话，需要使用\{\}扩起来，这里大家要注意，注解中的数组不能想CoreJava中的使用方式使用\[\]阔值，而是通过\{\}扩起来的，刚刚接触的话可能会有点陌生，写的代码多了就会熟悉了的

--------------------

②、method属性：method属性可以可以指定请求的方法，比如可以在method属性中约定请求类型是get请求|post请求。  
页面效果：  
![method属性介绍][method]

服务器端控制器代码如下：  
![这里写图片描述][SouthEast 7]

③、params属性：params属性可以更加精准映射当前请求，因为params属性可以约定请求的URL中的参数都可以包括哪些，甚至可以约定参数的值，注意params属性的值也是String类型的一维数组  
页面运行效果：  
![这里写图片描述][SouthEast 8]

单击没有参数的请求出现404错误  
![这里写图片描述][SouthEast 9]

单击其他两个连接，请求正常运行  
![这里写图片描述][SouthEast 10]

下面看控制器源代码：  
![这里写图片描述][SouthEast 11]

④、headers属性：在SpringMVC的@RequestMapping注解中还可以通过headers属性限定当前请求的请求头中包含有哪些属性和值

页面效果图，在Chrome浏览器中查看请求头部分Accept-Language:zh-CN,zh;q=0.8属性  
![这里写图片描述][SouthEast 12]

当单击连接请求时，页面可以正常运行  
![这里写图片描述][SouthEast 13]

下面看控制器源代码  
![这里写图片描述][SouthEast 14]

至此，在SpringMVC中关于请求URL的映射部分说完毕了，如下代码是整体代码请参阅。

客户端源码：  
![这里写图片描述][SouthEast 15]

控制器源码：  
![这里写图片描述][SouthEast 16]

SpringMVC对Ant以及Restfull的支持：  
1、ant风格ＵＲＩ的映射过程

1.  ?：统配了任意一个字符
2.  \*：通过多个任意字符
3.  \*\*：统配了多层目录

URI:  
? user/?/userDelete  
user/a/UserDelete  
user/b/UserDelete  
\*  
user/user\*  
user/userAdd  
user/userDelete  
\*\*  
user/\*\*/add  
user/a/b/add  
user/sdfasf/adsfasdf/add  
user/a/b/c/d/…/add  
案例  
前端代码：

<fieldset>
    		<legend>SpringMVC  对 Ant风格的RUI的处理</legend>
    		<a href="ant/a/ant1">ant/a/ant1</a><br/>
    		<a href="ant/b/ant1">ant/b/ant1</a><br/>
    		
    		<hr/>
    		<a href="ant/userAdd">ant/userAdd</a><br/>
    		<a href="ant/userDelete">ant/userDelete</a><br/>
    		<a href="ant/userUpdate">ant/userUpdate</a><br/>
    		<hr/>
    		
    		<a href="ant/a/b/abc">ant/a/b/abc</a><br/>
    		<a href="ant/a/b/c/d/abc">ant/a/b/c/d/abc</a><br/>
    		<a href="ant/abcdefg/abc">ant/abcdefg/abc</a><br/>
    	</fieldset>

后端代码

package com.rock.springmvc.action;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.RequestMapping;
    
    import com.sun.net.httpserver.Authenticator.Success;
    
    /**
     * FileName		:com.rock.springmvc.action 	AntAction.java
     * TODO			:
     * Copyright	:Copyright (c) 2015-2016 All Rights Reserved. Company: 01skill-soft.com Inc.
     * @author: 	:老张
     * @Date		:2019年4月23日:下午3:51:38
     * @version 	:1.0
     * 
     *           Modification History: Date			Author 		Version 	Description
     *           ----------------------------------------------------------------------
     *           					   2019年4月23日 	老张 			1.0 		1.0 Version
     * 
     */
    @Controller
    @RequestMapping("/ant")
    public class AntAction {
    	private static final String SUCCESS="success";
    	
    //	?统配了任意一个字符
    //	<a href="ant/a/ant1">ant/a/ant1</a><br/>
    //	<a href="ant/b/ant1">ant/b/ant1</a><br/>
    	@RequestMapping(value="/?/ant1")
    	public String testAnt1(){
    		System.out.println("AntAction.testAnt1() is running..........");
    		return SUCCESS;
    	}
    	
    //	*统配了任意多个字符
    //	<a href="ant/userAdd">ant/userAdd</a><br/>
    //	<a href="ant/userDelete">ant/userDelete</a><br/>
    //	<a href="ant/userUpdate">ant/userUpdate</a><br/>
    	@RequestMapping(value="/user*")
    	public String testUserMulti(){
    		System.out.println("AntAction.testUserMulti() is running..........");
    		return SUCCESS;
    	}
    //	**统配了任意层目录
    //	<a href="ant/a/b/abc">ant/a/b/abc</a><br/>
    //	<a href="ant/a/b/c/d/abc">ant/a/b/c/d/abc</a><br/>
    //	<a href="ant/abcdefg/abc">ant/abcdefg/abc</a><br/>
    	@RequestMapping(value="/**/abc")
    	public String testMultiPath(){
    		System.out.println("AntAction.testMultiPath() is running..........");
    		return SUCCESS;
    	}
    }

２、SpringMVC对RestFull风格URL的支持  
Http协议本身可以约定前端请求的方式有GET、POST、PUT、DELETE，但是html中的form表单仅仅能发起get或者post请求。

POST:新增（保存、注册）：一般在向服务器端发送一个资源（数据），新书入库，新闻发布，新品上架、用户注册  
DELETE：删除，一般要删除服务器端一个资源时（删除表中一条数据），需要送DELETE  
PUT：更新：跟新服务器端一个资源（跟新表中的一个数据），需要发起PUT请求  
GET：检索（获取、查询）；一般需要从服务器端获取一个资源

常规请求：删除  
RestFull：  
 删除 DELTET  
 新增 POST  
 检索 GET  
 跟新 PUT

@RequestMapping(“userAction/user/rock”)  
public String doSomeThing()\{\}

RestFull风格的URL的优势：  
Rest不是一个新的技术新的规范，而是对http协议的充分利用后到的的一个URL的风格  
①、让这个url具备很强的可读型  
②、这个url具有自我描述性  
③、很好的资源描述和视图

SpringMVC提供了一个叫做org.springframework.web.filter.HiddenHttpMethodFilter这个拦截器，用于拦截web前端发送过来的请求，拦截后会去识别当前请求的方式是POST|DELETE|PUT|GET。

在web.xml配置HiddenHttpMethodFilter拦截所有请求，然后判断请求中的\_method的值，然后基于这个值将请求转化不同类型的请求方式

<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>

web前端代码

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
    <!DOCTYPE html>
    <html lang="en">
    <head>
        <meta charset="UTF-8">
        <title>Title</title>
        <%
        	String path=this.getServletContext().getContextPath();
        	pageContext.setAttribute("APP_PATH",path);
        %>
    </head>
    <body>
    	<fieldset>
    		<legend>RestFull风格URL</legend>
    		<fieldset>
    			<legend>RestFul风格请求之---GET请求</legend>
    			
    			<form action="rest/user/rock" method="get">
    				<input type="hidden" value="GET" name="_method">
    				<input type="submit" value="【RestFull-get请求】">		
    			</form>
    		</fieldset>
    		<fieldset>
    			<legend>RestFul风格请求之---DELETE请求</legend>
    			
    			<form action="rest/user/rock" method="post">
    				<input type="hidden" value="DELETE" name="_method">
    				<input type="submit" value="【RestFull-delete请求】">		
    			</form>
    		</fieldset>
    		<fieldset>
    			<legend>RestFul风格请求之---PUT请求</legend>
    			<form action="rest/user/rock" method="post">
    				<input type="hidden" value="PUT" name="_method">
    				<input type="submit" value="【RestFull-put请求】">		
    			</form>
    		</fieldset>
    		<fieldset>
    			<legend>RestFul风格请求之---POST请求</legend>
    			<form action="rest/user/rock" method="post">
    				<input type="hidden" value="POST" name="_method">
    				<input type="submit" value="【RestFull-post请求】">		
    			</form>
    		</fieldset>
    	</fieldset>
    </body>
    </html>

后端代码

package com.rock.springmvc.action;
    
    import org.springframework.stereotype.Controller;
    import org.springframework.web.bind.annotation.PathVariable;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestMethod;
    import org.springframework.web.bind.annotation.ResponseBody;
    
    /**
     * FileName		:com.rock.springmvc.action 	RestAction.java
     * TODO			:
     * Copyright	:Copyright (c) 2015-2016 All Rights Reserved. Company: 01skill-soft.com Inc.
     * @author: 	:老张
     * @Date		:2019年4月24日:上午10:22:21
     * @version 	:1.0
     * 
     *           Modification History: Date			Author 		Version 	Description
     *           ----------------------------------------------------------------------
     *           					   2019年4月24日 	老张 			1.0 		1.0 Version
     * 
     */
    @Controller
    @RequestMapping(value="/rest")
    public class RestAction {
    	private static final String SUCCESS="success";
    	
    	
    	@RequestMapping(value="/user/{userid}",method=RequestMethod.GET)
    	public String testGet(@PathVariable("userid") String id){
    		System.out.println("RestAction.testGet()  RestFul-------->get--------id:"+id);
    		return SUCCESS;
    	}
    	
    	
    	@ResponseBody
    	@RequestMapping(value="/user/{id}",method=RequestMethod.DELETE)
    	public String testDelete(@PathVariable("id") String userid){
    		System.out.println("RestAction.testDelete()RestFul------->delete-----id:"+userid);
    		return SUCCESS;
    	}
    	
    	@ResponseBody
    	@RequestMapping(value="/user/{id}",method=RequestMethod.PUT)
    	public String testPut(@PathVariable("id") String userid){
    		System.out.println("RestAction.testPut()  RestFul-------->put--------id:"+userid);
    		return SUCCESS;
    	}
    	
    	@ResponseBody
    	@RequestMapping(value="/user/{id}",method=RequestMethod.POST)
    	public String testPost(@PathVariable("id") String userid){
    		System.out.println("RestAction.testPost()  RestFul------->post-----id:"+userid);
    		return SUCCESS;
    	}
    }

备注：  
1、各位朋友如果你觉得本篇博文对你有帮助，请您转发或者关注或者请给出您中肯的评论，如果有问题请及时与我联系！欢迎大家一起讨论一起成长！  
2、其他几篇关于SpringMVC详细博文如下  
[http://blog.csdn.net/dl0246/article/details/77996811][http_blog.csdn.net_dl0246_article_details_77996811] SSM框架CRUD操作&批量删除&批量追加数据（Oracle&MySQL数据库）  
[http://blog.csdn.net/dl0246/article/details/77966611][http_blog.csdn.net_dl0246_article_details_77966611] 诸多设计模式中，最为常见的三种设计模式-单例模式，代理模式，工厂模式  
[http://blog.csdn.net/dl0246/article/details/78251319][http_blog.csdn.net_dl0246_article_details_78251319] SpringMVC入门及系列教程（一）-SpringMVC环境搭建及入门案例（详细）  
[http://blog.csdn.net/dl0246/article/details/78259612][http_blog.csdn.net_dl0246_article_details_78259612] SpringMVC入门及系列教程（二）-SpringMVC请求周期及响应处理（初级）（详细）  
[http://blog.csdn.net/dl0246/article/details/78274343][http_blog.csdn.net_dl0246_article_details_78274343] SpringMVC入门及系列教程（三）-请求的映射（详细）  
[http://blog.csdn.net/dl0246/article/details/78286685][http_blog.csdn.net_dl0246_article_details_78286685] SpringMVC入门及系列教程（四）-SpringMVC在控制器中获取请求中的参数值(详细)  
[http://blog.csdn.net/dl0246/article/details/78390587][http_blog.csdn.net_dl0246_article_details_78390587] SpringMVC入门及系列教程（五）-响应处理&响应参数处理&SpringMVC作用域对象&SpringMVC原生Servlet对

[SouthEast]: /images/20220607/cb29925266824220b8097d048c52d03c.png
[SouthEast 1]: /images/20220607/737624fad38e45588d02c120b5a01b92.png
[SouthEast 2]: /images/20220607/fb2e565684744d8f84e05c2ab85330b8.png
[SouthEast 3]: /images/20220607/cd447d27617044669062705fb065e5b0.png
[SouthEast 4]: /images/20220607/1c8f5e183c904678a030c696051afff8.png
[SouthEast 5]: /images/20220607/541560b6aea341189a3a25ab8cd85650.png
[SouthEast 6]: /images/20220607/0df3ba1fb71445548c4c4a08ca97b1e8.png
[method]: /images/20220607/0eb35cd5a61646d590de1c3dddb3f698.png
[SouthEast 7]: /images/20220607/43a16016121c4045ac7d059112828841.png
[SouthEast 8]: /images/20220607/9d6e665ec7e743b5b42e253da849cc51.png
[SouthEast 9]: /images/20220607/331f4d81ac4e4e77b312dd363a9d6b2b.png
[SouthEast 10]: /images/20220607/ed7f27902d9c48e99b4787455798a9ff.png
[SouthEast 11]: /images/20220607/b21e80034475497aa30173b9d5b3eb9a.png
[SouthEast 12]: /images/20220607/85e4319a0be94a0bab74a4927047f1f1.png
[SouthEast 13]: /images/20220607/84b2223037aa400ea7f118166e4a93a8.png
[SouthEast 14]: /images/20220607/a516d7e2261547978617227c8b206fb4.png
[SouthEast 15]: /images/20220607/9a7d6ce2ec654382bf4feda0f8ad1002.png
[SouthEast 16]: /images/20220607/fc5131e0b7e54db4b54a6f406bc19c2a.png
[http_blog.csdn.net_dl0246_article_details_77996811]: http://blog.csdn.net/dl0246/article/details/77996811
[http_blog.csdn.net_dl0246_article_details_77966611]: http://blog.csdn.net/dl0246/article/details/77966611
[http_blog.csdn.net_dl0246_article_details_78251319]: http://blog.csdn.net/dl0246/article/details/78251319
[http_blog.csdn.net_dl0246_article_details_78259612]: http://blog.csdn.net/dl0246/article/details/78259612
[http_blog.csdn.net_dl0246_article_details_78274343]: http://blog.csdn.net/dl0246/article/details/78274343
[http_blog.csdn.net_dl0246_article_details_78286685]: http://blog.csdn.net/dl0246/article/details/78286685
[http_blog.csdn.net_dl0246_article_details_78390587]: http://blog.csdn.net/dl0246/article/details/78390587