請求限制一些情況下我們可能需要對請求進行限制,比如僅允許POST,GET等... RequestMapping註解中提供了多個參數用於添加請求的限制條件 value 請求地址 path 請求地址 method 請求方法 headers 請求頭中必須包含指定欄位 params 必須包含某個請求參數 ...

請求限制

一些情況下我們可能需要對請求進行限制,比如僅允許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還提供了集合路徑和方法限制的註解,包括常見的請求方法:

PostMapping
GetMapping
DeleteMapping
PutMapping

例:
@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")
@ResponseBody
public List<Course> getCourseList() {  //獲取所有課程
    return courseService.selectCourses();
}
@RequestMapping("/getCourse")
@ResponseBody
public 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兩個註解合併在一起;

例:

@RestController
public class CourseController {.....}

接受json數據

SpringMVC可以幫助我們將json參數反序列化到指定的實體類型,List或Map;

需要強調的是:客戶端必須指定ContenType為application/json

@RequestMapping("/addCourse")
@ResponseBody
public Course addCourse(@RequestBody Course course) {//接收json參數映射到實體
    course.setName("接收json成功");//修改name再把數據發回去 以便查看效果
    return course;
}

@RequestMapping("/addCourses")
@ResponseBody
public List<Course> addCourse(@RequestBody List<Course> courses) {//接收json數組參數映射到list
    return courses;
}

@RequestMapping("/addData")
@ResponseBody
public Map<String,String> addData(@RequestBody Map<String,String> data) {//接收json數據映射到map
    return data;
}

@RequestMapping("/addInfo")
@ResponseBody
public 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.編寫異常處理器

@Component
public 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來進行配置

SpringMVC 進階