Java で ZEDI（全銀EDI）XML 電文を生成・パースする実装

import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.OutputKeys;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import org.xml.sax.InputSource;

import java.io.StringReader;
import java.io.StringWriter;
import java.util.ArrayList;
import java.util.List;

/**
 * ZEDI（全銀EDIシステム）XML 電文の生成・パース。
 * ISO 20022 の pain.001（顧客振込指図）メッセージ構造に基づき、
 * 振込付帯情報（RmtInf）の読み書きを行う。
 *
 * DOM API を使用する理由:
 * - 要素の追加・属性設定が直感的で、電文の組み立てに適している
 * - 名前空間付き要素の生成が createElementNS() で簡潔に書ける
 * - 1電文ずつの処理であればメモリ消費も問題にならない
 */
public class ZenginEdiSample {

    // ISO 20022 pain.001 の名前空間 URI
    // ZEDI 技術仕様書で定められた名前空間を正確に使用すること
    private static final String ZEDI_NS =
        "urn:iso:std:iso:20022:tech:xsd:pain.001.001.03";

    /**
     * パース結果を保持する record。
     * 不変オブジェクトとして振込付帯情報を安全に受け渡せる。
     */
    record ZediRemittanceInfo(
        String invoiceNumber,    // 請求書番号（RfrdDocInf/Nb に対応）
        long amount,             // 振込金額（InstdAmt のテキスト値）
        String currency,         // 通貨コード（InstdAmt の Ccy 属性）
        String payeeName,        // 受取人名（Cdtr/Nm に対応）
        String additionalInfo    // 追加付帯情報（AddtlRmtInf に対応）
    ) {}

    /**
     * ZEDI XML 電文を DOM API で生成する。
     *
     * ISO 20022 の構造:
     * Document
     *   └ CstmrCdtTrfInitn（顧客振込指図）
     *       ├ GrpHdr（グループヘッダー: メッセージID等）
     *       └ PmtInf（支払情報）
     *           ├ Dbtr（支払人情報）
     *           └ CdtTrfTxInf（個別振込取引）
     *               ├ Amt/InstdAmt（振込金額 + 通貨コード）
     *               ├ Cdtr（受取人情報）
     *               └ RmtInf/Strd（構造化付帯情報）
     *                   ├ RfrdDocInf/Nb（請求書番号）
     *                   └ AddtlRmtInf（追加付帯情報）
     */
    public static String buildZediMessage(
            String invoiceNumber,
            long paymentAmount,
            String payerName,
            String payeeName,
            String paymentNoticeId) throws Exception {

        // DOM ファクトリの設定
        // setNamespaceAware(true) は ZEDI XML の生成・パースで必須
        var factory = DocumentBuilderFactory.newInstance();
        factory.setNamespaceAware(true);
        var doc = factory.newDocumentBuilder().newDocument();

        // ルート要素: Document（ISO 20022 メッセージのエンベロープ）
        // createElementNS で名前空間付き要素を作成する
        var root = doc.createElementNS(ZEDI_NS, "Document");
        doc.appendChild(root);

        // CstmrCdtTrfInitn: Customer Credit Transfer Initiation
        // 顧客からの振込指図メッセージ全体を包含する要素
        var initiation = doc.createElementNS(ZEDI_NS, "CstmrCdtTrfInitn");
        root.appendChild(initiation);

        // GrpHdr: Group Header — 電文の識別情報
        var grpHdr = doc.createElementNS(ZEDI_NS, "GrpHdr");
        initiation.appendChild(grpHdr);
        // MsgId: メッセージを一意に識別するID
        // 実務ではシステム固有の採番ルールに従う
        appendTextElement(doc, grpHdr, "MsgId",
            "MSG-" + System.currentTimeMillis());

        // PmtInf: Payment Information — 支払情報のブロック
        var pmtInf = doc.createElementNS(ZEDI_NS, "PmtInf");
        initiation.appendChild(pmtInf);

        // Dbtr: Debtor（支払人）
        var dbtr = doc.createElementNS(ZEDI_NS, "Dbtr");
        pmtInf.appendChild(dbtr);
        // Nm: 支払人の名称
        appendTextElement(doc, dbtr, "Nm", payerName);

        // CdtTrfTxInf: Credit Transfer Transaction Information
        // 個別の振込取引に対応する要素（1電文に複数可）
        var txInf = doc.createElementNS(ZEDI_NS, "CdtTrfTxInf");
        pmtInf.appendChild(txInf);

        // Amt: Amount ブロック
        var amt = doc.createElementNS(ZEDI_NS, "Amt");
        txInf.appendChild(amt);
        // InstdAmt: Instructed Amount（指定金額）
        // Ccy 属性で通貨コードを指定する（日本円 = JPY）
        var instdAmt = doc.createElementNS(ZEDI_NS, "InstdAmt");
        instdAmt.setAttribute("Ccy", "JPY");
        instdAmt.setTextContent(String.valueOf(paymentAmount));
        amt.appendChild(instdAmt);

        // Cdtr: Creditor（受取人）
        var cdtr = doc.createElementNS(ZEDI_NS, "Cdtr");
        txInf.appendChild(cdtr);
        appendTextElement(doc, cdtr, "Nm", payeeName);

        // RmtInf: Remittance Information — 付帯情報
        // ZEDI の核心部分。請求書番号や支払通知番号をここに格納する
        var rmtInf = doc.createElementNS(ZEDI_NS, "RmtInf");
        txInf.appendChild(rmtInf);

        // Strd: Structured — 構造化された付帯情報
        var strd = doc.createElementNS(ZEDI_NS, "Strd");
        rmtInf.appendChild(strd);

        // RfrdDocInf: Referred Document Information — 参照ドキュメント
        // 請求書番号などの文書識別情報を格納する
        var rfrdDocInf = doc.createElementNS(ZEDI_NS, "RfrdDocInf");
        strd.appendChild(rfrdDocInf);
        // Nb: Number — 請求書番号
        appendTextElement(doc, rfrdDocInf, "Nb", invoiceNumber);

        // AddtlRmtInf: Additional Remittance Information
        // 支払通知番号など、構造化しきれない追加情報を格納する
        appendTextElement(doc, strd, "AddtlRmtInf",
            "PaymentNotice:" + paymentNoticeId);

        // XML 文字列への変換
        // Transformer で DOM ツリーを文字列にシリアライズする
        var transformer = TransformerFactory.newInstance().newTransformer();
        // インデント付き出力（デバッグ・ログ用途で可読性を確保）
        transformer.setOutputProperty(OutputKeys.INDENT, "yes");
        // エンコーディングを UTF-8 に明示（ZEDI の標準エンコーディング）
        transformer.setOutputProperty(OutputKeys.ENCODING, "UTF-8");

        var writer = new StringWriter();
        transformer.transform(new DOMSource(doc), new StreamResult(writer));
        return writer.toString();
    }

    /**
     * 名前空間付きのテキスト要素を生成し、親要素に追加するヘルパー。
     * ZEDI 電文では全要素が同一名前空間に属するため、
     * createElementNS を共通化して記述量を減らす。
     */
    private static void appendTextElement(
            Document doc, Element parent, String localName, String text) {
        var elem = doc.createElementNS(ZEDI_NS, localName);
        elem.setTextContent(text);
        parent.appendChild(elem);
    }

    /**
     * ZEDI XML 電文をパースし、付帯情報を record のリストとして返す。
     *
     * パースでも DOM を使用する。1電文ずつの処理であればメモリ消費は問題にならず、
     * getElementsByTagNameNS() で名前空間付き要素を直接取得できるため実装が簡潔。
     * 大量電文の一括処理には StAX（XMLStreamReader）への切り替えを検討すること。
     */
    public static List<ZediRemittanceInfo> parseZediMessage(String xml)
            throws Exception {

        var factory = DocumentBuilderFactory.newInstance();
        // 名前空間対応を有効化（ZEDI では必須）
        factory.setNamespaceAware(true);
        // XXE 対策: 外部 DTD の読み込みを禁止
        factory.setFeature(
            "http://apache.org/xml/features/disallow-doctype-decl", true);
        // XXE 対策: 外部エンティティ参照を無効化
        factory.setFeature(
            "http://xml.org/sax/features/external-general-entities", false);

        var doc = factory.newDocumentBuilder()
                .parse(new InputSource(new StringReader(xml)));
        doc.getDocumentElement().normalize();

        var results = new ArrayList<ZediRemittanceInfo>();

        // CdtTrfTxInf（個別振込取引）を名前空間付きで全件取得
        var txNodes = doc.getElementsByTagNameNS(ZEDI_NS, "CdtTrfTxInf");

        for (int i = 0; i < txNodes.getLength(); i++) {
            var txElem = (Element) txNodes.item(i);

            // 振込金額: InstdAmt 要素のテキストと Ccy 属性
            var amountText = getTextNS(txElem, "InstdAmt");
            var currency = getAttributeNS(txElem, "InstdAmt", "Ccy");

            // 受取人名: Cdtr/Nm（ネストした要素の取得）
            var payeeName = getNestedTextNS(txElem, "Cdtr", "Nm");

            // 請求書番号: RfrdDocInf/Nb
            var invoiceNumber = getTextNS(txElem, "Nb");

            // 追加付帯情報: AddtlRmtInf
            var additionalInfo = getTextNS(txElem, "AddtlRmtInf");

            // record に格納して返す
            results.add(new ZediRemittanceInfo(
                invoiceNumber,
                amountText.isEmpty() ? 0L : Long.parseLong(amountText),
                currency,
                payeeName,
                additionalInfo
            ));
        }
        return results;
    }

    /** 名前空間付き要素のテキストを取得する（見つからなければ空文字） */
    private static String getTextNS(Element parent, String localName) {
        var nodes = parent.getElementsByTagNameNS(ZEDI_NS, localName);
        return nodes.getLength() > 0
            ? nodes.item(0).getTextContent() : "";
    }

    /** 名前空間付き要素の属性値を取得する */
    private static String getAttributeNS(
            Element parent, String localName, String attrName) {
        var nodes = parent.getElementsByTagNameNS(ZEDI_NS, localName);
        return nodes.getLength() > 0
            ? ((Element) nodes.item(0)).getAttribute(attrName) : "";
    }

    /** ネストされた名前空間付き要素のテキストを取得する */
    private static String getNestedTextNS(
            Element parent, String outerName, String innerName) {
        var outerNodes = parent.getElementsByTagNameNS(ZEDI_NS, outerName);
        if (outerNodes.getLength() > 0) {
            var outerElem = (Element) outerNodes.item(0);
            var innerNodes =
                outerElem.getElementsByTagNameNS(ZEDI_NS, innerName);
            return innerNodes.getLength() > 0
                ? innerNodes.item(0).getTextContent() : "";
        }
        return "";
    }

    public static void main(String[] args) throws Exception {
        // ZEDI 電文を生成する
        var xml = buildZediMessage(
            "INV-2025-001234",      // 請求書番号
            1500000L,               // 支払金額（150万円）
            "株式会社サンプル商事",    // 支払人名
            "株式会社テスト工業",      // 受取人名
            "PN-2025-00567"         // 支払通知番号
        );
        System.out.println("=== 生成した ZEDI XML 電文 ===");
        System.out.println(xml);

        // 生成した XML をパースして付帯情報を取り出す
        var remittanceList = parseZediMessage(xml);
        System.out.println("=== パース結果 ===");
        for (var info : remittanceList) {
            System.out.println("請求書番号: " + info.invoiceNumber());
            System.out.println("支払金額: " + info.amount() + " "
                + info.currency());
            System.out.println("受取人: " + info.payeeName());
            System.out.println("追加情報: " + info.additionalInfo());
        }
    }
}