はまる！JPA（初学者向けライト版）

3. 自己紹介  多田真敏（ただまさとし）  (株)カサレアル  大阪出身、香川育ちの31歳  Java EE 7などを中心に研修講師やってます  JJUG CCCは3回連続3回目の出場  SNS  Twitter：@suke_masa  はてなブログ：Java EE 事始め！  GitHub：https://github.com/MasatoshiTada (C) CASAREAL, Inc. All rights reserved. 3

13. 生成されたエンティティ（一部抜粋） (C) CASAREAL, Inc. All rights reserved. 13 // 製造者エンティティ @Entity public class Manufacturer ・・・ { @Id private Integer manufacturerId; private String name; private String addressline1; private String addressline2; ・・・ @OneToMany(・・・) private List<Product> productList; // setter/getter・・・

14. 生成された設定ファイル（persistence.xml） (C) CASAREAL, Inc. All rights reserved. 14 <persistence version=“2.1” ・・・> <persistence-unit name="samplePU" transaction-type="RESOURCE_LOCAL"> <provider>org.eclipse.persistence.jpa.PersistenceProvider</provider> <class>hoge.entity.Product</class> <class>hoge.entity.Manufacturer</class> ・・・ <properties> <property name="javax.persistence.jdbc.url" value="jdbc:derby://localhost:1527/sample"/> <property name="javax.persistence.jdbc.user" value="app"/> <property name="javax.persistence.jdbc.driver" value="org.apache.derby.jdbc.ClientDriver"/> <property name="javax.persistence.jdbc.password" value="app"/> </properties> </persistence-unit> </persistence>

15. ログ出力の設定（EclipseLinkの場合）  開発時は必ずログを出しましょう！ (C) CASAREAL, Inc. All rights reserved. 15 <persistence・・・> <persistence-unit ・・・> ・・・ <properties> ・・・ <property name="eclipselink.logging.level” value="FINE"/> </properties> ・・・

18. EntityManagerインターフェイス  find()･･･主キー検索  persist()･･･新規追加を予約する  remove()･･･削除を予約する  merge()･･･エンティティを永続化コンテキスト管理下に置く  detach()･･･エンティティを永続化コンテキストから切り離す  flush()･･･永続化コンテキストの変更をDBに反映する (C) CASAREAL, Inc. All rights reserved. 18

20. エンティティの状態 ① NEW状態  エンティティのインスタンスがnewされてすぐ ② MANAGED状態  エンティティが永続化コンテキストの管理下にある ③ DETACHED状態  エンティティが永続化コンテキストの管理下から切り離されている ④ REMOVED状態  DBからの削除が予約されている (C) CASAREAL, Inc. All rights reserved. 20

22. 基本的な書き方 (C) CASAREAL, Inc. All rights reserved. 22 EntityManagerFactory emf = Persistence.createEntityManagerFactory("samplePU"); EntityManager em = emf.createEntityManager(); // 処理 em.close(); emf.close(); persistence.xmlの persistence-unitの name属性

23. 主キー検索 (C) CASAREAL, Inc. All rights reserved. 23 Manufacturer m = em.find(Manufacturer.class, 19985678); System.out.println(m.getName()); [EL Fine]: sql: Connection(50826412)--SELECT MANUFACTURER_ID, ADDRESSLINE1, ADDRESSLINE2, CITY, EMAIL, FAX, NAME, PHONE, REP, STATE, ZIP FROM MANUFACTURER WHERE (MANUFACTURER_ID = ?) bind => [19985678] Happy End Searching 実行結果エンティティクラス名と主キー値を指定 SELECT文が発行される

24. 新規追加 (C) CASAREAL, Inc. All rights reserved. 24 EntityTransaction tx = em.getTransaction(); tx.begin(); Manufacturer m = new Manufacturer(); m.setManufacturerId(1); m.setName("HOGE"); em.persist(m); em.flush(); tx.commit(); persist()で永続化 →flush()でDBに反映 →commit()で確定

25. 新規追加 (C) CASAREAL, Inc. All rights reserved. 25 [EL Fine]: sql: Connection(1168076863)--INSERT INTO MANUFACTURER (MANUFACTURER_ID, ADDRESSLINE1, ADDRESSLINE2, CITY, EMAIL, FAX, NAME, PHONE, REP, STATE, ZIP) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?) bind => [1, null, null, null, null, null, HOGE, null, null, null, null] 実行結果 INSERT文が発行されるレコードが追加される

26. 更新 (C) CASAREAL, Inc. All rights reserved. 26 EntityTransaction tx = em.getTransaction(); tx.begin(); Manufacturer m = em.find(Manufacturer.class, 1); m.setName("FUGA"); em.flush(); tx.commit(); find()で取ってくる →setterで変更 →flush()でDBに反映

27. 更新 (C) CASAREAL, Inc. All rights reserved. 27 [EL Fine]: sql: Connection(1168076863)--SELECT MANUFACTURER_ID, ADDRESSLINE1, ADDRESSLINE2, CITY, EMAIL, FAX, NAME, PHONE, REP, STATE, ZIP FROM MANUFACTURER WHERE (MANUFACTURER_ID = ?) bind => [1] [EL Fine]: sql: Connection(1168076863)-- UPDATE MANUFACTURER SET NAME = ? WHERE (MANUFACTURER_ID = ?) bind => [FUGA, 1] 実行結果変更した列のみ UPDATEする

29. これでも更新可能 (C) CASAREAL, Inc. All rights reserved. 29 EntityTransaction tx = em.getTransaction(); tx.begin(); Manufacturer m = new Manufacturer(); m.manufacturerId(1); m.setName("FUGA"); em.merge(m); em.flush(); tx.commit(); newしてmerge()

30. これでも更新可能 (C) CASAREAL, Inc. All rights reserved. 30 [EL Fine]: sql: Connection(1168076863)--SELECT MANUFACTURER_ID, ADDRESSLINE1, ADDRESSLINE2, CITY, EMAIL, FAX, NAME, PHONE, REP, STATE, ZIP FROM MANUFACTURER WHERE (MANUFACTURER_ID = ?) bind => [1] [EL Fine]: sql: Connection(1168076863)--UPDATE MANUFACTURER SET NAME = ? WHERE (MANUFACTURER_ID = ?) bind => [FUGA, 1] 実行結果 merge()時にSELECT →flush()時にUPDATE

31. EntityTransaction tx = em.getTransaction(); tx.begin(); Manufacturer m = new Manufacturer(); m.manufacturerId(1); m.setName("FUGA"); em.remove(m); em.flush(); tx.commit(); 削除 (C) CASAREAL, Inc. All rights reserved. 31

32. 削除 (C) CASAREAL, Inc. All rights reserved. 32 Exception in thread "main" java.lang.IllegalArgumentException: Entity must be managed to call remove: com.example.entity.Manufacturer[ manufacturerId =1 ], try merging the detached and try the remove again. 実行結果例外！？

34. 【再確認】エンティティの状態遷移 (C) CASAREAL, Inc. All rights reserved. 34 NEW 状態 MANAGED 状態 REMOVED 状態 DETACHED 状態 DB persist() remove()merge() detach() clear() コミット find() flush() コミット refresh() MANAGED状態じゃないと remove()できない

35. EntityTransaction tx = em.getTransaction(); tx.begin(); Manufacturer m = new Manufacturer(); m.manufacturerId(1); m.setName("FUGA"); em.merge(m); em.remove(m); em.flush(); tx.commit(); merge()して削除 (C) CASAREAL, Inc. All rights reserved. 35 merge()すれば remove()できるはず！？

36. merge()して削除 (C) CASAREAL, Inc. All rights reserved. 36 Exception in thread "main" java.lang.IllegalArgumentException: Entity must be managed to call remove: com.example.entity.Manufacturer[ manufacturerId =1 ], try merging the detached and try the remove again. 実行結果同じ例外！？ MANAGEDになってない！？

39. JSR 338(JPA 2.1の仕様)を確認  3.2.7.1 Merging Detached Entity State エンティティXがDETACHED状態の場合、 Xと同じ識別子を持つMANAGED状態のX’にコピーされる またはMANAGED状態のX’が新規生成される (C) CASAREAL, Inc. All rights reserved. 39 merge()の引数のコピーがMANAGED状態になり、それが戻り値となる →引数自体はMANAGED状態にならない！

40. EntityTransaction tx = em.getTransaction(); tx.begin(); Manufacturer m = new Manufacturer(); m.manufacturerId(1); m.setName("FUGA"); Manufacturer managedManu = em.merge(m); em.remove(managedManu); em.flush(); tx.commit(); 削除プログラムを修正 (C) CASAREAL, Inc. All rights reserved. 40 merge()の戻り値をremove()

41. 削除プログラムを修正 (C) CASAREAL, Inc. All rights reserved. 41 [EL Fine]: sql: Connection(1168076863)--SELECT MANUFACTURER_ID, ADDRESSLINE1, ADDRESSLINE2, CITY, EMAIL, FAX, NAME, PHONE, REP, STATE, ZIP FROM MANUFACTURER WHERE (MANUFACTURER_ID = ?) bind => [1] [EL Fine]: sql: Connection(1168076863)--DELETE FROM MANUFACTURER WHERE (MANUFACTURER_ID = ?) bind => [1] 実行結果ちゃんと削除されてる！

43. もう少し詳しく  merge()でもINSERTは可能  persist()は主キー重複の際は例外発生、 merge()は主キー重複の際は例外にならず、 SELECT後にUPDATEする  flush()時に、MANAGED状態のエンティティと、DBとの差分（変更分）を一気に反映する  SQL発行タイミング等はJPA実装によって異なる (C) CASAREAL, Inc. All rights reserved. 43

45. リレーション  @OneToMany、@ManyToOneで表現 (C) CASAREAL, Inc. All rights reserved. 45 @Entity public class Manufacturer { // 製造者 @OneToMany(・・・) private List<Product> productList; ・・・ @Entity public class Product { // 製品 @ManyToOne(・・・) private Manufacturer manufacturer; ・・・

46. カスケード  関連のあるエンティティに対して、道連れに同じ操作を行う CascadeTypeはALL、DETACH、FLUSH、 PERSIST、REFRESH、REMOVEの6種類 (C) CASAREAL, Inc. All rights reserved. 46 @Entity public class Manufacturer { @OneToMany(cascade = CascadeType.ALL) private List<Product> productList; ・・・

47. カスケードの活用例  受注(1側)と受注明細(N側)を一括登録 (C) CASAREAL, Inc. All rights reserved. 47 受注 order = new 受注(・・・); order.addDetail(new 受注明細(・・・)); order.addDetail(new 受注明細(・・・)); order.addDetail(new 受注明細(・・・)); // 3つの受注明細も同時にINSERTされる em.persist(order);

48. フェッチ  関連のあるエンティティを、どのタイミングで読み込むか  FetchType.EAGER：即時読み込み  FetchType.LAZY：遅延読み込み (C) CASAREAL, Inc. All rights reserved. 48 @Entity public class Manufacturer { @OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER) private List<Product> productList; ・・・

49. よくあるサンプル  社員(Employee)と部署(Department) 社員：部署はＮ：１ (C) CASAREAL, Inc. All rights reserved. 49 dept_id name 1 SALES 2 DEVELOP emp_id name dept_id 101 Y.Aragaki 1 102 R.Matsui 1 103 E.Ikuta 2 104 R.Sakurai 2

53. 何故こうなったのか (C) CASAREAL, Inc. All rights reserved. 53 @Entity public class Department { ・・・ @OneToMany(mappedBy = "department", cascade = CascadeType.ALL, fetch = FetchType.EAGER) private List<Employee> employeeList; CascadeType.ALL かつ FetchType.EAGER

54. 何故こうなったのか (C) CASAREAL, Inc. All rights reserved. 54 EntityTransaction tx = em.getTransaction(); Department d = em.find(Department.class, 1); em.remove(d); tx.commit(); このタイミングで、関連する社員も同時に読み込まれる部署と道連れに社員も削除される

55. ログ (C) CASAREAL, Inc. All rights reserved. 55 SELECT DEPT_ID, NAME FROM DEPARTMENT WHERE (DEPT_ID = ?) bind => [1] SELECT EMP_ID, NAME, DEPT_ID FROM EMPLOYEE WHERE (DEPT_ID = ?) bind => [1] DELETE FROM EMPLOYEE WHERE (EMP_ID = ?) bind => [101] DELETE FROM EMPLOYEE WHERE (EMP_ID = ?) bind => [102] DELETE FROM DEPARTMENT WHERE (DEPT_ID = ?) bind => [1]

59. 動的にカスケード戦略を変える方法  EclipseLinkの独自機能 https://wiki.eclipse.org/EclipseLink/Examp les/JPA/Dynamic#Relationships より 試したかったけど、サンプルコードのリンクが切れてて確認できず(泣)  JPAの標準機能になってほしい！ (C) CASAREAL, Inc. All rights reserved. 59 OneToManyMapping mapping = ・・・; mapping.setCascadeMerge(true);

62. JPQLのメリット  DB製品のSQL方言などに依存せず、問合せを記述できるので、ポータビリティが高い  ただし、検証は自己責任でお願いします  事例（@kikutaro_さん）  GlassFish＋SQL Serverのアプリを、組込GlassFish＋Derbyに移殖  https://speakerdeck.com/kikutaro/chu- metefalse-java-ee-kai-fa-karaxue-ndakoto- jjug-ccc-2014-spring (C) CASAREAL, Inc. All rights reserved. 62

63. 基本的な使い方 (C) CASAREAL, Inc. All rights reserved. 63 String jpql = “SELECT m FROM Manufacturer m ” + “WHERE m.name LIKE :name”; TypedQuery<Manufacturer> query = em.createQuery(jpql, Manufacturer.class); query.setParameter(“name”, “B%”); List<Manufacturer> list = query.getResultList(); for (Manufacturer m : list) { System.out.println(m.getManufacturerId() + ":" + m.getName()); }

64. 基本的な使い方 (C) CASAREAL, Inc. All rights reserved. 64 [EL Fine]: sql: Connection(1168076863)--SELECT MANUFACTURER_ID, ADDRESSLINE1, ADDRESSLINE2, CITY, EMAIL, FAX, NAME, PHONE, REP, STATE, ZIP FROM MANUFACTURER WHERE NAME LIKE ? bind => [B%] 19971233:Bills Bank and Sons 19985590:Birders United 19955564:Birders United 19955565:Birders United 19984681:Birders United 19984682:Birders United 19941212:Birders United 19987296:Birders United 実行結果 SQLに変換して実行される

65. よくある間違い (C) CASAREAL, Inc. All rights reserved. 65 String jpql = “select m from manufacturer m ” + “where name like :name”; これはJPQLではなく、ほぼSQL！ Exception in thread "main" java.lang.IllegalArgumentException: An exception occurred while creating a query in EntityManager: Exception Description: Problem compiling [select m from manufacturer m where m.name like :name]. [14, 26] The abstract schema type 'manufacturer' is unknown. 実行結果

68. SQLとJPQLの違い② 列抽出では識別変数が必須 (C) CASAREAL, Inc. All rights reserved. 68 ○ SELECT m.manufacturerId, m.name FROM Manufacturer m; × SELECT manufacturerId, name FROM Manufacturer m; SQLとしては正しいが、 JPQLとしては正しくない

69. SQLとJPQLの違い③ JPQLは一部Case Sensitive  SELECTなどのJPQLの予約語 →大文字・小文字は区別されない  エンティティクラス名・プロパティ名など →大文字・小文字が区別される  識別変数→大文字・小文字は区別されない (C) CASAREAL, Inc. All rights reserved. 69 ○ SELECT m FROM Manufacturer m; ○ select m from Manufacturer m; × select m from manufacturer m; ○ select M from Manufacturer m; JPQLは基本的に Case Sensitiveと考えた方がいい！

75. まとめ JPAのはまりポイント  エンティティの状態が大切！ merge()とremove()は特に注意！  CascadeType.ALLは禁止！  JPQLはSQLではありません！  JPA実装やDB製品によって挙動が異なる場合がありますので、必ずログを出して、挙動を確かめながら開発しましょう！ (C) CASAREAL, Inc. All rights reserved. 75

はまる！JPA（初学者向けライト版）

Masatoshi Tada

Transcript