Jackson原理探究—Mixins其一

Z时代
2024-01-10
分类：综合

使用场景

Jackson mixins 用来实现在目标类的声明以及定义的情况下，实现 Jackson 的注解添加至目标类的效果。尤其我们在使用第三方类库的时候，这种机制就会显得尤为有用。

接下来我们展示一些实际的使用场景示例：

以 spring security 为例

假设我们要反序列化这个类：

package org.springframework.security.web.csrf;
······
public final class DefaultCsrfToken implements CsrfToken {
    private final String token;
    private final String parameterName;
    private final String headerName;
    ······
    public DefaultCsrfToken(String headerName, String parameterName, String token) {
        Assert.hasLength(headerName, "headerName cannot be null or empty");
        Assert.hasLength(parameterName, "parameterName cannot be null or empty");
        Assert.hasLength(token, "token cannot be null or empty");
        this.headerName = headerName;
        this.parameterName = parameterName;
        this.token = token;
    }
    ······}

com.fasterxml.jackson.databind.exc.InvalidDefinitionException: No dserializer found for class org.springframework.security.web.csrf and no properties discovered to create BeanDserializer (to avoid exception, disable SerializationFeature.FAIL_ON_EMPTY_BEANS)

我们无法反序列化这两个类，因为这是一个典型的不可变类，所有属性字段在构造器中完成初始化。而jackson 默认的反序列化策略需要一个无参的构造器，并提供字段的内省 （注1） 函数。如果要更改反序列化策略，jackson 需要我们在对象上增加对应的注解。

现在让我们来创建一个 mixin 类来解决这个问题！在我们的 mixin 中，我们将声明我们反序列化所需要的注解：

package org.springframework.security.web.jackson2;
······
@JsonTypeInfo(use = JsonTypeInfo.Id.CLASS, include = JsonTypeInfo.As.PROPERTY, property = "@class")
@JsonIgnoreProperties(ignoreUnknown = true)
class DefaultCsrfTokenMixin {
    ······
    @JsonCreator
    public DefaultCsrfTokenMixin(@JsonProperty("headerName") String headerName,
                                @JsonProperty("parameterName") String parameterName, @JsonProperty("token") String token) {
    }}

我们创建了一个 mixin 类，并为其声明了 typeInfo 信息以及要用到的构造器信息

之后，我们需要告诉 Jackson 使用我们的 Mixin。为此，我们需要通过 jackson 的 Module 扩展机制，实现自己的扩展器，告诉 jackson 需要使用我们的 mixin：

/**
 * Jackson module for spring-security-web. This module register {@link DefaultCsrfTokenMixin} and
 * {@link PreAuthenticatedAuthenticationTokenMixin}. If no default typing enabled by default then it'll enable
 * it because typing info is needed to properly serialize/deserialize objects.
 * In order to use this module just add this module into your ObjectMapper configuration.
 *
 * <pre>
 *     ObjectMapper mapper = new ObjectMapper();
 *     mapper.registerModule(new WebJackson2Module());
 * </pre>
 * <b>Note: use {@link SecurityJackson2Modules#getModules(ClassLoader)} to get list of all security modules.</b>
 *
 * @author Jitendra Singh
 * @see SecurityJackson2Modules
 * @since 4.2
 */
public class WebJackson2Module extends SimpleModule {
    public WebJackson2Module() {
        super(WebJackson2Module.class.getName(), new Version(1, 0, 0, null, null, null));
    }
    @Override
    public void setupModule(SetupContext context) {
        SecurityJackson2Modules.enableDefaultTyping(context.getOwner());
        context.setMixInAnnotations(DefaultCsrfToken.class, DefaultCsrfTokenMixin.class);
        context.setMixInAnnotations(PreAuthenticatedAuthenticationToken.class, PreAuthenticatedAuthenticationTokenMixin.class);
    }}