ADF Faces構成APIについて

ADF Facesには、adf-faces-config.xmlファイルから構成プロパティを取得する際に使用できる、oracle.adf.view.faces.context.AdfFacesContextと呼ばれるAPIが用意されています。AdfFacesContextクラスは、ADF Facesで必要なリクエスト単位およびwebapp単位のすべての情報に対するコンテキスト・クラスです。リクエストごとにAdfFacesContextクラスのインスタンスが1つ存在します。注意: JSF FacesContextクラスに類似していますが、AdfFacesContextクラスはFacesContextを拡張しません。

ADF Faces構成プロパティは、次の方法を使用して取得できます。

構成プロパティのプログラムによる取得

ADF Faces構成プロパティをプログラムで取得するには、最初に、staticメソッドgetCurrentInstance()をコールしてAdfFacesContextオブジェクトのインスタンスを取得し、次に、必要なプロパティを取得するメソッドをコールします。次に例を示します。

// Get an instance of the AdfFacesContext object
AdfFacesContext context = AdfFacesContext.getCurrentInstance();

// Get the time-zone property
TimeZone zone = context.getTimeZone();

// Get the right-to-left property
if (context.isRightToLeft())
{
   ...
}    

AdfFacesContextには、ADF Faces構成プロパティを取得するための次のメソッドが用意されています。

メソッド 説明
getAccessibilityMode() accessibility-modeプロパティを戻します。
getCurrencyCode() currency-codeプロパティを戻します。
getCurrencyCode() currency-codeプロパティを戻します。
isDebugOutput() debug-outputプロパティを戻します。
getDecimalSeparator() decimal-separatorプロパティを戻します。
getNumberGroupingSeparator() number-grouping-separatorプロパティを戻します。
getOracleHelpServletUrl() oracle-help-servlet-urlプロパティを戻します。
getOutputMode() output-modeプロパティを戻します。
getProcessScope() process-scope-lifetimeプロパティを戻します。
isRightToLeft() right-to-leftプロパティを戻します。
getSkinFamily() skin-familyプロパティを戻します。
getTimeZone() time-zoneプロパティを戻します。
getUploadedFileProcessor() uploaded-file-processorプロパティを戻します。

値バインディングの使用による構成プロパティの取得

AdfFacesContextクラスには、JSF EL式で使用するためにコンテキスト・オブジェクト・プロパティを公開する、adfFacesContextと呼ばれるELの暗黙的な変数が含まれています。JSF EL式を使用すると、コンポーネントの属性値をadfFacesContextオブジェクトのプロパティの1つにバインドできます。たとえば、次のサンプルのEL式では、ADF Facesの<currency-code>プロパティが、次のようにJSFのConvertNumberコンポーネントの属性値にバインドされています。

<ADF-Faces-Components:outputText>
		<f:convertNumber currencyCode="#{adfFacesContext.currencyCode}"/>
</ADF-Faces-Components:outputText>    

AdfFacesContext APIの詳細は、「ADF FacesのJavaDoc」を参照してください。


ADF Faces構成について
ADF Faces構成ファイルの編集
リファレンス: ADF Faces構成要素