SpringMVC 学习笔记(二) @RequestMapping、@PathVariable等注解

1.1. @RequestMapping映射请求

SpringMVC 使用 @RequestMapping 注解为控制器指定可以处理那些URL 请求

@requestMapping  可以定义在 类 和 方法 上 

package com.ibigsea.springmvc.helloworld;

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

@Controller
public class HelloWorld {
	
	/**
	 * 配置@RequestMapping 拦截 localhost:8080/springmvc/hello 请求 
	 * @return
	 */
	@RequestMapping("/hello")
	public String helloWorld() {
		System.out.println("hello world");
		return "helloworld";
	}
}

package com.ibigsea.springmvc.helloworld;

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

@Controller
@RequestMapping("/hello")
public class HelloWorld {
	
	/**
	 * 配置@RequestMapping 拦截 localhost:8080/springmvc/hello/world 请求 
	 * @return
	 */
	@RequestMapping("/world")
	public String helloWorld(){
		System.out.println("hello world");
		return "helloworld";
	}
}

@RequestMapping

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

– 方法处：提供进一步的细分映射信息。相对于类定义处的 URL。若

类定义处未标注 @RequestMapping，则方法处标记的 URL 相对于

WEB 应用的根目录

DispatcherServlet 截获请求后，就通过控制器上

@RequestMapping 提供的映射信息确定请求所对应的处理方法。

@RequestMapping 除了可以使用请求 URL 映射请求外，

还可以使用请求方法、请求参数及请求头映射请求

1.2. @RequestMapping限定请求方法、请求参数、请求头

/**
	 * 接收GET请求
	 * @return
	 */
	@RequestMapping(value="/get",method = RequestMethod.GET)
	public String get(){
		System.out.println("get");
		return "get";
	}

	/**
	 * 接收POST请求
	 * @return
	 */
	@RequestMapping(value="/post",method = RequestMethod.POST)
	public String post(){
		System.out.println("post");
		return "post";
	}
	
	/**
	 * 只接收 name 参数
	 * @return
	 */
	@RequestMapping(value="/params",params="name")
	public String params(String name){
		System.out.println("hello "+name);
		return "helloworld";
	}
	
	/**
	 * 只接收请求头中 Content-Type 为 text/html;charset=UTF-8的请求
	 * @return
	 */
	@RequestMapping(value="/headers",headers="Content-Type:text/html;charset=UTF-8")
	public String headers(){
		System.out.println("headers");
		return "helloworld";
	}

1.3. @RequestMapping匹配符

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

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

– **：** 匹配多层路径

实例:

URL : /user/*/create

-- /user/bigsea/create 、 /user/sea/create 等URL

URL : /user/**/create

-- /user/big/sea/create 、 /user/sea/big/create 等URL

URL : /user/create??

-- /user/createaa 、/user/createbb

1.4. @PathVariable 注解

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

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

/**
	 * localhost:8080/springmvc/hello/pathVariable/bigsea
	 * localhost:8080/springmvc/hello/pathVariable/sea
	 * 这些URL 都会 执行此方法 并且将  <b>bigsea</b>、<b>sea</b> 作为参数 传递到name字段
	 * @param name
	 * @return
	 */
	@RequestMapping("/pathVariable/{name}")
	public String pathVariable(@PathVariable("name")String name){
		System.out.println("hello "+name);
		return "helloworld";
	}

JSP(这里指定全路径):

<h1>pathVariable</h1>
<a href="${pageContext.request.contextPath}/hello/pathVariable/bigsea" > name is bigsea </a>
<br/>
<a href="${pageContext.request.contextPath}/hello/pathVariable/sea" > name is sea</a>
<br/>

运行结果:

hello bigsea
hello sea

1.5. @RequestParam 绑定请求参数

在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法

– value：参数名

– required：是否必须。默认为 true, 表示请求参数中必须包含对应的参数，若不存在，将抛出异常

/**
	 * 如果 required = true 则表示请求参数对应的 字段 必须存在.如果不存在则会抛出异常<br/>
	 * @param firstName 可以为null
	 * @param lastName 不能为null .为null报异常
	 * @param age age字段表示如果没有 age 参数 则默认值为 0 
	 * @return
	 */
	@RequestMapping("/requestParam")
	public String requestParam(@RequestParam(value="firstName",required=false)String firstName,
			@RequestParam( value="lastName" ,required = true) String lastName,
			@RequestParam(value="age",required = false ,defaultValue="0")int age) {
		System.out.println("hello my name is " + (firstName == null ? "" : firstName)
										+ lastName + "," + age +" years old this year");
		return "helloworld";
	}

Jsp:

<a href="requestParam?firstName=big&lastName=sea" > name is bigsea , age is 0 </a>
<br/>
<a href="requestParam?lastName=sea&age=23" > name is sea , age is 23 </a>
<br/>
<a href="requestParam" > throws exception </a>

运行结果:

hello my name is bigsea,0 years old this year
hello my name is sea,23 years old this year

1.6. @RequestHeader 获取请求头

请求头包含了若干个属性，服务器可据此获知客户端的信息，通过 @RequestHeader 即可将求头中的属性值绑定到处理方法的入参中

	/**
	 * 获取请求头中的信息
	 * @RequestHeader 也有 value ,required ,defaultValue 三个参数
	 * @param userAgent
	 * @param cookie
	 * @return
	 */
	@RequestMapping("/requestHeader")
	public String requestHeader(@RequestHeader("User-Agent")String userAgent,@RequestHeader("Cookie")String cookie){
		System.out.println("userAgent:["+userAgent+"]");
		System.out.println("cookie:["+cookie+"]");
		return "helloworld";
	}

<a href="requestHeader" > requestHeader </a>

userAgent:[Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/44.0.2383.0 Safari/537.36]
cookie:[JSESSIONID=DA3B15F559349EA2C3F08BE772FCAFD8]

1.7. @CookieValue 获取 cookie值

/**
	 * 使用@CookieValue 绑定cookie值<br/>
	 * 注解@CookieValue 也有 value ,required ,defaultValue 三个参数
	 * @param session
	 * @return
	 */
	public String cookieValue(@CookieValue(value = "JSESSIONID", required= false)String session){
		System.out.println("JESSIONID:["+session+"]");
		return "helloworld";
	}

<a href="cookieValue" > cookieValue </a>

JESSIONID:[A4196EEDFD829B40CC1975F029A61328]

1.8. 源码分析