R - このビジターのメソッドの戻り型。結果を返すことを必要としないビジターのVoidを使用する。P - このビジターのメソッドに追加するパラメータの型。追加のパラメータを必要としないビジターのVoidを使用する。@SupportedSourceVersion(value=RELEASE_6) public class ElementScanner6<R,P> extends AbstractElementVisitor6<R,P>
RELEASE_6ソース・バージョンに適したデフォルトの動作を持つ、プログラム要素のスキャン・ビジターです。このクラスのvisitXYZメソッドは、個々のメソッドの仕様に示されているとおりに、囲まれている要素やパラメータなどに対してscanを呼び出すことで、コンポーネント要素をスキャンします。サブクラスは、visitXYZメソッドをオーバーライドすることで、要素をビジットする順序を制御できます。スキャナのクライアントは、目的のルート・オブジェクトに対してv.visit(e, p)ではなくv.scan(e, p)を呼び出すことによって、望ましい動作を取得することができます。
サブクラスがvisitXYZメソッドをオーバーライドすると、新しいメソッドによってsuper.visitXYZを呼び出すことで、囲まれている要素をデフォルトの方法でスキャンすることが可能になります。この方法で、具象ビジターは追加の処理に対するコンポーネント要素のトラバーサルの順序を制御できます。たとえば、オーバーライドされたメソッドの開始時にsuper.visitXYZを常に呼び出すことで、事前に順序付けられたトラバーサルが生じます。ほかの順序でコンポーネント要素をトラバースするには、super.visitXYZを呼び出すのではなく、オーバーライドするビジット・メソッドで目的の順序の要素に対してscanを呼び出すようにしてください。
このクラスのメソッドは、一般規約に従ってオーバーライドできます。@Overrideを持つ具象サブクラスの注釈型メソッドを使用すると、メソッドが意図されたとおりにオーバーライドされます。
警告: Java(tm)プログラミング言語の将来のバージョンに、現在は未知の新しい言語構造が追加される場合、それらを格納するために、このクラスによって実装されるElementVisitorインタフェースにメソッドが追加される可能性があります。したがって、将来的に、名前が"visit"で始まるメソッドがこのクラスに追加される可能性があります。非互換性が生じることを避けるため、このクラスを拡張するクラスでは、名前が"visit"で始まるインスタンス・メソッドを宣言しないようにしてください。
このような新しいビジット・メソッドが追加されると、このクラスのデフォルトの実装はvisitUnknownメソッドを呼び出します。また、新しい要素スキャナ・ビジター・クラスが、新しい言語レベルに対応するように導入されます。このビジターでは、目的のビジット・メソッドに対するデフォルトの動作が異なります。新しいビジターが導入された場合、このビジターのすべてまたは一部が非推奨になる可能性があります。
ElementScanner7, ElementScanner8| 修飾子と型 | フィールドと説明 |
|---|---|
protected R |
DEFAULT_VALUE
指定されたデフォルト値です。
|
| 修飾子 | コンストラクタと説明 |
|---|---|
protected |
ElementScanner6()
具象サブクラスのコンストラクタです。デフォルト値に
nullを使用します。 |
protected |
ElementScanner6(R defaultValue)
具象サブクラスのコンストラクタです。デフォルト値に引数を使用します。
|
| 修飾子と型 | メソッドと説明 |
|---|---|
R |
scan(Element e)
v.scan(e, null)と同等の簡易メソッドです。 |
R |
scan(Element e, P p)
e.accept(this, p)を呼び出すことで要素を処理します。サブクラスによって、このメソッドをオーバーライドできます。 |
R |
scan(Iterable<? extends Element> iterable, P p)
指定された要素で反復し、各要素に対して
scan(Element, P)を呼び出します。 |
R |
visitExecutable(ExecutableElement e, P p)
実行可能要素をビジットします。
|
R |
visitPackage(PackageElement e, P p)
パッケージ要素をビジットします。
|
R |
visitType(TypeElement e, P p)
型要素をビジットします。
|
R |
visitTypeParameter(TypeParameterElement e, P p)
型パラメータ要素をビジットします。
|
R |
visitVariable(VariableElement e, P p)
変数要素をビジットします。
|
visit, visit, visitUnknownprotected final R DEFAULT_VALUE
protected ElementScanner6()
nullを使用します。protected ElementScanner6(R defaultValue)
defaultValue - デフォルト値public final R scan(Iterable<? extends Element> iterable, P p)
iterable - スキャン対象の要素p - 追加のパラメータDEFAULT_VALUEpublic R scan(Element e, P p)
e.accept(this, p)を呼び出すことで要素を処理します。サブクラスによって、このメソッドをオーバーライドできます。e - スキャンする要素p - スキャナ指定のパラメータeのビジット結果。public R visitPackage(PackageElement e, P p)
e - ビジットする要素p - ビジター指定のパラメータpublic R visitType(TypeElement e, P p)
e - ビジットする要素p - ビジター指定のパラメータpublic R visitVariable(VariableElement e, P p)
RESOURCE_VARIABLEの場合は、visitUnknownが呼び出されます。e - ビジットする要素p - ビジター指定のパラメータpublic R visitExecutable(ExecutableElement e, P p)
e - ビジットする要素p - ビジター指定のパラメータpublic R visitTypeParameter(TypeParameterElement e, P p)
e - ビジットする要素p - ビジター指定のパラメータ バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.