Spring MVC的映射请求

一、SpringMVC常用注解

@Controller 声明Action组件

@Service    声明Service组件    @Service("myMovieLister") 

@Repository 声明Dao组件

@Component   泛指组件, 当不好归类时. 

@RequestMapping("/menu")  请求映射

@Resource  用于注入，( j2ee提供的 ) 默认按名称装配，@Resource(name="beanName") 

@Autowired 用于注入，(srping提供的) 默认按类型装配 

@Transactional( rollbackFor={Exception.class}) 事务管理

@ResponseBody

@Scope("prototype")   设定bean的作用域

@Controller

负责注册一个bean 到spring 上下文中。

@Service    

声明Service组件，例如@Service("myMovieLister") 

@Repository 

声明Dao组件。

@Component   

泛指组件, 当不好归类时使用此注解。

@Resource  

用于注入，( j2ee提供的 ) 默认按名称装配，@Resource(name="beanName") 。

@Autowired 

用于注入，(srping提供的) 默认按类型装配 。

@Transactional( rollbackFor={Exception.class}) 

事务管理。

@Scope("prototype")   

设定bean的作用域。

@RequestMapping

注解为控制器指定可以处理哪些 URL 请求。

@RequestBody

该注解用于读取Request请求的body部分数据，使用系统默认配置的HttpMessageConverter进行解析，然后把相应的数据绑定到要返回的对象上 ,再把HttpMessageConverter返回的对象数据绑定到 controller中方法的参数上。

@ResponseBody

该注解用于将Controller的方法返回的对象，通过适当的HttpMessageConverter转换为指定格式后，写入到Response对象的body数据区。

@ModelAttribute 　　　

在方法定义上使用 @ModelAttribute 注解：Spring MVC 在调用目标处理方法前，会先逐个调用在方法级上标注了@ModelAttribute 的方法。

在方法的入参前使用 @ModelAttribute 注解：可以从隐含对象中获取隐含的模型数据中获取对象，再将请求参数 –绑定到对象中，再传入入参将方法入参对象添加到模型中 。

@RequestParam　

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

@PathVariable

绑定 URL 占位符到入参。

@ExceptionHandler

注解到方法上，出现异常时会执行该方法。

@ControllerAdvice

使一个Contoller成为全局的异常处理类，类中用@ExceptionHandler方法注解的方法可以处理所有Controller发生的异常。





二、@RequestMapping详解

1、映射请求 URL

Spring MVC 使用 @RequestMapping 注解为控制器指定可以处理哪些 URL 请求。在控制器的类定义及方法定义处都可标注。

@RequestMapping

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

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

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

@RequestMapping("/springmvc")
@Controller
public class HelloWorld {

	/**
	 * 1. 使用 @RequestMapping 注解来映射请求的 URL
	 * 2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器, 会做如下的解析:
	 * 通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作。
	 *
	 * /WEB-INF/views/success.jsp------->对应的请求是类的@RequestMapping+方法的@RequestMapping
	 * 也就是/springmvc/helloworld
	 *
	 */
	@RequestMapping("/helloworld")
	public String hello(){
		System.out.println("hello world");
		return "success";
	}

}

2、映射请求参数、请求方法或请求头

@RequestMapping 的 value、method、params 及 heads分别表示请求 URL、请求方法、请求参数及请求头的映射条件，他们之间是与的关系，联合使用多个条件可让请求映射更加精确化。

示例：

-----

@RequestMapping(value = "/testMethod", method = RequestMethod.POST)

指定请求方式为POST方式，如此便不再响应GET方式的请求。

-----

@RequestMapping(value = "testParamsAndHeaders", params = { "username",

"age!=10" }, headers = { "Accept-Language=en-US,zh;q=0.8" })





默认请求方式为GET方式，且需要有两个参数：username和age，还限定了age不能为10。

"/testParamsAndHeaders?username=atguigu&age=10"这个请求不满足要求，SpringMVC不会处理。





3、通配符

@RequestMapping 支持 Ant 风格的 URL。

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

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

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

示例：

---/user/*/createUser: 可以匹配如下

/user/aaa/createUser、/user/bbb/createUser 等 URL。

---/user/**/createUser: 可以匹配如下

/user/createUser、/user/aaa/bbb/createUser 等 URL。

---/user/createUser??: 可以匹配如下

/user/createUseraa、/user/createUserbb 等 URL，但不匹配/user/createUseraaa。









三、@PathVariable

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

示例：

@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id) {
                System.out.println("testPathVariable: " + id);
		return SUCCESS;
	}

假如请求为/testPathVariable/1，那么参数"1"会作为参数传给id作为传入参数。在方法中就可以获取这个参数值。





四、请求处理方法签名

Spring MVC 通过分析处理方法的签名，可以将 HTTP 请求信息绑定到处理方法的相应人参中。必要时可以对方法及方法入参标注相应的注解（@PathVariable、@RequestParam、@RequestHeader 等）、SpringMVC 框架会将 HTTP 请求的信息绑定到相应的方法入参中，并根据方法的返回值类型做出相应的后续处理。





1、@RequestParam

在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法。有三个属性：

value：指定参数名

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

defaultValue：指定请求参数的默认值。

示例

   @RequestMapping(value = "/testRequestParam")
	public String testRequestParam(
			@RequestParam(value = "username") String un,
			@RequestParam(value = "age", required = false, defaultValue = "10") int age) {
		System.out.println("testRequestParam, username: " + un + ", age: "
				+ age);
		return SUCCESS;
	}

声明两个输入参数，其中age参数可以缺省，默认为10。如/testRequestParam?username=kang&age=11。





2、@RequestHeader

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

示例：

 

       @RequestMapping("/testRequestHeader")
	public String testRequestHeader(
			@RequestHeader(value = "Accept-Language") String al) {
		System.out.println("testRequestHeader, Accept-Language: " + al);
		return SUCCESS;
	}

3、使用 @CookieValue 绑定请求中的 Cookie 值，可让处理方法入参绑定某个 Cookie 值。

示例：

        @RequestMapping("/testCookieValue")
	public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) {
		System.out.println("testCookieValue: sessionId: " + sessionId);
		return SUCCESS;
	}

五、将 POJO 对象绑定为请求参数值

Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配，自动为该对象填充属性值。支持级联属性。

示例：

POJO类：

Address.java

public class Address {

	private String province;
	private String city;
//省略了get/set方法
//重写了toString方法
}

User.java

public class User {

	private String username;
	private String password;
	private String email;
	private int age;
	private Address address;//持有一个Address的类实例

//省略了get/set方法
//重写了toString方法
}

jsp页面请求：

<form action="/testPojo" method="post">
		username: <input type="text" name="username"/>
		<br>
		password: <input type="password" name="password"/>
		<br>
		email: <input type="text" name="email"/>
		<br>
		age: <input type="text" name="age"/>
		<br>
		city: <input type="text" name="address.city"/>
		<br>
		province: <input type="text" name="address.province"/>
		<br>
		<input type="submit" value="Submit"/>
</form>
<br><br>

可以看出name="address.city"和name="address.province"都采用了级联属性。

Spring MVC代码：

@RequestMapping("/testPojo")
	public String testPojo(User user) {
		System.out.println("testPojo: " + user);
		return SUCCESS;
}

这里直接将User类和index.jsp的表单参数名直接对照，从而实现映射。





六、使用 Servlet API 作为入参

MVC 的 Handler 方法可以接受的 ServletAPI 类型的参数如下：

---HttpServletRequest

---HttpServletResponse

---HttpSession

---Locale，InputStream等。

示例：

public void testServletAPI(HttpServletRequest request,
			HttpServletResponse response, Writer out) throws IOException {
		System.out.println("testServletAPI, " + request + ", " + response);
                out.write("hello springmvc");
                return SUCCESS;
	}