iBATOR - Giriş
iBATOR, iBATIS için bir kod üretecidir. iBATOR, bir veya daha fazla veritabanı tablosunun içini inceler ve tablolara erişmek için kullanılabilecek iBATIS yapıları oluşturur.
Daha sonra gereksinimlerinizi karşılamak için özel SQL kodunuzu veya saklı yordamınızı yazabilirsiniz. iBATOR aşağıdaki yapıları oluşturur -
- SqlMap XML Dosyaları
- Tablo (lar) ın birincil anahtarı ve alanlarıyla eşleşecek Java Sınıfları
- Yukarıdaki nesneleri kullanan DAO Sınıfları (isteğe bağlı)
iBATOR, bağımsız bir JAR dosyası veya bir Ant görevi veya bir Eclipse eklentisi olarak çalışabilir. Bu eğitici, iBATIS yapılandırma dosyalarını komut satırından oluşturmanın en basit yolunu açıklar.
İBATOR'u indirin
Eclipse dışında bir IDE kullanıyorsanız bağımsız JAR'ı indirin. Bağımsız JAR, iBATOR'u çalıştırmak için bir Ant görevi içerir veya iBATOR'u Java kodunun komut satırından çalıştırabilirsiniz.
Zip dosyasını iBATOR İndir bölümünden indirebilirsiniz .
Çevrimiçi belgeleri kontrol edebilirsiniz - iBATOR Belgeleri .
Konfigürasyon Dosyası Oluşturuluyor
İBATOR'u çalıştırmak için şu adımları izleyin -
Aşama 1
Bir yapılandırma dosyası ibatorConfig.xml'yi uygun şekilde oluşturun ve doldurun. En azından şunu belirtmelisiniz -
Bir <jdbcConnection> Hedef veritabanına nasıl bağlanılacağını belirtmek için öğe.
Bir <javaModelGenerator> Oluşturulan Java modeli nesneleri için hedef paketi ve hedef projeyi belirtmek için öğe.
Bir <sqlMapGenerator> Oluşturulan SQL harita dosyaları için hedef paketi ve hedef projeyi belirtmek için öğe.
Bir <daoGenerator> Oluşturulan DAO arabirimleri ve sınıfları için hedef paketi ve hedef projeyi belirtmek için öğe (DAO'lar oluşturmak istemiyorsanız <daoGenerator> öğesini atlayabilirsiniz).
En az bir veritabanı <table> element
NOTE −Bkz XML Yapılandırma Dosyası Referans bir iBATOR yapılandırma dosyasının bir örneği için sayfa.
Adım 2
Dosyayı uygun bir konuma, örneğin şu konuma kaydedin: \ temp \ ibatorConfig.xml.
Aşama 3
Şimdi iBATOR'u komut satırından aşağıdaki gibi çalıştırın -
java -jar abator.jar -configfile \temp\abatorConfig.xml -overwrite
İBATOR'a yapılandırma dosyanızı kullanarak çalışmasını söyleyecektir. Ayrıca iBATOR'a aynı ada sahip mevcut Java dosyalarının üzerine yazmasını söyleyecektir. Mevcut herhangi bir Java dosyasını kaydetmek istiyorsanız,−overwrite parametre.
Bir çakışma varsa, iBATOR yeni oluşturulan dosyayı benzersiz bir adla kaydeder.
İBATOR'u çalıştırdıktan sonra, yeni oluşturulan kodunuzu kullanmak için standart iBATIS yapılandırma dosyalarını oluşturmanız veya değiştirmeniz gerekir. Bu sonraki bölümde açıklanmaktadır.
İBATOR'u Çalıştırdıktan Sonraki Görevler
İBATOR'u çalıştırdıktan sonra, diğer iBATIS yapılandırma yapılarını oluşturmanız veya değiştirmeniz gerekir. Ana görevler aşağıdaki gibidir -
- SqlMapConfig.xml dosyasını oluşturun veya değiştirin.
- Dao.xml dosyasını oluşturun veya değiştirin (yalnızca iBATIS DAO Framework kullanıyorsanız).
Her görev aşağıda ayrıntılı olarak açıklanmıştır -
SqlMapConfig.xml Dosyasını Güncelleme
iBATIS, bir iBATIS oturumunda kullanılan veritabanı bağlantısı, işlem yönetimi şeması ve SQL eşleme XML dosyalarını belirtmek için yaygın olarak SqlMapConfig.xml olarak adlandırılan bir XML dosyası kullanır.
iBATOR, yürütme ortamınız hakkında hiçbir şey bilmediği için bu dosyayı sizin için oluşturamaz. Ancak, bu dosyadaki bazı öğeler doğrudan iBATOR tarafından oluşturulan öğelerle ilgilidir.
Yapılandırma dosyasındaki iBATOR'a özgü ihtiyaçlar aşağıdaki gibidir -
- İfade ad alanları etkinleştirilmelidir.
- iBATOR tarafından oluşturulan SQL Map XML dosyaları listelenmelidir.
Örneğin, iBATOR'un MyTable_SqlMap.xml adlı bir SQL Map XML dosyası oluşturduğunu ve dosyanın projenizin test.xml paketine yerleştirildiğini varsayalım. SqlMapConfig.xml dosyası şu girişlere sahip olmalıdır -
<?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>
Birden fazla SQL Map XML dosyası varsa (oldukça yaygın olduğu gibi), dosyalar <transactionManager> öğesinden sonra tekrarlanan <sqlMap> öğeleriyle herhangi bir sırada listelenebilir.
Dao.xml Dosyasını Güncelleme
İBATIS DAO çerçevesi, genellikle dao.xml olarak adlandırılan bir xml dosyası tarafından yapılandırılır.
İBATIS DAO çerçevesi, bu dosyayı DAO'lar için veritabanı bağlantı bilgilerini kontrol etmek ve ayrıca DAO uygulama sınıflarını ve DAO arayüzlerini listelemek için kullanır.
Bu dosyada, SqlMapConfig.xml dosyanızın yolunu ve iBATOR tarafından üretilen tüm DAO arayüzlerini ve uygulama sınıflarını belirtmelisiniz.
Örneğin, iBATOR'un MyTableDAO adlı bir DAO arabirimi ve MyTableDAOImpl adlı bir uygulama sınıfı oluşturduğunu ve dosyaların projenizin test.dao paketine yerleştirildiğini varsayalım.
Dao.xml dosyası şu girişlere sahip olmalıdır -
<?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 − Bu adım yalnızca iBATIS DAO çerçevesi için DAO'lar oluşturduysanız gereklidir.