随着Jackson 3（也称为Jackson 3.0.0或更高版本）的正式发布，这个在Java生态中广泛使用的JSON处理库迎来了重大架构调整。许多长期依赖Jackson 2.x的开发者，在迁移时发现API发生了显著变化。一个典型的困惑是：“如果我只使用jackson-core模块，而不用databind，那么该如何创建JsonParser实例？”这个问题看似简单，却折射出Jackson 3设计理念的核心转变。本文将为你详细解答。

背景：为什么只使用jackson-core？

在Jackson的模块体系中，jackson-core是基础底层库，提供流式API（Streaming API），包括JsonParser（读取JSON）、JsonGenerator（写入JSON）和JsonFactory（工厂类）。而jackson-databind则构建在core之上，提供对象映射（ObjectMapper）功能。很多轻量级项目或性能敏感场景，并不需要完整的对象绑定，仅依赖core即可完成JSON的解析与生成，从而减少依赖体积、提高运行效率。

在Jackson 2.x中，创建JsonParser非常简单：

JsonFactory factory = new JsonFactory();
JsonParser parser = factory.createParser("{\"key\":\"value\"}");

但在Jackson 3中，JsonFactory的构造函数和部分方法已被重构，直接使用new JsonFactory()可能会遇到编译错误或废弃警告。这是因为Jackson 3引入了更严格的模块化设计，旨在消除歧义、提升线程安全性，并为未来的Schema支持做准备。

Jackson 3中的新机制：JsonFactoryBuilder

在Jackson 3中，推荐通过JsonFactoryBuilder来创建JsonFactory实例。这是一种构建器模式（Builder Pattern），允许更细粒度的配置。关键点是：JsonFactory本身不再提供直接的createParser方法，而是通过实例方法或静态工厂方法实现。具体步骤如下：

  1. 使用JsonFactoryBuilder构建工厂：
JsonFactory factory = JsonFactoryBuilder.builder().build();

你还可以在此设置各种特性，如流约束、引用处理等：

JsonFactory factory = JsonFactoryBuilder.builder()
    .enable(JsonReadFeature.ALLOW_TRAILING_COMMA)
    .maxDepth(1000)
    .build();
  1. 从工厂获取JsonParser：

JsonFactory实例保留了createParser方法（但签名可能有所调整）。你依然可以传入String、InputStream、Reader或byte[]等输入源：

String json = "{\"name\":\"Jackson3\"}";
JsonParser parser = factory.createParser(json);

注意：在Jackson 3中，createParser方法的参数类型可能更为严格。例如，String输入会被内部编码为UTF-8字节流，而char[]输入则需要通过Reader封装。建议查阅最新API文档确认具体重载。

  1. 完整示例（不依赖databind）：
import com.fasterxml.jackson.core.JsonFactory;
import com.fasterxml.jackson.core.JsonFactoryBuilder;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.core.JsonToken;

public class Jackson3CoreOnly {
    public static void main(String[] args) throws Exception {
        JsonFactory factory = JsonFactoryBuilder.builder().build();
        String json = "{\"message\":\"Hello, Jackson 3!\"}";

        try (JsonParser parser = factory.createParser(json)) {
            while (parser.nextToken() != JsonToken.END_OBJECT) {
                String fieldName = parser.getCurrentName();
                if ("message".equals(fieldName)) {
                    parser.nextToken();
                    System.out.println(parser.getValueAsString());
                }
            }
        }
    }
}

为什么会有这个变化？设计意图解读

Jackson团队在3.0中推动了多项重大改造，其中最关键的是将工厂创建与具体实现解耦。JsonFactoryBuilder的出现让用户可以明确指定需要哪些特性，避免了传统构造函数的“魔法配置”。同时，这一设计也为未来支持非JSON格式（如YAML、CBOR）的通用流式解析铺平了道路——你可以通过同一个Builder接口，产出针对不同数据格式的工厂。

此外，Jackson 3还移除了部分过时的“特性”枚举，将配置集中到JsonReadFeature和JsonWriteFeature中。这使得JsonFactory的实例化更加清晰，也降低了多线程下的竞争风险。

迁移注意事项：如果你之前使用jackson-core 2.x

  • 如果你直接从Jackson 2.x升级，确保jackson-core的版本号是3.x.x，而非2.15.x等。
  • JsonFactory的默认构造方法在3.0中已被标记为@Deprecated，建议改为Builder创建。
  • 所有与“特性”相关的API（如enable(Feature)）均已迁移到JsonReadFeature/JsonWriteFeature，且枚举值对应的整数ID可能改变。请重新审查你的配置。
  • JsonParser本身的行为基本保持不变，但部分方法（如getCurrentToken()）被替换为更安全的currentToken()，旧方法可能被移除。建议使用新版方法签名。
  • 注意资源管理：JsonParser实现了Closeable，在Java 7+中推荐使用try-with-resources。

与实际生产环境的结合

对于仅使用core模块的开发者，Jackson 3带来的改动其实是“一次配置，长期受益”。你可以将JsonFactoryBuilder.builder().build()封装为一个静态工厂方法或单例Bean，方便全局复用。同时，由于JsonFactory是线程安全的（在Jackson 3中进一步强化），你可以放心地在多个解析任务中共享同一个工厂实例。

如果你从databind中提取独立逻辑，但不想引入整个模块，那么核心API的稳定性至关重要。Jackson 3在core层面保持了向后兼容性的同时，也提供了更现代化的构建方式，值得尽快适配。

总结

在Jackson 3中，仅使用jackson-core模块创建JsonParser的正确做法是：通过JsonFactoryBuilder.builder().build()获取JsonFactory实例，然后调用其createParser方法。抛弃旧的new JsonFactory()习惯，拥抱Builder模式，你将获得更好的可配置性和未来兼容性。对于任何正在迁移Jackson 2.x到3.x的团队，这都是一项必须掌握的基本技能。