solon-serialization-jackson

<dependency>
    <groupId>org.noear</groupId>
    <artifactId>solon-serialization-jackson</artifactId>
</dependency>

1、描述

序列化扩展插件，为 Solon Serialization 提供基于 Jackson（代码仓库）的框架适配。

使用时，会涉及到格式化的定制，其它就不会有显示的感受。

2、主要接口实现类

何时会被时用？当 Content-Type 为 application/json（或 text/json）时会执行。

3、快捷格式化输出配置 (v1.12.3 后支持)

solon.serialization.json:
  dateAsFormat: 'yyyy-MM-dd HH:mm:ss' #配置日期格式（默认输出为时间戳）
  dateAsTimeZone: 'GMT+8' #配置时区
  dateAsTicks: false #将date转为毫秒数（和 dateAsFormat 二选一）
  longAsString: true #将long型转为字符串输出 （默认为false）
  boolAsInt: false   #将bool型转为字符串输出 （默认为false）
  nullStringAsEmpty: false
  nullBoolAsFalse: false
  nullNumberAsZero: false
  nullArrayAsEmpty: false
  nullAsWriteable: false
  enumAsName: false #枚举使用名字（v2.2.1 后支持）

注意：

• 当 dateAsFormat 有 'XXX' 时，LocalDateTime、LocalDate 会异常，需要另外定制转换器

提醒：

• 配置 null???As??? 时实体的null字段也会输出（相当于 nullAsWriteable 被动开了）

4、高级格式化定制（基于接口）

格式化输出定制和请求处理定制，（v1.12.3 后支持）：

@Configuration
public class Config {
    @Bean
    public void jsonInit(@Inject JacksonRenderFactory factory, @Inject JacksonActionExecutor executor){
        //方式1：通过转换器，做简单类型的定制
        factory.addConvertor(Date.class, s -> s.getTime());

        factory.addConvertor(LocalDate.class, s -> s.format(DateTimeFormatter.ofPattern("yyyy-MM-dd")));

        factory.addConvertor(Long.class, s -> String.valueOf(s));
        
        factory.addConvertor(BigDecimal.class, s -> s.toPlainString());

        //方式2：通过编码器，做复杂类型的原生定制（基于框架原生接口）
        factory.addEncoder(Date.class, new JsonSerializer<Date>() {
                    @Override
                    public void serialize(Date date, JsonGenerator out, SerializerProvider sp) throws IOException {
                        out.writeNumber(date.getTime());
                    }
                });
                
        //factory.config()...
        
        //executor.config()...
        
        //executor.config(new ObjectMapper())...//设定全新的 ObjectMapper，v2.6.6 后支持
    }
}

5、个性化输出定制

public class User{
    public long userId;
    
    public String name;
    
    //排除序列化
    public transient password; //使用 transient 排除具有通用性
    
    //格式化日期
    @JsonFormat(pattern="yyyy-MM-dd",timezone="GMT+8") //尽量不使用个性化定制//这样不会依赖具体框架
    public Date birthday;
}