一:Springmvc簡介
1.簡介:
Spring Web MVC 是基于Servlet API構建的原始Web框架,從一開始就包含在Spring Framework中。正式名稱“Spring Web MVC” 來自其源模塊名稱(spring-webmvc)但它通常被稱為“Spring Mvc”
在控制層框架歷經 Strust ,WebWork,Strust2等諸多產品的歷代更迭之后,目前業界普遍選擇了Spring MVC 作為JavaEE 項目表述層開發的首先方案。
優勢:
》Spring 家族的原生產品,與IOC容器等基礎設施無縫對接
》表述層各細分領域需要解決的問題全方位覆蓋,提供全面解決方案
》代碼清新簡潔,大幅度提升開發效率
》 內部組件化程度高,可插拔式組件即插即用,想要什么功能配置相應組件即可
》性能卓著,尤其適合現代大型/超大型互聯網項目要求
2.作用:
3.核心組件:
1.DispatcherServlet:SpringMVC提供,我們需要使用web.xml配置使其生效,它式整個流程處理的核心,所有請求都經過它的處理和分發
2.HandlerMapping:SpringMVC提供,我們需要進行Ioc配置使其假如Ioc容器方可生效,它內部緩存handler和handler訪問路徑數據,被DispatcherServlet調用,用于查找路徑對應的handler!
3.HandlerAdapter:SpringMVC提供,我們需要進行Ioc配置使其假如Ioc容器方可生效,它可以
處理請求參數和處理響應數據,每次DispatcherServlet都是通過HandlerAdapter間接調用handler,它是handler和DispatcherServlet之間的適配器
4.Handler:handler又稱為處理器,它是Controller類內部方法的簡稱,是由我們自己定義,用來接收參數,向后調用業務,最終返回響應結果!
5.ViewResovler: SpringMVC提供,我們需要進行Ioc配置使其假如Ioc容器方可生效,視圖解析器主要作用簡化模板視圖頁面查找的,但是需要注意,前后端分離項目,后端只返回JSON數據,不返回界面,那就不需要視圖解析器,相對其他組件不是必須的。
二:快速入門程序
步驟1:創建項目并導入依賴:
<dependency><groupId>jakarta.platform</groupId><artifactId>jakarta.jakartaee-web-api</artifactId><version>9.1.0</version> </dependency> <dependency><groupId>org.springframework</groupId><artifactId>spring-context</artifactId><version>6.0.6</version> </dependency><dependency><groupId>org.springframework</groupId><artifactId>spring-webmvc</artifactId><version>6.0.6</version> </dependency>
步驟2:創建控制層處理器并添加注解
@Controllerpublic class HelloHandler {@RequestMapping("spring/hello")//配置訪問路徑@ResponseBody //返回前端字符串,不調用視圖解析器public String hello(){System.out.println("hello handler");return "hello springmvc";} }
步驟3:創建配置類
@Configuration @ComponentScan("com.cn.handler") public class MyConfig {@Beanpublic RequestMappingHandlerMapping getRequestMapping(){RequestMappingHandlerMapping requestMappingHandlerMapping = new RequestMappingHandlerMapping();return requestMappingHandlerMapping;}@Beanpublic RequestMappingHandlerAdapter getRequestMappingHandlerAdapter(){RequestMappingHandlerAdapter requestMappingHandlerAdapter = new RequestMappingHandlerAdapter();return requestMappingHandlerAdapter;}}
步驟4:加載配置類并初始化容器
package com.cn.config;import org.springframework.web.WebApplicationInitializer; import org.springframework.web.server.adapter.AbstractReactiveWebInitializer; import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;public class SpringMvcInit extends AbstractAnnotationConfigDispatcherServletInitializer {@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}//指定配置類@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{MyConfig.class};}//設置DispatcherServlet的處理路徑,一般情況下 /代表處理所有請求@Overrideprotected String[] getServletMappings() {return new String[]{"/"};} }
步驟5:工程設置為web工程,并部署到tomcat(10.0以上版本)
1. 工程右鍵-選擇JBLJavaToWeb 把工程設置為web工程
2.把工程部署到tomcat,并重啟服務
3.瀏覽器地址輸入:http://localhost:8080/spring/hello
4.瀏覽器顯示:hello springmvc 表示程序運行成功
三:Spring MVC接收數據
1.訪問路徑設置:
@RequestMapping注解的作用就是將請求的URL地址和處理請求的方式(handler 方法)關聯起來,建立映射關系。
SpringMVC接收到指定的請求,就會來找到在映射關系中對應的方法來處理這個請求。@RequestMapping(不用必須使用/開頭) user/login??
1.精準地址【1個|多個】/user/login? ? {"地址1","地址2"}
2.支持模糊 * 任意一層字符串| **任意層任意字符串
? ?/user/* ->? /user/a? user/aaaa 可以, /user/a/b 不行
?/user/** ->? /user/a? ?/user/a/a/a/a
3.類上和方法上添加@RequestMapping的區別
? 類上提取通用的訪問地址
? 方法上時具體的handler地址
訪問: 類地址+方法地址即可
4.請求方式指定
?客戶端-> http(get|post|put|delete)->ds->handler
默認情況:@RequestMapping("login")主要地址正確,任何請求方式都可以訪問
指定請求方式:method={RequestMethod.GET,RequestMethod.POST}
不符合請求方式:會出現405異常!
5注解進階:
get @GetMapping ==@RequestMapping(xxx,method=GET);
post@PostMapping ==@RequestMapping(xxx,method=POST);
put@PUTMapping ==@RequestMapping(xxx,method=PUT);
delete@DeleteMapping ==@RequestMapping(xxx,method=DELETE);
2.參數接收:
2.1 param和json參數比較
在http請求中,我們可以選擇不同的參數類型,如 param 類型和JSon類型。下面對這兩種參數類型進行區別和對比:
1.參數編碼:
?param 類型的參數被編碼為ASCII碼。JSON類型會被編碼為UTF-8
2.參數順序:
param類型的參數沒有順序限制。但是,JSON類型的參數是有序的。JSON采用鍵值對的形式進行傳遞,其中鍵值對是有序排列的
3.數據類型:
param類型的參數僅支持字符串類型,數值類型和布爾類型等簡單數據類型。而JSON類型的參數則支持更復雜的數據類型,如數組,對象等。
4.嵌套性:
param類型的參數不支持嵌套。但是,JSON類型的參數支持嵌套,可以傳遞更為復雜的數據結構。
5.可讀性:
param 類型的參數格式比JSON類型的參數更加簡單,易讀。但是JSON格式在傳遞嵌套數據結構時更加清晰易懂。
總的來說,param類型的參數適用于單一的數據傳遞,而JSON類型的參數則更適用于更復雜的數據結構傳遞。根據具體的業務需求,需要選擇合適的參數類型。在實際開發中,常見的做法是:在GET請求中采用param類型的參數,而在POST請求中采用JSON類型的參數傳遞。
2.2 param接收參數:
@Controller @RequestMapping("user") public class MyHandler {/** 1 直接接收* /user/login?name=root&age=18* 形參列表,填寫對應名稱的參數即可!請求參數名=形參參數名即可!* 1)名稱相同* 2)可以不傳遞,不報錯** */@RequestMapping("/login")@ResponseBodypublic String login(String name,int age){System.out.println("name = " + name + ", age = " + age);return "name = " + name + ", age = " + age;}/** 2 注解指定* 指定任意的請求參數名,要求必須傳遞 ,要求不必須傳遞,給一個默認值* /user/login?account=root&age=18* account必須傳遞 ,page可以必須傳遞,如果不傳遞默認值就是1@RequestParam-> 形參列表 指定請求參數名 或者是否必須傳遞,或者非必須傳遞設置默認值用法:@RequestParam(value="指定請求參數名,如果形參名和請求參數名一致,可以省略!",required=false 前端是否必須傳遞此參數,默認是必須,不傳400異常!,* defaultValue="1" 當非必須傳遞false,可以設置默認值)** */@RequestMapping("/login2")@ResponseBodypublic String login2(@RequestParam("account")String name, @RequestParam(required = false,defaultValue = "10") int age){System.out.println("name = " + name + ", age = " + age);return "name = " + name + ", age = " + age;}/** 3 特殊值* /user/login3?hbs=吃&hbs=喝* 不加注解@RequestParam 將hbs對應的一個字符串直接賦值給集合! 類型異常!* 加了注解,會將集合加入對應的字符串* */@RequestMapping("/login3")@ResponseBodypublic String login3(@RequestParam List<String> hbs){System.out.println(hbs);return hbs.toString();}/** 4 使用實體對象接值* /user/login4?name=tom&age=10 準備一個對應屬性和get|set 方法的實體類即可,* 形參列表聲明對象參數即可!* */@RequestMapping("/login4")@ResponseBodypublic String login3(User user){System.out.println("name = " + user.getName() + ", age = " + user.getAge());return "name = " + user.getName() + ", age = " + user.getAge();}}
2.3?路徑傳參:
@Controller @RequestMapping("path") @ResponseBody public class PathHandler {// path/用戶名/密碼//動態路徑設計{key}//必須使用 注解@PathVariable@RequestMapping("{name}/{password}")public String hello(@PathVariable String name , @PathVariable String password){System.out.println("name = " + name + ", password = " + password);return "name = " + name + ", password = " + password;} }
2.4 JSON數據接收(重點):
前端傳遞JSON數據時,SpringMVC 框架可以使用@RequestBody 注解 來將JSON
數據轉換為Java對象,@RequestBody 注解表示當前方法參數的值應該從請求體中獲取,并且需要指定value 屬性來指示請求體應該映射到哪個參數上,其使用方式和示類代碼如下:
步驟1 .前端發送JSON數據(使用postman)
{"name":"zhangsan","age":18,"gender":"男"}
步驟2.定義一個用于接收JSON數據的Java 類
@Data public class Person {private String name;private int age;private String gender; }
步驟3.在控制器中使用@RequestBody注解來接收JSON數據,并將器轉換為Java對象:
@Controller
@RequestMapping("json")
@ResponseBody
public class JsonHandler {@PostMapping("data")
public String data(@RequestBody Person person){System.out.println("person = " + person);return person.toString();}}
步驟4:添加JSON解析依賴:
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.15.0</version> </dependency>
步驟5:在配置類添加注解:@EnableWebMvc,給SpringMVC HandlerAdpater配置JSON轉換器
@EnableWebMvc @Configuration @ComponentScan("com.cn.json") public class MyConfig {}
步驟6:測試并查看響應數據:
Person(name=zhangsan,?age=18,?gender=nan)
2.5?cookie和Header接收:
1.使用@CookieValue 注解獲取cookie數據
存取cookie
@GetMapping("save") public String save(HttpServletResponse httpResponse){Cookie cookie = new Cookie("cookieName","cookieValue");httpResponse.addCookie(cookie);return "ok"; }
獲取cookie
@RequestMapping("data") public String data(@CookieValue(name="cookieName") String value){System.out.println("value = " + value);return value; }
2.使用注解@RequestHeader 獲取header信息
@Controller @ResponseBody @RequestMapping("header") public class HeaderController {@GetMapping("data")public String data(@RequestHeader(value = "Host") String host){System.out.println("host = " + host);return host;}}
2.6?接收數據總結:
四:Spring MVC響應數據
1.開發模式介紹:
在Web開發中,有兩種主要的開發模式:前后端分離和混合開發
前后端分離模式(重點)
指將前端的界面和后端的業務邏輯通過接口分離開發的一種方式。開發人員使用不同的
技術和框架,前端開發人員主要負責界面的呈現和用戶交互,后端開發人員主要
負責業務邏輯和數據存儲。前后端通信通過API接口完成,數據格式一般使用JSON
或XML。前后端分離模式可以提高開發效率,同時也有助于代碼重用和維護。
混合開發模式:
指將前端和后端的代碼集成在同一個項目中,共享相同的技術棧和框架。這種模式在
小型項目中比較常見,可以減少學習成本和部署難度。但是,在大型項目中,這種模式
會導致代碼耦合性很高,維護和升級難度較大。
2.快速返回邏輯視圖:
1.創建項目并添加依賴:
<dependency><groupId>jakarta.servlet.jsp.jstl</groupId><artifactId>jakarta.servlet.jsp.jstl-api</artifactId><version>3.0.0</version> </dependency>
2. 在WEB-INF下創建視圖目錄和jsp文件:
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head><title>Title</title> </head> <body><font color="red">${data}</font> </body> </html>
3. 在配置類下配置視圖解析器
@Configuration @ComponentScan("com.cn.controller") @EnableWebMvc public class Myconfig implements WebMvcConfigurer { // 視圖解析器,指定前后綴 public void configureViewResolvers(ViewResolverRegistry registry) {registry.jsp("/WEB-INF/views/",".jsp");}}
4.創建handler
@Controller @RequestMapping("jsp") public class JspHandler {/** 快速查找視圖方法* 1.方法的返回值是字符串類型* 2.不能添加ResponseBody,直接返回字符串給瀏覽器,不找視圖,不走視圖解析器* 3.返回值 對應中間的視圖名稱即可* */@GetMapping("index")public String data(HttpServletRequest request){request.setAttribute("data","hello jsp!");return "index";} }
5.創建初始化接口
import com.cn.config.Myconfig; import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;public class SpringMvcInit extends AbstractAnnotationConfigDispatcherServletInitializer {@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{Myconfig.class};}@Overrideprotected String[] getServletMappings() {return new String[]{"/"};} }
6.轉換為web項目部署到服務器 并測試:
瀏覽器輸入:http://localhost:8080/jsp/index
3.轉發重定向:
@Controller @RequestMapping("jsp") public class JspHandler {/** 快速查找視圖方法* 1.方法的返回值是字符串類型* 2.不能添加ResponseBody,直接返回字符串給瀏覽器,不找視圖,不走視圖解析器* 3.返回值 對應中間的視圖名稱即可*** */@GetMapping("index")public String data(HttpServletRequest request){request.setAttribute("data","hello jsp!");return "index";}/** 轉發:只能是項目下的資源* 1.方法的返回值寫成字符串* 2.不能添加ResponseBody注解* 3.返回的字符串前 forward:+/轉發地址** */@GetMapping("forward")public String forward(){System.out.println("jsp forward");return "forward:/jsp/index";}/** 重定向:即可以是項目下的資源,也可以是項目外的資源* 1.方法的返回值寫成字符串* 2.不能添加ResponseBody注解* 3.返回的字符串前 redirect:+/轉發地址** */@GetMapping("redirect")public String redirect(){System.out.println("jsp redirect");return "redirect:/jsp/index";}@GetMapping("redirect/baidu")public String redirectbaidu(){System.out.println("jsp redirect");return "redirect:http://www.baidu.com";}}
4.返回JSON數據(重點):
步驟1:新建項目并導入依賴:
<dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.15.0</version> </dependency>
步驟2:創建配置類
@Configuration @ComponentScan("com.cn.handler") @EnableWebMvc public class MyConfig { }
步驟3:創建SpringMvc初始化類
package com.cn.init;import com.cn.config.MyConfig; import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;public class SpringMvcInit extends AbstractAnnotationConfigDispatcherServletInitializer {@Overrideprotected Class<?>[] getRootConfigClasses() {return new Class[0];}@Overrideprotected Class<?>[] getServletConfigClasses() {return new Class[]{MyConfig.class};}@Overrideprotected String[] getServletMappings() {return new String[]{"/"};} }
步驟4:創建 返回的json對應的實體類
import lombok.Data;@Data public class User {private String name;private String gender;private int age; }
步驟5:創建Handler
@Controller @RequestMapping("json") @ResponseBody//返回json的注解,不找視圖 public class JsonHandler {//返回單個實體類的json數據@GetMapping("data")public User data(){User user =new User();user.setName("zhangsan");user.setAge(18);user.setGender("man");return user;}//返回集合對應的json數據@GetMapping("data2")public List<User> data2(){List<User> list =new ArrayList<>();User user1 =new User();user1.setName("zhangsan");user1.setAge(18);user1.setGender("man");User user2 =new User();user2.setName("lisi");user2.setAge(20);user2.setGender("woman");list.add(user1);list.add(user2);return list;} }
步驟6:部署并測試:
瀏覽器輸入地址:http://localhost:8080/json/data
返回結果:
{"name":"zhangsan","gender":"man","age":18}
瀏覽器輸入地址:http://localhost:8080/json/data2
[{"name":"zhangsan","gender":"man","age":18},{"name":"lisi","gender":"woman","age":20}]
5.訪問靜態資源:
在配置類中重寫方法,開啟靜態資源查找
@Configuration @ComponentScan("com.cn.handler") @EnableWebMvc public class MyConfig implements WebMvcConfigurer {/*開啟靜態資源查找dispatcherServlet->handlerMapping 找有沒有對應的handler->沒有,找有沒有靜態資源* */@Overridepublic void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {configurer.enable();} }
五:其他擴展功能
1.restful 介紹和理解:
1)簡介:
2)設計規范:
3)實戰
1.需求
2.設計
3.實現:
package com.cn.controller;import com.cn.pojo.User; import org.springframework.web.bind.annotation.*;import java.util.List;@RestController @RequestMapping("user") public class UserController {//分頁查詢@GetMappingpublic List<User> page(@RequestParam(required = false,defaultValue = "1") int page ,@RequestParam(required = false,defaultValue = "10") int size){return null;}//用戶添加 @PostMappingpublic User save(@RequestBody User user){return user;}//用戶詳情@GetMapping("{id}")public User detail(@PathVariable int id){return null;}//用戶更新@PutMapping()public User update(@RequestBody User user){return user;}//用戶刪除 @DeleteMapping("{id}")public int delete(@PathVariable int id){return 0; }//用戶模糊 public List<User> search(String keyword,@RequestParam(required = false,defaultValue = "1") int page,@RequestParam(required = false,defaultValue = "10") int size){return null;} }
2.全局處理異常:
1.異常處理的方式:
2全局異常處理步驟:
步驟1:聲明全局異常處理類并添加注解@RestControllerAdvice
步驟2:在該類中通過添加注解@ExceptionHandler(指定異常.class) 聲明handler方法,處理異常
步驟3:在配置類中掃描類中把該包加進去
3.實戰:
1)產生異常的handler
@RestController @RequestMapping("user") public class UserHandler {@GetMapping("data")public String data(){String s1=null;int length = s1.length();//java.lang.NullPointerExceptionreturn "ok";}@GetMapping("data1")public String data1(){int i= 10/0;// java.lang.ArithmeticException: / by zeroreturn "ok2";}}
2)全局處理異常的類
package com.cn.excption;import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler;@RestControllerAdvice public class GlobelExceptionHandler { // 發生異常->ControllerAdvice 注解的類型-》 @ExceptionHandler(指定異常類型)-》handler@ExceptionHandler(NullPointerException.class)public Object PowerPointHandler(NullPointerException e){String message = e.getMessage();return message;}@ExceptionHandler(Exception.class)public Object OtherHandler(Exception e){String message = e.getMessage();return message;} }
3)把異常處理類添加到配置類掃描中,初始化類省略(SpringMvcInit)
@Configuration @ComponentScan({"com.cn.handler","com.cn.excption"}) @EnableWebMvc public class Myconfig { }
3.攔截器:
1.攔截器和過濾器區別:
2.攔截器使用:
步驟1:創建攔截器:
public class MyInterceptor implements HandlerInterceptor {@Override//在處理請求的目標handler方法前執行//一般用于編碼格式設置,登錄保護,權限處理public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {System.out.println("preHandle------------------");//返回true 放行,返回false:不放行return true;}@Override//在目標handler方法之后,handler報錯不執行!//此方法只有在preHandle返回true后才執行, 對結果處理,敏感詞匯檢查 public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {System.out.println("postHandle------------------");}@Override//渲染視圖之后執行,一定執行public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {System.out.println("afterCompletion------------------");} }
步驟2:在配置類中開啟攔截器,并設置攔截路徑
@Configuration @ComponentScan("com.cn.handler") @EnableWebMvc public class MyConfig implements WebMvcConfigurer {@Override//開啟攔截器public void addInterceptors(InterceptorRegistry registry) {//攔截所有// registry.addInterceptor(new MyInterceptor());//攔截指定地址registry.addInterceptor(new MyInterceptor()).addPathPatterns("/user/data1");} }
4.參數校驗注解jsr303:
1.校驗概述:
jsr303 是java為Bean數據合法性校驗提供的標準框架,他已經包含在JAVAEE6.0標準中,jsr303通過在Bean屬性上標注類似于@NotNull,@Max等標準的注解指定校驗規則,并通過標準的接口對Bean進行驗證。
2.校驗實現:
步驟1:導入jar包
<dependency><groupId>org.hibernate.validator</groupId><artifactId>hibernate-validator</artifactId><version>8.0.0.Final</version></dependency><dependency><groupId>org.hibernate</groupId><artifactId>hibernate-validator-annotation-processor</artifactId><version>8.0.0.Final</version></dependency> </dependencies>
步驟2:在實體類添加校驗注解
@Data public class User {/*1.name 不為null和空字符串字符串@NotBlank 集合@NotEmpty 包裝類@NotNull2.password長度大于63.age必須》=14.email 郵件格式的字符串5.birthday過去實際*** */@NotBlankprivate String name;@Length(min = 6)private String password;@Min(1)private int age;@Emailprivate String email;@Pastprivate Date birthday; }
步驟3:handler 添加注解@Validated,如果自定義返回異常,添加BindingResult,獲取錯誤信息
@RestController @RequestMapping("user") public class RegisterHandler {/** 步驟1:實體類添加校驗注解* 步驟2:handler(@Validated 實體類 對象)* 細節:param|json校驗都有效果* json參數-@RequestBody* 如果不符合校驗規則,直接向前端拋出異常* 接收綁定錯誤信息,自定義返回結果,約定參數錯誤-》{code:400}** 捕捉綁定信息* 1.handler(校驗對象,BindingResult result)要求:BindingResult必須緊挨著校驗對象* 2.BindingResult獲取綁定錯誤** */@PostMapping("register")public Object register(@Validated @RequestBody User user){// 自定義返回異常代碼 // public Object register(@Validated @RequestBody User user, BindingResult result){ // if(result.hasErrors()){ // Map map = new HashMap(); // map.put("code",400); // map.put("msg","參數校驗異常"); // return map; // // }return user;} }
步驟4:測試
1)正常情況:
2)自定義異常: