Jackson中基于上下文拦截属性输出的两种实现方式

需求如下,在一个类中,有一些字段属性,其是否输出并不是由字段上的JsonIgnore来决定,而是根据从上下文(如request)中传递过来的某些参数决定。如下类:

class A {
    @ContextIgnored("field1")
    private String field1;

    @ContextIgnored("field2")
    private String field2;
}

当上下文值为 field1 时,则表示 A 的最终输出json 中没有字段 field1. 当上下文为 field2 时, 则最终输出没有字段 field2. 其它情况则输出所有字段。

本文讨论Jackson中的处理方式,如果使用 Fastjson,则有很多方式处理,这里不表.

本文描述通过利用 JsonIgnore 注解处理方式解决此问题 和 通过 PropertyFilter 两种方式来完成此需求的处理方式。

利用 AnnotationIntrospector 中 hasIgnoreMarker 实现属性过滤

在标准的类处理中,jackson在处理每个类时,均会为此类生成1个 JsonSerializer 对象,在此场景中应该为 BeanSerializer 对象,而类中属性的处理,则是由 BeanPropertyWriter 来完成。即可以理解为在处理对象时,会先有1个解析类和属性的过程存在,如果在此过程中,检测到某个属性不应该最终输出,则不会产生相应属性的 BeanPropertyWriter 对象,即达到过滤输出的目的。

在正常的场景中,我们可以通过 注解 JsonIgnore, 将其加到属性上,即解析时即会过滤到属性。而实际实现,则是由类 JacksonAnnotationIntrospector 中 的 hasIgnoreMarker 来完成,则就是通过读取注解来判断属性是否应该被exclude掉。ObjectMapper中默认的 AnnotationIntrospector 即是 JacksonAnnotationIntrospector 来完成,但我们可以通过 方法 ObjectMapper.setAnnotationIntrospector 来重新指定自定义的实现。如下参考代码.

class VerifyIntrospetor extends JacksonAnnotationIntrospector {
    public boolean hasIgnoreMarker(AnnotatedMember m) {
        boolean f = super.hasIgnoreMarker(m);
        if(!f) {
            ContextIgnored anno =  _findAnnotation(m, ContextIgnoreed.class);
            if(anno.value() == "验证值")
                return true;
        }
        return f;
    }
}

如上代码,即在原来只处理注解 JsonIgnore 的基础之上,再加上处理 注解 ContextIgnored.

但是在Jackson中,此上的代码只能被调用1次,即针对单个类,ObjectMapper会缓存每个class所对应的 JsonSerializer 实例。当上下文改变时,ObjectMapper 并不会重新再创建新的 JsonSerializer,而是直接使用已经缓存过的 对象来处理,这样实际上就达不到最初的需求。相应的缓存类,可参考类 DefaultSerializerProvider.findTypedValueSerializer 方法实现 ,以及其中的类 SerializerCache. 由于当前jackson的实现, SerializerCache 为1个final类,并不支持扩展,因此修改 DefaultSerializerProvider 中属性的方式不可处理。

不过可以通过类似Composite的方式来解决此问题,通过方法 ObjectMapper.setSerializerProvider 可以重新使用1个新的 DefaultSerializerProvider 对象,此此类是可以被继承的。当 ObjectMapper 在writeValue时,均会调用 DefaultSerializerProvider 中 serializeValue 方法来进行序列化操作。更准确的说,会先调用 createInstance 方法产生1个新的 DefaultSerializerProvider 来完成对象序列化操作。那么在此过程中,可以通过1个类似 Map 来组合不同上下文的处理。即在 createInstance 时,根据当前上下文的值委派给具体的类来进行处理。而当委派之后,再由后面的 DefaultSerializerProvider.Impl 类来完成最终 JsonSerializer 的创建和处理过程。我们构建的 Composite 对象即完成了 上下文 中转换的中间隔离作用,即根据 上下文值 的不同会有多个 DefaultSerializerProvider 存在,但具体对象的内部缓存的 JsonSerializer 即会根据上下文的不同有自己的处理逻辑。

示意代码如下:

class Composite {
    private Map<上下文, DefaultSerializerProvider> map;
    public Composite createInstance(SerializationConfig config, SerializerFactory jsf) {
        return map.computeIfAbsent(上下文, k-> new DefaultSerializerProvider.Impl());
    }
}

在具体实现中, 还需要考虑 DefaultSerializerProvider.copy 方法,这个在具体使用时具体实现即可.

利用 PropertyFilter 拦截属性输出

相比第1种手法的复杂及晦涩(可以理解为直接怼),这种手法就比较简单了。自 jackson 2.3 之后,提供接口 PropertyFilter ,以及对应的注解 JsonFilter 来允许对特定的类在处理字段时,进行额外的过滤处理操作。所谓的过滤操作,即将属性的实际操作转交由接口来完成。其接口下的1个参考实现 SimpleBeanPropertyFilter 即提供了 包含 和 排除的实现代码。我们只需要实现方法 boolean include(BeanPropertyWriter writer) 即可完成判断是否输出某个属性的操作。

此 PropertyFilter 的使用即在类上,通过 JsonFilter 定义此类的过滤器, 然后通过 ObjectMapper.setFilterProvider(SimpleFilterProvider) 添加 具体实现即可, 两都通过 value 来完成匹配过程。

PropertyFilter 接口是在每一次属性序列化均会处理,即意味着,如果方法 include(BeanPropertyWriter writer) 的返回值是变化的,即完成了动态拦截属性的作用。参考实现如下:

public class ContextIgnoredFilter extends SimpleBeanPropertyFilter {
    @Override
    protected boolean include(BeanPropertyWriter writer) {
        ContextIgnored anno = writer.getAnnotation(ContextIgnored.class);
        //上下文值与注解值判断处理...

        return true;
    }
}

这种实现方法,不需要添加额外的 AnnotationIntrospector, 也不需要调整 ObjectMapper 的 DefaultSerializerProvider 属性,并且在代码Review上更简单易懂。

转载请标明出处:i flym
本文地址:https://www.iflym.com/index.php/code/201906190001.html

相关文章:

作者: flym

I am flym,the master of the site:)

《Jackson中基于上下文拦截属性输出的两种实现方式》有2个想法

发表评论

电子邮件地址不会被公开。 必填项已用*标注