SpringMVC学习 -- 使用 @RequestMapping 映射请求

在控制器的类定义及方法出定义出都可以标注 @RequestMapping：

类定义处：提供初步的请求映射信息。相对于 Web 应用的根目录。

方法定义出：提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注 @RequestMapping , 则方法定义处标记的 URL 相对于 Web 应用的根目录。

DispatcherServlet 截获请求后 , 就通过控制器上 @RequestMapping 提供的映射信息确定请求所对应的处理方法。

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd" version="3.1">

<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/applicationContext.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>

dispatcher-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!-- 扫描自定义包 -->
<context:component-scan base-package="com.itdoc.springmvc"/>

<!-- 配置试图解析器: 把 Controller 返回值解析成实际的物理视图 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
</bean>
</beans>

TestRequestMapping.java

package com.itdoc.springmvc;

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;

/**
* @BLOG http://www.cnblogs.com/goodcheap * @DESCRIBE RequestMapping 测试
* @AUTHOR WángChéngDá
* @DATE 2017-03-08 14:30
*/
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

private final static String SUCCESS = "success";

/**
* 1.@RequestMapping 除了修饰方法还可以修饰类。
* 2.修饰类和修饰方法
* 1) 修饰类: 提供初步的请求映射信息, 相对于 WEB 应用的根目录。
* 2) 修饰方法: 提供进一步细化的请求映射信息, 相对于修饰类处的 URL。
* 若修饰类处未标注 @RequestMapping, 则修饰方法处的 URL 相对于 WEB 应用的根目录。
*/
@RequestMapping("/testreqmap")
public String testReqMap() {
System.out.println("I am TestRequestMapping's testReqMap method...");
return SUCCESS;
}
}

映射请求参数、请求方式或请求头





@RequestMapping 的 value , method , params 及 headers 分别表示请求 URL , 请求方式 , 请求参数及请求头的映射条件 , 联合使用多个条件可让请求映射更加精确化。

method 请求方式常用有四种：

method = RequestMethod.POST

method = RequestMethod.GET

method = RequestMethod.PUT

method = RequestMethod.DELETE

package com.itdoc.springmvc;

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;

/**
* @BLOG http://www.cnblogs.com/goodcheap * @DESCRIBE RequestMapping 测试
* @AUTHOR WángChéngDá
* @DATE 2017-03-08 14:30
*/
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

private final static String SUCCESS = "success";

/**
* 使用 method 属性来制定请求方式。
*
* @return
*/
@RequestMapping(value = "/testMethod", method = RequestMethod.POST)
public String testMethod() {
System.out.println("I am TestRequestMapping's testMethod method...");
return SUCCESS;
}
}

params 和 headers 支持简单的表达式：

param：表示请求必须包含名为 param 的请求参数。

!param：表示请求不能包含名为 param 的请求参数。

param != value: 表示请求包含名为 param 的请求参数 , 但其值不能为 value。

params 可以有多个参数 , 用逗号隔开。示例：params = {"username", "age!=20"}

package com.itdoc.springmvc;

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;

/**
* @BLOG http://www.cnblogs.com/goodcheap * @DESCRIBE RequestMapping 测试
* @AUTHOR WángChéngDá
* @DATE 2017-03-08 14:30
*/
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

private final static String SUCCESS = "success";

/**
* 可以使用 params 和 headers 来更加精确的映射请求, params 和 headers 支持简单的表达式。
* @return
*/
@RequestMapping(value = "testParamsAndHeaders", params = {"username", "age!=20"},
headers = {"Accept-Language=zh-CN,zh;q=0.8"})
public String testParamsAndHeaders() {
System.out.println("I am TestRequestMapping's testParamsAndHeaders method...");
return SUCCESS;
}
}

Ant 风格资源地址支持3种匹配符：

?：匹配文件名中的一个字符。

*：匹配文件名中的任意字符。

**：匹配多层路径。

package com.itdoc.springmvc;

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;

/**
* @BLOG http://www.cnblogs.com/goodcheap * @DESCRIBE RequestMapping 测试
* @AUTHOR WángChéngDá
* @DATE 2017-03-08 14:30
*/
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

private final static String SUCCESS = "success";

@RequestMapping("/testAndPath/*/abc")
public String testAndPath() {
System.out.println("I am TestRequestMapping's testAntPath method...");
return SUCCESS;
}
}

@PathVariable 映射 URL 绑定占位符：

带占位符的 URL 是 Spring3.0 新增的功能 , 该功能在 SpringMVC 的 REST 目标挺进发展过程中具有里程碑的意义。

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的{xxx} 占位符可以通过 @PathVariable("xxx") 绑定到操作方法的入参中。

注意：@PathVariable("xxx") 中的 xxx 必须与占位符 {xxx} 中的 xxx 相同。

package com.itdoc.springmvc;

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;

/**
* @BLOG http://www.cnblogs.com/goodcheap * @DESCRIBE RequestMapping 测试
* @AUTHOR WángChéngDá
* @DATE 2017-03-08 14:30
*/
@Controller
@RequestMapping("/springmvc")
public class TestRequestMapping {

private final static String SUCCESS = "success";

/**
* @PathVariable 可以来映射 URL 中的占位符到目标方法的参数中。
* @param id
* @return
*/
@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id) {
System.out.println("I am TestRequestMapping's testPathVariable method...\t id=" + id);
return SUCCESS;
}
}