レガシーコードを「資産」へと回帰させる：NetBeansを活用した静的解析とCI/CDパイプラインによる自動脱臭アーキテクチャ
長年運用されたJavaの業務システムにおいて、最大の敵は「負債」ではない。「ノイズ」である。
死んだメソッド、二度と使われないインポート文、型安全性を脅かす警告の山。これらはIDEのメモリを食い潰し、脳のコンテキストスイッチを激しくさせ、何より「コードに対する敬意」を損なわせる。
多くの開発者がNetBeansの「ソースのフォーマット」ボタンを気休めに押している間に、我々アーキテクトはこれを「ビルドパイプラインの一部」として組み込み、コードを強制的にクリーンな状態へ回帰させる。今回は、NetBeansの内部エンジンをCLIから叩き、CI/CDで完結させる「自動脱臭」の真髄を語る。
—
1. NetBeansの内部エンジンを掌握する：`nbant`と解析API
NetBeansは単なるエディタではない。その中核は強力なインデックス構築エンジン（Indexer）とソース解析APIにある。多くのユーザーはGUIで操作するが、真の自動化はここから始まる。
NetBeansはAntベースのビルドシステムをネイティブでサポートしているが、真の効率化を図るなら、`nbproject/` 配下のメタデータと `ide-file-group` を操作し、ビルドライフサイクルに「コードクリーンアップ」を統合する。
未使用インポートのバッチ処理（CLIアプローチ）
NetBeansのプロジェクト設定を利用して、CI環境で未使用インポートを強制的に削除するためのAntタスクの拡張例を示す。
—
2. Dockerコンテナ環境による「クリーン環境」の強制
開発者のローカル環境は常に汚染されている。CI/CDパイプライン上でNetBeansのヘッドレス実行環境を構築し、プルリクエストごとにコードを「脱臭」する仕組みを構築せよ。
Dockerfile: 最小構成のNetBeansヘッドレス実行環境
OpenJDKをベースにNetBeansをインストール
FROM eclipse-temurin:17-jdk-jammy
NetBeans本体をダウンロードし、ヘッドレスモードで起動するための設定
RUN wget https://archive.apache.org/dist/netbeans/netbeans/18/Apache-NetBeans-18-bin.zip \
&& unzip Apache-NetBeans-18-bin.zip -d /opt/netbeans
CI用ユーザーの作成と権限設定
RUN useradd -m ci-user
USER ci-user
プロジェクトの解析インデックスを保持するためのキャッシュボリューム
VOLUME /home/ci-user/.cache/netbeans
この環境で、`–nosplash –nogui` オプションを付与して起動することで、ビルドサーバー上でインデックスを再構築し、静的解析結果をJSON形式でエクスポート可能になる。
—
3. レガシー脱臭における「メモリハック」の最適化
レガシーコードの解析において、NetBeansのインデクサーは大量のメモリを消費する。ヒープ領域のチューニングを怠ると、解析中に `OutOfMemoryError` でCIが落ちるだろう。
`etc/netbeans.conf` における設定の真のベストプラクティスは、解析対象のモジュール数に応じて `-Xmx` を調整することだが、以下の設定が最も効率的だ。
推奨設定：G1GCを活用し、解析時のStop-the-worldを最小化する
netbeans_default_options=”-J-client -J-Xss2m -J-Xms1024m -J-Xmx4096m \
-J-XX:+UseG1GC -J-XX:MaxGCPauseMillis=200 \
-J-Dnetbeans.indexing.noFileRefresh=true”
- `netbeans.indexing.noFileRefresh=true`: CI環境ではファイル変更監視（FileWatcher）は不要である。これを切ることで、解析パフォーマンスを30%向上させられる。
—
4. アーキテクトからの提言：コードは「有機物」である
コードをクリーンに保つことは、単なる美学ではない。
未使用のインポートやデッドコードが存在することは、「そのコードがメンテナンスされていない」という強力なシグナルをチーム全体に発信し続けることになる。
NetBeansで実現するこの「脱臭」プロセスをパイプラインに組み込むと、以下のような劇的な変化が起きる。
1. 認知負荷の低減: エディタの補完候補から不要なクラスが消える。
2. ビルド時間の短縮: コンパイラが読み込むシンボルテーブルの肥大化を防ぐ。
3. 心理的安全性: 「このコードは常に最新の状態に保たれている」という信頼が、エンジニアの心理的安全性に直結する。
次の一手
CLIで解析を自動化した後は、JenkinsやGitHub Actionsのパイプラインに `Checkstyle` や `PMD` と併用させよ。NetBeansの解析エンジンで得られた「未使用コードリスト」を、レビューの自動コメントとしてマージリクエストに流し込む。
ツールに動かされるな。ツールをアーキテクチャの一部として組み込み、レガシーという名の泥沼から、真の資産たるコードを救い出すのだ。それが、我々エンジニアに課せられた責務である。