Java XML和JSON：Java SE的文档处理第2部分

银河1号

发布于 2019-05-16 15:27:22

3.4K0

发布于 2019-05-16 15:27:22

文章被收录于专栏：银河系资讯

在这篇文章中，我们将继续探索Java 11及更高版本中的XML和JSON。

本文中的示例将向您介绍JSON-B，JSON绑定API for Java。在快速概述和安装说明之后，我将向您展示如何使用JSON-B来序列化和反序列化Java对象，数组和集合; 如何使用JSON-B自定义序列化和反序列化; 以及如何在序列化或反序列化期间使用JSON-B适配器将源对象转换为目标对象。

这篇文章的材料是全新的，但可以被认为是我的新书的另一章（第13章），最近由Apress出版：Java XML和JSON，第二版。

什么是JSON-B？

JSON-B是一个标准的绑定层和API，用于将Java对象与JSON文档进行转换。它类似于XML绑定的Java体系结构（JAXB），它用于将Java对象转换为XML或从XML转换成Java对象。

JSON-B构建于JSON-P之上，JSON-P是用于解析，生成，查询和转换JSON文档的JSON处理API。JSON-B是由Java规范请求（JSR）367在JSR 353（JSR for JSON-P）最终发布一年多之后推出的。

JSON-B API

JSON绑定的Java API（JSON-B）网站引入了JSON-B并提供对各种资源的访问，包括API文档。根据文档，JSON-B模块存储了六个包：

javax.json.bind：定义将Java对象绑定到JSON文档的入口点。
javax.json.bind.adapter：定义与适配器相关的类。
javax.json.bind.annotation：定义用于自定义Java程序元素和JSON文档之间的映射的注释。
javax.json.bind.config：定义用于自定义Java程序元素和JSON文档之间的映射的策略和策略。
javax.json.bind.serializer：定义用于创建自定义序列化程序和反序列化程序的接口。
javax.json.bind.spi：定义用于插入自定义的服务提供者接口（SPI）JsonbBuilder。

JSON-B网站还提供了Yasson的链接，Yasson是一个Java框架，提供Java类和JSON文档之间的标准绑定层，以及JSON Binding API的官方参考实现。

下载并安装JSON-B

JSON-B 1.0是撰写本文时的当前版本。您可以从Maven存储库获取此库的Yasson参考实现。您需要下载以下JAR文件：

Javax JSON Bind API 1.0：包含所有JSON-B类文件。我下载了javax.json.bind-api-1.0.jar。
Yasson：包含基于Eclipse的JSON-B参考实现。我下载了yasson-1.0.3.jar。
JSR 374（JSON处理）默认提供程序：包含所有JSON-P 1.0类文件以及Glassfish默认提供程序类文件。我下载了javax.json-1.1.4.jar。

在编译和运行使用这些库的代码时，将这些JAR文件添加到类路径中：

javac -cp javax.json.bind-api-1.0.jar;. main source file
java -cp javax.json.bind-api-1.0.jar;yasson-1.0.3.jar;javax.json-1.1.4.jar;. main classfile

使用JSON-B序列化和反序列化Java对象

该javax.json.bind包提供了Jsonb和JsonbBuilder接口，它们充当此库的入口点：

Jsonb提供了toJson()用于将Java对象的树序列化为JSON文档的重载方法，以及fromJson()用于将JSON文档反序列化为Java对象树的方法。
JsonbBuilder提供newBuilder()和其他方法获得新的构建，并build()和create()返回新方法Jsonb的对象。

以下代码示例演示了Jsonb和JsonBuilder类型的基本用法：

// Create a new Jsonb instance using the default JsonbBuilder implementation.
Jsonb jsonb = JsonbBuilder.create();

// Create an Employee object from a hypothetical Employee class.
Employee employee = ...

// Convert the Employee object to a JSON document stored in a string.
String jsonEmployee = jsonb.toJson(employee);

// Convert the previously-created JSON document to an Employee object.
Employee employee2 = jsonb.fromJson(jsonEmployee, Employee.class);

此示例调用序列化Java对象Jsonb的String toJson(Object object)方法（Employee）。此方法传递给Java对象树的根目录以进行序列化。如果null通过，则toJson()抛出java.lang.NullPointerException。在序列化期间发生意外问题（例如I / O错误）时，它会抛出javax.json.bind.JsonbException。

此代码段还调用Jsonb的<T> T fromJson(String str, Class<T> type)通用方法，该方法被用于反序列化。此方法传递基于字符串的JSON文档以反序列化，并返回生成的Java对象树的根对象的类型。传递给此方法任一参数为null时抛出NullPointerException; 在反序列化期间发生意外问题时抛出JsonbException。

我从一个JSONBDemo提供JSON-B基本演示的应用程序中摘录了代码片段。清单1展示了此演示的源代码。

清单1. JSONBDemo.java（版本1）

import java.time.LocalDate;

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;

public class JSONBDemo
{
   public static void main(String[] args)
   {
      Jsonb jsonb = JsonbBuilder.create();
      Employee employee = new Employee("John", "Doe", 123456789, false,
                                       LocalDate.of(1980, 12, 23),
                                       LocalDate.of(2002, 8, 14));
      String jsonEmployee = jsonb.toJson(employee);
      System.out.println(jsonEmployee);
      System.out.println();
      Employee employee2 = jsonb.fromJson(jsonEmployee, Employee.class);
      System.out.println(employee2);
   }
}

main()首先创建一个Jsonb对象，后跟一个Employee对象。然后，它调用toJson()将Employee对象序列化为存储在字符串中的JSON文档。打印该文档后，main()调用fromJson()与把字符串反序列化为Employee。

清单2. Employee.java（版本1）

import java.time.LocalDate;

public class Employee
{
   private String firstName;

   private String lastName;

   private int ssn;

   private boolean isMarried;

   private LocalDate birthDate;

   private LocalDate hireDate;

   private StringBuffer sb = new StringBuffer();

   public Employee() {}

   public Employee(String firstName, String lastName, int ssn, boolean isMarried,
                   LocalDate birthDate, LocalDate hireDate)
   {
      this.firstName = firstName;
      this.lastName = lastName;
      this.ssn = ssn;
      this.isMarried = isMarried;
      this.birthDate = birthDate;
      this.hireDate = hireDate;
   }

   public String getFirstName()
   {
      return firstName;
   }

   public String getLastName()
   {
      return lastName;
   }

   public int getSSN()
   {
      return ssn;
   }

   public boolean isMarried()
   {
      return isMarried;
   }

   public LocalDate getBirthDate()
   {
      return birthDate;
   }

   public LocalDate getHireDate()
   {
      return hireDate;
   }

   public void setFirstName(String firstName)
   {
      this.firstName = firstName;
   }

   public void setLastName(String lastName)
   {
      this.lastName = lastName;
   }

   public void setSSN(int ssn)
   {
      this.ssn = ssn;
   }

   public void setIsMarried(boolean isMarried)
   {
      this.isMarried = isMarried;
   }

   public void setBirthDate(LocalDate birthDate)
   {
      this.birthDate = birthDate;
   }

   public void setHireDate(LocalDate hireDate)
   {
      this.hireDate = hireDate;
   }

   @Override
   public String toString()
   {
      sb.setLength(0);
      sb.append("First name [");
      sb.append(firstName);
      sb.append("], Last name [");
      sb.append(lastName);
      sb.append("], SSN [");
      sb.append(ssn);
      sb.append("], Married [");
      sb.append(isMarried);
      sb.append("], Birthdate [");
      sb.append(birthDate);
      sb.append("], Hiredate [");
      sb.append(hireDate);
      sb.append("]");
      return sb.toString();
   }
}

编制清单1和2如下：

javac -cp javax.json.bind-api-1.0.jar;. JSONBDemo.java

运行应用程序如下：

java -cp javax.json.bind-api-1.0.jar;yasson-1.0.3.jar;javax.json-1.1.4.jar;. JSONBDemo

您应该观察以下输出（为了便于阅读，分布在多行中）：

{"SSN":123456789,"birthDate":"1980-12-23","firstName":"John","hireDate":"2002-08-14",
 "lastName":"Doe","married":false}

First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]

使用JSON-B的规则

在玩这个应用程序时，我观察到一些有趣的行为，这些行为使我制定了以下有关Employee的规则：

class必须是public; 否则，抛出异常。
toJson()不会使用非publicgetter方法序列化字段。
fromJson()不会使用非publicsetter方法反序列化字段。
fromJson()在没有public no argument构造函数的情况下抛出JsonbException。

为了在Java对象字段和JSON数据之间无缝转换，JSON-B必须支持各种Java类型。例如，JSON-B支持以下基本Java类型：

java.lang.Boolean
java.lang.Byte
java.lang.Character
java.lang.Double
java.lang.Float
java.lang.Integer
java.lang.Long
java.lang.Short
java.lang.String

其他类型，例如java.math.BigInteger，java.util.Date和java.time.LocalDate支持。查看JSON-B规范以获取支持类型的完整列表。

使用JSON-B序列化和反序列化数组和集合

上一节重点介绍了单个Java对象的序列化和反序列化。JSON-B还支持序列化和反序列化对象数组和集合的功能。清单3提供了一个演示。

清单3. JSONBDemo.java（版本2）

import java.time.LocalDate;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;

public class JSONBDemo
{
   public static void main(String[] args)
   {
      arrayDemo();
      listDemo();
   }

   // Serialize and deserialize an array of Employee objects.
   static void arrayDemo()
   {
      Jsonb jsonb = JsonbBuilder.create();
      Employee[] employees =
      {
         new Employee("John", "Doe", 123456789, false,
                      LocalDate.of(1980, 12, 23),
                      LocalDate.of(2002, 8, 14)),
         new Employee("Jane", "Smith", 987654321, true,
                      LocalDate.of(1982, 6, 13),
                      LocalDate.of(2001, 2, 9))
      };
      String jsonEmployees = jsonb.toJson(employees);
      System.out.println(jsonEmployees);
      System.out.println();
      employees = null;
      employees = jsonb.fromJson(jsonEmployees, Employee[].class);
      for (Employee employee: employees)
      {
         System.out.println(employee);
         System.out.println();
      }
   }

   // Serialize and deserialize a List of Employee objects.
   static void listDemo()
   {
      Jsonb jsonb = JsonbBuilder.create();
      List<Employee> employees =
         Arrays.asList(new Employee("John", "Doe", 123456789, false,
                                    LocalDate.of(1980, 12, 23),
                                    LocalDate.of(2002, 8, 14)),
                       new Employee("Jane", "Smith", 987654321, true,
                                    LocalDate.of(1982, 6, 13),
                                    LocalDate.of(1999, 7, 20)));
      String jsonEmployees = jsonb.toJson(employees);
      System.out.println(jsonEmployees);
      System.out.println();
      employees = null;
      employees = jsonb.fromJson(jsonEmployees,
                                 new ArrayList<>(){}.
                                     getClass().getGenericSuperclass());
      System.out.println(employees);
   }
}

清单3是表1的简单扩展，并使用相同的Employee清单2.此外，在呈现类，此代码示例和toJson()和fromJson()方法调用相同。

将JSON文档反序列化为Java对象数组时，将表达式Employee[].class作为第二个参数传递给fromJson()，以便它可以创建适当的数组。将JSON对象反序列化为列表或其他集合时，会将表达式new ArrayList<>(){}.getClass().getGenericSuperclass()作为第二个参数传递。JDK 11会推断Employee，所以我不必指定ArrayList<Employee>。

理想情况下，应该可以传递ArrayList<Employee>.class，以告知fromJson()集合的预期参数化类型进行实例化。但是，由于类型擦除，这种表达是非法的。相反，我可以指定ArrayList.class哪个会起作用。但是，它还会生成未经检查的警告消息。表达式越复杂，就不会产生警告。本质上，它实例化一个匿名子类ArrayList<Employee>，获取它的Class对象，并使用该Class对象来获取其超类的参数化类型，这恰好是ArrayList<Employee>。此参数化类型可用于fromJson()。

编译清单3和2，并运行生成的应用程序。您应该观察以下输出（为了便于阅读，分布在多行中）：

[{"SSN":123456789,"birthDate":"1980-12-23","firstName":"John","hireDate":"2002-08-14",
  "lastName":"Doe","married":false},
 {"SSN":987654321,"birthDate":"1982-06-13","firstName":"Jane","hireDate":"2001-02-09",
  "lastName":"Smith","married":true}]

First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]

First name [Jane], Last name [Smith], SSN [987654321], Married [false],
 Birthdate [1982-06-13], Hiredate [2001-02-09]

[{"SSN":123456789,"birthDate":"1980-12-23","firstName":"John","hireDate":"2002-08-14",
  "lastName":"Doe","married":false},
 {"SSN":987654321,"birthDate":"1982-06-13","firstName":"Jane","hireDate":"1999-07-20",
  "lastName":"Smith","married":true}]

[{firstName=John, lastName=Doe, hireDate=2002-08-14, birthDate=1980-12-23, married=false,
  SSN=123456789},
 {firstName=Jane, lastName=Smith, hireDate=1999-07-20, birthDate=1982-06-13, married=true,
  SSN=987654321}]

在JSON-B中自定义序列化和反序列化

虽然JSON-B通过支持各种Java类型为您做了很多事情，但您可能需要自定义其行为; 例如，更改序列化属性的输出顺序。JSON-B支持编译时和运行时自定义。

编译时自定义

JSON-B通过其javax.json.bind.annotation包中的各种注释类型支持编译时自定义。例如，您可以使用JsonbDateFormat提供自定义日期格式并更改JsonbProperty字段的名称。清单4的Employee类中说明了这两种注释类型。

清单4. Employee.java（版本2）

import java.time.LocalDate;

import javax.json.bind.annotation.JsonbDateFormat;
import javax.json.bind.annotation.JsonbProperty;

public class Employee
{
   @JsonbProperty("first-name")
   private String firstName;

   @JsonbProperty("last-name")
   private String lastName;

   private int ssn;

   private boolean isMarried;

   @JsonbDateFormat("MM-dd-yyyy")
   private LocalDate birthDate;

   @JsonbDateFormat("MM-dd-yyyy")
   private LocalDate hireDate;

   private StringBuffer sb = new StringBuffer();

   public Employee() {}

   public Employee(String firstName, String lastName, int ssn, boolean isMarried,
                   LocalDate birthDate, LocalDate hireDate)
   {
      this.firstName = firstName;
      this.lastName = lastName;
      this.ssn = ssn;
      this.isMarried = isMarried;
      this.birthDate = birthDate;
      this.hireDate = hireDate;
   }

   public String getFirstName()
   {
      return firstName;
   }

   public String getLastName()
   {
      return lastName;
   }

   public int getSSN()
   {
      return ssn;
   }

   public boolean isMarried()
   {
      return isMarried;
   }

   public LocalDate getBirthDate()
   {
      return birthDate;
   }

   public LocalDate getHireDate()
   {
      return hireDate;
   }

   public void setFirstName(String firstName)
   {
      this.firstName = firstName;
   }

   public void setLastName(String lastName)
   {
      this.lastName = lastName;
   }

   public void setSSN(int ssn)
   {
      this.ssn = ssn;
   }

   public void setIsMarried(boolean isMarried)
   {
      this.isMarried = isMarried;
   }

   public void setBirthDate(LocalDate birthDate)
   {
      this.birthDate = birthDate;
   }

   public void setHireDate(LocalDate hireDate)
   {
      this.hireDate = hireDate;
   }

   @Override
   public String toString()
   {
      sb.setLength(0);
      sb.append("First name [");
      sb.append(firstName);
      sb.append("], Last name [");
      sb.append(lastName);
      sb.append("], SSN [");
      sb.append(ssn);
      sb.append("], Married [");
      sb.append(isMarried);
      sb.append("], Birthdate [");
      sb.append(birthDate);
      sb.append("], Hiredate [");
      sb.append(hireDate);
      sb.append("]");
      return sb.toString();
   }
}

清单4用JsonbProperty注释firstName和lastName字段，并用JsonbDateFormat注释birthDate和hireDate字段。JsonbProperty导致firstName序列化为first-name和lastName序列化为last-name。此注释类型还会导致first-name反序列化firstName并last-name反序列化lastName。JsonbDateFormat导致生日和雇用日期在月 - 日 - 年中序列化，而不是默认的年 - 月 - 日订单，并导致JSON-B在反序列化时考虑序列化的月 - 日 - 年订单。

编译清单1和清单4，然后运行生成的应用程序。您应该观察以下输出（为了便于阅读，分布在多行中）：

{"SSN":123456789,"birthDate":"12-23-1980","first-name":"John","hireDate":"08-14-2002",
 "last-name":"Doe","married":false}

First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]

运行时自定义

JSON-B通过javax.json.bind.JsonbConfig和JsonbBuilder支持运行时自定义。在实例JsonbConfig中，调用各种withXXX方法（例如，withPropertyOrderStrategy）来配置该任务，并且使配置JsonbConfig提供给对象JsonBuilder，可能通过将其作为JsonbBuilder的static Jsonb create(JsonbConfig config)方法的参数。查看清单5。

清单5. JSONBDemo.java（版本3）

import java.time.LocalDate;

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;
import javax.json.bind.JsonbConfig;

import static javax.json.bind.config.PropertyOrderStrategy.*;

public class JSONBDemo
{
   public static void main(String[] args)
   {
      JsonbConfig config = new JsonbConfig()
                               .withPropertyOrderStrategy(REVERSE);
      Jsonb jsonb = JsonbBuilder.create(config);
      Employee employee = new Employee("John", "Doe", 123456789, false,
                                       LocalDate.of(1980, 12, 23),
                                       LocalDate.of(2002, 8, 14));
      String jsonEmployee = jsonb.toJson(employee);
      System.out.println(jsonEmployee);
      System.out.println();
      Employee employee2 = jsonb.fromJson(jsonEmployee, Employee.class);
      System.out.println(employee2);
   }
}

清单5的main()方法首先实例化JsonbConfig然后调用此类的JsonbConfig withPropertyOrderStrategy(String propertyOrderStrategy)方法将属性顺序策略更改为javax.json.bind.config.PropertyOrderStrategy.REVERSE。此策略顺序导致属性以与正常输出方式相反的顺序输出。

该JsonbConfig对象被传递给create(JsonbConfig)配置所得到的Jsonb对象JsonbBuilder最终返回。该方法的其余部分与清单1中所示的相同。

编译清单2和5，然后运行生成的应用程序。您应该观察以下输出（为了便于阅读，分布在多行中）：

{"married":false,"lastName":"Doe","hireDate":"2002-08-14","firstName":"John",
 "birthDate":"1980-12-23","SSN":123456789}

First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]

您可以使用JSON-B的注释类型之一完成相同的反向属性顺序任务。我会留下弄清楚如何做这个练习。

在JSON-B中使用适配器

最后，JSON-B支持适配器，它是在序列化或反序列化期间将源对象转换为目标对象的对象。例如，您可以使用适配器来加密JSON文档中对象的字段名称和值。

适配器由原始Java对象，包含修改/附加字段的适配/转换对象和适配器对象组成，适配器对象是该javax.json.bind.adapter.Adapter<Original,Adapted>类型的实例。

该Adapter类型提供以下方法：

Original adaptFromJson(Adapted obj)：在反序列化期间调用此方法以转换Adapted为Original。
Adapted adaptToJson(Original obj)：在序列化期间调用此方法以转换Original为Adapted，然后将其序列化为JSON。

这两种方法都用一个throws Exception子句声明，表明它可以在转换期间抛出任何类型的异常。

清单6给出了一个源代码IdentityAdapter，一个不会改变任何东西的适配器。但是，它会打印出原本可以调整的对象，并演示适配器架构。

清单6. IdentityAdapter.java

import javax.json.bind.adapter.JsonbAdapter;

public class IdentityAdapter implements JsonbAdapter<Employee, Employee>
{
   @Override
   public Employee adaptFromJson(Employee obj)
   {
      System.out.println("Deserializing: " + obj);
      return obj;
   }

   @Override
   public Employee adaptToJson(Employee obj)
   {
      System.out.println("Serializing: " + obj);
      return obj;
   }
}

您使用JsonbConfig及其JsonbConfig withAdapters(JsonbAdapter...)方法来注册一个或多个适配器：

JsonbConfig config = new JsonbConfig()
                         .withAdapters(new IdentityAdapter());

这个对象传递给JsonbBuilder的create(JsonbConfig)方法，正如我前面表现。为了完整起见，清单7的JSONBDemo源代码演示了这两个任务。

清单7. JSONBDemo.java（版本4）

import java.time.LocalDate;

import javax.json.bind.Jsonb;
import javax.json.bind.JsonbBuilder;
import javax.json.bind.JsonbConfig;

public class JSONBDemo
{
   public static void main(String[] args)
   {
      JsonbConfig config = new JsonbConfig()
                               .withAdapters(new IdentityAdapter());
      Jsonb jsonb = JsonbBuilder.create(config);
      Employee employee = new Employee("John", "Doe", 123456789, false,
                                       LocalDate.of(1980, 12, 23),
                                       LocalDate.of(2002, 8, 14));
      String jsonEmployee = jsonb.toJson(employee);
      System.out.println(jsonEmployee);
      System.out.println();
      Employee employee2 = jsonb.fromJson(jsonEmployee, Employee.class);
      System.out.println(employee2);
   }
}

编译清单2,6和7，并运行生成的应用程序。您应该观察以下输出（为了便于阅读，分布在多行中）：

Serializing: First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]
{"SSN":123456789,"birthDate":"1980-12-23","firstName":"John","hireDate":"2002-08-14",
 "lastName":"Doe","married":false}

Deserializing: First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]
First name [John], Last name [Doe], SSN [123456789], Married [false],
 Birthdate [1980-12-23], Hiredate [2002-08-14]

结论

JSON-B很好地补充了JSON-P，我在本书的第12章，Java XML和JSON，第二版中介绍了它。在这篇文章中，我介绍了JSON-B并向您展示了如何使用它来序列化和反序列化Java对象，数组和集合。我还向您展示了如何使用JSON-B自定义序列化和反序列化，并向您介绍了JSON-B适配器，它们可用于在序列化或反序列化期间将源对象转换为目标对象。

我确信JSON-B将继续发展，并且可能是我书第三版的一个很好的补充。同时，我建议您通过探索本文未涉及的各种方法和注释类型来了解有关JSON-B的更多信息。

英文原文：javaworld.com/article/3

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2019-04-12，如有侵权请联系 cloudcommunity@tencent.com 删除

json

本文分享自银河系1号微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！