プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle WebLogic Server Enterprise JavaBeansの開発
12c (12.2.1.3.0)
E90322-03
目次へ移動
目次

前
次

8 Oracle WebLogic Serverでの永続性プロバイダの構成

この章では、Oracle WebLogic Serverのデフォルトの永続性プロバイダであるOracle TopLinkについて説明し、その使用方法を紹介します。この章では、WebLogic Serverでデフォルトの永続性プロパイダを設定する方法も説明します。

この章の内容は次のとおりです:

Oracle TopLinkの概要

Oracle TopLinkは、WebLogic Server 12c以降のデフォルトの永続性プロバイダです。これは、包括的な標準ベースのオブジェクト永続性およびオブジェクト変換フレームワークであり、アプリケーションの永続性レイヤーに関するAPI、スキーマ、ランタイム・サービスを提供します。

TopLinkのコア・コンポーネントは、EclipseLinkプロジェクトで作成されたライブラリとユーティリティで構成されています。EclipseLinkとは、TopLinkで提供される開発フレームワークおよびランタイムのオープン・ソース実装です。EclipseLinkでは、次の仕様に加えて付加価値機能を実装します。

  • Java Persistence 2.1 (JPA 2.1)。

    JPA 2.1には、Criteria Bulk Update/Delete、ストアド・プロシージャ、JPQL汎用関数、インジェクション可能なエンティティ・リスナー、TREAT、コンバータ、DDL生成およびエンティティ・グラフなどの機能に対する新しいサポートまたは拡張が含まれます。JPA 2.1の完全な仕様は、「JSR-000338 Java Persistence 2.1 (Final Release)」(http://jcp.org/aboutJava/communityprocess/final/jsr338/index.html)を参照してください。

  • Java Architecture for XML Binding (JAXB) 2.2(EclipseLink JAXB実装、およびEclipseLink拡張機能は、MOXyと呼ばれています。)

    JAXB 2.0仕様については、「JSR-000222 Java Architecture for XML Binding (JAXB) 2.0」(http://jcp.org/aboutJava/communityprocess/pfd/jsr222/index.html)を参照してください。

  • EclipseLinkには、Database Web Service (DBWS)も含まれます。これは、Java API for XML Web Services (JAX-WS) 2 Webサービスを使用することで、リレーショナル・データベース・アーティファクトへのアクセスを提供します。

EclipseLinkは、Oracle SpatialおよびOracle XDBのマッピング機能もサポートします。

サポートされるその他のサービスを含め、EclipseLinkに関する詳細は、EclipseLinkプロジェクト・ホーム(http://wiki.eclipse.org/EclipseLink)およびEclipseLink/Documentation Center(http://wiki.eclipse.org/EclipseLink/UserGuide)を参照してください。

すべてのEclipseLinkに加えて、Oracle TopLinkには次が含まれます。

  • TopLink Grid。EclipseLinkでOracle Coherenceをレベル2 (L2)キャッシュおよびエンティティの永続性レイヤーとして使用するためのEclipseLink JPAとOracle Coherenceとの統合です。『Oracle Coherenceでのアプリケーションの開発』を参照してください

    注意:

    Oracle CoherenceでTopLink Gridを使用するためのライセンスが必要です。

  • WebLogic Serverとのロギングの統合。

  • WebLogic ServerでのMBeanのサポート。

Oracle TopLinkアプリケーションの開発、デプロイメント、および構成の詳細は、次を参照してください。

  • Oracle TopLinkソリューション・ガイド

  • Oracle TopLinkの理解

  • Oracle TopLinkのJava APIリファレンス

注意:

前述のドキュメントはOracle TopLink 12.1.3用ですが、現在のバージョンのWebLogic Serverにも適用されます。

次のEclipseLinkの資料も参照してください。

永続性プロバイダの指定

次の項で説明するように、アプリケーション・コードの永続性ユニットで使用する永続性プロバイダを指定するか、あるいはWebLogic Serverドメインのデフォルト永続性プロバイダを受け入れることができます。

ドメインのデフォルト・プロバイダの設定

他に何も指定していないと、WebLogic Serverドメインのデフォルト永続性プロバイダとしてTopLinkが使用されます。デフォルト・プロバイダは、別の永続性プロバイダを使用するように構成されていないアプリケーションの任意のエンティティで使用されます。デフォルト・プロバイダは、注入されたエンティティ・マネージャおよびファクトりでもアプリケーション管理のエンティティ・マネージャおよびファクトリでも使用されます。

デフォルト・プロバイダは、WebLogic Server管理コンソールで設定することも、直接JPAMBean.DefaultJPAProviderで設定することもできます。

注意:

Oracle Kodo JPA/JDOは、このリリースのWebLogic Serverでサポートされなくなりました。JPA 2.1をサポートするOracle TopLinkを使用することをお薦めします。Kodoでは、JPA 1.0のみをサポートします。

WebLogic Server管理コンソールでデフォルトを設定する方法は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプデフォルトのJPA永続性プロバイダの構成を参照してください。

デフォルト・プロバイダを変更する場合、JPAプロバイダを指定しない任意のデプロイされたアプリケーションに対して次を実行する必要があります。

  • アプリケーション管理によるエンティティ・マネージャ・ファクトリを使用するアプリケーションを再起動します。

  • 注入されたエンティティ・マネージャ・ファクトリまたはエンティティ・マネーシャを使用するアプリケーションを再デプロイします。

アプリケーションでの永続性プロバイダの指定

アプリケーションで指定された永続性プロバイダは、WebLogic Serverドメインに設定されたデフォルト・プロバイダより優先されます。

使用するプロバイダは、次のようにして設定できます。

  • persistence.xmlファイル内の永続性ユニットの<provider>要素でプロバイダを指定します。例:

     <persistence-unit name="example">
        <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
    ...
      </persistence-unit>
    
  • javax.persistence.Persistence.createEntityManagerFactory(String, Map)メソッドのMapパラメータに渡すjavax.persistence.providerプロパティでプロバイダを指定します。

Oracle WebLogic ServerでのOracle TopLinkの使用方法

WebLogic ServerでのOracle TopLinkの使用の詳細は、Oracle TopLinkソリューション・ガイドのWebLogic ServerでのTopLinkの使用を参照してください。これはOracle TopLink 12.1.3の刊行物ですが、現在のバージョンのWebLogic Serverに適用されます。