MediaType（媒体类型）

在Java编程中，它用于表示在HTTP通信中传输的数据类型。

1.MediaType定义与组成

MediaType由两部分组成：主类型和子类型，用斜杠（/）进行分隔。

• 主类型：表示一大类数据类型，如text（文本）、image（图像）、audio（音频）、video（视频）、application（应用程序）等。
• 子类型：表示主类型下的具体数据类型，如plain（纯文本）、html（超文本标记语言）、json（JavaScript对象表示法）、xml（可扩展标记语言）、jpeg（JPEG图片）、png（PNG图片）等。

2.常见的MediaType 类型

• 文本类型：text/plain（纯文本类型）、text/html（HTML类型）、text/css（层叠样式表类型）、text/javascript（JavaScript类型）、text/xml（XML类型）。
• 图片类型：image/jpeg（JPEG图片类型）、image/png（PNG图片类型）、image/gif（GIF图片类型）、image/svg+xml（可缩放矢量图形类型）。
• 音频类型：audio/mpeg（MPEG音频类型）、audio/wav（WAV音频类型）、audio/ogg（Ogg音频类型）。
• 视频类型：video/mp4（MP4视频类型）、video/quicktime（QuickTime视频类型）、video/webm（WebM视频类型）。
• 应用程序类型：application/json（JSON类型）、application/xml（XML类型）、application/pdf（PDF类型）、application/msword（Microsoft Word文档类型）、application/octet-stream（二进制流类型）。
• 多媒体类型：multipart/form-data（表单数据类型，用于文件上传等）、multipart/mixed（混合类型，用于发送包含多种类型的消息体）、multipart/alternative（替代类型，用于发送多种表示形式中的一种）。

3.Media Type 的使用

1. 在资源方法上使用 @Produces 和 @Consumes

@Path("/example")
public class ExampleResource {

    @GET
    @Produces(MediaType.APPLICATION_JSON)//@Produces：指定资源方法返回的媒体类型。
    public MyResponseObject getExample() {
        // 返回一个JSON对象
        return new MyResponseObject("Hello, World!");
    }

    @POST
    @Consumes(MediaType.APPLICATION_JSON)
    @Produces(MediaType.APPLICATION_JSON)//@Consumes：指定资源方法接受的请求体的媒体类型。
    public MyResponseObject postExample(MyRequestObject request) {
        // 处理JSON请求体，并返回一个JSON对象
        return new MyResponseObject("Received: " + request.getMessage());
    }

    // 简单的POJO类
    public static class MyRequestObject {
        private String message;
        // getter和setter
    }

    public static class MyResponseObject {
        private String message;
        // 构造函数、getter和setter
    }
}

 2.常见方法

获取主类型和子类型 getType(): 返回媒体类型的主类型（如"application"）。 getSubtype(): 返回媒体类型的子类型（如"json"）。

MediaType mediaType = MediaType.APPLICATION_JSON_TYPE;
String type = mediaType.getType(); // "application"
String subtype = mediaType.getSubtype(); // "json"

检查兼容性 isCompatible(MediaType other): 检查当前媒体类型是否与另一个媒体类型兼容。

MediaType mediaType1 = MediaType.APPLICATION_JSON_TYPE;
MediaType mediaType2 = MediaType.APPLICATION_XML_TYPE;
boolean isCompatible = mediaType1.isCompatible(mediaType2); // false

转换为字符串 toString(): 返回媒体类型的字符串表示（如"application/json"）。 解析和创建 MediaType.parse(String mediaType): 解析字符串并创建MediaType实例。 MediaType.valueOf(String mediaType): 类似于parse，但更常用于枚举类型值。

String mediaTypeStr = "application/pdf";
MediaType mediaType = MediaType.parse(mediaTypeStr);
// 现在可以使用mediaType对象，例如获取主类型和子类型

其他方法（这些方法可能因库的不同而有所差异）

• withCharset(Charset charset): 创建新实例，具有指定字符集。
• withoutParameters(): 创建新实例，无参数。
• getParameters(): 返回参数映射。
• hasParameter(String name): 检查是否有指定参数。
• getParameter(String name): 获取指定参数的值。