SpringMVC中的常用注解

RequestParam

作用:

　　用于  将请求参数区数据  映射到  功能处理方法的参数上。

属性: 

　　value  请求参数中的名称

　　required   请求参数中是否必须提供此参数.

　　　　　　默认值: true   表示必须提供, 如果不提供将报错

使用示例:

jsp代码:

<!-- requestParams 注解的使用 --> 
<a href="springmvc/useRequestParam?name=test">requestParam 注解</a> 

控制器中的代码： 

@RequestMapping("/useRequestParam") 
public String useRequestParam(@RequestParam("name")String username, @RequestParam(value="age",required=false)Integer age){  
　　System.out.println(username+","+age);  
　　return "success"; 
}

RequestBody

作用:

　　用于获取请求体内容, 

　　直接使用得到的是  key=value&key=value.....结构的数据

　　get请求方式不使用

属性:

　　required  是否必须有请求体

　　　　　　默认值是  true 

　　　　　　当取值为true时, get请求方式会报错

　　　　　　若取值是false , get请求得到的是null

使用示例:

POST请求 jsp代码:

<!-- request body 注解 --> 
<form action="springmvc/useRequestBody" method="post"> 
　　用户名称：<input type="text" name="username" ><br/>  
　　用户密码：<input type="password" name="password" ><br/>  
　　用户年龄：<input type="text" name="age" ><br/> 
　　<input type="submit" value=" 保存 "> 
</form> 

GET请求   jsp代码

　　<a href="springmvc/useRequestBody?body=test">requestBody 注解 get 请求</a> 

控制器代码:

@RequestMapping("/useRequestBody") 
public String useRequestBody(@RequestBody(required=false) String body){  
　　System.out.println(body); 
　　return "success"; 
} 

PathVariable

路径变量

作用: 

　　用于绑定URL中的占位符

　　例如：请求URL中 /delete/{id}，这个{id}就是 URL占位符。 

　　URL支持占位符是 Spring3.0 之后加入的。是 springMVC支持 Rest 风格 URL 的一个重要标志。 

属性:

　　value  用于指定URL中占位符名称

　　required  是否必须提供占位符

使用示例:

jsp中的代码:

　　<!-- PathVariable 注解 -->

　　<a href="springmvc/usePathVariable/100">pathVariable 注解</a> 

控制器中的代码:

@RequestMapping("/usePathVariable/{id}") 
public String usePathVariable(@PathVariable("id") Integer id){  
　　System.out.println(id);  
　　return "success"; 
} 

REST 风格 URL 

什么是REST

　　REST（英文：Representational State Transfer，表现层状态转化 , 简称 REST）描述了一个架构样式的网络系统， 比如 web 应用程序。

　　它首次出现在 2000 年 Roy Fielding 的博士论文中，他是 HTTP 规范的主要编写者之 一。

　　在目前主流的三种 Web 服务交互方案中，REST 相比于 SOAP（Simple Object Access protocol，简单对象访问协议）以及 XML-RPC 更加简单明了，无论是对 URL 的处理还是对Payload 的编码，REST 都倾向于用更加简单轻量的方法设计和实现。

　　值得注意的是 REST 并没有一个明确的标准，而更像是一种设计的风格。 

　　它本身并没有什么实用性，其核心价值在于如何设计出符合 REST 风格的网络接口。 

 restful 的优点 

　　 它结构清晰、符合标准、易于理解、扩展方便

 restful 的特性： 

 　　资源（Resources）：网络上的一个实体，或者说是网络上的一个具体信息。 

 　　　　它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的存在。

　　　　 可以用一个 URI（统一 资源定位符）指向它，每种资源对应一个特定的 URI 。

　　　　 要获取这个资源，访问它的 URI 就可以，因此 URI 即为每一个资源的独一无二的识别符。 

 　　表现层（Representation）：把资源具体呈现出来的形式，叫做它的表现层 （Representation）。 

 　　　　 比如，文本可以用 txt 格式表现，也可以用 HTML 格式、XML 格式、JSON 格式表现，甚至可以采用二进制格式。

 　　 状态转化（State Transfer）：每发出一个请求，就代表了客户端和服务器的一次交互过程。 

　　　　　　HTTP 协议，是一个无状态协议，即所有的状态都保存在服务器端。

　　　　　　因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生“状态转化”（State Transfer）。

　　　　　　而这种转化是建立在表现层之上的，所以就是 “表现层状态转化”。

　　　　　　具体说，就是 HTTP 协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。

　　　　　　它们分别对应四种基本操作：

　　　　　　　　GET 用来获取资源，

　　　　　　　　POST 用来新建资源，

　　　　　　　　PUT 用来更新资源，

　　　　　　　　DELETE 用来删除资源。

Restful 风格的URL示例： 

/account    HTTP POST： 新增 account 

/account/1 HTTP GET ： 得到 id = 1 的 account

/account/1 HTTP DELETE： 删除 id = 1 的 account

/account/1 HTTP PUT： 更新 id = 1 的 account

基于 HiddentHttpMethodFilter 的示例 

作用: 

　　由于浏览器 form 表单只支持 GET 与 POST 请求，而 DELETE、PUT 等 method 并不支持，

　　Spring3.0 添加了一个过滤器，

　　可以将浏览器请求改为指定的请求方式，发送给我们的控制器方法，

　　使得支持 GET、POST、PUT 与 DELETE 请求。

使用方法:

　　第一步：在 web.xml 中配置HiddenHttpMethodFilter。

 <!-- 配置 org.springframework.web.filter.HiddenHttpMethodFilter: 可以把 POST 请求转为 DELETE 或 POST 请求 -->
        <filter>
            <filter-name>HiddenHttpMethodFilter</filter-name>
            <filter-class>org.springframework.web.filter.HiddenHttpMethodFilter</filter-class>
        </filter>
        
        <filter-mapping>
            <filter-name>HiddenHttpMethodFilter</filter-name>
            <url-pattern>/*</url-pattern>
        </filter-mapping>

　　

　　第二步：请求方式必须使用 post 请求。

　　　　<form action="springmvc/testRestPOST" method="post"> 

　　　　<form action="springmvc/testRestPOST/1" method="post"> 

　　第三步：需要在发送 POST 请求时携带一个 name="_method" 的隐藏域, 值为 DELETE 或 PUT

　　　　<input type="hidden" name="_method" value="DELETE">  

　　

　　在控制器方法中  使用@PathVariable注解得到id　　

　　　　

示例:

jsp代码:

<!-- 保存 --> 
<form action="springmvc/testRestPOST" method="post"> 
　　用户名称：<input type="text" name="username"><br/>  
　　<!-- <input type="hidden" name="_method" value="POST"> --> 
　　<input type="submit" value=" 保存 "> 
</form> 
<hr/> 

<!-- 更新 --> 
<form action="springmvc/testRestPUT/1" method="post"> 
　　用户名称：<input type="text" name="username"><br/>   
　　<input type="hidden" name="_method" value="PUT"> 
　　<input type="submit" value=" 更新 "> 
</form> 
<hr/> 

<!-- 删除 --> 
<form action="springmvc/testRestDELETE/1" method="post"> 
　　<input type="hidden" name="_method" value="DELETE"> 
　　<input type="submit" value=" 删除 "> 
</form> 
<hr/> 

<!-- 查询一个 --> 
<form action="springmvc/testRestGET/1" method="post">  
　　<input type="hidden" name="_method" value="GET"> 
　　<input type="submit" value=" 查询 "> 
</form> 

控制器代码:

/** 
* post 请求：保存  
* @param username  
* @return  
*/ 
@RequestMapping(value="/testRestPOST",method=.POST) 
public String testRestfulURLPOST(User user){  
　　System.out.println("rest post"+user);  
　　return "success"; 
}     
/** 
* put 请求：更新  
* @param username  
* @return  
*/ 
@RequestMapping(value="/testRestPUT/{id}",method=.PUT) 
public String testRestfulURLPUT(@PathVariable("id")Integer id,User user){  
　　System.out.println("rest put "+id+","+user);  
　　return "success"; 
}

@RequestMapping(value="/testRestDELETE/{id}",method=RequestMethod.DELETE) 
public String testRestfulURLDELETE(@PathVariable("id")Integer id){  
　　System.out.println("rest delete "+id); 
　　return "success"; 
}

@RequestMapping(value="/testRestGET/{id}",method=RequestMethod.GET)
public String testRestfulURLGET(@PathVariable("id")Integer id){  
　　System.out.println("rest get  "+id);  
　　return "success"; 
}

RequestHeader

作用:

　　获取请求头信息

属性:

　　value   提供消息头名称

　　required   是否必须有此消息头

使用示例:

<!-- RequestHeader 注解 -->

<a href="springmvc/useRequestHeader">获取请求消息头</a> 

控制器中代码:

@RequestMapping("/useRequestHeader") 
public String useRequestHeader(@RequestHeader(value="Accept-Language",required=false)String requestHeader){  
　　System.out.println(requestHeader);  
　　return "success"; 
}

CookieValue 

作用:

　　用于把指定cookie名称的值传入控制器方法参数

属性:

　　value  指定cookie的名称

　　required  是否必须有此cookie

使用示例:

jsp中的代码:

<!-- CookieValue 注解 -->

<a href="springmvc/useCookieValue">绑定 cookie 的值</a> 

控制器中代码:

@RequestMapping("/useCookieValue") 
public String useCookieValue(@CookieValue(value="JSESSIONID",required=false) String cookieValue){  
　　System.out.println(cookieValue);  
　　return "success"; 
}

ModelAttribute 

作用:

　　该注解是SpringMVC4.3版本以后新加入的, 它可以用于修饰方法和参数

　　出现在方法上, 表示当前方法会在控制器的方法执行之前, 先执行.  他可以修饰没有返回值的方法, 也可以修饰有具体返回值的方法

　　出现在参数上, 获取指定的数据给参数赋值

属性: 

　　value   用于获取数据的Key,    key可以是POJO的属性名称, 也可以是map结构的key

应用场景: 

　　当表单提交数据不是完整的实体类数据时

　　保证没有提交数据的字段使用数据库对象原来的数据

　　例如:

　　　　我们在编辑一个用户是时, 用户有一个创建信息字段, 该字段的值是不允许被修改的

　　　　在提交表单数据时肯定没有此字段的内容, 一旦更新会把该字段内容置为NULL

　　　　此时就可以使用此注解解决问题

使用示例:

基于POJO属性的基本使用:

jsp 代码：

<!-- ModelAttribute 注解的基本使用 --> 

<a href="springmvc/testModelAttribute?username=test">测试 modelattribute</a> 

控制器代码:

/** 
* 被 ModelAttribute 修饰的方法   
* @param user   
*/  
@ModelAttribute  
public void showModel(User user) {   
　　System.out.println("执行了 showModel 方法"+user.getUsername());  
} 

/** 
 * 接收请求的方法   
* @param user   
* @return   
*/  
@RequestMapping("/testModelAttribute")  
public String testModelAttribute(User user) {   
    System.out.println("执行了控制器的方法"+user.getUsername());   
    return "success";  
}

基于 Map 的应用场景示例 1：ModelAttribute 修饰方法带返回值 

需求： 

　　修改用户信息，要求用户的密码不能修改 

jsp 的代码：

<form method="post" action="userDataHandler/SubmitUserData">
    username : <input type="text" name="username"/><br/>
    birthday : <input type="text" name="birthday"/> 格式 : YYYY-MM-DD <br/>
    age : <input type="text" name="age"/> <br/>
    <input type="submit" value="submit"/>
</form>

控制的代码： 

   @ModelAttribute
    public User showModel(String username){  //获取请求参数中的username
        User user=findByUsername (username); //从数据库查询
        System.out.println ("执行了 showModel 方法 : "+user);
        return  user;
    }

　　//模拟修改用户信息方法
    @RequestMapping(value = "/SubmitUserData",method = RequestMethod.POST)
    public String testModelAttribute(User user){
        System.out.println ("控制器中处理请求的方法：修改用户 : "+user);
        return "success";
    }

　　//模拟从数据库查询数据
　　public User findByUsername(String username){
    　　//数据库元数据
   　　 User user = new User ();
    　　user.setUsername (username);
    　　user.setBirthday (new Date ());
    　　user.setAge ("19");
    　　user.setPassword ("1234");
    　　return  user;
　　}

 执行结果:

 基于 Map 的应用场景示例 1：ModelAttribute 修饰方法不带返回值 

    @ModelAttribute
    public void showModel(String username, Map<String,User> map){
        User user=findByUsername (username);
        System.out.println ("执行了 showModel 方法 : "+user);
        map.put ("modelAttributeUser",user);
    }

    @RequestMapping(value = "/SubmitUserData",method = RequestMethod.POST)
    public String testModelAttribute(@ModelAttribute("modelAttributeUser") User user){
        System.out.println ("控制器中处理请求的方法：修改用户 : "+user);
        return "success";
    }

SessionAttribute 

 作用: 

　　用于多次执行控制器方法间的参数共享

属性:

　　value  用于指定存入的数据名称

　　type   用于指定存入的数据类型

示例:

jsp中代码:

<!-- SessionAttribute 注解的使用 --> 
<a href="springmvc/testPut">存入 SessionAttribute</a> <hr/> 
<a href="springmvc/testGet">取出 SessionAttribute</a> <hr/> 
<a href="springmvc/testClean">清除 SessionAttribute</a> 

控制器中的代码： 

@Controller("sessionAttributeController") 
@RequestMapping("/springmvc") 
@SessionAttributes(value ={"username","password"},types={Integer.class}) //把数据存入到session域对象中
public class SessionAttributeController { 
　　/** 
  　　* 把数据存入 SessionAttribute   
  　　* @param model   
  　　* @return 
  　　*  Model 是 spring 提供的一个接口，该接口有一个实现类 ExtendedModelMap   
  　　*  该类继承了 ModelMap，而 ModelMap 就是 LinkedHashMap 子类   
  　　*/ 
 　　@RequestMapping("/testPut")   
 　　public String testPut(Model model){   
　　　　//底层会存储到request域对象中
    　　model.addAttribute("username", "泰斯特");               
    　　model.addAttribute("password","123456");           
    　　model.addAttribute("age", 31);  
 　　　　//跳转之前将数据保存到 username、password 和 age 中，因为注解@SessionAttribute 中有 这几个参数
　　　　return "success";   
　　 }

　　@RequestMapping("/testGet")       
　　public String testGet(ModelMap model){   
　　　　System.out.println(model.get("username")+";"+model.get("password")+";"+model.get("a ge"));           
　　　　return "success";   
　　}

　　@RequestMapping("/testClean")        
　　public String complete(SessionStatus sessionStatus){         
　　　　sessionStatus.setComplete();            
　　　　return "success";        
　　}
}