請求限制
一些情況下我們可能需要對請求進行限制,比如僅允許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返回值為檢視和資料的包裝型別,用於返回邏輯檢視名稱和檢視需要展示的資料
例:
@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.配置攔截器
攔截器的執行順序由配置順序來決定,攔截器也和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來進行配置
文末福利: