public class AspectJAdviceParameterNameDiscoverer
extends ObjectSE
implements ParameterNameDiscoverer

ParameterNameDiscoverer 実装は、ポイントカット式からアドバイスメソッドのパラメーター名を推測し、句を返し、スローします。明確な解釈が利用できない場合は、null を返します。

このクラスは、引数を次のように解釈します。

1. メソッドの最初のパラメーターの型が JoinPoint または ProceedingJoinPoint である場合、thisJoinPoint をアドバイスに渡すためのものであると想定され、パラメーター名には値 "thisJoinPoint" が割り当てられます。
2. メソッドの最初のパラメーターの型が JoinPoint.StaticPart の場合、"thisJoinPointStaticPart" をアドバイスに渡すためのものであると想定され、パラメーター名には値 "thisJoinPointStaticPart" が割り当てられます。
3. throwingName が設定されていて、型 Throwable+ のバインドされていない引数がない場合、IllegalArgumentExceptionSE が発生します。型 Throwable+ のバインドされていない引数が複数ある場合は、AspectJAdviceParameterNameDiscoverer.AmbiguousBindingException が発生します。型 Throwable+ のバインドされていない引数が 1 つだけある場合、対応するパラメーター名には値 <throwingName> が割り当てられます。
4. バインドされていない引数が残っている場合は、ポイントカット式が調べられます。a を、バインディング形式で使用されるアノテーションベースのポイントカット式（@annotation、@this、@target、@args、@within、@withincode）の数とします。バインディング形式での使用箇所は、それ自体を推測する必要があります。ポイントカット内の式が Java 変数名の規則を満たす単一の文字列リテラルである場合、変数名であると見なされます。a がゼロの場合、次の段階に進みます。a > 1 の場合、AmbiguousBindingException が発生します。a == 1 であり、型 Annotation+ のバインドされていない引数がない場合、IllegalArgumentException が発生します。そのような引数が 1 つだけある場合、対応するパラメーター名には、ポイントカット式からの値が割り当てられます。
5. returnName が設定されていて、バインドされていない引数がない場合、IllegalArgumentException が発生します。バインドされていない引数が複数ある場合は、AmbiguousBindingException が発生します。バインドされていない引数が 1 つだけの場合、対応するパラメーター名には値 <returningName> が割り当てられます。
6. バインドされていない引数が残っている場合、ポイントカット式は、バインディングフォームで使用されている this、target、args ポイントカット式についてもう一度調べられます（バインディングフォームは、アノテーションベースのポイントカットに従って推定されます）。プリミティブ型のバインドされていない引数が複数残っている場合（args でのみバインドできます）、AmbiguousBindingException が発生します。プリミティブ型の引数が 1 つだけある場合、args バインド変数が 1 つだけ見つかった場合は、対応するパラメーター名に変数名を割り当てます。args バインド変数が見つからなかった場合、IllegalStateException が発生します。複数の args バインド変数がある場合、AmbiguousBindingException が発生します。この時点で、バインドされていない引数が複数残っている場合は、AmbiguousBindingException を発生させます。バインドされていない引数が残っていない場合は、完了です。バインドされていない引数が 1 つだけ残っていて、this、target、args からバインドされていない候補変数名が 1 つしかない場合は、対応するパラメーター名として割り当てられます。複数の可能性がある場合は、AmbiguousBindingException が発生します。

IllegalArgumentException または AmbiguousBindingException を発生させる際の動作は、この発見者を責任の連鎖の一部として使用できるように構成できます。デフォルトでは、条件がログに記録され、getParameterNames(..) メソッドは単に null を返します。raiseExceptions プロパティが true に設定されている場合、条件はそれぞれ IllegalArgumentException および AmbiguousBindingException としてスローされます。

それは完全に明確でしたか？ ;）

短縮版: 明確なバインディングが推定できる場合、そうです。アドバイスの要件を満たさない可能性がある場合は、null が返されます。raiseExceptions プロパティを true に設定すると、パラメーター名が見つからない場合に null を返す代わりに説明的な例外がスローされます。