Gaeｊ Jdo

App Engine for Java の JDO 使用上の考慮点（株）ケーピーエス　平　克介

目次  RDB から JDO への実装の変更概要  今回トライした例について  JDO の基本  考慮点　–　 Transaction  考慮点　–　関連  考慮点　–　 PersistenceManager  考慮点　–　 Index  参考：基本情報技術者試験　午前問題特訓システム

KPS フレームワークの機能  クライアントから直接擬似 HibernateAPI を操作  ORM オブジェクトを検索、更新、作成、削除  クライアントからサーバー側 Sesar2 コンポーネントの呼び出し  Gxt 　 GUI 画面デザインツール　 D-RexGxt Hibernate 部分を JDO へ入れ替え Criteria を Query 集計処理部分の　へ変更変更

JDO への移行  サーバー側の ORM アクセス部分の変更  Hibernate から JDO へ  フレームワーク側の変更  クライアント側検索 API の変更  Criteria から Query へ  フレームワークおよびクライアントコードの変更  集計処理部分の変更  集計処理を行っている Seaser2 コンポーネントの変更

JDO の基本１  JDO とは  Java 標準のデータの永続化・検索機能を提供する API  JDO の ORM クラス（ GAE では kind と呼ぶ) @PersistenceCapable(identityType = IdentityType.APPLICATION) public class Employee { @PrimaryKey @Persistent(valueStrategy = IdGeneratorStrategy.IDENTITY) private Long id; @Persistent private String firstName; @Persistent private String lastName; この下に constructor ： getter/setter が続く

JDO の基本 2  Object(entity) を永続化する PersistenceManager pm = PMF.get().getPersistenceManager(); Employee e = new Employee("Alfred", "Smith", new Date()); try { pm.makePersistent(e); } finally { pm.close(); } ：

JDO の基本 3  Object の更新 PersistenceManager pm = PMF.get().getPersistenceManager(); try { Employee e = pm.getObjectById(Employee.class, 1); e.setTitle(newTitle); } finally { pm.close(); } ：  Object の削除 pm.deletePersistent(e); 　　　　　　　：

JDO の基本 4  Object の検索 Query query = pm.newQuery(Employee.class); query.setFilter("lastName == lastNameParam"); query.setOrdering("hireDate desc"); query.declareParameters("String lastNameParam"); try { List<Employee> results = (List<Employee>) query.execute("Smith"); if (results.iterator().hasNext()) { for (Employee e : results) { // ... } } else { // ... no results ... Where lastName=‘Smith’ } Order by hireDate desc } finally { に相当 query.closeAll(); } ：

JDO の基本 5  Transaction Transaction tx = pm.currentTransaction(); try { tx.begin(); ClubMembers members = pm.getObjectById(ClubMembers.class, "k12345"); members.incrementCounterBy(1); pm.makePersistent(members); tx.commit(); } finally { if (tx.isActive()) { Tx 間に他所で同じ entity が更新された場 tx.rollback(); 合 } JDOOptimisticVerificationException とな } る：

JDO の基本 6  com.google.appengine.api.datastore.Key import com.google.appengine.api.datastore.Key; // ... @PrimaryKey @Persistent(valueStrategy = IdGeneratorStrategy.IDENTITY) private Key key; public void setKey(Key key) { this.key = key; } ：  親のクラスを持つ場合は主キーに Key を使用する  Key は親のクラスの Key への参照を持つ  子 Key→ 親 Key  Entity の Key は変更できない

JDO の基本 7  関連  Employee.java // ... @Persistent(mappedBy = "employee") private List<ContactInfo> contactInfoSets;  ContactInfo.java // ... @Persistent private Employee employee;  Employee:Contactinfo = 1:N  この場合 Employee が Contactinfo の親になる  共通の親（親の親も含む）を持つ entity の集合を entity group と言う

参考資料  ORM クラス間の一般的な関連の実装方法 RDB の場合：主キー / 外部キーの関連商品テーブル外部キ商品 CD 商品名単価商品メーカー CDー商品メーカーテーブル商品メーカー CD 商品メーカー名関連相手の Object 主キーの参照を持つ関連相手の Object の集合の参照を持つ ORM でのオブジェクト間の関連 Shohin ShohinMaker １ String shohinCd 0..* String shohinMakerCd String shohinNm String shohinMakerNm Long tanka Set shohins ShohinMaker shohinMaker getShohinMaker() getShohins()

考慮点 (Transaction)  １ Transaction 内では同一の entity group に属する entity しか扱えない　　 tx.begin(); Query query = pm.newQuery(Employee.class); List<Employee> results = (List<Employee>) query.execute(); Employee e1 = results.get(0); Employee e2 = results.get(1); e1.setFirstName(e1.getFirstName() + "1"); e2.setFirstName(e2.getFirstName() + "2"); tx.commit(); javax.jdo.JDOException  つまり、共通の親を持つ entity しか Transaction 化できない

考慮点 (Transaction)  Transaction の制約を受けない方法  単一の entity 「 root 」をすべての親の無い entity の親にする root employee1 employee2 employee3 company1 company2 contactInfo1 contactInfo2 すべては同一の entity group

考慮点 (Transaction)  Root クラス ( 主キーだけあればよい ) @PersistenceCapable(identityType = IdentityType.APPLICATION) public class Root { @PrimaryKey @Persistent(valueStrategy = IdGeneratorStrategy.IDENTITY) private Key key; public Key getKey() { return key; } public void setKey(Key key) { this.key = key; } }

考慮点 (Transaction)  親の無い entity の例（ Root の Key を持たせる ) @PersistenceCapable(identityType = IdentityType.APPLICATION) public class Employee { @PrimaryKey @Persistent(valueStrategy = IdGeneratorStrategy.IDENTITY) private Key key; @Persistent @Extension(vendorName="datanucleus", key="gae.parent-pk", value="true") private Key rootKey; public void setRootKey(Key rootKey) { this.rootKey = rootKey; } }  Root との ManyToOne 関連を持たせる方法でも OK

考慮点 (Transaction)  親が root である Entity の新規作成  root の key をセットする (root のキー値が１の場合) // ... Employee e = new Employee("Alfred", "Smith", new Date()); Key key = KeyFactory.createKey("Root", 1); e.setRootKey(key); pm.makePersistent(e); ：

考慮点 ( 関連 )  関連実装時の問題（関連が Key の構造になる)  親を一度設定すると変更できない  複数の親を定義できない division1 division2 2009 年春の「コンピュータの基礎」の問題 season1 genre1 x employee1 x Employee1 は一生 division1 question1 Season と Genre 両方親に出来ない

考慮点 7 ( 関連 - 解決策 )  関連は親の Key を保持することで実装する @PersistenceCapable(identityType = IdentityType.APPLICATION) public class Question { @PrimaryKey @Persistent(valueStrategy = IdGeneratorStrategy.IDENTITY) private Key key; @Persistent private Key seasonKey; @Persistent 関連先 Object を要求された時 private Key genreKey; に entity を読む public Season getSeason() { if (this.seasonKey == null) { return null; } return getPm().getObjectById(Season.class, this.seasonKey); } public void setSeason(Season season) { this.seasonKey = season.getKey(); } ：

考慮点 (PersistenceManager)  PersistenceManager の使いまわし  一連の処理で使用する PersistenceManager は同一のものを使用する必要がある。 // ... Season s = question.getSeason(); s.setCnt(s.getCnt()+1); pm.makePersistent(s); public Season getSeason() { if (this.seasonKey == null) { return null; } return pm.getObjectById(Season.class, this.seasonKey); }

考慮点 (PersistenceManager)  PersistenceManager を request に保持する public class PMManager { public static final String pmName = " PMManager _PM"; public static PersistenceManager getPm() { HttpServletRequest request = null; PersistenceManager pm = null; try { request = (HttpServletRequest) SingletonS2ContainerFactory .getContainer().getComponent(HttpServletRequest.class); pm = (PersistenceManager) request.getAttribute(pmName); } catch (Exception e) { } if (pm == null) { pm = PMF.get().getPersistenceManager(); if (request != null) { request.setAttribute(pmName, pm); この場合 Seasar2 のコンテナ } から request を得ている } return pm; } }

考慮点 (PersistenceManager)  PMManager から入手する例 // ... Season s = question.getSeason(); s.setCnt(s.getCnt()+1); PMManager.getPm().makePersistent(s); public Season getSeason() { if (this.seasonKey == null) { return null; } return PMManager.getPm() . getObjectById(Season.class, this.seasonKey); }

考慮点 (Index)  検索条件によっては明示的に Index を定義する必要がある。  Google の資料で Index 定義が必要な検索とは  複数のソートが指定された場合  Key の逆順ソートの場合  == でない条件と == の条件がある場合  == の条件と ancestor フィルターがある場合  Local 環境で OK でも Deploy した環境で NG の場合がある

考慮点 (Index)  Index の設定例  war/WEB-INF/datastore-indexes.xml に指定 <?xml version="1.0" encoding="utf-8"?> <datastore-indexes autoGenerate="false"> <datastore-index kind="Question" ancestor="false" source="auto"> <property name="seasonKey" direction="asc"/> <property name="genreKey" direction="asc"/> </datastore-index> </datastore-indexes>

その他の考慮点  kind 間の Join による読み込みはできない  group by を使用した集約関数は使用できない  count(*) / sum(xxx) 等  検索条件に　 != 、 IN は使用できない  Python ではクライアント側の実装として実現している  検索条件の組み合わせで or 、 not は使用できない

おわり  ありがとうございました

http://kptech.cocolog-nifty.com	257
http://kpnote.cocolog-nifty.com	149
http://www.extjs.co.jp	41
http://extjs.co.jp	29
http://webcache.googleusercontent.com	14
http://www.slideshare.net	8
http://74.125.153.132	2
http://74.125.159.132	1

Gaeｊ Jdo

by katsu.taira on Jul 08, 2009

Accessibility

Categories

Tags

Upload Details

Usage Rights

8 Embeds 501

Statistics

Gaeｊ Jdo — Presentation Transcript