55 WebCenter Sitesへのカスタマイズの追加
WebCenter Sites 12cでは、Weblogic Serverの共有ライブラリ・メカニズムを使用してカスタマイズを追加するためのモジュラとアップグレード・セーフの方法が用意されています。WebCenter Sitesのランタイム・アプリケーションはこの共有ライブラリを参照するため、この共有ライブラリに追加するカスタマイズを実行時にWebCenter Sitesのクラス・パスで使用できるようになります。
共有ライブラリを使用する利点は複数あります。WebCenter Sitesをアップグレードしても、カスタマイズは別の共有ライブラリで管理されるため、そのまま残ります。さらに、デプロイ中にカスタマイズによって発生するエラーのデバッグも簡単になります。
共有ライブラリの使用
WebCenter Sitesランタイム(sites.war
)は、extend.sites.webapp-lib.warという名前の共有ライブラリを参照します。デフォルトでは、この共有ライブラリがプレースホルダになります。すべてのWebCenter Sitesカスタマイズをextend.sites.webapp-lib.war
に追加する必要があります。共有ライブラリで共有するアーティファクトの例の一部を次に示します。
-
<customapp>.js
、イメージ(例:<custom>.png
)、CSSファイル(例:<custom>.css
)などのファイルを必要とするアプリケーションをビルドしている場合。これらのファイルを<custom>.war
に追加できます。 -
テンプレートの作成に使用されるカスタム・タグ・ライブラリをビルドしている場合。このライブラリには
custom.tld
およびcustom.jar
が含まれます。
カスタマイズで共有ライブラリを作成する方法を次に示します。
-
カスタム・リソース(
.jar
ファイル)をアセンブルし、共有ライブラリ(.war
ファイル)をパッケージします -
WebCenter Sitesが実行されている管理対象サーバーに共有ライブラリをデプロイします
カスタム・リソースのアセンブルと共有ライブラリのパッケージ
-
リソース(イメージ、cssなど)を関連するサブディレクトリとともにベース・ディレクトリにアセンブルします。共有ライブラリの作成とWebLogic Serverへのデプロイの詳細は、『Oracle Fusion Middleware Oracle WebLogic Serverアプリケーションの開発』の共有Java EEライブラリ・ファイルのアセンブルに関する項を参照してください。
-
ライブラリを記述する
META-INF/MANIFEST.MF
ファイルを作成します。Manifest-Version: 1.0 Specification-Title: Customizations Specification-Version: 1.0 Implementation-Title: Custom Implementation Implementation-Version: 1.0 Implementation-Vendor: Example.com Extension-Name: images
-
ベース・ディレクトリをWARファイルとしてパッケージします。ライブラリをWARファイルに圧縮した後のライブラリのパッケージ内容は次のようになります。
$ jar -tf customizations.war META-INF/ META-INF/MANIFEST.MF WEB-INF/weblogic.xml mylogo.gif WEB-INF/lib/custom.jar WEB-INF/futuretense_cs/custom.tld customapp.js custom.png
.jar
ファイルも/WEB-INF/lib
フォルダに配置されます。
ノート:
リソース参照の優先順位は、最初にsites.war
、次に共有ファイルです。WebLogic Serverは、最初に検出したリソースを提供します。つまり、次のようになります。
-
sites.war
ファイルでリソースを探します。 -
リソースが
sites.war
ファイルに見つからない場合は、共有ライブラリを探します。
WebCenter Sitesが実行されている管理対象サーバーへの共有ライブラリのデプロイ
-
WebCenter Sitesが実行されている管理対象サーバーにWARをライブラリとしてデプロイします。
-
Webアプリケーションが参照する単一の共有ライブラリから2つのJARを一緒にデプロイすることもできます。