【技術累積】【點】【java】【27】@JSONField

@JSONField

該注解隸屬于阿里fastjson，方便fastjson處理對象時的一些操作

源碼

@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER })
public @interface JSONField {/*** config encode/decode ordinal* @since 1.1.42* @return*/int ordinal() default 0;String name() default "";String format() default "";boolean serialize() default true;boolean deserialize() default true;SerializerFeature[] serialzeFeatures() default {};Feature[] parseFeatures() default {};String label() default "";/*** @since 1.2.12*/boolean jsonDirect() default false;/*** Serializer class to use for serializing associated value.* * @since 1.2.16*/Class<?> serializeUsing() default Void.class;/*** Deserializer class to use for deserializing associated value. * * @since 1.2.16 */Class<?> deserializeUsing() default Void.class;/*** @since 1.2.21* @return the alternative names of the field when it is deserialized*/String[] alternateNames() default {};/*** @since 1.2.31*/boolean unwrapped() default false;
}

• ordinal() 順序設置。

  缺省fastjson序列化一個java bean，是根據fieldName的字母序進行序列化的，你可以通過ordinal指定字段的順序。這個特性需要1.1.42以上版本

• name() 指定名字。指定后，序列化后字段名變為指定名稱，反序列化同理；
• format() 指定日期格式；
• serialize() deserialize() 是否序列化和反序列化，默認true。
• serialzeFeatures() 序列化特性選擇，具體參考后面文章吧；通過枚舉選擇
• parseFeatures() 解釋特性選擇；通過枚舉選擇

• label() 打標記，可定制化輸出

@JSONField(label = "normal")public int getId() {return id;}public void setId(int id) {this.id = id;}@JSONField(label = "normal")public String getName() {return name;}
System.out.println(JSON.toJSONString(v, Labels.includes("normal")));

• jsonDirect() 直接輸出而不經過json轉譯

  在fastjson-1.2.12版本中，JSONField支持一個新的配置項jsonDirect，它的用途是：當你有一個字段是字符串類型，里面是json格式數據，你希望直接輸入，而不是經過轉義之后再輸出。

• serializeUsing() deserializeUsing() 指定序列化、反序列化使用自定義Serialize、Parser（注意，直接寫在類中即可，格式固定，關鍵是取值）

//示例1
public static class TimeStampDeserializer implements ObjectDeserializer {@Overridepublic <T> T deserialze(DefaultJSONParser parser, Type type, Object fieldName) {String time = parser.getLexer().stringVal();if (StringUtils.isBlank(time)) {return (T)String.valueOf(new Date().getTime());} else {return (T)(time + "000");}}@Overridepublic int getFastMatchToken() {return 0;}}//示例2
public static class Model {@JSONField(serializeUsing = ModelValueSerializer.class)public int value;
}public static class ModelValueSerializer implements ObjectSerializer {@Overridepublic void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType,int features) throws IOException {Integer value = (Integer) object;String text = value + "元";serializer.write(text);}
}

• alternateNames() 多名字。允許多個名字的變量轉成一個

@JSONField(alternateNames = {"user", "person"})
public String name;

• unwrapped() 不封箱

搭配JSON.parseObject

給輸出結構體中field配置上@JSONField(name="aaa")等，直接轉出得到的json串

Response response = JSON.parseObject(res, Response.class);@Setter
@Getter
@NoArgsConstructor
@ToString
public class Response {@JSONField(name = "answerList")private List<Answer> answers;@JSONField(name = "timeStamp")private String timeStamp;@JSONField(name = "type")private String answerType;@JSONField(name = "id")private String erp;@JSONField(name = "session")private String sessionId;@JSONField(name = "topic")private String topic;@JSONField(deserialize = false, serialize = false)private String answerType = AnswerTypeEnum.ANSWER.getCode();
}

參考文章

• Fastjson JSONField
• JSONField_jsonDirect_cn
• FastJson 自定義Serialize、Parser
• fastjson使用(八) -- LabelFilter的使用
• fastjson的@JSONField注解的一點問題
• fastjson SerializerFeature詳解