下面是各个 MediaType
常量的详细用途和使用场景的表格,并且包含了具体的例子说明:
MediaType 常量 | MIME 类型字符串 | 用途 | 使用场景 | 例子 |
---|---|---|---|---|
ALL | */* | 表示任意类型的媒体 | 处理任何类型的 HTTP 请求或响应时使用 | 处理任何类型的文件上传或下载,接受任何内容类型的响应 |
APPLICATION_ATOM_XML | application/atom+xml | 表示 Atom XML 类型的应用程序 | 处理 Atom 格式的 XML 数据(如 RSS 订阅源) | 获取 Atom 格式的 RSS 订阅源内容 |
APPLICATION_CBOR | application/cbor | 表示 CBOR 类型的应用程序 | 处理 CBOR 格式的二进制数据(如 IoT 设备通信) | IoT 设备上传传感器数据 |
APPLICATION_FORM_URLENCODED | application/x-www-form-urlencoded | 表示 URL 编码的表单提交数据 | 提交 HTML 表单数据 | 使用 HTML 表单提交用户名和密码 |
APPLICATION_GRAPHQL | application/graphql+json | 表示 GraphQL 数据 | 处理 GraphQL API 请求和响应 | 使用 GraphQL 查询获取用户信息 |
APPLICATION_JSON | application/json | 表示 JSON 格式的数据 | 处理 RESTful API 请求和响应,传输 JSON 数据 | 获取或提交用户信息,处理 JSON 格式的 API 响应 |
APPLICATION_JSON_UTF8 (已废弃) | application/json;charset=UTF-8 | 表示带 UTF-8 编码的 JSON 数据 | 处理带有 UTF-8 编码的 JSON 数据(建议使用 application/json ) | 处理旧系统中使用的带有 UTF-8 编码的 JSON 数据 |
APPLICATION_OCTET_STREAM | application/octet-stream | 表示任意的二进制数据 | 下载或上传任意的二进制文件(如文件传输) | 下载或上传二进制文件,如图片或视频 |
APPLICATION_PDF | application/pdf | 表示 PDF 文档 | 处理 PDF 文件的下载或查看 | 下载或查看 PDF 文档,如电子书或报告 |
APPLICATION_PROBLEM_JSON | application/problem+json | 表示问题详情的 JSON 数据 | 返回 API 错误或问题详情时使用 JSON 格式的数据 | API 返回包含错误详情的 JSON 数据 |
APPLICATION_PROBLEM_JSON_UTF8 (已废弃) | application/problem+json;charset=UTF-8 | 表示带 UTF-8 编码的问题详情的 JSON 数据 | 处理带有 UTF-8 编码的问题详情 JSON 数据(建议使用 application/problem+json ) | 处理旧系统中使用的带有 UTF-8 编码的 JSON 错误详情数据 |
APPLICATION_PROBLEM_XML | application/problem+xml | 表示问题详情的 XML 数据 | 返回 API 错误或问题详情时使用 XML 格式的数据 | API 返回包含错误详情的 XML 数据 |
APPLICATION_RSS_XML | application/rss+xml | 表示 RSS XML 数据 | 处理 RSS 订阅源数据 | 获取 RSS 订阅源内容,如博客更新 |
APPLICATION_NDJSON | application/x-ndjson | 表示 Newline Delimited JSON 数据 | 处理包含多行 JSON 对象的数据流 | 处理实时日志或大数据流中的多行 JSON 数据 |
APPLICATION_STREAM_JSON (已废弃) | application/stream+json | 表示 JSON 流数据 | 处理 JSON 数据流(建议使用其他合适的 MIME 类型) | 处理旧系统中的 JSON 数据流,如 WebSocket 数据流 |
APPLICATION_XHTML_XML | application/xhtml+xml | 表示 XHTML 格式的 XML 数据 | 处理 XHTML 文档 | 显示或传输 XHTML 格式的网页内容 |
APPLICATION_XML | application/xml | 表示 XML 数据 | 处理 XML 数据或文档 | 传输或接收配置文件或数据交换格式,如 SOAP 请求 |
IMAGE_GIF | image/gif | 表示 GIF 图片 | 处理或传输 GIF 格式的图片 | 显示或上传 GIF 图片,如动画表情或广告图片 |
IMAGE_JPEG | image/jpeg | 表示 JPEG 图片 | 处理或传输 JPEG 格式的图片 | 显示或上传 JPEG 图片,如照片或插图 |
IMAGE_PNG | image/png | 表示 PNG 图片 | 处理或传输 PNG 格式的图片 | 显示或上传 PNG 图片,如图标或透明背景图片 |
MULTIPART_FORM_DATA | multipart/form-data | 表示多部分表单数据 | 提交包含文件上传的 HTML 表单数据 | 上传文件和表单数据,如上传头像或附件 |
MULTIPART_MIXED | multipart/mixed | 表示多部分混合数据 | 处理包含多个不同部分的邮件或 HTTP 请求 | 发送包含文本和附件的电子邮件 |
MULTIPART_RELATED | multipart/related | 表示多部分相关数据 | 处理包含相关部分的邮件或 HTTP 请求 | 发送包含 HTML 和嵌入图片的电子邮件 |
TEXT_EVENT_STREAM | text/event-stream | 表示服务器发送事件的数据流 | 处理服务器发送事件(Server-Sent Events,SSE) | 实时更新网页内容,如推送通知或聊天消息 |
TEXT_HTML | text/html | 表示 HTML 文档 | 处理或传输 HTML 格式的文档 | 显示或传输网页内容,如 HTML 页面 |
TEXT_MARKDOWN | text/markdown | 表示 Markdown 文档 | 处理或传输 Markdown 格式的文档 | 显示或传输 Markdown 内容,如博客文章或文档 |
TEXT_PLAIN | text/plain | 表示纯文本 | 处理或传输纯文本数据 | 显示或传输纯文本,如日志文件或简单文本信息 |
TEXT_XML | text/xml | 表示 XML 文本 | 处理或传输 XML 格式的文本 | 显示或传输 XML 数据,如配置文件或数据交换格式 |
PARAM_QUALITY_FACTOR | q | 表示质量因子参数 | 用于内容协商中的质量因子参数 | 在 HTTP 请求头中指定首选内容类型的权重,如 Accept: text/html;q=0.9 |