- 追加された行はこの色です。
- 削除された行はこの色です。
* iBATIS [#y4de6b33]
iBATIS は O/Rマッピングツールといわれるフレームワークのひとつ。
Apache プロジェクトで開発されている。
** 特徴 [#ua251832]
O/R マッピングツールであるが、[[Hibernate:http://www.hibernate.org/]] 等と違うのは SQL がそのまま使えること。
** インストール [#r637ea52]
次のダウンロードサイトなどから ibatis-x.x.x.xxx.zip (最新版) を取得して、
適当なフォルダに展開する。
- [[iBATIS - apache.org:http://ibatis.apache.org/]]
-- [[Java 版:http://ibatis.apache.org/javadownloads.cgi]]
-- [[.NET 版:http://ibatis.apache.org/dotnetdownloads.cgi]]
出てきたファイルをクラスパスの通っているところに置くか、
プロジェクト直下に置く。
- ibatis-common-2.jar
- ibatis-dao-2.jar
- ibatis-sqlmap-2.jar
最新版(2007/03/22時点)だとファイルが1つ (ibatis-2.3.0.677.jar) なんだけど、1つにまとまったのかな。
次に設定ファイルを書きます。
ファイル名はサンプルに従って SqlMapConfig.xml などとします。
<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE sqlMapConfig
PUBLIC "-//ibatis.apache.org//DTD SQL Map Config 2.0//EN"
"http://ibatis.apache.org/dtd/sql-map-config-2.dtd">
<sqlMapConfig>
<properties resource="SqlMapConfig.properties" />
<settings
cacheModelsEnabled="true"
enhancementEnabled="true"
lazyLoadingEnabled="true"
maxRequests="5"
maxSessions="2"
maxTransactions="2"
useStatementNamespaces="false"
/>
<transactionManager type="JDBC" >
<dataSource type="SIMPLE">
<property name="JDBC.Driver" value="${driver}"/>
<property name="JDBC.ConnectionURL" value="${url}"/>
<property name="JDBC.Username" value="${username}"/>
<property name="JDBC.Password" value="${password}"/>
</dataSource>
</transactionManager>
<!-- ここにリソース設定ファイルのパスを書く -->
<sqlMap resource="sqlmap/login.xml" />
<sqlMap resource="sqlmap/getHogeTable.xml" />
:
:
</sqlMapConfig>
このファイルに直接設定を書いても良いけど、
ここは SqlMapConfig.properties というファイルから設定を取ってくるようにする。
SqlMapConfig.properties は、例えば Oracle の場合、こんな感じで書く。
driver=oracle.jdbc.driver.OracleDriver
url=jdbc:oracle:thin:@127.0.0.1:1521:ORCL
username=user
password=passwd
** Eclipse プラグイン [#k68a26f2]
iBATIS のプラグインがあるので、それも入れておく。
*** インストール [#rfd2fcf5]
+ 「ヘルプ」→「ソフトウェア更新」→「検索とインストール」を選択。
+ 「新規リモートサイト」ボタンを選択。
+ 新規更新サイトダイアログに次のサイトを入力
-- 名前 : Abator for iBATIS Update Site (何でも良い)
-- URL : http://ibatis.apache.org/tools/abator
+ 「検索に含めるサイト」に「Abator for iBATIS Update Site」チェックボックスが現れるので、チェックして「終了」ボタンを選択。
あとは指示に従ってインストール。
*** Hibernate Tools プラグインの問題 [#z9620a4e]
Hibernate Tools プラグインが入っていると、なぜか「構成にエラーがある」という旨のメッセージが出て
新たなプラグインがインストールできないことがある。
Hibernate Tools 自体がまだベータ(2007/03/23 17:03時点 私の環境では 3.2.0.beta9a)なので、何か不具合を抱えてるんだろうとは思うけど。
''対処''&br;
とりあえず Hibernate プラグインを使わないのであれば、無効にすれば良い。
+ 「ヘルプ」→「ソフトウェア更新」→「構成の管理」を選択。
+ ツリーを展開して「Hibernate Tools」を選択して「使用不可にする」を選択。
+ 現在の構成に問題が起こるかもしれないという旨のメッセージが出て脅されるけど、
とりあえず Hibernate Tools を使っていなければ問題ない。
また、問題が出た場合は、同じダイアログで直前の構成に戻すこともできる(はず)。
+ 完了したら Eclipse の再起動を促されるので、そのまま再起動する。
+ Hibernate のパースペクティブがなくなるので「以前の環境を復元できなかった」
という旨のメッセージが出るけど問題ない。
-----
[[プログラム・開発系メモ]]