JPAの基本を覚える (2/7)

■persistence.xmlの作成

まずは、persistence.xmlを作成しましょう。このファイルは、「main」フォルダ内の「resources」フォルダの中に用意をします。

「resources」フォルダの中に、「META-INF」というフォルダを作成して下さい。そしてこの「META-INF」フォルダの中に、「persistence.xml」という名前のファイルを作成します。ここに記述するソースコードは、下のリスト欄のようになります。

persistence.xmlは、以下のような形で記述をします。

<persistence ……略……>

    <persistence-unit ……略……>
        <provider>プロバイダー</provider>
        <class>エンティティクラス</class>
        <properties>
            <property name="プロパティ" value="値" />
            ……必要なだけ記述……
        </properties>
    </persistence-unit>

</persistence>

persistence.xmlは、ルートに<persistence>というタグを用意します。そしてこの中に、<persistence-unit>というタグを作成します。このタグが、パーシスタンス・ユニットになります。この中に必要な情報を色々と記述しておくのです。最低でも以下のタグは用意する必要があります。

<provider>――これはプロバイダーというものを指定するタグです。これは、実際に利用するJPAのエンジン部分のプログラムのことです。JPAは仕様であり、さまざまな実装が存在します。この<provider>タグで、どのJPA実装を利用するかを指定します。

<class>――JPAで利用するエンティティクラスを指定するタグです。

この他に、<properties>というタグが用意されていますね。これは、パーシスタンス・ユニットで必要となる情報をプロパティとしてまとめたものです。具体的には以下のような項目が用意されています。

javax.persistence.jdbc.driver ――データベースのドライバークラスの指定です。H2では、org.h2.Driverクラスを指定します。
javax.persistence.jdbc.url ――アクセス先のデータベースのURLです。ここでは、jdbc:h2:mem:dbと指定をしています。これはH2でメモリ内にdbという名前でデータベースを保存していることを示します。
javax.persistence.jdbc.user ――アクセスするユーザー名です。
javax.persistence.jdbc.password ――これはサンプルにはありませんが、パスワードを指定するものです。

eclipselink.ddl-generation――これは、EclipseLink特有のもので、データベーステーブルの生成に関するものです。"drop-and-create-tables"と指定して、実行時に、それまでのテーブルを削除し新たにテーブルを生成します（ただし、ここではメモリにデータベースを保存しているのでその必要はないんですが……）。ファイルに保存する場合、これを指定することでサーバー起動時にデータベースを初期化できる、ということですね。
eclipselink.ddl-generation.output-mode――出力モードの指定です。databaseと値を指定してありますが、これは出力先がデータベースであることを示すものです。

H2はデータベースサーバーではないので、サーバータイプのようにユーザー名とパスワードでログインする必要がありません。このためパスワードの情報は特に用意していません。MySQLなどを利用する場合は用意する必要がある、ということです。

(by. SYODA-Tuyano.)

※リストが表示されない場合

AddBlockなどの広告ブロックツールがONになっているとリストなどが表示されない場合があります。これらのツールをOFFにしてみてください。

<?xml version="1.0" encoding="UTF-8"?>
<persistence version="2.1"
    xmlns="http://xmlns.jcp.org/xml/ns/persistence"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/persistence
        http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd">

    <persistence-unit name="mydataentity-persistance" 
            transaction-type="RESOURCE_LOCAL">
        <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider>
        <class>com.tuyano.libro.MyDataEntity</class>
        <properties>
            <property name="javax.persistence.jdbc.driver" value="org.h2.Driver" />
            <property name="javax.persistence.jdbc.url" value="jdbc:h2:mem:db" />
            <property name="javax.persistence.jdbc.user" value="sa" />
            <property name="eclipselink.ddl-generation" value="drop-and-create-tables" />
            <property name="eclipselink.ddl-generation.output-mode" value="database" />
        </properties>
    </persistence-unit>
</persistence>

<< 前へ　

　次へ >>

記事のリストに戻る

PC Site G+ mail