 | ||||||
 |
 |
 |
||||
 |
 |
 |
 |
 |
 |
 |
| ||||||
|
S2Hibernateを使うと、S2のJTAやConnectionPoolとHibernateが簡単に連動するようになります。これまでHibernateで開発するときの悩みの種だったSession管理をS2Hibernateが自動的に行ってくれるので、開発者はSessionのオープン・クローズ、Transaction処理から開放されます。SessionはJTAのトランザクション中は維持され、トランザクションの終了時に自動的にクローズ(flushも)されます。 セットアップS2と同様にJDK1.4以上が必要です。 S2HibernateVx.x.x.jarを解凍してできたs2hibernateディレクトリをEclipseのJavaプロジェクトとして丸ごとインポートしてください。 .classpathを上書きするか聞かれるので、すべてはいのボタンをクリックして、すべてを取り込みます。 これで、私と全く同じ環境になります。 サンプルはS2HibernateExamleVx.x.x.jarとして別途用意されているので、ダウンロードして解凍してください。 Eclipseでs2hibernate-exampleという名前でJavaプロジェクトを作成します。 解凍してできたs2hibernate-exampleディレクトリを丸ごとインポートしてください。 .classpathを上書きするか聞かれるので、すべてはいのボタンをクリックして、すべてを取り込みます。
コンソールアプリサンプルWEB-INF/src/examples配下にJavaアプリケーションのサンプルがあります。S2Hibernateとして必要なjarファイルは、s2hibernate/WEB-INF/libにそろってます。 Hibernateはコネクションプールやキャッシュの実装をいろいろ選べるようになっているので、 S2Hibernateで用意していない実装が必要な場合は、Hibernateのサイトよりダウンロードしてください。 簡単に機能を試すことができるように、RDBMSとしてHSQLDBを用意しています。 機能を試す前にあらかじめHSQLDBを実行しておいてください。 HSQLDBを実行するには、WEB-INF/bin/runHsqldb.batをダブルクリック(Windowsの場合)します。 lib/hsqldb.jarはHSQLDBを実行する上では必要ですが、本番では必要ありません。 libのjarファイル(hsqldb.jar以外)とsrcのhibernate.cfg.xml、ehcache.xml、j2ee.dicon、log4j.propertiesをCLASSPATHにとおせば、S2Hibernateを実行できます。 Eclipseにインポートして使う場合は設定は不要です。
OpenSessionInViewサンプルTomcatと Tomcat Pluginを使うことを前提にしています。 あらかじめインストールして置いてください。 s2hibernate-exampleプロジェクトを右クリックしてプロパティ->Tomcatを選びます。 Tomcatプロジェクトであるをチェックし、アプリケーションURIを/s2hibernate-exampleとします。 これで、Tomcatを再起動して、ブラウザからhttp://localhost:8080/s2hibernate-example/にアクセスするとOpenSessionInViewサンプルを見ることができます。使い方Hibernateを使いたいクラスは、S2SessionFactory型のフィールドを定義してコンストラクタあるいはプロパティ経由で実装クラス(S2SessionFactoryImpl)を受け取ります。あとは、S2SessionFactory.getSession()を呼び出してHibernateの機能を自由に使うことができます。Sessionのオープン・クローズ、トランザクション制御は一切必要ありません。S2SessionFactory.getSession()が返すオブジェクトは、HibernateのSessionのラッパーであるS2Sessionです。実行できるメソッドはHibernateのSessionと同じで、検査例外(HibernateException)を実行時例外(HibernateRuntimeException)に変換してくれます。そのため、HibernateExceptionをcatchしたくないクラスは特に何もする必要はありません。catchする必要がある場合は、HibernateRuntimeExceptionでcatchしてgetCause()でHibernateExceptionを取り出します。 ExampleEmployee.java
package examples.hibernate.entity;
import java.io.Serializable;
public class Employee implements Serializable {
private long empno;
private String ename;
private String job;
private Short mgr;
private java.util.Date hiredate;
private Float sal;
private Float comm;
private short deptno;
public Employee(long empno, java.lang.String ename, java.lang.String job, Short mgr,
java.util.Date hiredate, Float sal, Float comm, short deptno) {
this.empno = empno;
this.ename = ename;
this.job = job;
this.mgr = mgr;
this.hiredate = hiredate;
this.sal = sal;
this.comm = comm;
this.deptno = deptno;
}
public Employee() {
}
public Employee(long empno) {
this.empno = empno;
}
public long getEmpno() {
return this.empno;
}
public void setEmpno(long empno) {
this.empno = empno;
}
public java.lang.String getEname() {
return this.ename;
}
public void setEname(java.lang.String ename) {
this.ename = ename;
}
public java.lang.String getJob() {
return this.job;
}
public void setJob(java.lang.String job) {
this.job = job;
}
public Short getMgr() {
return this.mgr;
}
public void setMgr(Short mgr) {
this.mgr = mgr;
}
public java.util.Date getHiredate() {
return this.hiredate;
}
public void setHiredate(java.util.Date hiredate) {
this.hiredate = hiredate;
}
public Float getSal() {
return this.sal;
}
public void setSal(Float sal) {
this.sal = sal;
}
public Float getComm() {
return this.comm;
}
public void setComm(Float comm) {
this.comm = comm;
}
public short getDeptno() {
return this.deptno;
}
public void setDeptno(short deptno) {
this.deptno = deptno;
}
public boolean equals(Object other) {
if ( !(other instanceof Employee) ) return false;
Employee castOther = (Employee) other;
return this.getEmpno() == castOther.getEmpno();
}
public int hashCode() {
return (int) this.getEmpno();
}
}
Employee.hbm.xml<hibernate-mapping> EmployeeDao.javapackage examples.hibernate.dao;
import examples.hibernate.entity.Employee;
public interface EmployeeDao {
public Employee getEmployee(int empno);
}
EmployeeDaoImpl.java
package examples.hibernate.dao;
import java.util.List;
import net.sf.hibernate.Hibernate;
import org.seasar.hibernate.S2SessionFactory;
import examples.hibernate.entity.Employee;
public class EmployeeDaoImpl implements EmployeeDao {
private static final String HQL = "from Employee where empno = ?";
private S2SessionFactory sessionFactory_;
public EmployeeDaoImpl(S2SessionFactory sessionFactory) {
sessionFactory_ = sessionFactory;
}
public Employee getEmployee(int empno) {
List result = sessionFactory_.getSession().find(
HQL, new Integer(empno), Hibernate.INTEGER);
if (result.size() > 0) {
return (Employee) result.get(0);
} else {
return null;
}
}
}
EmployeeService.java
package examples.hibernate.service;
import examples.hibernate.entity.Employee;
public interface EmployeeService {
public Employee getEmployee(int empno);
}
EmployeeServiceImpl.java
package examples.hibernate.service;
import examples.hibernate.dao.EmployeeDao;
import examples.hibernate.entity.Employee;
public class EmployeeServiceImpl implements EmployeeService {
private EmployeeDao employeeDao_;
public EmployeeServiceImpl(EmployeeDao employeeDao) {
employeeDao_ = employeeDao;
}
public Employee getEmployee(int empno) {
return employeeDao_.getEmployee(empno);
}
}
Employee.dicon<components> EmployeeClient.java
package examples.hibernate.client;
import org.seasar.framework.container.S2Container;
import org.seasar.framework.container.factory.S2ContainerFactory;
import examples.hibernate.service.EmployeeService;
public class EmployeeClient {
private static final String PATH =
"examples/hibernate/client/Employee.dicon";
public static void main(String[] args) {
S2Container container = S2ContainerFactory.create(PATH);
container.init();
try {
EmployeeService service =
(EmployeeService) container.getComponent(EmployeeService.class);
System.out.println(service.getEmployee(7788).getEname());
} finally {
container.destroy();
}
}
}
実行結果DEBUG 2004-04-07 18:53:52,511 [main] トランザクションを開始しましたS2Hibernateを使えば、Hibernateのおいしいところだけを簡単に利用できるということが分かっていただけたと思います。 Open Session In View"Open Session In View"パターンは、ビューでSessionをオープンする機能です。実際には、クライアントから来たリクエストがServletFilterを通るときに自動的にSessionをオープンしRequestオブジェクトに設定、逆にリクエストがServletFilterを通ってかえるときに、Sessionを自動的に閉じます。 この機能により、JSPの中でSessionをすぐに使うことができます。もちろん、Sessionのオープン、クローズは、OpenSessionInViewFilterによって自動的に処理されるので、記述する必要はありません。 セットアップ次の２つのファイルに設定を追加します。・web.xmlに、OpenSessionInViewFilterの設定を追加。 ・app.diconに、OpenSessionInView.diconを読み込む設定を追加。 web.xml
<filter>
app.dicon
<include path="org/seasar/hibernate/filter/OpenSessionInView.dicon"/>
ExampleS2Session.jspフィルターで自動設定されたS2Sessionを直接使うサンプル<%@page contentType="text/html"%> departmentDao.jspJSPで、Service層を呼び出すサンプル（遅延ロード）<%@page contentType="text/html"%> 実行結果
DEBUG 2004-07-24 12:16:04,260 [http-8080-Processor24] トランザクションを開始しました
DEBUG 2004-07-24 12:16:04,260 [http-8080-Processor24] 論理的なコネクションを取得しました
DEBUG 2004-07-24 12:16:05,412 [http-8080-Processor24] 論理的なコネクションを取得しました
Hibernate: select department0_.DEPTNO as DEPTNO, department0_.DNAME as DNAME, department0_.LOC as LOC
from DEPT department0_ where (deptno=? )
== html start ==
Hibernate: select employeeli0_.EMPNO as EMPNO__, employeeli0_.DEPTNO as DEPTNO__,
employeeli0_.EMPNO as EMPNO0_, employeeli0_.ENAME as ENAME0_, employeeli0_.JOB as JOB0_,
employeeli0_.MGR as MGR0_, employeeli0_.HIREDATE as HIREDATE0_, employeeli0_.SAL as SAL0_,
employeeli0_.COMM as COMM0_, employeeli0_.DEPTNO as DEPTNO0_
from EMP employeeli0_ where employeeli0_.DEPTNO=?
== html end ==
DEBUG 2004-07-24 12:16:05,692 [http-8080-Processor24] 論理的なコネクションを閉じました
DEBUG 2004-07-24 12:16:05,762 [http-8080-Processor24] トランザクションをコミットしました
Service層の外でも、遅延ロードが設定されているオブジェクトの情報が取得できることを確認していただけると思います。
|
|
|
| |
|
© Copyright The Seasar Project and the others 2004, all rights reserved. |