为什么gson序列化java.time.ZoneId时要找java.time.ZoneRegion？

Question

我想了解 Gson 在这里做什么。

这是我的简单测试用例。

import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import com.google.gson.TypeAdapter;
import com.google.gson.stream.JsonReader;
import com.google.gson.stream.JsonWriter;
import org.junit.Test;

import java.io.IOException;
import java.time.ZoneId;

public class TestSuite
{
   public class TestItem 
   {
      private ZoneId TimeZone = ZoneId.of("America/New_York");
   }

   class ZoneIdAdapter extends TypeAdapter<ZoneId>
    {
        @Override
        public void write(final JsonWriter jsonWriter, final ZoneId timeZone) throws IOException
        {
            jsonWriter.value(timeZone.getId());
        }

        @Override
        public ZoneId read(final JsonReader jsonReader) throws IOException
        {
            return ZoneId.of(jsonReader.nextString());
        }
    }
   
   @Test
   public void canSerializeTestItem()
   {
      Gson gson = new GsonBuilder()
          .registerTypeAdapter(ZoneId.class, new ZoneIdAdapter())
          .create();
      
      gson.toJson(new TestItem());
   }
}

对我来说，使用 Java 17 和 Gson 2.10 失败并显示以下内容：

com.google.gson.JsonIOException: Failed making field 'java.time.ZoneRegion#id' accessible; either increase its visibility or write a custom TypeAdapter for its declaring type.

我不明白为什么 gson 与java.time.ZoneRegion#id有关，当我想*我已经告诉它如何序列化ZoneId （我猜 ZoneRegion 是 java.time.ZoneId 的内部？我好像找不到。）。

更让我困惑的是，如果我更改为以下内容：

public class TestItem
{
   @Expose
   private ZoneId timeZone = ZoneId.of("America/New_York");
}

// ... omitted other stuff

 Gson gson = new GsonBuilder()
    .excludeFieldsWithoutExposeAnnotation()
    .registerTypeAdapter(ZoneId.class, new ZoneIdAdapter())
    .create();

 gson.toJson(new TestItem());

然后它像我期望的那样工作（没有错误）。

有没有更好的方法来“教”gson 如何序列化我关注的第三方类型？

Answer 1

ZoneId.of()返回的实际具体类型是ZoneRegion ，而registerTypeAdapter仅为单个类型注册适配器。

由于ZoneRegion不是公共的 class，您不能（轻松地）为它注册一个适配器——当然，即使您有一个TestItem实例，其中timeZone具有不同的具体类型，您当然也需要一个可以工作的配置。

您可以改用registerTypeHierarchyAdapter 。 这为 class 及其所有子类注册了一个适配器。

我不知道为什么 @Expose 会改变行为。