Jackson

Annotations

@JsonManagedReference

• この注釈(アノテーション) が付(つ) いた属性(ぞくせい) は正常(せいじょう) にシリアライズされます

@JsonBackReference

• この注釈(アノテーション) が付(つ) いた属性(ぞくせい) はシリアライズ時(じ) に無視(むし) されます。通常(つうじょう) のbeanにのみ使用(しよう) 可能(かのう) で、コレクション、Map、配列(はいれつ) 、enumには使用(しよう) できません。

@JsonInclude

• Jacksonに特定(とくてい) の条件(じょうけん) を満(み) たした場合(ばあい) 、そのPropertyをシリアライズしないよう指示(しじ) します

@JsonInclude(JsonInclude.Include.NON_DEFAULT)

• Include.ALWAYS (Default) : 常(つね) にすべてのpropertiesを含(ふく) み、nullと空文字列もシリアライズされます
• Include.NON_DEFAULT : 値(あたい) がnullのpropertiesを除外(じょがい) します

@JsonProperty

• その欄位(フィールド) (属性(ぞくせい) )を指定(してい) した名前(なまえ) でシリアライズします

@JsonPropertyOrder

• Entity Serializer時(じ) のProperties順序(じゅんじょ) を決定(けってい) できます

@JsonFormat

@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private LocalDateTime created_at;

• Enum : enumはシリアライズのみ可能(かのう) で、デシリアライズはできません

@JsonFormat(shape = JsonFormat.Shape.OBJECT)
public enum Categories {

}

@JsonIgnoreProperties

• 存在(そんざい) しない欄位(フィールド) を無視(むし) し、無視(むし) する欄位(フィールド) を指定(してい) することもできます

@JsonIgnoreProperties(ignoreUnknown = true)
public class Model{
	//...
}

@JsonAnyGetter

• 可変(かへん) のMapに使用(しよう) し、Key/Valueを拡張(かくちょう) 可能(かのう) なPropertiesに変換(へんかん) します

@JsonValue

• 注釈(アノテーション) されたPropertyのValueを取得(しゅとく) します

@JsonRawValue

• 注釈(アノテーション) されたProperty, Methodは、シリアライズ時(じ) にescaping(\)やdecorationが適用(てきよう) されません