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

自己紹介  多田真敏（ただまさとし）  (株)カサレアル  大阪出身、香川育ちの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

https://github.com/MasatoshiTada

4.

5.

6.

7.

8.

9.

10.

11.

http://masatoshitada.hatenadiary.jp/entry/2014/05/11/153725

12.

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・・・ (C) CASAREAL, Inc. All rights reserved. 13

14.

[beta]

生成された設定ファイル
（persistence.xml）
<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>
(C) CASAREAL, Inc. All rights reserved.

14

15.

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

16.

17.

18.

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

19.

20.

21.

22.

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

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文が発行される (C) CASAREAL, Inc. All rights reserved. 23

24.

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

25.

新規追加 INSERT文が発行される実行結果 [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] レコードが追加される (C) CASAREAL, Inc. All rights reserved. 25

26.

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

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する (C) CASAREAL, Inc. All rights reserved. 27

28.

29.

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

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 (C) CASAREAL, Inc. All rights reserved. 30

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.

削除実行結果 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. 例外！？ (C) CASAREAL, Inc. All rights reserved. 32

33.

34.

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

35.

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

36.

merge()して削除実行結果 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になってない！？ (C) CASAREAL, Inc. All rights reserved. 36

37.

38.

39.

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

40.

削除プログラムを修正 merge()の戻り値をremove() 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

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] ちゃんと削除されてる！ (C) CASAREAL, Inc. All rights reserved. 41

42.

43.

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

44.

45.

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

46.

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

47.

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

48.

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

49.

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

50.

51.

52.

53.

[beta]

何故こうなったのか
CascadeType.ALL
かつ
FetchType.EAGER

@Entity
public class Department {
・・・
@OneToMany(mappedBy = "department",
cascade = CascadeType.ALL,
fetch = FetchType.EAGER)
private List<Employee> employeeList;

(C) CASAREAL, Inc. All rights reserved.

53

54.

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

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] (C) CASAREAL, Inc. All rights reserved. 55

56.

57.

58.

59.

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

https://wiki.eclipse.org/EclipseLink/Examples/JPA/Dynamic#Relationships

60.

61.

62.

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

https://speakerdeck.com/kikutaro/chu-metefalse-java-ee-kai-fa-karaxue-ndakoto-jjug-ccc-2014-spring

63.

[beta]

基本的な使い方
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());
}
(C) CASAREAL, Inc. All rights reserved.

63

64.

基本的な使い方 SQLに変換して実行される実行結果 [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 (C) CASAREAL, Inc. All rights reserved. 64

65.

よくある間違いこれはJPQLではなく、ほぼSQL！ String jpql = “select m from manufacturer m ” + “where name like :name”; 実行結果 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. (C) CASAREAL, Inc. All rights reserved. 65

66.

67.

68.

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

69.

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

70.

71.

72.

73.

74.

75.

76.