分享一些简化定义和转换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来请求第三方的时候会用到这个泛型处理工具。

Java17 新特性确定，Java之父：终于可以和一个长达25年的漏洞说再见了

2021-06-16

这个类库可以帮助你理解Java中的函数式编程

2021-06-15