正文
Spring MVC常用的注解类
小程序：扫一扫查出行【扫一扫了解最新限行尾号】
复制小程序
一、注解类配置
要使用springmvc的注解类，需要在springmvc.xml配置文件中用context:component-scan/扫描:

二、五大重要的注解类1.RequestMapping注解
RequestMapping注解类的使用方法
在Controller控制器类的类定义和方法定义处都可以标注@RequestMapping注解
DispatcherServlet截获请求后，就可以通过控制器上的@RequestMapping提供的映射信息确定请求所对应的处理方法
package net.quickcodes.controller;import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;@Controller
@RequestMapping("/home") //类级别，可以不需要，如果要了，下面所有的请求路径前都需要加上“/home”
public class IndexController { //方法级别，必须有，决定这个方法处理哪个请求(这里处理/helloworld/home/index.html请求)
@RequestMapping(value = "/index")
public String helloWorld(){
return "index";//"WEB-INF/page/index.jsp"
}}
RequestMapping注解类的属性
RequestMapping注解类的属性，分别有 value, method, consumes, produces, params, headers
1>.value属性
• 代表具体的请求路径，比如上面的 "/home"， "/index"都是value的值
• value可以省略，就像例子中一样，直接用 @RequestMapping("/home") 的格式，它等同于@RequestMapping(value = "/home")

2>.method属性
• 指定请求的method类型， GET、POST、PUT、DELETE等:
例：@RequestMapping(value = "/login", method = RequestMethod.POST) 那么只有发送POST请求才会触发这个方法
• 它的值既可以是字符串也可以是数组:
例：@RequestMapping(value = "/login", method = {RequestMethod.POST, RequestMethod.GET})
3>.consumes属性
• 指定请求的提交内容类型（Content-Type），例如application/json, text/html
例：@RequestMapping(value = "/login", consumes = "application/json")
• 它的值既可以是字符串也可以是数组
例：@RequestMapping(value = "/login", consumes = {"application/json", "text/html"})
4>.produces属性
• 指定返回的内容的类型（Content-Type），例如application/json, text/html
例：@RequestMapping(value = "/login", produces = "application/json")
• 它的值既可以是字符串也可以是数组
例：@RequestMapping(value = "/login", produces = {"application/json", "text/html"})
5>.params属性
• 指定请求中必须包含某些参数值，才会触发这个处理方法
例：@RequestMapping(value = "/login", params = "id=1")
• 参数中除了使用=等号外，还可以使用!=号，表示在参数的值不等于的情况下触发这个方法
例：@RequestMapping(value = "/login", params = {"id=1","age!=18"})
• 也可以不指定具体的值，直接使用 "paramName" 的格式，代表请求中必须包含参数名为 paramName 的参数
• 直接使用 “!paramName”格式表示请求不能包含名为paramName的请求参数
6>.headers属性
• 请求头Header中必须包含某些指定的参数值，才能让该方法处理请求，可以利用这个特性拒绝非指定来源的客户端的访问，以加强站点的安全。
例：@RequestMapping(value = "/login", headers = "content-type=text/*")
例：@RequestMapping(value = "/login", headers = {"content-type=text/*","Referer=http://www.buyinplay.com"})
定义Ant风格和带占位符的URL
@RequestMapping不仅支持标准的URL，还支持Ant风格和带{xxx}占位符的URL，下面的URL都是合法的：
• /user/*/login：匹配/user/aaa/login，/user/任意字符/login 等
• /user/**/login：匹配/user/login， /user/aaa/bbb/login 等
• /user/login??：匹配/user/loginAA, /user/loginbb 等
• /user/{userId}：匹配/user/123， /user/234 等
• /user/**/{userId}：匹配/user/aaa/bbb/123，/user/aaa/234等
2.Component注解
Component注解是“Controller注解”、“Service注解”和“Repository注解”的通用注解，可以和它们起到相同的作用(在不清楚使用那个注解的时候，可以统统使用Component，为了代码逻辑清晰，还是建议使用具体的注解)。这四个注解都是类级别的， 可以不带任何参数，也可以带一个参数，代表bean名字，在进行注入的时候就可以通过名字进行注入了。
使用@Resource或@Autowired注解实现注入
@Resource和@Autowired注解的异同：
@Resource 用于注入，( j2ee提供的 ) 默认按名称装配，@Resource(name="beanName")
@Autowired 用于注入，(srping提供的) 默认按类型装配,默认情况下必须要求依赖对象必须存在，如果要允许null值，可以设置它的required属性为false，例如：@Autowired(required=false) ，如果我们想使用名称装配可以结合@Qualifier注解进行使用

一般我会使用@Resource进行注入：

3.Controller注解
类级别的注解，用于声明控制器类。用法参考“Component注解”。

@Controller 负责注册一个bean 到spring 上下文中，bean 的ID 默认为类名称开头字母小写,你也可以自己指定，如下
方法一：
@Controller
public class TestController {}
方法二：
@Controller("tmpController")
public class TestController {}
4.Service注解
类级别的注解，用于声明Service类。用法参考“Component注解”。

5.Repository注解
类级别的注解，用于声明DAO类。用法参考“Component注解”。

三、其他常用的注解类1.CookieValue注解
读取Cookies中的值，并且赋值给变量
有三个属性 value， required， defaultValue，分别表示Cookie的名字，是否必须有这个Cookie值，如果没有则使用默认值
不带任何参数，表示需要的参数名与标注的变量名相同
@RequestMapping("/listone")
public String listone(@CookieValue String goodsName){//不带任何参数
return "listone";
}@RequestMapping("/listtwo")
public String listtwo(@CookieValue("goodsName") String goodsName){//指定Cookie的名字
return "listtwo";
}@RequestMapping("/listthree")
public String listthree(@CookieValue(value="goodsName",defaultValue="new",required =false) String goodsName){//指定Cookie的名字，如果没有这个名字，赋值默认值new
return "listthree";
}
2.PathVariable注解
1>.@PathVariable用于方法中的参数，表示方法参数绑定到地址URL的模板变量。
例如：
@RequestMapping(value="/owners/{ownerId}", method=RequestMethod.GET)
public String findOwner(@PathVariable String ownerId, Model model) {
Owner owner = ownerService.findOwner(ownerId);
model.addAttribute("owner", owner);
return "displayOwner";
}

2>.@PathVariable用于地址栏使用{xxx}模版变量时使用。
如果@RequestMapping没有定义类似"/{ownerId}" ，这种变量，则使用在方法中@PathVariable会报错。
3.RequestBody注解
4.RequestHeader注解
可以把Request请求header部分的值绑定到方法的参数上


5.RequestMethod注解
6.RequestParam注解
@RequestParam是一个可选参数，例如：@RequestParam("id") 注解，所以它将和URL所带参数 id进行绑定 。
如果入参是基本数据类型（如 int、long、float 等），URL 请求参数中一定要有对应的参数，否则将抛出
org.springframework.web.util.NestedServletException 异常，提示无法将 null 转换为基本数据类型.
@RequestParam包含3个配置 @RequestParam(required = ,value="", defaultValue = "")
required :参数是否必须，boolean类型,可选项，默认为true
value: 传递的参数名称，String类型,可选项，如果有值，对应到设置方法的参数
defaultValue:String类型,参数没有传递时为参数默认指定的值
7.ResponseBody注解
这个注解可以直接放在方法上，表示返回类型将会直接作为HTTP响应字节流输出(不被放置在Model，也不被拦截为视图页面名称)。可以用于ajax。
用于将Controller的方法返回的对象，通过适当的HttpMessageConverter（转换器）转换为指定格式后，写入到Response对象的body数据区
返回如json、xml等时使用
在springmvc配置文件中通过，给AnnotationMethodHandlerAdapter初始化7个转换器
- ByteArranHttpMessageConverter 读写二进制数据
- StringHttpMessageConverter 将请求信息转换为字符串
- ResourceHttpMessageConverter 读写org.springframework.core.io.Resource对象
- SourceHttpMessageConverter 读写javax.xml.transform.Source类型的数据
- XmlAwareFormHttpMessageConverter 处理表单中的XML数据
- Jaxb2RootElementHttpMessageConverter 通过JAXB2读写XML消息，将请求消息转换到标注XmlRootElement和XmlType的注解类中
- MappingJacksonHttpMessageConverter 读写JSON数据


8.SessionAttribute注解
session管理
如果希望在多个请求之间公用某个模型属性数据，则可以在控制器类标注一个@SessionAttributes，Spring MVC会将模型中对应的属性暂存到HttpSerssion中
除了SessionAttributes，还可以直接用原生态的request.getSession()来处理session数据
Spring 允许我们有选择地指定 ModelMap 中的哪些属性需要转存到 session 中，以便下一个请求属对应的 ModelMap 的属性列表中还能访问到这些属性。这一功能是通过类定义处标注 @SessionAttributes 注解来实现的。@SessionAttributes 只能声明在类上，而不能声明在方法上。
@SessionAttributes("currUser") // 将ModelMap 中属性名为currUser 的属性 @SessionAttributes({"attr1","attr2"})
@SessionAttributes(types = User.class)
@SessionAttributes(types = {User.class,Dept.class})
@SessionAttributes(types = {User.class,Dept.class},value={"attr1","attr2"})
@Controller
@RequestMapping(value = "/goods")
@SessionAttributes("rowCount")//代码中所有名为rowCount的属性都会自动存入session中
public class GoodsController { @Resource
GoodsService service; /**注入语法
@Autowired
@Qualifier("goodsService")
GoodsService service;
*/ @RequestMapping(value = "/list")
public String helloWorld(HttpServletRequest request){
String currPageStr = request.getParameter("page");
int currPage = 1;
try {
currPage = Integer.parseInt(currPageStr);
} catch (Exception e) {
} // 获取总记录数
int rowCount = service.getRowCount();//被自动存入session中
PageParam pageParam = new PageParam();
pageParam.setRowCount(rowCount);
if (pageParam.getTotalPage() < currPage) {
currPage = pageParam.getTotalPage();
}
pageParam.setCurrPage(currPage);
pageParam = service.getGoodsByPage(pageParam); request.setAttribute("pageParam", pageParam); return "list";
} @RequestMapping("/clearsession")//本方法仅用于演示清除session
public String doClearSession(String goodsName,SessionStatus status){
status.setComplete();
return "list";
}
}
9.Scope("prototype")注解
设定bean的作用域
10.Transactional( rollbackFor={Exception.class})注解
事务管理
11.ModelAttribute注解
1>.应用于方法参数,参数可以在页面直接获取，相当于request.setAttribute(,)
2>.应用于方法,将任何一个拥有返回值的方法标注上 @ModelAttribute，使其返回值将会进入到模型对象的属性列表中.
3>.应用于方法参数时@ModelAttribute("xx"),须关联到Object的数据类型，基本数据类型 如：int,String不起作用
例如：
Java代码
@ModelAttribute("items")//<——①向模型对象中添加一个名为items的属性 public List<String> populateItems() {
List<String> lists = new ArrayList<String>();
lists.add("item1");
lists.add("item2");
return lists;
}@RequestMapping(params = "method=listAllBoard")
public String listAllBoard(@ModelAttribute("currUser")User user, ModelMap model) {
bbtForumService.getAllBoard();
//<——②在此访问模型中的items属性
System.out.println("model.items:" + ((List<String>)model.get("items")).size());
return "listBoard";
}
在 ① 处，通过使用 @ModelAttribute 注解，populateItem() 方法将在任何请求处理方法执行前调用，Spring MVC 会将该方法返回值以“items”为名放入到隐含的模型对象属性列表中。 所以在 ② 处，我们就可以通过 ModelMap 入参访问到 items 属性，当执行 listAllBoard() 请求处理方法时，② 处将在控制台打印出“model.items:2”的信息。当然我们也可以在请求的视图中访问到模型对象中的 items 属性。
