Spring?Boot中怎么使用Spring?MVC

本篇內(nèi)容主要講解“Spring Boot中怎么使用Spring MVC”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實(shí)用性強(qiáng)。下面就讓小編來帶大家學(xué)習(xí)“Spring Boot中怎么使用Spring MVC”吧!

1.MVC

MVC 是一種常見的軟件設(shè)計(jì)模式，用于分離應(yīng)用程序的不同部分以實(shí)現(xiàn)松散耦合和高內(nèi)聚性。MVC 模式由三個(gè)核心組件組成：

• 模型（Model）：表示應(yīng)用程序的數(shù)據(jù)和業(yè)務(wù)邏輯。模型處理應(yīng)用程序的數(shù)據(jù)，并根據(jù)控制器的指令執(zhí)行相應(yīng)的操作。

• 視圖（View）：提供模型數(shù)據(jù)的用戶界面。視圖通常是模板、HTML 頁面、XML 文件或其他格式，可以呈現(xiàn)模型數(shù)據(jù)給用戶。

• 控制器（Controller）：處理用戶交互并更新模型和視圖?？刂破髫?fù)責(zé)接收來自視圖的用戶輸入，對模型進(jìn)行相應(yīng)的操作，并更新視圖以反映更改。

MVC 模式的優(yōu)點(diǎn)是可以將代碼分離成三個(gè)獨(dú)立的組件，使得應(yīng)用程序更易于維護(hù)和擴(kuò)展。例如，如果要更改視圖的外觀，可以修改視圖而不影響模型和控制器；如果要更改數(shù)據(jù)存儲方式，可以修改模型而不影響視圖和控制器。同時(shí)，MVC 模式還有助于降低應(yīng)用程序中的耦合度，使得各組件更加獨(dú)立和可重用。

2.Spring MVC

在Spring體系下的MVC架構(gòu)中一次請求處理的流程如下：

請求到控制器（controller），經(jīng)過業(yè)務(wù)模型（model）處理后返回響應(yīng)給識圖層。

整個(gè)流程里面Spring MVC干了些啥：

整個(gè)Spring MVC的核心是DispatcherServlet，圍繞DispatcherServlet SpringMVC提供了一套組件配合DispatcherServlet完成整個(gè)工作流程。

DispatcherServlet 首先收到請求，將請求映射到對應(yīng)的處理器（controller）上，映射到controller的時(shí)候會觸發(fā)攔截器；處理器處理完后封裝數(shù)據(jù)模型，交給視圖解析器將數(shù)據(jù)模型解析為對應(yīng)的視圖返回給前端。

當(dāng)然有時(shí)候以上流程不會全部走完，比如使用@RestController或者@ResponseBody的時(shí)候由于直接返回響應(yīng)了，不會轉(zhuǎn)跳識圖，所以不會走視圖解析器。

3.Spring Boot中使用Spring MVC

3.1.配置

因?yàn)镾pring Boot自動裝配機(jī)制的存在，一般來說我們不需要對Spring MVC進(jìn)行配置，如果要進(jìn)行特別定制化的配置，Spring Boot也支持配置文件或者編寫代碼的兩種方式來進(jìn)行配置。

3.1.1.文件配置

# 啟用Spring MVC
spring.mvc.enabled=true

# 配置靜態(tài)資源路徑
spring.mvc.static-path-pattern=/static/**
spring.resources.static-locations=classpath:/static/

# 配置視圖解析器
spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

# 配置HTTP緩存
spring.resources.cache.period=3600

# 配置文件上傳
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

# 配置JSON序列化
spring.jackson.serialization.indent_output=true
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss

# 配置異常處理
server.error.whitelabel.enabled=false

# 配置攔截器
spring.mvc.interceptor.exclude-path-patterns=/login,/logout
spring.mvc.interceptor.include-path-patterns=/admin/**

# 配置會話管理
server.session.timeout=1800
server.session.cookie.max-age=1800

3.1.2.代碼配置

@Configuration
public class MyWebMvcConfig implements WebMvcConfigurer {
 
    // 配置視圖解析器
    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".jsp");
        registry.viewResolver(resolver);
    }
 
    // 配置靜態(tài)資源
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/static/**").addResourceLocations("/static/");
    }
 
    // 配置攔截器
    @Autowired
    private MyInterceptor myInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myInterceptor).addPathPatterns("/**");
    }
 
    // 配置消息轉(zhuǎn)換器
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter converter = new MappingJackson2HttpMessageConverter();
        List<MediaType> supportedMediaTypes = new ArrayList<MediaType>();
        supportedMediaTypes.add(MediaType.APPLICATION_JSON);
        converter.setSupportedMediaTypes(supportedMediaTypes);
        converters.add(converter);
    }
 
    // 配置異常處理器
    @ControllerAdvice
    public class GlobalExceptionHandler {
        @ExceptionHandler(value = Exception.class)
        public ModelAndView handleException(HttpServletRequest req, Exception e) {
            ModelAndView mav = new ModelAndView();
            mav.addObject("exception", e);
            mav.addObject("url", req.getRequestURL());
            mav.setViewName("error");
            return mav;
        }
    }
 
    // 配置跨域資源共享（CORS）
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/api/**").allowedOrigins("http://localhost:8080");
    }
 
    // 配置文件上傳
    @Bean
    public MultipartResolver multipartResolver() {
        CommonsMultipartResolver resolver = new CommonsMultipartResolver();
        resolver.setMaxUploadSize(10485760);
        resolver.setMaxInMemorySize(4096);
        return resolver;
    }
 
    // 配置請求緩存
    @Bean
    public KeyGenerator keyGenerator() {
        return new DefaultKeyGenerator();
    }
 
    @Bean
    public RequestCache requestCache() {
        return new HttpSessionRequestCache();
    }
 
    // 配置視圖控制器
    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("index");
        registry.addViewController("/login").setViewName("login");
    }
}

3.2.使用

3.2.1.映射處理器

這里只介紹@RequestMapping，@GETMapping和@PostMapping類似。

@Target({ElementType.TYPE, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Mapping
public @interface RequestMapping {
	
    String name() default "";
    
    @AliasFor("path")
    String[] value() default {};
	
    @AliasFor("value")
    String[] path() default {};
 
    RequestMethod[] method() default {};
 
    String[] params() default {};
 
    String[] headers() default {};
 
    String[] consumes() default {};
 
    String[] produces() default {};
}

各參數(shù)的作用如下：

• value和path：用于指定請求的URL路徑，可以使用占位符和正則表達(dá)式。

• method：指定HTTP請求方法，可以是GET、POST、PUT、DELETE等。

• params：指定請求參數(shù)的條件，支持表達(dá)式、多個(gè)參數(shù)和邏輯運(yùn)算。

• headers：指定請求頭的條件，支持表達(dá)式、多個(gè)頭和邏輯運(yùn)算。

• consumes：指定請求的MIME類型，用于限制請求內(nèi)容類型。

• produces：指定響應(yīng)的MIME類型，用于限制響應(yīng)內(nèi)容類型。

• name：指定請求參數(shù)的名稱，用于自動綁定參數(shù)值。

• defaultValue：指定請求參數(shù)的默認(rèn)值。

• pathVariable：用于綁定URL路徑中的占位符。

• required：指定請求參數(shù)是否為必須的。

• value、method、params、headers、consumes和produces屬性都支持?jǐn)?shù)組形式，可以匹配多個(gè)條件。

3.2.2.傳參

1.按參數(shù)名匹配

@Controller
@RequestMapping("/user")
public class UserController {
    
    @RequestMapping("/info")
    public String getUserInfo(Integer userId, Model model) {
        // 根據(jù)用戶ID查詢用戶信息并返回
        User user = userService.getUserById(userId);
        model.addAttribute("user", user);
        return "user_info";
    }
}

URL:

ip:port/info?userId=1

2.@RequestParam

通過@RequestParam注解可以指定匹配的參數(shù).

@Controller
@RequestMapping("/user")
public class UserController {
    
    @RequestMapping(value = "/search", method = RequestMethod.GET, params = "keyword")
    public String searchUser(@RequestParam("keyword") String keyword, Model model) {
        // 根據(jù)關(guān)鍵詞查詢用戶信息并返回
        List<User> userList = userService.searchUser(keyword);
        model.addAttribute("userList", userList);
        return "user_list";
    }
}

3.傳數(shù)組

@RequestMapping("/delete")
public String deleteUsers(int[] userIds, Model model) {
    // 根據(jù)用戶ID數(shù)組刪除多個(gè)用戶，并返回用戶列表頁面
    userService.deleteUsers(userIds);
    List<User> userList = userService.getUserList();
    model.addAttribute("userList", userList);
    return "user_list";
}

4.傳JSON

傳JSON只能用POST方法，使用@ResponseBody注解參數(shù)列表中的參數(shù)，就可以用來接收J(rèn)SON，如果被注解的參數(shù)是個(gè)對象那么會將JSON自動轉(zhuǎn)化為改對象。

@RequestMapping(value = "/save", method = RequestMethod.POST)
@ResponseBody
public Map<String, Object> saveUser(@RequestBody User user) {
    // 保存用戶信息，并返回成功的響應(yīng)
    userService.saveUser(user);
    return Collections.singletonMap("success", true);
}

注意傳參的時(shí)候要將設(shè)置好contentType: "application/json"

5.Restful

@Controller
@RequestMapping("/user")
public class UserController {
    
    @RequestMapping("/info/{id}")
    public String getUserInfo(@PathVariable("id") Integer userId, Model model) {
        // 根據(jù)用戶ID查詢用戶信息并返回
        User user = userService.getUserById(userId);
        model.addAttribute("user", user);
        return "user_info";
    }
}

前端URL為：

ip:port/info/1

3.2.3.參數(shù)轉(zhuǎn)換

當(dāng)后端接口的參數(shù)列表是對象類型時(shí)，Spring MVC會自動按照參數(shù)名完成參數(shù)的轉(zhuǎn)換和填充，當(dāng)然這種轉(zhuǎn)化規(guī)則也可以由我們自己定義，Spring MVC為我們準(zhǔn)備了轉(zhuǎn)換接口，以下是一個(gè)完整示例：

實(shí)體對象：

public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
    // 省略 getter 和 setter 方法
}

參數(shù)轉(zhuǎn)換器：

public class UserConverter implements Converter<String, User> {
 
    @Override
    public User convert(String source) {
        // 將請求參數(shù)解析為User對象
        String[] values = source.split(",");
        User user = new User();
        user.setId(Long.parseLong(values[0]));
        user.setName(values[1]);
        user.setAge(Integer.parseInt(values[2]));
        user.setEmail(values[3]);
        return user;
    }
}

注冊參數(shù)轉(zhuǎn)換器：

@Configuration
public class WebConfig implements WebMvcConfigurer {
 
    @Override
    public void addFormatters(FormatterRegistry registry) {
        registry.addConverter(new UserConverter());
    }
}

以后再傳對應(yīng)類型的參數(shù)時(shí)，會用我們自定義的轉(zhuǎn)換規(guī)則來進(jìn)行轉(zhuǎn)換：

@RequestMapping(value = "/save", method = RequestMethod.POST)
@ResponseBody
public Map<String, Object> saveUser(User user) {
    // 保存用戶信息，并返回成功的響應(yīng)
    userService.saveUser(user);
    return Collections.singletonMap("success", true);
}

3.2.4.數(shù)據(jù)校驗(yàn)

有時(shí)候我們希望前端傳過來的參數(shù)是滿足一定格式的，Spring MVC也考慮到了這一點(diǎn)，為我們提供了基于注解的參數(shù)校驗(yàn)功能。

public class User {
    @NotNull(message = "id不能為空")
    private Long id;
 
    @NotBlank(message = "name不能為空")
    private String name;
 
    @Min(value = 0, message = "age不能小于0")
    @Max(value = 150, message = "age不能大于150")
    private Integer age;
 
    @Email(message = "email格式不正確")
    private String email;
 
    // 省略 getter 和 setter 方法
}

只是使用了注解，校驗(yàn)并不會生效，還需要在想要進(jìn)行校驗(yàn)的地方配上@Validated開啟校驗(yàn)：

public class User {
    @NotNull(message = "id不能為空")
    private Long id;
 
    @NotBlank(message = "name不能為空")
    private String name;
 
    @Min(value = 0, message = "age不能小于0")
    @Max(value = 150, message = "age不能大于150")
    private Integer age;
 
    @Email(message = "email格式不正確")
    private String email;
 
    // 省略 getter 和 setter 方法
}

3.2.5.數(shù)據(jù)模型

Spring MVC 中的數(shù)據(jù)模型用于在處理器方法（Controller）和視圖之間傳遞數(shù)，有三種：

• Model

• ModelMap

• ModelAndView

Model：

只能承載參數(shù)

@GetMapping("/hello")
public String hello(Model model) {
    model.addAttribute("message", "Hello, world!");
    return "hello";
}

ModelMap:

和Model功能相似。

@GetMapping("/hello")
public String hello(ModelMap model) {
    model.put("message", "Hello, world!");
    return "hello";
}

ModelAndView:

既能承載參數(shù)也能承載視圖名。

@GetMapping("/hello")
public ModelAndView hello() {
    ModelAndView mav = new ModelAndView("hello");
    mav.addObject("message", "Hello, world!");
    return mav;
}

3.2.6.視圖和解析器

1.視圖

Spring MVC的視圖可以理解為最終返給前端的東西，分為兩類：

• 邏輯視圖

• 非邏輯視圖

邏輯視圖：

邏輯視圖是指一個(gè)字符串，它代表了一個(gè)視圖的邏輯名稱，與實(shí)際的視圖實(shí)現(xiàn)解耦合，而是通過視圖解析器將其映射為實(shí)際的視圖。在 Spring MVC 中，處理器方法可以返回邏輯視圖名，由 DispatcherServlet 根據(jù)視圖解析器的配置，將其映射為實(shí)際的視圖。

常用的邏輯視圖包括：

• JSP 視圖：使用 InternalResourceViewResolver 視圖解析器，將邏輯視圖名映射為 JSP 文件名。

• Velocity 視圖：使用 VelocityViewResolver 視圖解析器，將邏輯視圖名映射為 Velocity 模板文件名。

• Thymeleaf 視圖：使用 ThymeleafViewResolver 視圖解析器，將邏輯視圖名映射為 Thymeleaf 模板文件名。

非邏輯視圖：

非邏輯視圖是指一個(gè)具體的視圖實(shí)現(xiàn)，通常是一個(gè)視圖類或者一個(gè) RESTful Web Service。在處理器方法中，可以直接返回一個(gè)非邏輯視圖，它會被直接渲染，而不需要通過視圖解析器進(jìn)行轉(zhuǎn)換。

常用的非邏輯視圖包括：

• JSON 視圖：使用 MappingJackson2JsonView 視圖實(shí)現(xiàn)，將模型數(shù)據(jù)轉(zhuǎn)換為 JSON 格式返回給客戶端。

• XML 視圖：使用 MappingJackson2XmlView 視圖實(shí)現(xiàn)，將模型數(shù)據(jù)轉(zhuǎn)換為 XML 格式返回給客戶端。

• PDF 視圖：使用 iText PDF 庫和 AbstractPdfView 視圖實(shí)現(xiàn)，將模型數(shù)據(jù)轉(zhuǎn)換為 PDF 格式返回給客戶端。

需要注意的是，非邏輯視圖通常需要進(jìn)行額外的配置和處理，比如 JSON 視圖需要添加 Jackson 依賴庫，并在 Spring 配置文件中配置 MappingJackson2JsonView 視圖解析器。

2.視圖解析器

視圖解析器決定@Controller的return具體映射到什么類型的視圖上，默認(rèn)是使用InternalResourceViewResolver視圖解析器，也就是JSP視圖解析器，當(dāng)我們配置好前綴、后綴后，它會自動將@Controller的return映射到對應(yīng)的jsp上去。

spring.mvc.view.prefix=/WEB-INF/views/
spring.mvc.view.suffix=.jsp

當(dāng)然在Spring Boot中也支持我們切換視圖解析器，以下是切換為JSON視圖解析器的示例，切換為JSON視圖解析器后return會直接返回JSON給前端：

@Configuration
@EnableWebMvc
public class AppConfig implements WebMvcConfigurer {
 
    @Bean
    public ViewResolver viewResolver() {
        InternalResourceViewResolver resolver = new InternalResourceViewResolver();
        resolver.setPrefix("/WEB-INF/views/");
        resolver.setSuffix(".jsp");
        return resolver;
    }
}

3.2.7.攔截器

Spring Boot中使用自定義Spring MVC攔截器鏈的代碼如下：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new FirstInterceptor());
        registry.addInterceptor(new SecondInterceptor());
    }
}
 
public class FirstInterceptor implements HandlerInterceptor {
 
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception {
        // 在處理器處理請求之前執(zhí)行
        return true;
    }
 
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
            ModelAndView modelAndView) throws Exception {
        // 在處理器處理請求之后，渲染視圖之前執(zhí)行
    }
 
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,
            Exception ex) throws Exception {
        // 在渲染視圖之后執(zhí)行
    }
}
 
public class SecondInterceptor implements HandlerInterceptor {
 
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
            throws Exception {
        // 在處理器處理請求之前執(zhí)行
        return true;
    }
 
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
            ModelAndView modelAndView) throws Exception {
        // 在處理器處理請求之后，渲染視圖之前執(zhí)行
    }
 
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,
            Exception ex) throws Exception {
        // 在渲染視圖之后執(zhí)行
    }
}

到此，相信大家對“Spring Boot中怎么使用Spring MVC”有了更深的了解，不妨來實(shí)際操作一番吧！這里是億速云網(wǎng)站，更多相關(guān)內(nèi)容可以進(jìn)入相關(guān)頻道進(jìn)行查詢，關(guān)注我們，繼續(xù)學(xué)習(xí)！