* 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 のパースペクティブがなくなるので「以前の環境を復元できなかった」
という旨のメッセージが出るけど問題ない。

-----
[[プログラム・開発系メモ]]
トップ   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS