请求限制
一些情况下我们可能需要对请求进行限制,比如仅允许POST,GET等...
RequestMapping注解中提供了多个参数用于添加请求的限制条件
- value 请求地址
- path 请求地址
- method 请求方法
- headers 请求头中必须包含指定字段
- params 必须包含某个请求参数
- consumes 接受的数据媒体类型 (与请求中的contentType匹配才处理)
- produce 返回的媒体类型 (与请求中的accept匹配才处理)
案例:
@RequestMapping(value = "/editCourse",method = RequestMethod.POST,headers = {"id"},params = {"name"},consumes = {"text/plain"},produces = {"text/html"})//含义:url为/editCourse 请求方法为POST hander必须包含id字段 参数必须包含name 只接受text/plain类型数据 返回数据类型为text/html
为了简化书写,MVC还提供了集合路径和方法限制的注解,包括常见的请求方法:
PostMappingGetMappingDeleteMappingPutMapping例:@PostMapping("/editCourse")
handler返回值
handler方法可以是三种类型的返回值,用于不同场景
ModelAndView
返回值为视图和数据的包装类型,用于返回逻辑视图名称和视图需要展示的数据
等同于在Request中添加了属性,然后进行了请求转发
例:
@RequestMapping("/test")public ModelAndView test() { ModelAndView modelAndView = new ModelAndView(); modelAndView.setViewName("index.jsp"); modelAndView.addObject("msg", "hello ssm!"); return modelAndView;}
void
表示handler不返回任何数据,用于当需要直接操作response完成响应的场景
例:
@RequestMapping("/test2")public void test2(String name,HttpServletResponse response) throws IOException { response.getWriter().println(name.toUpperCase());}
String
返回一个字符串类型的值,返回的内容可以是视图名称也可以是其他请求地址
其背后采用的是请求转发的方式
例:
@RequestMapping("/test3")public String test3(Model model) { model.addAttribute("msg","hello XXX"); return "index.jsp";}@RequestMapping("/test4")public String test4() { return "/test";}
转发和重定向:
也可指定对目标地址的请求是通过重定向或请求转发;
例:
@RequestMapping("/test5")public String test5() { return "forward:/index.jsp";}@RequestMapping("/test6")public String test6() { return "redirect:/index.jsp";}
当然了 默认就是forward所以可以省略;
json交互
当下,大多数公司都会有移动端App,当我们的后台服务需要为App提供接口时,就不得不使用到json数据了,当然还有前后端分离项目中前端和后台同样采用json来交换数据;
在开始前,需要导入jackson依赖,用于实现json的序列化与反序列化;
<dependency> <groupId>com.fasterxml.jackson.core</groupId> <artifactId>jackson-databind</artifactId> <version>2.9.9</version></dependency>
返回json数据
@ResponseBody注解用于标注一个handler方法返回的是json数据,同时方法的返回值将作为返回给前台的数据;
例:
@RequestMapping("/getCourseList")@ResponseBodypublic List<Course> getCourseList() { //获取所有课程 return courseService.selectCourses();}@RequestMapping("/getCourse")@ResponseBodypublic Course getCourse(Integer id) {// 根据id获取一个课程 return courseService.selectByID(id);}
ResponseBody会将响应的ContentType设置为application/json, 然后调用jackson的toJsonString将返回值转为json字符串,最后返回给客户端;
@RestController
如果需要为每一个方法添加ResponseBody的话,就显得非常麻烦,SpringMVC提供了@RestController注解,表示这是一个所有handler返回值全都是json的Controller,相当于把Controller和ResponseBody两个注解合并在一起;
例:
@RestControllerpublic class CourseController {.....}
接受json数据
SpringMVC可以帮助我们将json参数反序列化到指定的实体类型,List或Map;
需要强调的是: 客户端必须指定ContenType为application/json
@RequestMapping("/addCourse")@ResponseBodypublic Course addCourse(@RequestBody Course course) {//接收json参数映射到实体 course.setName("接收json成功");//修改name再把数据发回去 以便查看效果 return course;}@RequestMapping("/addCourses")@ResponseBodypublic List<Course> addCourse(@RequestBody List<Course> courses) {//接收json数组参数映射到list return courses;}@RequestMapping("/addData")@ResponseBodypublic Map<String,String> addData(@RequestBody Map<String,String> data) {//接收json数据映射到map return data;}@RequestMapping("/addInfo")@ResponseBodypublic String addInfo(@RequestBody String data) {//接收json数据不做任何转换 return data;}
当客户端传递的json比较复杂时可能无法直接转换到某个实体类型,这是我们可以通过Map来接收,或直接获取原始的json字符串自己处理; 就像上面的 addData 和 addInfo 一样
Handler拦截器
顾名思义Handler拦截器可对Handler方法进行拦截,控制Handler方法是否执行,与Servlet的过滤器非常相似
但是要注意:
Servlet的filter的执行时机是在SpringMVC之前,过滤的目标对象是请求;
而Handler拦截器,拦截的目标对象是Handler方法
Handler拦截器可以方便的实现,登录状态验证,操作权限验证等操作;
使用案例:
1.编写拦截器
public class MyInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { //在执行handler前调用 返回值将决定是否继续执行请求 System.out.println("preHandle"); return true; } @Override public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception { //handler被真正执行了,已经拿到了handler的返回结果 但是DispatcherServlet还没有发送给前台 System.out.println("postHandle"); } @Override public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception { //DispatcherServlet将视图发送给前台后的回调 (无论handler是否执行 一定有响应发给前台) System.out.println("afterCompletion"); //Handler中出现的任何异常也会传给该方法,可以在这里进行处理 if (ex != null){ System.out.println("handler中出现异常了...."); } }}
2.配置拦截器
<mvc:interceptors> <mvc:interceptor> <mvc:mapping path="/**"/> <bean class="com.kkb.interceptor.MyInterceptor"/> </mvc:interceptor></mvc:interceptors><!--* path用于指定拦截器拦截的url只有handler的url与之匹配才会被拦截 /** 表示拦截所有请求* interceptors中可配置多个interceptor -->
3.执行顺序
拦截器的执行顺序由配置顺序来决定,拦截器也和filter一样是一个链条的形式
在请求处理完成时,会按照相反的顺序通知interceptor(即执行afterComplation),前提是这个拦截器正常放行了请求(preHandler中返回了true),否则不会收到通知;
异常处理
一个完整的系统必然要考虑异常情况的处理,SpringMVC提供了一种非常方便的处理方法,只需要实现HandlerExceptionResolver接口,并注册Bean至容器中即可
1.编写异常处理器
@Componentpublic class MyExceptionHandler implements HandlerExceptionResolver { @Override public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) { ModelAndView modelAndView = new ModelAndView(); modelAndView.setViewName("error.jsp"); modelAndView.addObject("exobj",ex); return modelAndView; }}
可以看到在处理方法的返回值为ModelAndView,我们需要在其中添加错误页面的名称和错误信息;
2.注册到容器中
可以直接添加Component注解或是,在配置文件中注册
<bean class="com.kkb.exceptionhandler.MyExceptionHandler"/>
强调:无论是拦截器还是异常处理器都是针对handler而不是所有请求,举个例子如果请求本身就是错误的如404,是无法被异常Handler异常处理器处理的,仍需要到web.xml来进行配置