@RetentionSE(valueSE=RUNTIMESE) @TargetSE(valueSE=TYPESE) @InheritedSE public @interface FacesRenderer
クラスにこのアノテーションが存在すると、クラスは自動的に Renderer としてランタイムに登録されます。renderKitId() 属性の値は、この Renderer のインスタンスが追加される render-kit-id と見なされます。このアノテーションが表示されるクラスには、パブリックのゼロ引数コンストラクターが必要です。そのようなコンストラクターが存在せず、アプリケーションを稼働させてはならない場合、実装は致命的なエラーを示す必要があります。その RenderKit 内では、rendererType() 属性の値はレンダラー型と見なされ、componentFamily() 属性の値はコンポーネントファミリーと見なされます。実装は、セクション JSF.11.5 のアルゴリズムで見つかった FacesRenderer でアノテーションが付けられたクラスごとに、次のアクションが実行されることを保証する必要があります。
このアプリケーションの RenderKitFactory への参照を取得します。
render-kit-id の RenderKit が存在するかどうかを確認します。存在する場合、そのインスタンスを renderKit として議論します。存在しない場合、そのような RenderKit が存在しないと実装で致命的なエラーを示す必要があり、アプリケーションをサービスに投入してはなりません。
パブリックゼロ引数コンストラクターを使用して、このクラスのインスタンスを作成します。
renderKit で RenderKit.addRenderer(java.lang.String, java.lang.String, jakarta.faces.render.Renderer) を呼び出し、最初の引数として component-family を、2 番目の引数として renderer-type を、3 番目の引数として新しくインスタンス化された RenderKit インスタンスを渡します。
| 修飾子と型 | 必須要素と説明 |
|---|---|
StringSE | componentFamily このアノテーション属性の値は、 |
StringSE | rendererType このアノテーション属性の値はレンダラー型と見なされ、 |
| 修飾子と型 | オプションの要素と説明 |
|---|---|
StringSE | renderKitId このアノテーション属性の値は、 |
public abstract StringSE rendererType
このアノテーション属性の値はレンダラー型と見なされ、componentFamily() と組み合わせて、RenderKit.getRenderer(java.lang.String, java.lang.String) を呼び出すことによってこの Renderer のインスタンスへの参照を取得できます。
public abstract StringSE componentFamily
このアノテーション属性の値は、rendererType() と組み合わせて、RenderKit.getRenderer(java.lang.String, java.lang.String) を呼び出すことにより、この Renderer のインスタンスへの参照を取得するために使用できるコンポーネントファミリーと見なされます。
public abstract StringSE renderKitId
このアノテーション属性の値は、Renderer のこのクラスのインスタンスをインストールする必要がある render-kit-id と見なされます。
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.