iBATOR - Pendahuluan

iBATOR adalah generator kode untuk iBATIS. iBATOR melakukan introspeksi terhadap satu atau lebih tabel database dan menghasilkan artefak iBATIS yang dapat digunakan untuk mengakses tabel.

Nanti Anda dapat menulis kode SQL kustom atau prosedur tersimpan untuk memenuhi kebutuhan Anda. iBATOR menghasilkan artefak berikut -

File XML SqlMap
Kelas Java untuk mencocokkan kunci utama dan bidang dari tabel
Kelas DAO yang menggunakan objek di atas (opsional)

iBATOR dapat dijalankan sebagai file JAR mandiri, atau sebagai tugas Ant, atau sebagai plugin Eclipse. Tutorial ini menjelaskan cara paling sederhana untuk menghasilkan file konfigurasi iBATIS dari baris perintah.

Unduh iBATOR

Unduh JAR mandiri jika Anda menggunakan IDE selain Eclipse. JAR mandiri menyertakan tugas Ant untuk menjalankan iBATOR, atau Anda dapat menjalankan iBATOR dari baris perintah kode Java.

Anda dapat mengunduh file zip dari Download iBATOR .
Anda dapat memeriksa dokumentasi online - Dokumentasi iBATOR .

Membuat File Konfigurasi

Untuk menjalankan iBATOR, ikuti langkah-langkah berikut -

Langkah 1

Buat dan isi file konfigurasi ibatorConfig.xml dengan benar. Setidaknya, Anda harus menentukan -

SEBUAH <jdbcConnection> elemen untuk menentukan bagaimana menghubungkan ke database target.
SEBUAH <javaModelGenerator> elemen untuk menentukan paket target dan proyek target untuk objek model Java yang dihasilkan.
SEBUAH <sqlMapGenerator> elemen untuk menentukan paket target dan proyek target untuk file peta SQL yang dihasilkan.
SEBUAH <daoGenerator> elemen untuk menentukan paket target dan proyek target untuk antarmuka dan kelas DAO yang dihasilkan (Anda dapat menghilangkan elemen <daoGenerator> jika Anda tidak ingin membuat DAO).
Setidaknya satu database <table> elemen

NOTE −Lihat halaman Referensi File Konfigurasi XML untuk contoh file konfigurasi iBATOR.

Langkah 2

Simpan file di lokasi yang nyaman, misalnya, di: \ temp \ ibatorConfig.xml.

LANGKAH 3

Sekarang jalankan iBATOR dari baris perintah sebagai berikut -

java -jar abator.jar -configfile \temp\abatorConfig.xml -overwrite

Ini akan memberi tahu iBATOR untuk dijalankan menggunakan file konfigurasi Anda. Ini juga akan memberi tahu iBATOR untuk menimpa file Java yang ada dengan nama yang sama. Jika Anda ingin menyimpan file Java yang ada, hilangkan−overwrite parameter.

Jika ada konflik, iBATOR menyimpan file yang baru dibuat dengan nama unik.

Setelah menjalankan iBATOR, Anda perlu membuat atau memodifikasi file konfigurasi iBATIS standar untuk menggunakan kode yang baru Anda buat. Ini dijelaskan di bagian selanjutnya.

Tugas Setelah Menjalankan iBATOR

Setelah Anda menjalankan iBATOR, Anda perlu membuat atau memodifikasi artefak konfigurasi iBATIS lainnya. Tugas utamanya adalah sebagai berikut -

Buat atau modifikasi file SqlMapConfig.xml.
Buat atau modifikasi file dao.xml (hanya jika Anda menggunakan Framework iBATIS DAO).

Setiap tugas dijelaskan secara rinci di bawah -

Memperbarui File SqlMapConfig.xml

iBATIS menggunakan file XML, umumnya bernama SqlMapConfig.xml, untuk menentukan informasi untuk koneksi database, skema manajemen transaksi, dan file XML peta SQL yang digunakan dalam sesi iBATIS.

iBATOR tidak dapat membuat file ini untuk Anda karena tidak tahu apa-apa tentang lingkungan eksekusi Anda. Namun, beberapa item dalam file ini berhubungan langsung dengan item yang dibuat oleh iBATOR.

Kebutuhan khusus iBATOR dalam file konfigurasi adalah sebagai berikut -

Ruang nama pernyataan harus diaktifkan.
File XML Peta SQL yang dihasilkan iBATOR harus dicantumkan.

Misalnya, iBATOR telah membuat file XML Peta SQL yang disebut MyTable_SqlMap.xml, dan file tersebut telah ditempatkan dalam paket test.xml proyek Anda. File SqlMapConfig.xml harus memiliki entri ini -

<?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>
   <!-- Statement namespaces are required for Abator -->
   <settings useStatementNamespaces="true" />

   <!-- Setup the transaction manager and data source that are
   appropriate for your environment
   -->
	
   <transactionManager type="...">
      <dataSource type="...">
      </dataSource>
   </transactionManager>

   <!-- SQL Map XML files should be listed here -->
   <sqlMap resource="test/xml/MyTable_SqlMap.xml" />

</sqlMapConfig>

Jika ada lebih dari satu file XML Peta SQL (seperti yang cukup umum), maka file tersebut dapat dicantumkan dalam urutan apa pun dengan elemen <sqlMap> yang diulang setelah elemen <transactionManager>.

Memperbarui File dao.xml

Kerangka iBATIS DAO dikonfigurasi oleh file xml yang biasa disebut dao.xml.

Kerangka kerja iBATIS DAO menggunakan file ini untuk mengontrol informasi koneksi database untuk DAO, dan juga untuk membuat daftar kelas implementasi DAO dan antarmuka DAO.

Dalam file ini, Anda harus menentukan jalur ke file SqlMapConfig.xml Anda, dan semua antarmuka DAO yang dihasilkan iBATOR dan kelas implementasi.

Misalnya, iBATOR telah membuat antarmuka DAO yang disebut MyTableDAO dan kelas implementasi yang disebut MyTableDAOImpl, dan bahwa file telah ditempatkan dalam paket test.dao proyek Anda.

File dao.xml harus memiliki entri ini -

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE daoConfig PUBLIC "-//ibatis.apache.org//DTD DAO Configuration 2.0//EN" "http://ibatis.apache.org/dtd/dao-2.dtd">

<daoConfig>

   <context>
	
      <transactionManager type="SQLMAP">
         <property name="SqlMapConfigResource" value="test/SqlMapConfig.xml"/>
      </transactionManager>

      <!-- DAO interfaces and implementations should be listed here -->
      <dao interface="test.dao.MyTableDAO" implementation="test.dao.MyTableDAOImpl" />
   </context>
	
</daoConfig>

NOTE − Langkah ini diperlukan hanya jika Anda membuat DAO untuk framework iBATIS DAO.