下面是 jackson-dataformat-msgpack 依赖包的 Maven 配置信息和详细的使用说明。

📦 Maven 依赖配置

将以下依赖添加到你的 pom.xml 文件中 ：

<dependency>
    <groupId>org.msgpack</groupId>
    <artifactId>jackson-dataformat-msgpack</artifactId>
    <version>0.9.0</version> <!-- 请检查最新版本 -->
</dependency>

Gradle 用户可以在 build.gradle 文件中这样配置 ：

dependencies {
    implementation 'org.msgpack:jackson-dataformat-msgpack:0.9.0'
}

🔧 核心使用示例

这个库的核心是使用 Jackson 的 ObjectMapper，并指定 MessagePackFactory 来处理 MessagePack 格式。

1. 序列化/反序列化 POJO 对象

假设你有一个简单的 Java 类 MessageData ：

public class MessageData {
    private String uuid;
    private String name;
    // 省略 getter 和 setter 方法
}

使用 ObjectMapper 进行序列化和反序列化的代码如下 ：

import com.fasterxml.jackson.databind.ObjectMapper;
import org.msgpack.jackson.dataformat.MessagePackFactory;

import java.io.IOException;
import java.util.UUID;

public class MessagePackExample {
    public static void main(String[] args) throws IOException {
        // 1. 实例化支持 MessagePack 的 ObjectMapper
        ObjectMapper objectMapper = new ObjectMapper(new MessagePackFactory());

        // 2. 创建一个 POJO 对象
        MessageData pojo = new MessageData();
        pojo.setUuid(UUID.randomUUID().toString());
        pojo.setName("CWIKI.US");

        // 3. 序列化对象为 MessagePack 字节数组
        byte[] bytes = objectMapper.writeValueAsBytes(pojo);
        System.out.println("序列化后的字节长度: " + bytes.length);

        // 4. 将字节数组反序列化回 Java 对象
        MessageData deserialized = objectMapper.readValue(bytes, MessageData.class);
        System.out.println("反序列化后的 name: " + deserialized.getName());
        // 输出: CWIKI.US
    }
}

2. 处理列表（List）集合

对于集合类型，如 List<MessageData>，需要使用 TypeReference 来正确指定泛型类型 ：

import com.fasterxml.jackson.core.type.TypeReference;
import java.util.List;

// ... ObjectMapper 初始化代码同上 ...

List<MessageData> objList = Arrays.asList(new MessageData(), new MessageData()); // 填充列表

// 序列化
byte[] listBytes = objectMapper.writeValueAsBytes(objList);

// 反序列化时，使用 TypeReference 保留泛型信息
List<MessageData> deserializedList = objectMapper.readValue(listBytes, new TypeReference<List<MessageData>>() {});
System.out.println("反序列化列表大小: " + deserializedList.size());

3. 处理映射（Map）集合

处理 Map 时，如果键（Key）不是字符串类型，可能需要使用 @JsonSerialize 注解指定 Key 的序列化器 ：

import com.fasterxml.jackson.databind.annotation.JsonSerialize;
import org.msgpack.jackson.dataformat.MessagePackKeySerializer;

// 在测试方法或映射字段上使用注解
@JsonSerialize(keyUsing = MessagePackKeySerializer.class)
public void testMapSerialization() {
    ObjectMapper objectMapper = new ObjectMapper(new MessagePackFactory());
    Map<Integer, MessageData> map = new HashMap<>();
    // ... 向 Map 中添加数据 ...

    byte[] mapBytes = objectMapper.writeValueAsBytes(map);
    // 反序列化
    Map<Integer, MessageData> deserializedMap = objectMapper.readValue(mapBytes, new TypeReference<Map<Integer, MessageData>>() {});
}

💡 重要提示

• 版本兼容性：请注意，jackson-dataformat-msgpack 默认的 POJO 序列化/反序列化方式与较早的 msgpack-java（v0.6 或更早版本）不兼容 。如果你需要与旧版本兼容，可以考虑使用 JsonArrayFormat 。
• 核心原理：这个库本质上是 Jackson 的一个扩展，所以如果你熟悉 Jackson 的 API，那么上手会非常快，大部分操作逻辑是相通的 。

🔍 如何查找最新版本

建议你通过 Maven Central Repository 直接搜索 “jackson-dataformat-msgpack” 来获取最新的正式版本号，以确保使用最新的功能和安全更新 。

希望这些信息能帮助你顺利使用 MessagePack！如果你在处理特定数据类型时遇到问题，或者想了解更高级的用法，随时可以再问我。