一、SpringMVC常用注解
@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;
}