SpringMvc常用注解详细介绍（附示例代码）

一、注解类配置

要使用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名字，在进行注入的时候就可以通过名字进行注入了。

![](media/14612091580198/14612489590879.jpg)

使用@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 属性。