この付録の内容は次のとおりです。
GlassFishサーバーは、Oracle ADFアプリケーションを実行するように構成できるアプリケーション・サーバーです。JDeveloperを使用すると、ADFアプリケーションをGlassFish Serverに直接デプロイするか、またはデプロイ・ターゲットとしてアーカイブ・ファイルに間接的にデプロイし、このアーカイブ・ファイルを対象のGlassFish Serverにインストールできます。
GlassFishサーバーがインストールされていない場合は、GlassFishサーバーをWebからダウンロードできます。GlassFishサーバーでADFアプリケーションを実行する前に、Oracle ADFランタイム・ライブラリを使用してGlassFishを構成する必要があります。
GlassFishに対してサポートされているOracle ADF機能のリストは、Oracle Technology Network (OTN)のサイト(http://www.oracle.com/technetwork/developer-tools/adf/overview/adfessentials-1719844.html
)を参照してください。
JDeveloperおよびADFでサポートされているGlassFishサーバーのバージョンに関する情報は、OTN (http://www.oracle.com/technetwork/developer-tools/jdev/documentation/index.html
)で、ご使用のJDeveloperリリースの「Certification Information」リンクを参照してください。
GlassFishの入手方法およびインストール方法は、https://javaee.github.io/glassfish/download
を参照してください。
GlassFish用にADFアプリケーションを開発する方法の詳細は、『Oracle Application Development FrameworkによるFusion Webアプリケーションの開発』の付録「GlassFishへのADFアプリケーションのデプロイ」を参照してください。
GlassFishサーバーでOracle ADFの機能をサポートする場合は、Oracle ADF EssentialsおよびADFランタイム・ライブラリをインストールする必要があります。
Oracle ADF Essentialsは、GlassFishサーバーのオープン・ソース・バージョンおよび市販バージョンをサポートしています。どちらのバージョンもフル・プラットフォームの配布が必要です。Webプロファイルの配布はサポートされていません。GlassFishサーバーをインストールした後、ADF Essentialsのadf-essentials.zip
ファイルをOTNから取得し、この付録の手順に従ってADFランタイム・ライブラリをインストールする必要があります。
このサーバーおよびその他のアプリケーション・サーバーのタスクを起動および停止する方法の詳細は、GlassFishのWebサイトにあるGlassFishのドキュメントを参照してください。
次のトピックに記載されているタスクを実行する必要があります。
GlassFishのWebサイトからGlassFishサーバーのオープン・ソース・バージョンをダウンロードできます。
https://javaee.github.io/glassfish/download
注意:
JMSのような企業クラス機能を含んでいるため、Java EE 7のフル・プラットフォーム(Java EE 7 Webプロファイルではなく)をダウンロードする必要があります。
GlassFishサイトの手順およびドキュメントに従って、GlassFishサーバーをインストールして構成します。
注意:
ADF Essentialsをインストールする前に、/glassfish–4.1/glassfish/modules/javax.el.jar
にあるGlassFishサーバーのインストールに、javalibs.com
などのJavaリポジトリからダウンロード可能なjavax.el–3.0.1-b08.jar
のパッチを適用する必要があります。
GlassFishサーバーでOracle ADFアプリケーションを実行するには、ADFランタイム・ライブラリ・ファイルをGlassFishのインストール・ディレクトリにインストールする必要があります。
Oracle ADF Essentialsのadf-essentials.zip
ファイルをOracle Technology Network (http://www.oracle.com/technetwork/developer-tools/adf/downloads/index.html
)からダウンロードできます。
adf-essentials.zip
ファイルをダウンロードした後、必要なファイルをGlassFishインストール・ディレクトリにコピーするために使用できるフラットな構造の一時ディレクトリにファイルを抽出できます。
たとえば、unzip
を使用する場合は、-j
オプションを追加して、階層フォルダを持たないフラットなディレクトリ構造を作成できます。
unzip -j <file> -d <destination>
GlassFishサーバーは、Oracle ADFアプリケーションを実行するように構成できます。GlassFishサーバーでADFアプリケーションを実行する前に、Oracle ADFランタイム・ライブラリを使用してGlassFishを構成する必要があります。
ADFランタイム・ライブラリは次のものから構成されています。
ADF Shareライブラリ
ADF動作保証済互換JSF実装
ADFモデル・ライブラリ
ADF Controllerライブラリ
ADFビュー・ライブラリ
ADF ShareライブラリおよびADF動作保証済互換JSF実装は、GlassFishインストールに手動でインストールする必要があります。オペレーティング・システムのコマンドまたはツールを使用して、ファイルをGlassFishにコピーします。手順は、「ADF Shareライブラリの手動でのインストール」を参照してください
ADFモデル、ADF ControllerおよびADFビューの各ライブラリは、デプロイされるアプリケーションとともにGlassFishにロードされます。JDeveloperを使用してアプリケーションを開発する場合は、デプロイ用にアプリケーションをEARファイルにパッケージ化する前に、必要なライブラリを参照します。
ADFランタイム・ライブラリをインストールする手順:
GlassFishのADF Shareをマッピングするときに使用できるオプションについて理解しておくと役立ちます。詳細は、「ADFランタイム・ライブラリを使用したGlassFishの構成」を参照してください
次のタスクを完了する必要があります。
GlassFishサーバーをインストールします。
adf-essentials.zip
ファイルを取得し、一時ディレクトリに解凍します。
ADF動作保証済互換JSF実装のバージョン2.2.8-11を、https://repo.maven.apache.org/maven2/org/glassfish/javax.faces/2.2.8-11/javax.faces-2.2.8-11.jarのMaven Centralから取得します
ADF Shareランタイム・ライブラリをインストールする方法:
次のADF Shareライブラリ・ファイルを一時ディレクトリから<glassfish>
/domains/domain1/lib/applibs
フォルダにコピーまたは移動します。
ADF Shareファイルは、「Oracle ADFランタイムの取得」で説明しているように、adf-essentials.zip
ファイルを解凍した一時ディレクトリにあります。このディレクトリは<temp>
/oracle_common/modules
になります。
次のJARファイルを<glassfish>/domains/domain1/lib/applibs
ディレクトリにコピーする必要があります。
oracle.adf.share.ca_12.2.1/adf-share-base.jar oracle.adf.share.ca_12.2.1/adf-share-ca.jar oracle.adf.share_12.2.1/commons-el.jar oracle.adf.share_12.2.1/adf-share-support.jar oracle.adf.share_12.2.1/adfsharembean.jar oracle.adf.share_12.2.1/jsp-el-api.jar oracle.adf.share_12.2.1/adflogginghandler.jar oracle.adf.share_12.2.1/oracle-el.jar oracle.mds_12.2.1/mdsrt.jar oracle.bali.share_12.2.1/share.jar oracle.xmlef_12.2.1/xmlef.jar oracle.javatools_12.2.1/resourcebundle.jar oracle.javatools_12.2.1/javamodel-rt.jar oracle.javatools_12.2.1/javatools-nodeps.jar oracle.javatools_12.2.1/oicons.jar oracle.adf.security_12.2.1/adf-share-security.jar oracle.adf.security_12.2.1/adf-controller-security.jar oracle.xdk_12.2.1/xmlparserv2_sans_jaxp_services.jar oracle.xdb_11.1.0.jar oracle.jrf_12.2.1/jrf-api.jar oracle.jdbc_11.2/ojdbc6dms.jar oracle.dms_12.2.1/dms.jar oracle.odl_12.2.1/ojdl.jar oracle.odl_12.2.1/ojdl2.jar oracle.classloader_11.1.1.jar oracle.logging-utils_11.1.1.jar oracle.web-common_12.2.1.jar org.apache.bcel_5.1.jar oracle.nlsrtl_11.2.0/orai18n-mapping.jar org.apache.commons.beanutils_1.8.3 org.apache.commons.logging_1.1.1 oracle.jsp_12.2.1/globaltldcache oracle.mds_12.2.1/mdsrt com.oracle.webservices.fmw.oc4j-ws-support-impl_12.2.1 oracle.http_client_12.2.1 oracle.web-common_12.2.1 oracle.web-common-schemas_12.2.1
ライブラリを検証します。
ADF動作保証済互換JSF実装をインストールするには:
ADFランタイム・ライブラリをインストールしたら、データソースおよびJVMキャッシュを作成するよう、GlassFishサーバーを構成できます。追加の構成タスクを実行するには、GlassFishサーバーの管理コンソールを使用します。
ADFランタイムをGlassFishサーバーにインストールした後、GlassFishで追加の構成タスクを実行する必要があります。
構成タスクは次のとおりです。
GlassFish管理コンソールを使用すると、アプリケーション、JDBCプールおよびその他のリソースの管理などについてGlassFishサーバーを構成できます。GlassFish 3.1.2を使用している場合は、セキュア・コンソールはデフォルトで無効化されています。管理ページにリモートからアクセスする場合はセキュア・コンソールを有効化する必要があります。または、GlassFishサーバーが実行されているマシンからのみページにアクセスしてください。
GlassFish管理コンソールは次の場所にあります。
http://<machine_name>:4848/
GlassFishのデータソースを作成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、「追加の構成タスク」を参照してください。
GlassFishコンソールまたはasadminコマンドを使用してデータソースを作成できます。GlassFishコンソールを使用してデータソースを作成する方法は、GlassFishのドキュメントを参照してください。
asadminコマンドを使用してGlassFishのデータソースを作成するには:
JVM設定をsimple
に構成して、メモリー・サイズを192MBから512MBに増加する必要があります。
GlassFishのJVMを構成するときに使用できるオプションについて理解しておくと役立ちます。詳細は、「追加の構成タスク」を参照してください。
MDSのJVMキャッシュを構成する方法:
GlassFish管理コンソールを起動します。
「構成」→「server-config」→「JVM設定」を選択します。
「JVMオプション」を選択し、-Doracle.mds.cache=simple
およびXX:MaxPermSize=512m
を指定します。
「保存」をクリックします。
または、<glassfish>
/domains/domain1/config/domain.xml
ファイルを開き、次のエントリを編集します。
<jvm-options>-XX:MaxPermSize=512m</jvm-options> <jvm-options>-Doracle.mds.cache=simple</jvm-options>