4.11. JSON 的更改

JSON 类中的所有实现 Jackson 类型的方法均已被删除。使用以下方法之一：

例如，使用以下代码：

在早期版本中，运行时需要 Jackson core 和 Jackson databind 依赖项。

从 Eclipse Vert.x 4 onward 中，只需要 Jackson 核心依赖项。

只有在对象映射 JSON 时，才需要 Jackson databind 依赖项。在这种情况下，您必须在 com.fasterxml.jackson.core:jackson-databind jar 中明确添加项目描述符中的依赖关系。

上述类型支持以下方法。

只支持使用 Jackson bind 的方法：

Eclipse Vert.x JSON 类型实现了 RFC-7493。在较早版本的 Eclipse Vert.x 中，实施会错误地使用 Base64 编码程序而不是 Base64URL。这个问题已在 Eclipse Vert.x 4 中修复，在 JSON 类型中使用 Base64URL encoder。

如果您要继续使用 Eclipse Vert.x 4 中的 Base64 编码器，您可以使用 旧的 配置标志。以下示例演示了如何在 Eclipse Vert.x 4 中设置配置标志。

java -Dvertx.json.base64=legacy ...

如果您部分迁移了从 Eclipse Vert.x 3.x 到 Eclipse Vert.x 4 的迁移，则应用程序将在版本 3 和 4 上进行。在这种情况下，您可以使用以下实用程序将 Base64 字符串转换为 Base64URL。

public String toBase64(String base64Url) {
  return base64Url
    .replace('+', '-')
    .replace('/', '_');
}

public String toBase64Url(String base64) {
  return base64
    .replace('-', '+')
    .replace('_', '/');
}

在以下情况下必须使用工具方法：

使用以下示例代码将 Base64URL 转换为 Base64 编码程序。

String base64url = someJsonObject.getString("base64encodedElement")
String base64 = toBase64(base64url);

Base64 和 toBase64 Url 的帮助程序功能仅启用 JSON 迁移。如果您使用对象映射将 JSON 对象自动映射到应用程序中的 Java POJO，则必须创建一个自定义对象映射程序，将 Base64 字符串转换为 Base64URL。

以下示例演示了如何使用自定义 Base64 解码器创建对象映射程序。

// simple deserializer from Base64 to byte[]
class ByteArrayDeserializer extends JsonDeserializer<byte[]> {
  ByteArrayDeserializer() {
  }

  public byte[] deserialize(JsonParser p, DeserializationContext ctxt) {
    String text = p.getText();
    return Base64.getDecoder()
      .decode(text);
  }
}

// ...

ObjectMapper mapper = new ObjectMapper();

// create a custom module to address the Base64 decoding
SimpleModule module = new SimpleModule();
module.addDeserializer(byte[].class, new ByteArrayDeserializer());
mapper.registerModule(module);

// JSON to POJO with custom deserializer
mapper.readValue(json, MyClass.class);

TrustOptions.toJSON 方法已被删除。