Spring MVC 请求头中 ContentType和DataType区别

一、Spring MVC 请求头中ContentType和DataType区别用途

1. dataType【通常在JQuery中使用】

  • 定义dataType 通常用于描述前端希望从服务器接收的数据格式。
  • 常见场景 :这是前端参数,通常在 jQuery.ajax 或其他前端框架中使用,告诉客户端如何解析服务器返回的数据。
  • 取值范围
    • json:期望接收到 JSON 格式数据。
    • xml:期望接收到 XML 格式数据。
    • html:期望接收到 HTML 文本。
    • text:期望接收到普通文本。
  • 作用
    • 决定客户端解析响应数据的方式。

    • 不会直接影响服务器的处理方式,而是客户端根据返回数据进行解析时的参考。

      $.ajax({
      url: '/api/getData',
      type: 'GET',
      dataType: 'json', // 告诉前端期望接收 JSON 格式
      success: function(data) {
      console.log(data);
      }
      });

2. contentType【Http请求和响应的内容类型】

  • 定义contentType 用于描述 HTTP 请求或响应的内容类型(MIME 类型)。
  • 常见场景
    • 在 HTTP 请求中,contentType 表示请求的正文格式。
    • 在 HTTP 响应中,contentType 表示服务器返回数据的格式。
  • 取值范围
    • 常见 MIME 类型:
      • application/json:表示 JSON 格式的数据。
      • application/xml:表示 XML 格式的数据。
      • text/html:表示 HTML 文本。
      • text/plain:表示普通文本。
      • multipart/form-data:表示文件上传表单格式。
  • 作用
    • 告诉服务器或客户端请求或响应的具体数据类型。
    • 决定了请求正文的解析方式(对于服务器来说)或内容展示方式(对于客户端来说)。
复制代码
  @PostMapping(value = "/submit", consumes = "application/json")
  public ResponseEntity<String> submit(@RequestBody MyObject obj) {
      // 处理 JSON 格式的请求体
      return ResponseEntity.ok("Success");
  }

  @GetMapping(value = "/data", produces = "application/json")
  public MyObject getData() {
      // 返回 JSON 格式的数据
      return new MyObject();
  }

二、SpringMVC @PostMapping@GetMapping 注解中 consumesproduces区别和用途

1. consumes 用途

  • 定义 :指定当前方法能够处理的 请求体Content-Type
  • 作用 :告诉 Spring MVC,这个方法只处理符合指定 Content-Type 的请求。如果请求的 Content-Type 不匹配,将返回 415 Unsupported Media Type 错误。
  • 常用场景
    • 用于 POST、PUT 或 PATCH 方法,这些方法通常需要处理请求体数据。
  • 取值
    • 通常指定为 MIME 类型,如:

      • application/json
      • application/xml
      • multipart/form-data(文件上传)

      @PostMapping(value = "/submit", consumes = "application/json")
      public ResponseEntity<String> submit(@RequestBody MyObject obj) {
      // 只能处理 Content-Type 为 application/json 的请求体
      return ResponseEntity.ok("Success");
      }

如果请求中不包含 Content-TypeContent-Type 不为 application/json,Spring MVC 会拒绝处理请求。

2. produces 用途

  • 定义 :指定当前方法返回的 响应体Content-Type
  • 作用 :告诉客户端,响应的媒体类型是什么。如果客户端无法接受该媒体类型(通过请求头中的 Accept 指定),可能会返回 406 Not Acceptable 错误。
  • 常用场景
    • 用于 GET 或其他返回数据的请求方法。
  • 取值
    • 通常指定为 MIME 类型,如:

      • application/json
      • application/xml
      • text/html

      @GetMapping(value = "/data", produces = "application/json")
      public MyObject getData() {
      // 返回的响应体会被设置为 Content-Type: application/json
      return new MyObject();
      }

如果客户端的 Accept 请求头中不包含 application/json,Spring MVC 可能会拒绝处理并返回 406 错误。

核心区别

属性 consumes produces
定义 请求的 Content-Type 响应的 Content-Type
适用场景 限制服务器能够接受的请求内容类型 限制服务器能够生成的响应内容类型
取值来源 对应请求头中的 Content-Type 对应请求头中的 Accept
错误响应 如果请求的 Content-Type 不匹配,返回 415 错误 如果请求的 Accept 不匹配,返回 406 错误
常用注解 @PostMapping@PutMapping @GetMapping@RequestMapping

总结

POST 请求可以使用 @PostMapping 中的 consumes 属性来限制接受的 请求内容类型 (Content-Type),当客户端发送的请求 Content-Type 不符合指定类型时,Spring 会返回 415 Unsupported Media Type 错误。

相关推荐
€81114 分钟前
Java入门级教程16——JUC的安全并发包机制
java·开发语言·juc的安全并发包机制·栅栏机制·闭锁机制·信号量机制·无锁机制
杨杨杨大侠15 分钟前
Atlas Mapper 教程系列 (2/10):环境搭建与项目初始化
java·开源·github
杨杨杨大侠24 分钟前
Atlas Mapper 教程系列 (1/10):框架概述与设计思路
java·开源·github
椰椰椰耶35 分钟前
[Spring Cloud][3]从零开始简单工程搭建实践详解,远程调用
java·数据库·spring cloud
兔子撩架构1 小时前
Akka Cluster的整体应用:系统管理的核心支撑
java·架构
毕设源码-李学长1 小时前
计算机毕业设计java高校多媒体教室管理系统高校多媒体教室综合管理系统高校智能多媒体教室管理平台
java·开发语言·课程设计
AAA修煤气灶刘哥1 小时前
从 Timer 到 XXL-Job,定时任务调度的 “进化史”,看完再也不怕漏跑任务~
java·后端·架构
Funcy1 小时前
XxlJob 源码分析04:admin与executor通讯
java
托比-马奎尔1 小时前
初识SpringBoot
java·spring boot·后端
前行的小黑炭2 小时前
Android :如何提升代码的扩展性,方便复制到其他项目不会粘合太多逻辑,增强你的实战经验。
android·java·kotlin