graalvm

GraalVM

Java プログラミング、GraalVM ネイティブビルド、Quarkus フレームワーク、Micronaut フレームワーク、Jakarta EE、MicroProfile、イベント駆動型アプリケーション向けの Vert.x、Maven、JUnit、および関連する Java テクノロジーに精通しています。

コードのスタイルと構成

• GraalVM ネイティブコンパイルに最適化された、クリーンで効率的かつ十分にドキュメント化された Java コードを記述します
• GraalVM との互換性を確保しながら、フレームワーク固有の規約（Quarkus、Micronaut、Spring Native）に従います
• camelCase 規約に従い、説明的なメソッド名と変数名を使用します
• 一貫した構成（リソース、サービス、リポジトリ、エンティティ、設定）でアプリケーションを構成します

GraalVM Native Image の詳細

• 最適なパフォーマンスと最小限のフットプリントを実現するようにネイティブイメージビルドを設定します
• ネイティブコンパイルにおけるリフレクション、リソース、シリアライズについて理解し、設定します
• 起動時間を短縮するため、可能な場合はビルド時初期化を使用します
• 互換性のないコードパスには適切な置換を実装します

命名規則

• クラス名には PascalCase を使用します（例：UserResource、OrderService）
• メソッド名と変数名には camelCase を使用します（例：findUserById、isOrderValid）
• 定数には ALL_CAPS を使用します（例：MAX_RETRY_ATTEMPTS、DEFAULT_PAGE_SIZE）

Java と GraalVM の使用

• 該当する場合は Java 17 以降の機能（例：レコード、sealed クラス、パターンマッチング）を使用します
• ネイティブイメージにおける GraalVM の閉世界仮定を理解します
• 複数の言語を統合する際は、GraalVM のポリグロット機能を使用します
• JVM モードでは、GraalVM の高性能 JIT コンパイラーを活用します

Native Image の設定

• reflect-config.json またはフレームワークのアノテーションを使用してリフレクションを設定します
• resource-config.json を使って、ネイティブイメージに含めるリソースを登録します
• 実行時のシリアライズが必要なクラスのシリアライズを設定します
• 動的プロキシの生成には proxy-config.json を使用します
• ビルド時の設定には native-image.properties を活用します

フレームワークとの統合

Quarkus

• ネイティブイメージに対応した Quarkus エクステンションを使用します
• 迅速な開発には Quarkus Dev Mode を活用します
• ネイティブビルドを最適化するために quarkus.native.* プロパティを設定します

Micronaut

• ネイティブに適したコードを実現するため、Micronaut のコンパイル時処理を使用します
• 自動設定には Micronaut の GraalVM メタデータを活用します
• リフレクションを使わない Bean のイントロスペクションには @Introspected を使用します

Spring Native

• Spring Boot のネイティブイメージをサポートするために Spring Native を使用します
• リフレクションとリソースのヒントには @NativeHint アノテーションを設定します
• Spring の設定には AOT 処理を使用します

テスト

• フレームワーク固有のテストサポートを利用して、JUnit 5 で単体テストを作成します
• JVM モードとネイティブイメージビルドの両方をテストします
• 統合テストには @QuarkusTest、@MicronautTest、または Spring Boot Test を使用します
• 統合テストにはインメモリデータベースまたは Testcontainers を導入します

パフォーマンスの最適化

• ネイティブイメージのビルドを高速化するため、リフレクションの使用を最小限に抑えます
• 静的データにはビルド時初期化を使用します
• ネイティブイメージに適切なメモリ設定（-Xmx、-Xms）を実装します
• GraalVM VisualVM または async-profiler を使用してアプリケーションをプロファイリングします
• クラスパスのスキャンを減らし、起動時間を最適化します

セキュリティに関する考慮事項

• ネイティブイメージコンパイルのセキュリティ上の影響を理解します
• HTTPS 接続の証明書を適切に処理するように設定します
• フレームワーク固有のセキュリティモジュール（Quarkus Security、Micronaut Security）を使用します
• ネイティブ環境へのデプロイでは、安全なコーディング手法を実践します

ロギングとモニタリング

• ロギングには SLF4J と Logback、または JUL を使用します
• ネイティブイメージに対応したヘルスチェックとメトリクスを実装します
• クラウドネイティブなモニタリングには MicroProfile Health と Metrics を使用します
• 適切なログレベルと構造化ロギングを設定します

ビルドとデプロイ

• GraalVM ネイティブイメージプラグインを使用して、Maven または Gradle を利用します
• ネイティブイメージコンテナ向けに、マルチステージの Docker ビルドを設定します
• 本番環境へのデプロイには、distroless または最小限のベースイメージを使用します
• ネイティブイメージのビルドに対応した CI/CD パイプラインを実装します
• コンテナイメージの作成には、buildpacks の使用を検討します

ネイティブビルドのトラブルシューティング

• トレーシングエージェントを使用して、実行時設定の要件を特定します
• ビルド出力を分析し、不足しているリフレクション設定やリソース設定を確認します
• -H:+ReportExceptionStackTraces を使用して、ネイティブイメージの問題をデバッグします
• 問題のあるネイティブビルドのデバッグには、フォールバックイメージを使用します

一般的なベストプラクティス

• RESTful API 設計の原則に従います
• 起動が速く、メモリ使用量が最小限のマイクロサービスには、GraalVM を活用します
• リソースを効率的に使用するため、非同期処理とリアクティブ処理を実装します
• 高い凝集度と低い結合度を実現するため、SOLID 原則に従います
• クラウドネイティブなデプロイ（Kubernetes、サーバーレス、エッジコンピューティング）を前提に設計します
• ネイティブイメージの設定をバージョン管理下に置きます
• GraalVM 固有の要件と制限事項を文書化します