快捷導(dǎo)航

Spring MVC 響應(yīng)機(jī)制綜合實(shí)踐之頁面、數(shù)據(jù)、JSON 與響應(yīng)配置處理方法

更新時間：2026年01月28日 08:59:49 作者：yangminlei

SpringMVC的響應(yīng)機(jī)制包括返回視圖、純文本/HTML、JSON、響應(yīng)頭與狀態(tài)碼控制、重定向與轉(zhuǎn)發(fā)、全局響應(yīng)配置、CORS跨域配置、異常處理與錯誤響應(yīng),這篇文章給大家介紹Spring MVC 響應(yīng)機(jī)制綜合實(shí)踐：頁面、數(shù)據(jù)、JSON 與響應(yīng)配置,感興趣的朋友跟隨小編一起看看吧

Spring MVC 響應(yīng)機(jī)制的核心方式

返回視圖（頁面渲染）
通過返回視圖名稱（如 return "home"），配合視圖解析器（InternalResourceViewResolver）定位到 /WEB-INF/views/home.jsp 等具體頁面。需在配置中定義視圖前綴和后綴：

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

返回純文本或HTML
使用 @ResponseBody 注解直接返回字符串內(nèi)容，適用于簡單文本或HTML片段：

@GetMapping("/text")
@ResponseBody
public String rawText() {
    return "<h1>Hello World</h1>";
}

JSON 響應(yīng)處理

自動序列化對象為JSON
結(jié)合 @RestController 或 @ResponseBody，Spring 默認(rèn)使用 Jackson 將對象序列化為 JSON：

@GetMapping("/user")
public User getUser() {
    return new User("Alice", 25);
}

需添加 Jackson 依賴（如 spring-boot-starter-json）。

定制JSON字段
通過 @JsonIgnore 忽略字段，@JsonProperty 重命名字段：

public class User {
    @JsonProperty("username")
    private String name;
    @JsonIgnore
    private String password;
}

響應(yīng)頭與狀態(tài)碼控制

手動設(shè)置狀態(tài)碼
使用 ResponseEntity 自定義狀態(tài)碼和響應(yīng)頭：

@GetMapping("/custom")
public ResponseEntity<String> customResponse() {
    HttpHeaders headers = new HttpHeaders();
    headers.add("X-Custom-Header", "value");
    return new ResponseEntity<>("Custom Body", headers, HttpStatus.CREATED);
}

重定向與轉(zhuǎn)發(fā)
通過 redirect: 前綴實(shí)現(xiàn)重定向，或返回 ModelAndView 進(jìn)行轉(zhuǎn)發(fā)：

@GetMapping("/redirect")
public String redirect() {
    return "redirect:/new-url";
}

全局響應(yīng)配置

統(tǒng)一響應(yīng)格式
使用 @ControllerAdvice 定義全局響應(yīng)封裝：

@ControllerAdvice
public class GlobalResponseHandler implements ResponseBodyAdvice<Object> {
    @Override
    public boolean supports(MethodParameter returnType, Class<? extends HttpMessageConverter<?>> converterType) {
        return true;
    }
    @Override
    public Object beforeBodyWrite(Object body, MethodParameter returnType, MediaType selectedContentType, 
                                  Class<? extends HttpMessageConverter<?>> selectedConverterType, 
                                  ServerHttpRequest request, ServerHttpResponse response) {
        return new ResponseWrapper<>(200, "success", body);
    }
}

CORS 跨域配置
在配置類中全局啟用 CORS：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/api/**")
                .allowedOrigins("*")
                .allowedMethods("GET", "POST");
    }
}

異常處理與錯誤響應(yīng)

統(tǒng)一異常處理
通過 @ExceptionHandler 捕獲異常并返回結(jié)構(gòu)化錯誤信息：

@ControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleException(Exception ex) {
        ErrorResponse error = new ErrorResponse(500, ex.getMessage());
        return ResponseEntity.status(500).body(error);
    }
}

自定義錯誤頁面
配置 ErrorViewResolver 或定義 /error 映射：

@Controller
public class ErrorController implements ErrorController {
    @RequestMapping("/error")
    public String handleError(HttpServletRequest request) {
        Integer status = (Integer) request.getAttribute("javax.servlet.error.status_code");
        return status == 404 ? "error-404" : "error-general";
    }
}

到此這篇關(guān)于Spring MVC 響應(yīng)機(jī)制綜合實(shí)踐之頁面、數(shù)據(jù)、JSON 與響應(yīng)配置處理方法的文章就介紹到這了,更多相關(guān)Spring MVC 響應(yīng)機(jī)制內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: