Red Hat Summit第3章 異なる環境の設定
RichFaces には JSF (JavaServer Faces) 仕様に含まれるすべてのタグ (コンポーネント) に対するサポートが含まれています。 既存の JSF プロジェクトに RichFaces の機能を追加するには、 RichFaces ライブラリをプロジェクトの
lib ディレクトリに配置し、 フィルタマッピングを追加します。 RichFaces を追加しても既存プロジェクトの動作は変更しません。
3.1. Web アプリケーション記述子パラメータ
リンクのコピーリンクがクリップボードにコピーされました!
RichFaces では
web.xml にパラメータを定義する必要はありませんが、 下記の RichFaces パラメータは開発中に便利なパラメータで、 RichFaces アプリケーションの柔軟性を向上します。
| 名前 | デフォルト | 内容 |
|---|---|---|
| org.richfaces.SKIN | DEFAULT | アプリケーションで使用されるスキンの名前です。 スキン名を含むリテラルストリングか、 org.richfaces.framework.skin タイプのプロパティの String プロパティ (スキン名) に関連する EL 表現 (#{...}) になります。 EL 表現の場合、 そのインスタンスが現在のスキンとして使用されます。 |
| org.richfaces.LoadScriptStrategy | DEFAULT | RichFaces スクリプトファイルがアプリケーションへロードされる方法を定義します。 可能な値は ALL、 DEFAULT、 NONE です。 |
| org.richfaces.LoadStyleStrategy | DEFAULT | RichFaces スタイルファイルがアプリケーションへロードされる方法を定義します。 可能な値は ALL、 DEFAULT、 NONE です。 |
| org.ajax4jsf.LOGFILE | なし | アプリケーションの URL またはコンテナログファイル (該当する場合) です。 このパラメータが設定されている場合、 指定の URL からのコンテンツは iframe ウインドウのデバッグページ上に表示されます。 |
| org.ajax4jsf.VIEW_HANDLERS | なし | ビューハンドラチェーンに挿入するための ViewHandler インスタンスのコンマ区切りリストです。 これらのハンドラは、 リストされた順に RichFaces のビューハンドラの前に挿入されます。 Facelets アプリケーションでは、 faces-config.xml ファイルではなく、 このリストに com.sun.facelets.FaceletViewHandler を宣言します。 |
| org.ajax4jsf.CONTROL_COMPONENTS | なし | メッセージバンドルローダやエイリアス Bean コンポーネントなど特別な 制御ケース コンポーネントのコンマ区切りリストです。 これらのハンドラは静的フィールド COMPONENT_TYPE からの反射より提供されます。 これらコンポーネントのエンコーディングメソッドは、 コンポーネントが更新されていなくても AJAX 応答のレンダリング中に常に呼び出されます。 |
| org.ajax4jsf.ENCRYPT_RESOURCE_DATA | false | 生成されたリソース (暗号生成データなど) ではリソース URL でエンコードされます。 例えば、 mediaOutput コンポーネントによって生成されたイメージの URL には生成メソッド名が含まれます。 悪意のあるコードはこれを利用して JSF Bean や属性の要求を作成できるため、 重大なアプリケーションではこのパラメータを true に設定する必要があります (この修正は Java Runtime Environment 1.4 で動作します)。 |
| org.ajax4jsf.ENCRYPT_PASSWORD | random | リソースデータの暗号化に使用されるパスワードです。 設定されていないと、 無作為のパスワードが使用されます。 |
| org.ajax4jsf.COMPRESS_SCRIPT | true | 定義されると、 フレームワークが JavaScript ファイルを再フォーマットできなくなります。 そのため、 デバッグ機能が使用できなくなります。 |
| org.ajax4jsf.RESOURCE_URI_PREFIX | a4j | 生成されたリソースすべての URL に追加するプレフィックスを定義します。 RichFaces によって生成されたリソース要求を処理することが目的です。 |
| org.ajax4jsf.GLOBAL_RESOURCE_URI_PREFIX | a4j/g | すべてのグローバルリソースの URI に追加されるプレフィックスを定義します。 RichFaces によって生成されたリソース要求を処理するためのプレフィックスです。 |
| org.ajax4jsf.SESSION_RESOURCE_URI_PREFIX | a4j/s | 生成されたリソースのセッションを追跡するために使用するプレフィックスを定義します。 RichFaces によって生成されたリソース要求を処理するためのプレフィックスです。 |
| org.ajax4jsf.DEFAULT_EXPIRE | 86400 | リソースがブラウザへストリームバックされた時にリソースがキャッシュされる期間 (秒単位) を定義します。 |
| org.ajax4jsf.SERIALIZE_SERVER_STATE | false | true に設定されると、 コンポーネントのステート (ツリーではない) がセッションに保存される前にシリアライズされます。 モデル変更に影響を受けるビューステートを持つアプリケーションで有用です。 この代わりに各環境で com.sun.faces.serializeServerState パラメータと org.apache.myfaces.SERIALIZE_STATE_IN_SESSION パラメータを使用することもできます。 |
注記
org.richfaces.SKIN は org.ajax4jsf.SKIN と同様に使用されます。
| 名前 | デフォルト | 内容 |
|---|---|---|
| log4j-init-file | - | log4j.xml 設定ファイルへの (Web アプリケーションのコンテキストに相対的な) パスです。アプリケーションごとのカスタムロギングを設定するために使用できます。 |
| enable-cache | true | フレームワークによって生成されたリソース (JavaScript、 CSS、 イメージなど) のキャッシングを有効にしますが、 カスタムの JavaScript やスタイルをデバッグする際はキャッシュされたリソースは使用されません。 |
| forcenotrf | true | すべての JSF ページが HTML 構文チェックフィルタによって解析されるよう強制します。 false に設定すると、 AJAX 応答のみが解析され、 整形式 XML へ変換されます。 false に設定するとパフォーマンスは向上されますが、 AJAX の更新中に予期しない情報がレンダリングされる原因にもなります。 |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}