1. 導入
エンタープライズJava開発において、ログ出力やトランザクション管理、権限チェックといった「横断的関心事」をビジネスロジックから分離することは重要です。これを実現するための強力な武器が java.lang.reflect.Proxy です。本記事では、動的プロキシとアノテーションを組み合わせ、いかに柔軟で保守性の高いコードを実現するかを解説します。
2. 基礎知識
Proxyとは、あるオブジェクトのメソッド呼び出しを「横取り」して、前後に独自の処理を追加するための仕組みです。
・リフレクション: 実行時にクラスの構造（メソッドやフィールド）を解析・操作する技術。
・アノテーション: クラスやメソッドにメタデータを付与するもの。
・Retention (RetentionPolicy.RUNTIME): アノテーションをリフレクション経由で実行時に読み取るために必須の設定です。
・Target (ElementType.METHOD): アノテーションをどこ（メソッド等）に付与できるかを定義します。
3. 実装/解決策
動的プロキシを作成するには、java.lang.reflect.InvocationHandler インターフェースを実装します。このクラスの `invoke` メソッド内で、「本来のメソッド実行前後に何をするか」を記述します。アノテーションを併用することで、特定のメソッドだけをインターセプトするような条件分岐を動的に実装できます。
4. サンプルプログラム
以下のコードは、`@Loggable` アノテーションが付与されたメソッドのみ、実行ログを出力するプロキシの例です。
import java.lang.annotation.;
import java.lang.reflect.;
// 1. 実行時に読み取れるアノテーションを定義
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
@interface Loggable {}
// 2. インターフェース
interface Service {
@Loggable
void doTask();
void skipTask();
}
// 3. 実装クラス
class ServiceImpl implements Service {
public void doTask() { System.out.println(“業務処理を実行中…”); }
public void skipTask() { System.out.println(“ログ不要な処理を実行中…”); }
}
// 4. InvocationHandlerの実装
class LoggingHandler implements InvocationHandler {
private final Object target;
public LoggingHandler(Object target) { this.target = target; }
@Override
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
// アノテーションの有無を確認
if (method.isAnnotationPresent(Loggable.class)) {
System.out.println(“[ログ] ” + method.getName() + ” を開始します”);
}
Object result = method.invoke(target, args); // 本来の処理
return result;
}
}
// 5. 実行クラス
public class Main {
public static void main(String[] args) {
Service realService = new ServiceImpl();
Service proxy = (Service) Proxy.newProxyInstance(
Service.class.getClassLoader(),
new Class[]{Service.class},
new LoggingHandler(realService)
);
proxy.doTask(); // ログが出力される
proxy.skipTask(); // ログが出力されない
}
}
5. 応用・注意点
現場での利用にあたっては以下の点に注意してください。
・パフォーマンス: リフレクションは直接呼び出しよりもオーバーヘッドがあります。頻繁に呼ばれるホットパスでの乱用は避けましょう。
・デバッグの難易度: プロキシを介するとスタックトレースが深くなり、デバッグが複雑になります。ログ出力等のインフラ層に留めるのが賢明です。
・インターフェース必須: `java.lang.reflect.Proxy` はインターフェースを実装したクラスに対してのみ有効です。クラスベースのプロキシが必要な場合は、CGLIBやByteBuddyといったライブラリを検討してください。
これらを使いこなすことで、ビジネスロジックを汚染することなく、高度な機能拡張が可能になります。ぜひ実装の引き出しとして活用してください。
コメント