とある案件でCSV出力の実装をした際、特定の項目に対して加工をする必要がありました。
そのときの実装内容をメモとして残します。

背景

業務システムの開発でCSV出力機能を実装する中で、
ある項目だけ、出力時にゼロ埋めして5桁に整形するという要件がありました。

その際に、JacksonのカスタムSerializerを使って対応したので、
備忘録として残しておきます。

環境

Java：17
フレームワーク：Spring Boot
CSV出力ライブラリ：Jackson（jackson-databind）

やりたいこと

「在庫数」などの数値項目をCSV出力する際に、
常に5桁のゼロパディングで出力したい。

例："12" → "00012"

カスタムSerializerの作成

Jacksonの StdSerializer を継承して、独自の文字列整形を行うクラスを作成します。

public class ZeroPadded5DigitSerializer extends StdSerializer<String> {

    public ZeroPadded5DigitSerializer() {
        super(String.class);
    }

    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        String trimmed = (value == null) ? "" : value.trim();
        String padded = String.format("%05d", Integer.parseInt(trimmed));
        gen.writeString(padded);
    }
}

処理の流れ
・入力された文字列（例："12"）をトリム（前後の空白除去）
・Integer.parseInt() で整数に変換
・String.format("%05d") で5桁のゼロパディング
・"00012" のように整形し、JSON文字列として出力

DTOでの使い方
Serializerを使いたいフィールド（今回は「在庫数」）に
アノテーションを付けるだけでOKです。

@JsonProperty("在庫数")
@JsonSerialize(using = PlusZeroPadded5DigitSerializer.class)
private String stockCount;

出力結果のイメージ
たとえば、以下のようなCSVを出力したいとします。

商品コード,在庫数,登録日,更新日
123456789012345,00005,20250701,20250701
このように、「在庫数」の項目のみゼロ埋めされた形式で出力されます。

まとめ

CSV出力時に特定の項目だけ整形したいとき、
JacksonのカスタムSerializerを使えば柔軟に対応できます。

特にフォーマットやゼロ埋めなどの要件は業務でよく出るので、
使い回せる形でクラスを作っておくと便利です。