Javaデータオブジェクトのガイド
1. 概要
Java Data Objectsは、オブジェクト指向データを任意のデータベースに永続化するために設計されたAPIであり、Java構文を使用した使いやすいクエリ言語を提供します。
この記事では、JDO APIを使用してオブジェクトをデータベースに永続化する方法を説明します。
2. Mavenの依存関係とセットアップ
最新のDataNucleus JDO APIを使用し、JDO 3.2 APIを完全にサポートします。
次の依存関係をpom.xmlファイルに追加しましょう。
org.datanucleus
javax.jdo
3.2.0-m6
org.datanucleus
datanucleus-core
5.1.0-m2
org.datanucleus
datanucleus-api-jdo
5.1.0-m2
org.datanucleus
datanucleus-rdbms
5.1.0-m2
org.datanucleus
datanucleus-xml
5.0.0-release
依存関係の最新バージョンは、javax.jdo、datanucleus-core、datanucleus-api-jdo、datanucleus-rdbms、およびdatanucleus-xmlにあります。
3. モデル
データベースにデータを保存します。その前に、JDOがデータを保存するために使用するクラスを作成する必要があります。
これを行うには、いくつかのプロパティを持つクラスを作成し、@PersistentCapable:で注釈を付ける必要があります。
@PersistenceCapable
public class Product {
@PrimaryKey
@Persistent(valueStrategy = IdGeneratorStrategy.INCREMENT)
long id;
String name;
Double price = 0.0;
// standard constructors, getters, setters
}また、主キーと選択した戦略に注釈を付けました。
オブジェクトを作成したら、エンハンサーを実行してJDOに必要なバイトコードを生成する必要があります。 Mavenを使用して、次のコマンドを実行できます。
mvn datanucleus:enhanceこのステップは必須です。 そうでない場合、クラスが拡張されていないというコンパイル時エラーが発生します。
もちろん、Mavenビルド中にこれを自動的に行うことは可能です。
org.datanucleus
datanucleus-maven-plugin
5.0.2
JDO
${basedir}/datanucleus.properties
${basedir}/log4j.properties
true
process-classes
enhance
プラグインの最新バージョンはここにあります：datanucleus-maven-plugin
4. 永続化オブジェクト
トランザクションの実行を担当するトランザクションマネージャーを提供するJDOファクトリを使用して、データベースにアクセスします。
PersistenceManagerFactory pmf = new JDOPersistenceManagerFactory(pumd, null);
PersistenceManager pm = pmf.getPersistenceManager();トランザクションは、エラーが発生した場合にロールバックを許可するために使用されます。
Transaction tx = pm.currentTransaction();トランザクションはtry/catchブロック内で行います。
Product product = new Product("Tablet", 80.0);
pm.makePersistent(product);finallyブロックでは、障害が発生した場合に実行されるこれらの操作を定義します。
何らかの理由でトランザクションを完了できない場合は、ロールバックを実行し、pm.close()を使用してデータベースへの接続も閉じます。
finally {
if (tx.isActive()) {
tx.rollback();
}
pm.close();
}プログラムをデータベースに接続するには、実行時にpersistence-unitを作成して、永続クラス、データベースタイプ、および接続パラメーターを指定する必要があります。
PersistenceUnitMetaData pumd = new PersistenceUnitMetaData(
"dynamic-unit", "RESOURCE_LOCAL", null);
pumd.addClassName("com.example.jdo.Product");
pumd.setExcludeUnlistedClasses();
pumd.addProperty("javax.jdo.option.ConnectionDriverName", "org.h2.Driver");
pumd
.addProperty("javax.jdo.option.ConnectionURL", "jdbc:h2:mem:mypersistence");
pumd.addProperty("javax.jdo.option.ConnectionUserName", "sa");
pumd.addProperty("javax.jdo.option.ConnectionPassword", "");
pumd.addProperty("datanucleus.autoCreateSchema", "true");5. オブジェクトの読み取り
トランザクションブロック内のデータベースからデータを読み取るには、クエリを作成します。 次に、これらのアイテムをJavaListコレクションに格納します。このコレクションは、永続ストレージからの情報のメモリ内コピーを保持します。
永続性マネージャーは、データベースと対話するためのクエリインターフェイスへのアクセスを提供します。
Query q = pm.newQuery(
"SELECT FROM " + Product.class.getName() + " WHERE price < 1");
List products = (List) q.execute();
Iterator iter = products.iterator();
while (iter.hasNext()) {
Product p = iter.next();
// show the product information
} 6. オブジェクトの更新
データベース内のオブジェクトを更新するには、クエリを使用して更新するオブジェクトを見つけ、クエリの結果を更新してトランザクションをコミットする必要があります。
Query query = pm.newQuery(Product.class, "name == \"Phone\"");
Collection result = (Collection) query.execute();
Product product = (Product) result.iterator().next();
product.setName("Android Phone");7. オブジェクトの削除
更新手順と同様に、最初にオブジェクトを検索してから、永続マネージャーを使用してオブジェクトを削除します。 これらの状況では、JDOは永続ストレージを更新します。
Query query = pm.newQuery(Product.class, "name == \"Android Phone\"");
Collection result = (Collection) query.execute();
Product product = (Product) result.iterator().next();
pm.deletePersistent(product);8. XMLデータストア
XMLプラグインを使用すると、データを永続化するためにXMLファイルを使用できます。
ConnectionURLを指定して、それがXMLファイルであることを示し、ファイルの名前を指定します。__
pumdXML.addProperty("javax.jdo.option.ConnectionURL", "xml:file:myPersistence.xml");XMLデータストアは自動インクリメントプロパティをサポートしていないため、別のクラスを作成する必要があります。
@PersistenceCapable()
public class ProductXML {
@XmlAttribute
private long productNumber = 0;
@PrimaryKey
private String name = null;
private Double price = 0.0;
// standard getters and setters@XmlAttributeアノテーションは、これが要素の属性としてXMLファイルに表示されることを示します。
製品を作成して永続化しましょう。
ProductXML productXML = new ProductXML(0,"Tablet", 80.0);
pm.makePersistent(productXML);製品をXMLファイルに保存します。
Tablet
80.0
8.1. XMLデータストアからオブジェクトを回復する
クエリを使用して、XMLファイルからオブジェクトを回復できます。
Query q = pm.newQuery("SELECT FROM " + ProductXML.class.getName());
List products = (List) q.execute(); そして、イテレータを使用して各オブジェクトと対話します。
9. JDOクエリ
JDOQLは、Javaオブジェクトを使用してクエリを実行するために設計されたオブジェクトベースのクエリ言語です。
9.1. 宣言型JDOQL
宣言クエリを使用して、パラメーターを宣言し、Javaを使用して設定します。これにより、型の安全性が確保されます。
Query qDJDOQL = pm.newQuery(Product.class);
qDJDOQL.setFilter("name == 'Tablet' && price == price_value");
qDJDOQL.declareParameters("double price_value");
List resultsqDJDOQL = qDJDOQL.setParameters(80.0).executeList(); 9.2. SQL
JDOは、標準のSQLクエリを実行するメカニズムを提供します。
Query query = pm.newQuery("javax.jdo.query.SQL", "SELECT * FROM PRODUCT");
query.setClass(Product.class);
List results = query.executeList(); クエリオブジェクトの1つのパラメータとしてjavax.jdo.query.SQLを使用し、2番目のパラメータはSQL自体です。
9.3. JPQL
JDOは、JPAクエリを実行するメカニズムも提供します。 JPAクエリ言語の完全な構文を使用できます。
Query q = pm.newQuery("JPQL",
"SELECT p FROM " + Product.class.getName() + " p WHERE p.name = 'Laptop'");
List results = (List) q.execute();10. 概要
このチュートリアルでは、次のことを行います。
-
JDOを使用する簡単なCRUDアプリケーションを作成しました
-
データをXMLとして保存および取得
-
一般的なクエリメカニズムを調べた
いつものように、あなたは記事over on Githubからコードを見つけることができます。