JPA & Kuina-Dao入門

Size: px

Start display at page:

Download "JPA & Kuina-Dao入門"

こうごあきます
5 years ago
Views:

1 2007 Autumn JPA & Kuina-Dao 入門 The Seasar Project 中村年宏 (taedium) 1

自己紹介中村年宏ブログ http://d.hatena.ne.jp/taedium/ hatena ne メールアドレス toshihiro.nakamura@gmail.

2 自己紹介中村年宏ブログ hatena ne メールアドレスコミッタとして関わっているプロダクト S2Container S2Dao S2Hibernate Kuina-Dao など執筆活動記事 :EJB3.00 入門講座書籍 :JPA 入門 ( 絶賛執筆中 ) 来年初頭発売? 2

3 アジェンダ JPA とは? JPA の効率的な学習方法 Kuina-Dao とは? Q&A 3

4 アジェンダ JPA とは? JPA の効率的な学習方法 Kuina-Dao とは? 4

5 JPA とは? Java Persistence API Java の永続化と O/R マッピングの標準 API 要するにデータベースアクセスの API JavaEE 環境でも JavaSE 環境でも使用できるただし JavaSE5 以上が必須 EJB3.0 とは別もの JPA はあくまで仕様 5

6 代表的な JPA 実装プロダクト Hibernate Red Hat 社が提供のOSS いわずと知れたO/Rマッピングフレームワークの代名詞 TopLink Essentials The GlassFish community が提供の OSS Oracle 社の TopLinkがベースになっている Apache OpenJPA The Apache Software Foundationが提供のOSS BEA 社の Kodo がベースになっている 6

7 JPAは JDBC とどう違う? O/R マッピングの自動化 SQL の方言の吸収ページングの SQL などキャッシュ機能 7

8 JPAは JDBC とどう違う? 部署テーブルを使って比較してみるブルを使って比較してみる PK DEPT( 部署 ) ID DEPT_NO DEPT_NAME LOC VERSION_NO ( 部署番号 ) ( 部署名 ) ( 所在地 ) ( バージョン番号 ) 1 10 ACCOUNTING NEW YORK RESERCH DALLAS SALES CHICAGO OPERATIONS BOSTON 0 8

9 通常の JavaBeans JDBC の場合 public class Dept { private Long id; private Integer deptno; private String deptname; private String loc; private Integer versionno; public Long getid(){...} public void setid(long id){...}... } O/R マッピング Java クラスのちがいエンティティクラス JPA public class private Long = "DEPT_NO") private Integer = "DEPT_NAME") private String deptname; private = "VERSION_NO") private Integer versionno; public Long getid(){...} public void setid(long id){...} アノテーションを... 指定する } 9

10 JDBC の場合 O/R マッピング主キーで取得するケース public Dept getdept(long id) throws SQLException { String sql = "select ID, DEPT_NO, DEPT_NAME, LOC, VERSION_NO from DEPT where ID =?"; Connection con = datasource.getconnection(); PreparedStatement ps = con.preparestatement(sql); ps.setlong(1, id); ResultSet rs = ps.executequery(); if (rs.next()) { Dept dept = new Dept(); } dept.setid(rs.getlong(1)); g( dept.setdeptno(rs.getint(2)); dept.setdeptname(rs.getstring(3)); dept.setloc(rs.getstring(4)); dept.setversionno(rs.getint(5)); return dept; コード上でマッピングを行うリソースの開放処理は省略しています return null; } 10

11 O/R マッピング主キーで取得するケース JPA の場合 public Dept getdept(long g id) { return entitymanager.find(dept.class, id); } すでにアノテーションでマッピングが行われているためコードが簡潔で済む 11

12 O/R マッピング新規追加するケース JDBC の場合 public void insert(dept dept) throws SQLException { String sql = "insert into DEPT (ID, DEPT_NO, DEPT_NAME, LOC, VERSION_NO) " + " values (?,?,?,?,?)"; Connection con = datasource.getconnection(); PreparedStatement ps = con.preparestatement(sql); ps.setlong(1, dept.getid()); ps.setint(2, dept.getdeptno()); ps.setstring(3, dept.getdeptname()); ps.setstring(4, dept.getloc()); ps.setint(5, dept.getversionno()); ps.executeupdate(); } コード上でマッピングを行うリソースの開放処理は省略しています 12

13 O/R マッピング新規追加するケース JPA の場合 public void insert(dept dept) { entitymanager.persist(dept); i t(d t) } すでにアノテーションでマッピングが行われているためコードが簡潔で済む 13

14 ページング RDBMS ごとに SQL を別のものにする必要がある JDBC で Oracle を使う場合 select * from ( select temp_.*, rownum rownum_ from ( select T.dept_id, T.dept_no, T.dept_name, T.loc, T.version FROM DEPT T order by T.dept_name ) temp_ where rownum <=? ) where rownum_ >? JDBC で H2 を使う場合 select T.dept_id, T.dept_no, T.dept_name, T.loc, T.version FROM DEPT T order by T.dept_name limit? offset? 14

15 ページングどの RDBMS であっても同じ呼び出し方で OK JPA の場合 public List<Dept> getdeptlist(int offset, int limit) { return entitymanager.createquery("select ect d from Dept d order by d.deptname") e.setfirstresult(offset).setmaxresults(limit).getresultlist(); } 15

16 キャッシュ機能 JDBC の場合キャッシュの機能はない JPA の場合 entitymanager.find(dept.class, 1L); entitymanager.find(dept.class, 1L); entitymanager.find(dept.class, 1L); 実際のデータベースアクセスは最初の一回だけ 16

17 JDBCと JPA の関係 JPAはアプリケーションにとって JDBC よりも使いやすい API JPAプロバイダ (HibernateやOpenJPA) は内部的にJDBCを使って RDBMSにアクセスするアプリ JPA JPA JDBC JDBC RDBMS プロバイダドライバ 17

18 アジェンダ JPA とは? JPA の効率的な学習方法 Kuina-Dao とは? 18

19 学習のポイント多くの機能に惑わされないよく使うのは一握り最初に代表的なアノテーションを覚えてしまうのがいい実際に動かしてみる環境を準備するのに時間がかかると嫌になってしまう便利な開発環境を利用するのがいい 19

20 最初はこれだけ覚えれば大丈夫! @GeneratedValue DEPT ) public class private Long = "DEPT_NO") private Integer = "DEPT_NAME") private String deptname; private = "VERSION_NO") private Integer versionno; } 20

21 次はこれだけ覚えれば大丈夫!! public class Dept { public class private Long id; private Long = = FetchType.LAZY) private Set<Emp> emps = new HashSet<Emp>(); } private Dept dept; ちゃんと理解できるまでは使わないほうが安全必ず LAZY を指定 21

22 META-INF の直下に必須次のことを設定できる永続プロバイダデータソーストランザクションのタイプ接続先のRDBMSの種類存在は確認しておきたい JPAの設定ファイル persitence.xml 22

23 JPA を試すのにお奨めの開発環境 Hibernate エンティティクラスからテーブルを自動生成できる Seasar2 テストツール (S2UnitまたはS2JUnit4) が便利トランザクションやデータソースなどHibernateとの連携をサポートエンティティクラスの自動検出ができる Dolteng( どぅるてん ) Seasar2 + Hibernateに必要なファイル群を自動生成できるエンティティクラスを自動生成できる H2のサンプルデータをもつ 23

24 デモデモ 1 開発環境の作成 (Dolteng を使用します ) デモ 2 テーブルからエンティティクラスを作って動かすデモ 3 エンティティクラスからテーブルを作って動かすデモ 4 関連を作成する 24

25 JPA を使いこなすためのポイント複合主キーは使わない主キーはサロゲートキー 1 つとするエンティティクラスとテーブルは 1:1 とするちゃんと理解するまでは継承や組み込みオブジェクトは使わないすべてを JPA で解決しようとしない必要ならば SQL も使用するエンティティにロジックをもたせない真のオブジェクト指向とかを求めない FetchType.LAZY と Fetch Join を効果的に利用する必要なデータにだけアクセスする 25

26 アジェンダ JPA とは? JPA の効率的な学習方法 Kuina-Dao とは? 26

27 Kuina-Dao とは? JPA 上で利用可能な Daoフレームワーク Dao インタフェースさえ定義すれば実装がいらない複数の JPA 実装に対応 Hibernate TopLink Essentials OpenJPA メソッドの引数名を実行時に利用する JPAの使いづらいところを解決! 動的なクエリの自動生成 SQLのDTOへのマッピング 27

28 Dao インタフェースのみで動作エンティティクラスDept に対するDao public interface DeptDao { /** 全件取得 */ public List<Dept> findall(); /** IDで取得 */ public Dept find(long id); /** 追加 */ public void persist(dept dept); /** 削除 */ public void remove(dept dept); } 28

29 メソッドの引数名を実行時に利用 Diigu を利用 Java クラスまたはインタフェースのメソッドが持つ引数の名前を実行時に利用可能にするためのプロダクト public interface DeptDao { } public List<Dept> finddeptbydeptname(string deptname); DiiguによりKuina-DaoはdeptNameをwhere 句に含めるべきと判断できるそして下記の JPAコード相当の処理を実行する public List<Dept> finddeptbydeptname(string deptname) { } return entitymanager.createquery("select d from Dept d where d.deptname = :deptname").setparameter("deptname", deptname).getresultlist(); 29

30 動的なクエリの自動生成エンティティのプロパティを条件とする検索ティを条件とする検索 (QueryByExample) Daoを利用するコード検索条件をセットしてDao Dept example = new Dept(); のメソッドに渡すだけ example.setdeptno(10); tn List<Dept> list = dao.findbyexample(example); SELECT dept FROM Dept AS dept WHERE (dept.deptno deptno = :deptno) 自動生成されるクエリ Daoを利用するコード Dept example = new Dept(); example.setdeptno(10); example.setdeptname("hoge"); List<Dept> list = dao.findbyexample(example); SELECT dept FROM Dept AS dept WHERE ((dept.deptno = :deptno) AND (dept.deptname d tn = :deptname)) 30

31 SQLの DTO へのマッピング SQL による検索 (QueryBySql) hoge.foo.deptdao public List<DeptDto> findbydeptname(string deptname); SQLファイルをDaoと同じパッケージに Dao 名 _ メソッド名.sql の形式で用意 SQLコメントを利用してメソッドの引数をバインドできる hoge.foo.deptdao_findbydeptname.sql select id, dept_name from dept where dept_name = /*deptname*/ SALES テスト用の文字列 Daoを利用するコード List<DeptDto> list = dao.findbydeptname("accounting"); 31

32 Q&A 32

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

Microsoft PowerPoint - sc2007spring_Aa1_Kuina.ppt

Microsoft PowerPoint - sc2007spring_Aa1_Kuina.ppt 2007 Spring Kuina-Dao 入門 2007.05.27 中村年宏 2007 Spring Copyright 2004-2007 The Seasar Foundation and the others. All rights reserved. 1 自己紹介名前 : 中村年宏ブログ :http://d.hatena.ne.jp/taedium/ コミッタとして参加しているプロジェクト