Springmvc入门基础(五) ---controller层注解及返回类型解说
0.@Controller注解
作用:通过@Controller注解，注明该类为controller类，即控制器类，需要被spring扫描，然后注入到IOC容器中，作为Spring的Bean来管理，这样，Spring就能找到Controller类，通过@RequestMapping注解处理对应的请求。
1.@RequestMapping注解
作用:通过@RequestMapping注解可以定义不同的处理器映射规则。
1.1 注解位置
放在class类上
在class上添加@RequestMapping(url)指定通用请求前缀， 限制此类下的所有方法请求url必须以请求前缀开头,则前端访问url则是localhost:8080/springmvc/item/itemlist.action
放在controller方法上，注明访问该controller方法的uri是什么。
@Controller
@RequestMapping("/item")
public class ItemController {
@Autowired
private ItemService itemService;
@RequestMapping(value = {"/itemlist.action","/samePage.action"})
public String itemList(Model model,
HttpServletRequest request,
HttpServletResponse response,
HttpSession session
) throws Exception{
model.addAttribute("itemList", list);
return "itemList";
}
}1.2 请求方法限定
除了可以对url进行设置，还可以限定请求进来的方法
1.2.1.限定GET方法
@RequestMapping(value = "/itemList",method = RequestMethod.GET)
如果通过POST访问则报错：
HTTP Status 405 - Request method 'POST' not supported
1.2.2.限定POST方法
@RequestMapping(value = "/itemList",method = RequestMethod.POST)
如果通过GET访问则报错：
HTTP Status 405 - Request method 'GET' not supported
1.2.3.GET和POST都可以
@RequestMapping(value = "/itemList",method = {RequestMethod.GET,RequestMethod.POST})
或者不注明method，则默认接收任何类型的请求
@RequestMapping(value = "/itemList")
注意：@RequestMapping(value = "/itemList")，也可写成@RequestMapping("/itemList")
假如项目路径后面加了/，即/springmvc/,则需要写成@RequestMapping(value = "itemList")，或者@RequestMapping("itemList")
2.@RequestBody和@ResponseBody注解
2.1@RequestBody注解
作用：@RequestBody注解用于读取http请求的内容(字符串)，通过springmvc提供的HttpMessageConverter接口将读到的内容（json数据）转换为java对象并绑定到Controller方法的参数上。
2.2 @ResponseBody注解
作用：@ResponseBody注解用于将Controller的方法返回的对象，通过springmvc提供的HttpMessageConverter接口转换为指定格式的数据如：json,xml等，通过Response响应给客户端
前端请求body部分json字符串，不管前端是以什么样的方式给服务的发送，服务端接收到的只要是json格式字符串即可-params
var params = '{"id": 1,"name": "测试商品","price": 99.9,"detail": "测试商品描述","pic": "123456.jpg"}';
//json数据交互
@RequestMapping(value = "/json.action")
public @ResponseBody
Items json(@RequestBody Items items){
return items;
}
pojo类
public class Items {
private Integer id;
private String name;
private Float price;
private String pic;
private String detail;
此处省略get,set方法}注意:前端请求的body中的json字符串中的key值，即上图所示的id,name等，必须要与controller方法形参中使用@RequestBody注解封装的pojo类的属性值一样。
至于使用 @ResponseBody,把controller方法的返回值给封装到item对象中，前端接收到的也是个json
字符串，至于如何从json字符串取出展示啥的，此处不做多处讨论，举个简单例子即可
比如前端是通过ajax方式向服务端发起请求
$.ajax({
url : "${pageContext.request.contextPath }/json.action",
data : params,
contentType : "application/json;charset=UTF-8",//发送数据的格式
type : "post",
dataType : "json",//回调
success : function(data){
alert(data.id);
alert(data.name);
}
});只需要在回调函数中通过data.属性值即可取出具体value值
3.@RequestParam,@PathVariable等
3.1 @RequestParam注解
作用:@RequestParam主要是用来解决前端页面的name属性值与服务端controller方法中定义的形参值名称不一样，比如下图所示，把前端页面name为itemId的值给注入到controller方法定义的形参id中去
@RequestMapping("/itemEdit")
public String queryItemById(@RequestParam(value = "itemId", required = true, defaultValue = "1") Integer id,
ModelMap modelMap) {
// 根据id查询商品数据
Item item = this.itemService.queryItemById(id);
// 把商品数据放在模型中
modelMap.addAttribute("item", item);
return "itemEdit";
}
3.2 PathVariable注解
我们需要从url上获取商品id，步骤如下：
1.使用注解@RequestMapping("item/{id}")声明请求的url
{xxx}叫做占位符，请求的URL可以是“item /1”或“item/2”
2.使用(@PathVariable() Integer id)获取url上的数据
/**
* 使用RESTful风格开发接口，实现根据id查询商品
*
* @param id
* @return
*/
@RequestMapping("item/{id}")
@ResponseBody
public Item queryItemById(@PathVariable() Integer id) {
Item item = this.itemService.queryItemById(id);
return item;
}
注意@PathVariable和@RequestParam区别
- @PathVariable是获取url上数据的。@RequestParam获取请求参数的（包括post表单提交）
3.3 @RequestHeader、@CookieValue
@RequestHeader 注解，可以把Request请求header部分的值绑定到方法的参数上。
@CookieValue 可以把Request header中关于cookie的值绑定到方法的参数上。
@RequestMapping("/iteamList.action")
public void editList(@RequestHeader("Accept-Encoding") String encoding,
@CookieValue("JSESSIONID") String cookie) {
System.out.println(encoding);
System.out.println(cookie);
}
3.4 @SessionAttributes, @ModelAttribute
@SessionAttributes-该注解用来绑定HttpSession中的attribute对象的值，便于在方法中的参数里使用,该注解有value、types两个属性，可以通过名字和类型指定要使用的attribute 对象；
若希望在多个请求之间共用数据，则可以在控制器类上标注一个 @SessionAttributes,配置需要在session中存放的数据范围，Spring MVC将存放在model中对应的数据暂存到 HttpSession 中。
注意:@SessionAttributes只能使用在类定义上。
@Controller
@RequestMapping("/item")
@SessionAttributes(value={"username","password")
@SessionAttributes(types=User.class)
@SessionAttributes(types={User.class,Item.class},value={"username","password"})
public class ItemController{
@RequestMapping("/editIteam.action")
public String editItem(Model model){
User user = new User("jack","123456");
model.addAttribute("user", user);
model.addAttribute("username","jack");
return "success";
}
} 处理方法editItem在model中存放了属性名为user和username的数据，
处理结束后,model里的数据会被放入到request中,页面通过request域可以获取到。
而这里使用了@SessionAttributes(value={“user”})将model中属性名为user的数据copy一份进了session域中.
页面获取：
<h1>user requestScope:${requestScope.user}</h1>
<h1>user sessionScope:${sessionScope.user}</h1>
@ModelAttribute
该注解有两个用法，一个是用于方法上，一个是用于参数上；
用于方法上时： 通常用来在处理@RequestMapping之前，为请求绑定需要从后台查询的model；
被@ModelAttribute注释的方法会在此controller每个方法执行前被执行，因此对于一个controller映射多个URL的用法来说，要谨慎使用。
用于参数上时： 用来通过名称对应，把相应名称的值绑定到注解的参数bean上；要绑定的值来源于：
A） @SessionAttributes 启用的attribute 对象上；
B） @ModelAttribute 用于方法上时指定的model对象；
C） 上述两种情况都没有时，new一个需要绑定的bean对象，然后把request中按名称对应的方式把值绑定到bean中。
备注:由于很少很少用到，详细用法就不在此介绍了，有需要请自行网上查找具体用法。
4.controller方法返回值类型
4.1 返回ModelAndView
controller方法中定义ModelAndView对象并返回，对象中可添加model数据、指定view。
@RequestMapping(value = "/itemEdit.action")
public ModelAndView toEdit(Integer id,
HttpServletRequest request,HttpServletResponse response
,HttpSession session,Model model){
//查询一个商品
Items items = itemService.selectItemsById(id);
ModelAndView mav = new ModelAndView();
//数据
mav.addObject("item", items);
mav.setViewName("editItem");
return mav;
}4.2 返回void
在Controller方法形参上可以定义request和response，使用request或response指定响应结果：
4.2.1、使用request转发页面，如下：
request.getRequestDispatcher("页面路径").forward(request, response);
request.getRequestDispatcher("/WEB-INF/jsp/success.jsp").forward(request, response);4.4.2、通过response页面重定向：
response.sendRedirect("url")
response.sendRedirect("/springmvc-web2/itemEdit.action");4.4.3 通过response指定响应结果
可以通过response指定响应结果，例如响应json数据如下：
response.getWriter().print("{\"abc\":123}");
4.5 返回字符串
4.5.1 返回逻辑视图名
controller方法返回字符串可以指定逻辑视图名，通过视图解析器解析为物理视图地址。
//指定逻辑视图名，经过视图解析器解析为jsp物理路径：/WEB-INF/jsp/itemList.jsp
@RequestMapping(value = "/itemlist.action")
public String itemList(Model model,
HttpServletRequest request,
HttpServletResponse response,
HttpSession session
) throws Exception{
List<Items> list = itemService.selectItemsList();
model.addAttribute("itemList", list);
return "itemList";
}4.5.2 通过Redirect重定向
Contrller方法返回字符串可以重定向到一个url地址
如下商品修改提交后重定向到商品编辑页面。
@RequestMapping("updateItem")
public String updateItemById(Item item) {
// 更新商品
this.itemService.updateItemById(item);
// 修改商品成功后，重定向到商品编辑页面
// 重定向后浏览器地址栏变更为重定向的地址，
// 重定向相当于执行了新的request和response，所以之前的请求参数都会丢失
// 如果要指定请求参数，需要在重定向的url后面添加 ?itemId=1 这样的请求参数
return "redirect:/itemEdit.action?itemId=" + item.getId();
}
4.5.3 forward转发
Controller方法执行后继续执行另一个Controller方法
如下商品修改提交后转向到商品修改页面，修改商品的id参数可以带到商品修改方法中。
@RequestMapping("/updateItem")
public String updateItemById(Item item) {
// 更新商品
this.itemService.updateItemById(item)；
// 修改商品成功后，继续执行另一个方法
// 使用转发的方式实现。转发后浏览器地址栏还是原来的请求地址，
// 转发并没有执行新的request和response，所以之前的请求参数都存在
return "forward:/itemEdit.action";
}
哈喽，各位亲，觉得还不错请在评论处来个某某来此一游!
