Java接口如何动态返回指定的对象字段属性

经常遇到的问题

在实际得开发过程中，我们经常会遇到以下场景，我们后端请求某个接口后获取到得数据，不希望将所有字段都返回给前端，那么我们需要封装，或者过滤一些不必要得字段后返回给前端。

不完美的解决方案

使用 Jackson 字段动态过滤

• @JsonIgnore用于忽略序列化和反序列化中使用的逻辑属性。@JsonIgnore 可用于 setter、getter 或字段。

• @JsonIgnoreProperties忽略 JSON 序列化和反序列化中的指定逻辑属性。它在类级别进行了注释。

• @JsonIgnoreType在类级别进行了注释，它忽略了整个类。

• @JsonInclude(JsonInclude.Include.NON_NULL) 属性为NULL不序列化，即不返回给前端

以上方式都不满足实际要求，需要序列化的Property，并非固定的。这次我要id,name，下次我可能要name,score。

通过SimplePropertyPreFilter

这种写法，只能满足返回单个Json对象，实际业务上的数据都是List对象。这就需要把list对象转换成JSONArray，也不是最终想要的实现方式。

场景一：只保留所需的字段

public static void main(String[] args) {
    JSONObject jsonObject = new JSONObject();
    jsonObject.put("name", "jhon");
    jsonObject.put("age", 18);
    jsonObject.put("sex", "男");
    jsonObject.put("phone", "1111111");
    jsonObject.put("email","142qq.com");
    System.out.println(jsonObject);
    // SimplePropertyPreFilter filter = new SimplePropertyPreFilter("name","sex");
    SimplePropertyPreFilter filter = new SimplePropertyPreFilter();
    filter.getIncludes().add("name");
    filter.getIncludes().add("sex");
    System.out.println(JSONObject.toJSONString(jsonObject, filter));
}
// 或者调用以下方式
public static String object2Json(Object object, String... keys) {
    SimplePropertyPreFilter filter = new SimplePropertyPreFilter(object.getClass(),keys);
    return JSONObject.toJSONString(object,filter, SerializerFeature.WriteMapNullValue);
}

场景二：过滤掉不要的字段

public static void main(String[] args) {
    JSONObject jsonObject = new JSONObject();
    jsonObject.put("name", "jhon");
    jsonObject.put("age", 18);
    jsonObject.put("sex", "男");
    jsonObject.put("phone", "1111111");
    jsonObject.put("email","142qq.com");
    System.out.println(jsonObject);
    SimplePropertyPreFilter filter = new SimplePropertyPreFilter();
    filter.getExcludes().add("email");
    filter.getExcludes().add("phone");
    System.out.println(JSONObject.toJSONString(jsonObject, filter));
}

@ResponseBody忽略特定属性

@RequestBody注解标记接收前端传递给后端的json数据，然后转成对象。

@ResponseBody注解标记是把后端返回的对象转换成json数据，然后传递给前端。

我们想要的效果是将查询得到的 List<对象> 动态过滤指定的字段

但实际得到的对象还会再封装一层：return new IResult(list);

使用AOP，通过自定义注解的方式来控制动态过滤指定字段。（实现太麻烦放弃了）

最终解决方案反射Map

定义查询列表数据的接口，用Map来承载，而不是bean。

/**
 * Mybatis的dao层直接返回Map格式数据
 */
public List<Map<String,Object>> list(Entity entity);

/**
 * Java对象列表转换Map集合返回指定字段
 * @param list
 * @param keys  指定字段
 * @return
 */
public List<Map<String,Object>> filter(List<E> list, String ... keys){
    List<Map<String,Object>> mapList = new ArrayList<>();
    if(list.size()>0){
        for (E e : list) {
            Map<String,Object> map = BeanUtil.beanToMap(e, keys);
            mapList.add(map);
        }
    }
    return mapList;
}

/**
 * Java对象转换Map对象返回指定字段
 * @param e
 * @param keys  指定字段
 * @return
 */
public Map<String,Object> filter(E e, String ... keys){
    if(e != null){
        return BeanUtil.beanToMap(e, keys);
    }
    return null;
}

同一个对象如何被不同接口展示不同的参数

当我们在写接口的时候，一个实体类对象会被多个接口使用，但每个接口要求的参数可能都不一样。为了接口参数规范，于是我们就重写了多个实体类，对应不同的接口。（相信很多人目前是偷懒每套业务都只用了一个实体类对象吧，前端自己挑选所需要的字段）

但是提供给第三方的接口，参数和结果字段必须都要求规范起来，否则等着被喷了。

Swagger2实现参数使用相同对象展示不同参数，可以用分组方式实现，但用起来也比较麻烦。

还会遇到每个接口需要做字段校验@Valid，又是麻烦的一批。

最终发现还是多写几个实体类更快更规范此，且针对不同接口的参数也更便于管理。

接口参数使用Map传输的优缺点

好处就是一个人用着贼方便，随时添减参数不用改实体类，业务中过程中随时可以对任意参数进行增加和修改，返回Map对象数据也是很方便。（一时用着一时爽）

但问题也很明显：

• map就像个无底洞，不看后台代码永远不知道传递了什么参数。
• 有潜在的类型转换异常发生
• 数据序列化反序列化问题
• 无法使用MybatisPlus插件
• 无法使用validator验证注解
• swagger文档注解无法完美兼容
• 这种接口很难去写一份文档来维护