分享一些简化定义和转换Java Bean的一些小技巧

今天在封装第三方应用的开放接口，写了很多返回值的类，这些类很多都是结构相似只是个别字段名称不一样。为了单独的字段就要复制一个改改不胜其烦，而且起名是最头疼的事情。就像下面这两个：

@EqualsAndHashCode(callSuper = true)
@Data
public class SimpleUserResponse extends WeComResponse {
    private List<SimpleUser> userlist;
}

@EqualsAndHashCode(callSuper = true)
@Data
public class UserDetailResponse extends WeComResponse {
    private List<UserDetail> userlist;
}

是不是差不多？于是就利用泛型将它们合并了：

@EqualsAndHashCode(callSuper = true)
@Data
public class UserResponse<T> extends WeComResponse {
    private List<T> userlist;
}

这样通过​​UserResponse<SimpleUser>​​​和​​UserResponse<UserDetail>​​就能定义他们了，简化了不少代码。不过没多久又来了一个类：

@EqualsAndHashCode(callSuper = true)
@Data
public class QrCodeResponse extends WeComResponse {
    private String qrcode;
}

这个结构其实也差不多啊，如果把​​UserResponse<T>​​进一步改造成：

@EqualsAndHashCode(callSuper = true)
@Data
public class OjbectResponse<T> extends WeComResponse {
    private T userlist;
}

似乎​​OjbectResponse<String>​​​就等同于​​QrCodeResponse​​​。不过单纯这样搞是不行的，细心的同学会发现它们的属性名称不一样，一个是​​qrcode​​​；一个是​​userlist​​。如果能起个别名就好了！我似乎有了一个解决方案。

如果是类型转换

Bean类型转换的话，用Mapstruct就能解决这个问题，最终我们把属性名称定义为​​data​​：

@Mapping(target = "data", source = "qrcode")
    @Mapping(target = "data", source = "userlist")

通过上面的两个注解映射编写两个转换接口就解决了。关于Mapstruct可以看我相关的讲解文章。

如果是反序列化

Jackson提供了一个别名注解​​@JsonAlias​​，可以让字段属性名称接受更多的别名。就像这样：

@EqualsAndHashCode(callSuper = true)
@Data
public class OjbectResponse<T> extends WeComResponse {
    @JsonAlias({"qrcode","userlist"})
    private T data;
}

那么下面这个json能映射到​​OjbectResponse<String>​​中：

{
    "qrcode":"https://felord.cn/myqr.png"
}

这个会映射到​​OjbectResponse<List<UserDetail>>​​中：

{
 "userlist":[{"username":"felord.cn"},{"username":"felordcn"},{"username":"felord"}]
}

到这里可能大家会有疑问：Jackson是如何处理泛型问题的？

如何获取泛型的Class类型

通过直接手段是无法获取泛型的​​Class​​​类型的，不过我们可以获取到泛型的抽象定义​​java.lang.reflect.ParameterizedType​​​，直接使用​​ParameterizedType​​会不太方便。所以在Jackson中可以通过​​TypeReference<T>​​​来处理泛型问题。如果我们需要反序列化​​OjbectResponse<String>​​我们可以：

ObjectMapper objectMapper = new ObjectMapper();
String json = "{\"qrcode\":\"https://felord.cn/myqr.png\"}";
OjbectResponse<String> obj = objectMapper.readValue(json,new TypeReference<OjbectResponse<String>>(){});

其实对应的Spring也提供了类似的工具类​​org.springframework.core.ParameterizedTypeReference<T>​​​，特别是如果你使用了​​RestTemplate​​来请求第三方的时候会用到这个泛型处理工具。