ibatis AFŞIN AKDOĞAN Hacettepe Üniversitesi Mühendislik Fakültesi Bilgisayar Bilimleri Mühendisliği

Transkript

1 ibatis AFŞIN AKDOĞAN Hacettepe Üniversitesi Mühendislik Fakültesi Bilgisayar Bilimleri Mühendisliği 2006

2 İÇİNDEKİLER 1.iBatis Veri Haritalayıcısı (Data Mapper) Burada ne anlatılmaktadır? Ana Konu ibatis ne yapar? ibatis nasıl çalışır? Veri Haritalarıyla Çalışmak Veri Haritası bilgi kütükleri neleri içerir? Haritalanmış ifadeler İfade türleri ParameterMap ve satıriçi parametreler ResultMap Java Geliştirici Rehberi Java için ibatis Veri Haritalayıcısını yüklemek Java için Veri Haritalayıcısının konfigürasyonu Veri Haritalayıcısı istemcileri Veri Haritalayıcı konfigürasyon kütüğü (SqlMapConfig.xml) Veri Haritalayıcı konfigürasyon elemanları <properties> elemanı <properties> nitelikeleri <settings> elemanı <typealias> elemanı <typealias> nitelikleri Daha önceden tanımlanmış lakaplar <transactionmanager> Elemanı <datasource> Elemanı (transactionmanger la birlikte) <sqlmap> Elemanı ibatis Veri Haritalayıcısı ile Programlama : Java API Konfigürasyon Hareketler Global (Dağıtılmış) Hareketler Kümeler İfadelerin İşletilmesi insert(), update(), delete(): queryforobject(): queryforlist(): queryformap(): Örnekler Örnek Uygulama Eklentiler...26 Kaynaklar...27 Terimler Sözlüğü

3 1.iBatis Veri Haritalayıcısı ibatis çatısı, Java ve.net geliştiricilerine veriye ulaşmada yardımcı olmak amacıyla hazırlanmış açık kaynak bileşenlerinden oluşan bir yapıdır. İlişkisel veritabanına erişim sırasında genel olarak kullanılan yol JDBC yaklaşımıdır. Fakat bu yöntem okunurluğu az, gereğinden fazla şişmiş ve iş mantığı üzerinde bir etkisi olmayan karmaşık kodlar ortaya çıkarmaktadır. SQL Maps, bu yaklaşımla birlikte gelen fazla kodları azaltmayı sağlar(not:sql Map ları kullanmak için JavaBean ler, XML ve SQL ile aşina olmanız yeterlidir). 1.1.Burada ne anlatılmaktadır? Bu döküman ibatis Data Mapper ın Java ve.net uygulamalarını içermektedir. Java için ibatis Data Mapper versiyon 2.x Örnek uygulamaları da bu dökümanda bulabilirsiniz. Size tavsiyemiz bu dökümanı okumadan önce kendi platformunuz için hazırlanan örnek uygulamalara bakmanızdır. 2.Ana Konu ibatis, nesneleri SQL ifadelerine haritalamada(map) kolaylık sağlayan basit ama tam bir çatıdır. ibatis i geliştiren ekibin temel felsefesi : veriye erişimde %80 fonksiyonelliği %20 kod kullanark sağlamaktır ibatis ne yapar? Geliştiriciler çoğu zaman bir uygulamanın içindeki nesneler arasında haritalar yaratırlar. Haritalayıcı(Mapper) denince anlaşılan anlamlardan biri, iki bağımsız nesne arasındaki iletişimi sağlayan nesne olarak bilinir. Veri Haritalayıcı (A Data Mapper) ise verileri nesneler ve veritabanı arasında taşıyan ve bunu yaparken aradaki bağımsızlığı sağlayıp, koruyan bir haritalayıcı katmandır. Siz veritabanı ve nesneleri sağlarken; ibatis bu ikisi arasındaki haritalama katmanı görevini yerine getirir ibatis nasıl çalışır? Çalışıtığınız platform size veritabanına erişmek amacıyla bazı araçları sağlamaktadır. Bu araçlar SQL ifadeleri ya da mevcut fonksiyonlardır. Fakat JDBC kullanırken geliştiriciler için hala bazı zorluklar mevcuttur, bunlar: SQL ve program kodlarını birbirinden ayırmak Kütüphane sınıflarına parametre geçmek İş mantığı içeren sınıfları ve veriye erişimi sağlayan sınıfları birbirinden ayırmak Sık kulanılan verilere erişimde tekrar tekrar erişim yapmayarak performası arttırmak Hareketleri (transaction) yönetmek. 3

4 ibatis Data Mapper bu ve bunun gibi pek çok problemi geleneksel nesneler(plain-old objects) ve SQL ifadeleri arasında XML belgeleri kullanarak çözmektedir. Geleneksel nesneler (Java kullanıyorsanız) berhangi bir harita veya JavaBean ya da (.NET kullanıyorsanız) Idictionary veya özellik nesnesi(property object) olabilir. İpucu Nesnenin özel bir nesne hiyerarşisine ait olmasına veya özel bir arayüzü gerçekleştirmesine gerek yoktur (Bu neden onları Geleneksel Nesne olarak adlandırdığımızı açıklamaktadır). Şekil 1. ibatis Veri Haritalayıcısı İş Akışı Şekil 1 tarafından gösterilen iş akışının üst düzey açıklaması; 1. Ya bir nesne ya da belirgin(native) bir tür olan bir parametrenin sunulması. Bu parametre SQL ifadelerinin veya mevcut fonksiyonların gerçek zamandaki değerlerini vermede kullanılır. Eğer gerçek zamanlı bir değere ihtiyaç yoksa bu parametre ihmal edilebilir. 2. Parametre geçilen değer ve XML betimleyici içindeki adını sizin verdiğiniz SQL ifadesi ile haritalamayı çalıştırılır. Bu adım mantığın işlediği adımdır. Kullanılan çatı daha önce parametre olarak geçilen değeri de kullanark gerçek zamanlı değerleri de koyarak SQL ifadesini veya mevcut fonksiyonu hazırlar. H azırlanan bu ifade veya fonksiyonu işletir, sonuçlarını elde eder ve geri döndürür. 3. Herhangi bir update işlemi gerçekleştiğinde, bu işlemden etkilenen satır sayısı geri döndürülür. Herhangi bir sorguda tek bir nesne veya bir nesne kümesi sorgu sonucu olarak geri dönebilir. Tıpkı parametre gibi sonuçta dönen nesne veya nesne kümesi, geleneksel bir nesne veya belirli bir türde olabilir. Aynı zamanda sonuç XML olarak da verilebilir. Peki bu anlatılanlar kaynak kodunda nasıl görünecektir? Burada lineitem nesnesinin veritabanına ekleme işini gerçekleştiren örnek bir kod parçası görceksiniz. Eğer veritabanınız birincil anahtarlar(primary key) üretiyor ise bu üretilen anahtar aşağıdaki fonksiyonun çağırılmasıyla geri döndürülebilir, 4

5 Örnek 1 XML betimleyicinin InsertLineItem için kullanımını gösterir Örnek 1. "InsertLineItem" betimleyicisi <selectkey> SQL Sunucu veritabanı tarafından otamatik olarak üretilen bir anahtar döndürür. Eğer birden fazla satırı veritabanından çekmek isterseniz, ibatis her biri sonuç kümesinde tek tek bir satıra haritalanmış bir nesne listesi döndürür. Bölüm 3 Data Map bilgi kütükleri bu bölümde "InsertLineItem" için gerekli açıklamalar tanımlanmıştır. Bölüm 4 ve 5 Geliştirici Rehberi ibatis in uygulamanıza adapte olması için gerekli konfigürasyon kütüklerini anlatmaktadır. 3. Veri Haritalarıyla Çalışmak Eğer ibatis i nasıl yükleyeceğinizi ve nasıl konfigürasyon yapacağınızı öğrenmek istiyorsanız, Geliştirici Rehberi ne bakınız (Bölüm 4 veya 5). Fakat ibatis in gerçekte nasıl çalıştığını öğrenmek istiyorsanız bu bölüme devam ediniz. Data Map bilgi kütükleri uygulamaya dönük daha ilgi çekici bir konudur. Burada veritabanı ile geliştirdiğiniz uygulamanın nasıl birlikte çalışıcağı anlatılmaktadır. Daha önce de belirtildiği gibi Data Map bilgi kütükleri denilen şey aslında XML betimleyici kütükleridir. ibatis tarafından sunulan hizmetleri kullanarak, XML betimleyicilerini birer istemci nesnelerini haline getirmekteyiz. Data Maplere erişmek için uygulamanız sunucu nesnesini çağırır. ibatis kullanırken yapılan esas iş çoğunlukla uygulama kodunda değilidir, bunun yerine ibatis tarafından dönüştürülen XML betimleyicilerindedir. Bu uygulamanın kaynak koduyla 5

6 uğraşmak yerine daha çok XML betimleyiciyle çalışılması anlamına gelmektedir. Bunun yararı ise nesnleri veritabanına haritalamanın bu yolla daha kolay olmasıdır Veri Haritası bilgi kütükleri neleri içerir? Eğer örnek uygulamarı okuduysanız, Data Map ile ilgili bazı basit örnekleri görmüşsünüzdür, tıpkı aşağıdaki örnekte olduğu gibi. sqlmap name="lineitem" xmlns:xsi=" xsi:nonamespaceschemalocation=" sd"> <alias> <typealias alias="lineitem" assembly="npetshop.domain.dll" class="npetshop.domain.billing.lineitem" /> </alias> <statements> <insert id="insertlineitem" parameterclass="lineitem"> INSERT INTO [LinesItem] (Order_Id, LineItem_LineNum, Item_Id, LineItem_Quantity, LineItem_UnitPrice) VALUES (#Order.Id#, #LineNumber#, #Item.Id#, #Quantity#, #Item.ListPrice#) </insert> </statements> </sqlmap> Örnek 2..NET için Veri Haritası Bu harita LineItem örneğinin bazı özelliklerini almış ve SQL ifadesi içerisinde değerleri birleştirmiştir. Şimdi de Örnek 3 te basit bir select ifadesini göreceğiz Örnek 3. Java için Veri Haritası örneği 6

7 3.2. Haritalanmış ifadeler Haritalanmış ifadeler herhangi bir SQL ifadesini tutabilir ve girdi-çıktı amacıyla Parametre Haritalarını ve Sonuç Haritalarını kullanabilir. Basit bir durumda haritalanmış ifade bir parametreyi veya sonuç sınıflarını direk referans olarak gösterebilir. Haritalanmış ifadeler aynı zamanda caching yeteneğin de sahiptirler. Örnek 4. ifadeler için örnek sözdizim Örnek 5 te [ ] arasına alınmış ifadeler opsiyoneldir. Bazı durumlarda sadece kısıtlı ifadelere izin verilir. Örnek 6 da görüldüğü gibi basit Haritalanmış ifadeler ise tamamen yasaldır. Örnek 5. Basit Bir Haritalanmış İfade Örnek 6 da açıkça görülüyorki ibatis i bazı keyfi SQL ifadelerini gerçekleştirmede kullanabilirsiniz. 7

8 İfade türleri Örneklerde görülen <statement> ifadesi genel bir yaklaşımı karşılamaktadır. Bu ifade SQL ifadesinin herhangi bir türü için kullanılabilir. Genelde bu tarz bütünü kapsayan bir ifade kullanmak yerine daha özelleşmiş bir ifade kullanmak tercih edilir. Özelleşmiş(spesifik) elemanların kullanımı genel ifadeleri kullanmaya göre daha fazla özellik sağlayabilir. Tablo 1 ifade-türleri ni ve onların niteliklerini ve özelliklerini özetlemektedir. İfade <statement> Nitelikler id parameterclass resultclass parametermap resultmap cachemodel xmlresultname All dynamic elements Çocuk Elemanlar insert update delete Fonksiyonlar All query methods <insert> id parameterclass parametermap All dynamic elements <selectkey> insert update delete <update> id parameterclass parametermap All dynamic elements insert update delete <delete> id parameterclass parametermap All dynamic elements insert update delete <select> id parameterclass resultclass parametermap resultmap cachemodel All dynamic elements All query methods <procedure> id parameterclass resultclass parametermap resultmap xmlresultname All dynamic elements insert update delete All query methods Tablo 1. İfade türleri 8

9 3.3. ParameterMap ve satıriçi parametreler Bir çok SQL ifadesi kullanışlıdır, çünkü gerçek zamanlı olarak bu ifadelere parametre geçilebilir. Örneğin biri 42 No lu kaydı veritabanından çekmek istiyor. Eğer 42 değeri başta elimizde yoksa gerçek zamanlı olarak bu değer SQL ifadesine verilebilir. JDBC kullanark bu yapıldığında 42 değeri yerine? konur. Bu? yerine daha sonra üretilen değer konabilir. Bir veya daha çok parametre bu şekilde gerçek zamanlı olarak parametre geçilebilir, ancak bunu yapabilmek için parametreler sıralı olarak girilmelidir. Bu basit olmasına rağmen yoğun emek isteyen ve geliştiricilerin fazlaca zamanını alan bir iştir. Parametre Haritalayıcı SQL ifadesine parametre olarak geçilecek değerleri verebilmek için sıralı bir liste tutar. Bu aşamada da harita tarafından açıkça belirtilen nitelikler doğru sırada verilmeli ve her bir parametre isimlendirilmelidir. Parametre Haritaları dış eleman ve satıriçi olarak sağlanabilirler. Aşağıdaki örnek dış parametre haritasına bir örnektir.  <parametermap id= parametermapname [class= classname ]>[type= String ] <parameter property = propertyname [jdbctype= VARCHAR ] [javatype= String ] [nullvalue= NUMERIC ] [null= ]/> <parameter /> <parameter /> </parametermap>  <parametermap id= parametermapname [class= classname ]> <parameter property = propertyname [dbtype= VARCHAR ] [nullvalue= NUMERIC ] [null= ]/> <parameter /> <parameter />database columns </parametermap> Örnek 6. dış Parametre haritası Örnek te [ ] arasına alınmış ifadeler opsiyoneldir. ParameterMap elemanı sadece id niteliğine ihtiyaç duymaktadır. Class niteliği ise opsiyonel ama gereklidir. Class niteliği gelen parametreyi onaylamada ve performansı arttırmada yardımcıdır. Aşağıdaki örnek <parametremap> için tipik bir örnektir. 9

10 3.4. Result Map Bölüm 3.3 de ParameterMap ve Satıriçi parametreler anlatıldı. Anlatıldığı gibi bunlar nesnenin özelliklerini veritabanı sorgusuna haritalamayı sağlayan kullanımlardı. Result Map veritabanı sorgusu sonucunda oluşan sonuçları nesne özelliklerine haritalayarak işi bitirir. ResultMap ler verinin sorgu sonucundan nasıl çekildiğini ve kolonların nesne özelliklerine nasıl haritandığını kontrol etme imkanı verir. Aşağıdaki örnek bir result map elemanının genel yapısını göstermektedir. Örnek 7. Bir Result Map elemanının genel yapısı Örnekte [] içine alınmış alanlar opsiyoneldir. Id niteliği mutlaka kullanılmalıdır. Bunun sebebi ifade ye referans göstermek için gerekli ismi sağlamasıdır. Aynı zamanda class niteliği de gereklidir. Class niteliği bir sınıfın tam ismini vermektedir. 10

11 4. Java Geliştirici Rehberi 4.1. Java için ibatis Veri Haritalayıcısını yüklemek Java için ibatis Veri Haritalayıcısını bilgisayarınıza yüklemek için classpath e gerekli.jar kütüklerini eklemelisiniz. Bu ya JVM nin açılış zamanında açıkça belirtilen classpath olabilir ya da web uygulamaları altındaki WEB-INF/lib dizini olabilir. Eğer Java ve/veya classpath kavramları için yeni iseniz aşağıda linkleri verilen web sitelerinden gerekli bilgileri öğrenebilirsiniz ibatis Veri Haritalayıcısı classpath de olması gereken JAR kütüklerini kendiyle birlikte getirmektedir. Bu JAR kütükleri; Kütük adı ibatis-common.jar ibatis-sqlmap.jar ibatis-dao-1-x-x-b.jar ibatis-compat Açıklama ibatis in genel özellikleri ibatis Veri Haritalayıcı çatısı Veriye erişimde geriye dönük uyumluluğu sağlamak için Java için geriye dönük uyumluluğu sağlamak için Gerekli mi? evet evet hayır hayır Tablo 2. ibatis Veri Haritalayıcısı tarafından kullanılan JAR kütükleri 4.2. Java için Veri Haritalayıcısının konfigürasyonu XML betimleyicisi, sahip olduğunuz veri, veri haritaları veya hareketlere ait ayrıntıları içerir. ibatis Veri Haritalayacısının konfigürasyonu bu XML betimleyicisini kullanarak yapılır. Çalışma zamanında geliştirmiş olduğunuz uygulama kodunuz bir ibatis kütüphanesi çağırır. Bu çağırılan kütüphane ana konfigürasyon kütüğünü okur ve parçalara ayırır. Diğer XML betimleyicileri referans ile bu işleme dahil edilebilir ancak her bir Veri Haritalayıcı istemci örneği tek bir konfigürasyon kütüğü tarafından başlatılırlar Veri Haritalayıcısı istemcileri Her bir Veri Haritalayıcısı ( SqlMapClient ın örneği ) tek bir konfigürasyon kütüğünün okunmasıyla yaratılır. Her bir konfigürasyon kütüğü sadece tek bir veritabanı veya veri kaynağını belirtebilir. Yinede uygulamanızda birden çok Veri Haritalayıcı istemcisini kullanabilirsiniz. Bunun için sadece başka bir konfigürasyon kütüğü yaratın ve Veri Haritalayıcı istemcisi yaratıldığında, kütüğün ismini bu konfigürasyon kütüğüne vermeniz. Bu konfigürasyon kütükleri aynı veritabanında farklı bir hesabı kullanabildiği gibi farklı sunucular üzerinde bulunan farklı veritabanlarını da kullabilir. 11

12 Veri Haritalayıcı konfigürasyon kütüğü (SqlMapConfig.xml) Aşağıda konfigürasyon kütüğüne bir örnek bulunmaktadır. <?xml version="1.0" encoding="utf-8"?> <!DOCTYPE sqlmapconfig PUBLIC "-//ibatis.com//dtd SQL Map Config 2.0//EN" " <sqlmapconfig> <properties resource="properties/database.properties"/> <settings cachemodelsenabled="true" enhancementenabled="true" maxsessions="64" maxtransactions="8" maxrequests="128"/> <transactionmanager type="jdbc"> <datasource type="simple"> <property value="${driver}" name="jdbc.driver"/> <property value="${url}" name="jdbc.connectionurl"/> <property value="${username}" name="jdbc.username"/> <property value="${password}" name="jdbc.password"/> <property value="15" name="pool.maximumactiveconnections"/> <property value="15" name="pool.maximumidleconnections"/> <property value="1000" name="pool.maximumwait"/> </datasource> </transactionmanager> <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/account.xml"/ > <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/category.xml" /> <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/product.xml"/ > <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/sequence.xml" /> <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/lineitem.xml" /> <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/order.xml"/> <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/item.xml"/> </sqlmapconfig> Örnek 8. SqlMapConfig.xml (Java) Veri Haritalayıcı konfigürasyon elemanları Bundan sonraki birkaç bölüm java için gerekli konfigürasyon kütüğünü ve bu kütüğün elemanlarını anlatacaktır <properties> elemanı Bazen XML konfigürasyon kütüğü içindeki değerler 12

13 Geliştirdiğimiz uygulamayı bir sunucudan başka bir sunucuya taşıdığımızda çoğu zaman XML konfigürasyon kütüğü içindeki değerler de değişikliğe uğrarlar. XML konfigürasyon kütüğü içindeki bu değerleri bütünlüğü bozmadan yötebilmek için, Veri Haritalayıcı konfigürasyonun bir parçası olarak standart bir özellikler (properties) kütüğü yaratabilirsiniz (name=value). Özellikler kütüğündeki her bir isimlendirilmiş değer artık bir kabuk olrak anılır. Artık bu değerler Veri Haritalayıcı konfigürasyonu boyunca kullanılabilirler (Bu konudaki gerekli açıklamalar bölüm 3 de açıklanmıştır). Örneğin Veri Haritalayıcı konfigürayonundaki veri haritası içeren herhangi bir eleman ${username} değişkenini, değeri ibatis e eklemek için kullanabilir. Örneğin Özellikler classpath ten veya tanımlı herhangi bir URL den yüklenebilir. Örneğin <properties> nitelikeleri resource ve url niteliklerinden birini içeren ancak tek bir <properties> elemanı olabilir. resource classpath üzerinde herhangi bir yerde bulanabilen özellikler kütüğü url yerel kütük sisteminde bulunan özellikler <settings> elemanı Çatı tarafından kullanılan belirli sayıda minimumlar, maksimumlar ve diğer ayarlar bulunmaktadır. Bir uygulama için öngörülmüş ayarlar diğer bir uygulama için uygun olmayabilir. <settings> elemanı size bu seçenekleri ayarlamanıza ve XML dökümanı tarafından yaratılan SqlMapClient örneğinin optimizasyona olanak sağlar. Bütün ayarların başlangıçta varsayılan değerleri vardır, ama bu ayarları tamamiyle veya bazı nitelikelerini çıkarabilirsiniz. Aşağıdaki tabloda gerekli ayarları, bunların davranışlarını ve örneklerini bulabilirsiniz. cachemodelsenabled Bu ayar global olarak SqlMapClient için tüm cache modelleri etkin hale getirir ya da tam tersini yapar. usestatementnamespaces (Java) Bu seçeneğin etkin hale gelmesiyle, haritalanmış ifadeleri onların tam isimleriyle referans göstermek zorunluluğunu getirmiş olursunuz. Tam isim dediğimiz sqlmap adı ve ifadenin adından oluşmaktadır.örneğin maxrequests Bu bir SQL ifadesinin bir anda işletebileceği maksimum 13

14 thread sayısıdır.farklı Veritabanı Yönetim Sistemlerinin farklı limitleri vardır. Ancak bu limitleri içemeyen bir veritabanı olamaz. Bu değer genelde maxtransactions sayısının 10 katı, aynı zamanda hem maxsessions hem de maxtransactions sayısından daha fazla olmalıdır. Raslantısal olarak ortaya çıkan istemleri azaltmak performansın artmasını sağlamaktadır. maxsessions Bu belirli bir anda aktif olabilecek maksimum oturum sayısını belirtir. Bu sayı maxtransactions sayısında eşit veya büyük ve maxrequests sayısından küçük olmalıdır. maxtransactions Bu bir anda SqlMapClient.startTransaction() a dahil olabilen maksimum thread sayısıdır. lazyloadingenabled Bu ayar global olarak SqlMapClient lar için tüm yavaş yüklemeleri etkin hale getirir ya da tam tersini yapar. enhancementenabled İdeal JavaBean erişimleri için byte kodu etkin hale getirir. errortracingenabled TODO Tablo 3. <settings> elemanının nitelikleri <typealias> elemanı typealias elemanı tüm sınıf ismini yazmak yerine daha kısa olarak tanımlamanızı sağlar. Örneğin Örnek 9. ytpealias Yukarıdaki örnekte tüm sınıf ismini yazmak yerine account ya da Account yazmak yeterlidir <typealias> nitelikleri <typealais> elemanının iki tane gerekli niteliği vardır: alias biricik bir belirteçtir. class paket referansını da içeren tüm sınıf ismi 14

15 Daha önceden tanımlanmış lakaplar Java için tanımlanmış bir kaç çeşit lakap(alias) vardır. Örnek 10. Transaction Manager Lakapları (Java) Örnek 11. Data Source Factory Lakapları (Java) <transactionmanager> elemanı.net sadece ADO tarafından kontrol edilen hareketleri desteklemektedir. Sadece tek bir yöneticinin olması sebebiyle TransactionManager elemanı.net tarafından desteklenmemektedir. Bu sebeble burdaki örnekler sadece Java üzerinden verilecektir <datasource> elemanı (transactionmanger la birlikte) Java gerçekleştirimi üç adet DataSource fabrikası sağlamaktadır. Aynı zamanda kendinizinkini yazabilirsiniz. <transactionmanager type="jdbc"> <datasource type="simple"> <property name="jdbc.driver" value="org.postgresql. Örnek 2. SimpleDataSourceFactory için TransactionManager elemanı (Java) <transactionmanager type="jdbc"> <datasource type="dbcp"> <property name="jdbc.driver" value="${driver}"/> Örnek 13. DbcpDataSourceFactory için TransactionManager elemanı (Java) <transactionmanager type="jdbc" > <datasource type="jndi"> <property name="datasource" value="java:comp/env/ Örnek 14. JndiDataSourceFactory için TransactionManager elemanı (Java) <transactionmanager type="jta" > <property name="usertransaction" value="java:/ctx/con/usertransaction"/> Örnek 15. global transactions için konfigüre edilmiş TransactionManager elemanı(java) 15

16 <sqlmap> elemanı Günümüzde pek çok iş Veri Haritaları kullanılarak yapılmaktadır. Veri Haritaları sizin uygulamalarınız tarafından kullanılan mevcut fonksiyonlar veya SQL ifadelerini tanımlar. Aynı zamanda Parameter ve Result nesneleri Veri Haritasının bir parçası olarak tanımlanırlar. Uygulamanız geliştikçe bir kaç çeşit Veri Haritasına gereksinim duyabilirsiniz. Pek çok Herhangi bir sayıda Veri Haritasını yaratabilirsiniz. Veri Haritalarının artmasıyla bütünlüğü koruyabilmek ve onları birleştirmek için Veri Haritalayıcı konfigürasyon kütüğüne referans göstermelisiniz. Veri Haritalayıcıları tarafından kullanılan tüm bu bilgi kütükleri konfigürasyon kütüğünde listelenmelidir. Örnek 32 Bir Veri Haritası kümesinin URL den veya classpath ten yüklenmek için <sqlmap> elemanını göstermektedir.  <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/category.xml"/> <sqlmap resource="com/ibatis/jpetstore/persistence/sqlmapdao/sql/product.xml"/>  <sqlmap url="file:///c:/config/category.xml" /> <sqlmap url="file:///c:/config/product.xml" />  <sqlmap file="maps/category.xml"/> <sqlmap file="mmps/product.xml"/> Örnek 16. Veri Haritası elemanı 4.3. ibatis Veri Haritalayıcısı ile Programlama : Java API SqlMap istemci API sı basit ve çok küçüktür. Dört adet işleme izin verir; 1- Veri Haritasının konfigürasyonu 2- SQL update komutunun işletilmesi. 3- Tek bir nesne için bir sorgunun işletilmesi 4-Liste halindeki nesneler kümesi için bir sorgunun işletilmesi Konfigürasyon ibatis Veri Haritalayıcısının konfigürasyonu, bir kere Veri Haritası bilgi kütüklerini ve Veri Haritalayıcı konfigürasyon kütüğünü yarattıktan sonra çok kolay bir işlem haline gelir. SqlMapClient örnekleri SqlMapClientBuilder kullanılarak yapılırlar. Bu sınıfın buildsqlmap() adıyla anılan bir tane özel statik metodu vardır. buildsqlmap() metodu sqlmap-config.xml kütüğünü okuyacak bir okuyucu parametre olarak alır(aşağıdaki örnekte açıkça gösterilmektedir). 16

17 Hareketler Bir SqlMapClient örneği nezaman bir executexxxx() metodunu çağırsa sadece tek bir iş yapılır. Bu ideal bir yaklaşım deeğildir. Çünkü eğer işin tek bir parçasını yapacak olan birden çok ifadeniz varsa bu demek oluyorki ya başarılı luncak ya da grup olarak başarısız oluncak. Bu neden Hareketleri kullandığımızı açıklamaktadır. Eğer global, performansı arttırmanın yanı sıra veritabanına erişim trafiğini de oldukça azaltmaktadır. SqlMapClient arayüzü size bazı sınırlamalar getirme konusunda yardımcı metodlara sahiptir. Bir hareket SqlMapClient arayüzündeki aşağıda gösterilen metodları kullanarak başlatılabilir, işletilebilir... Bir hareket başlatarak bağlantı havuzundan bir tane bağlantı edinmiş olursunuz. Aynı zamanda SQL sorgularını işletebilmek için bu bağlantıyı açmış olursunuz. private Reader reader = new Resources.getResourceAsReader ("com/ibatis/example/sqlmapconfig.xml"); private SqlMapClient sqlmap = XmlSqlMapBuilder.buildSqlMap(reader); public updateitemdescription (String itemid, String newdescription)throws SQLException { try { sqlmap.starttransaction (); Item item = (Item) sqlmap.queryforobject ("getitem", itemid); item.setdescription (newdescription); sqlmap.update ("updateitem", item); sqlmap.committransaction (); } finally { sqlmap.endtransaction (); } } Örnek 17. Hareketlerin kullanımı Not : endtransaction() metodunun ne olursa olsun (bie aykırı durum oluşsa bile) çağırıldığına dikkat ediniz. Bu bütünlüğü sağlamak için önemli bir adımdır. Kural : eğer starttransaction() metodunu çağırdıysanız mutlaka endtransaction() metodunu da çağırmalısınız. Not : Hareketler içiçe olacak şekilde olamaz. Bir thread ten commit() veya rollback() metodları çağırılmadan birden çok starttransaction() metodu çağırılıyor ise bu bir aykırı duruma sebep olacaktır. Diğer bir deyişle her bir SqlMapClient başına her bir thread en çok bir tane hareket başlatabilir. Not: SqlMapClient hareketleri Java nın kendi yerel belleğini kullanmaktadır. Bu starttransaction() metodunu çağıran her bir thread için ayrı bir bağlantı sağlandığı anlamına gelmektedir. Bu bağlantıları Veri Kaynağına geri verebilmek için mutlaka committransaction() veya endtransaction() metodları çağırılmalıdır. Aksi takdirde bağlantı havuzundaki bağlantılar zamanla tükenecek ve ve bir kilitlenme durumu ortaya çıkacaktır. 17

18 Global (Dağıtılmış) hareketler ibatis Veri Haritalayıcısı aynı zamanda global hareketlere de izin vermektedir. Global hareketler, diğer adıyla dağıtılmış hareketler, birden çok veritabanında güncelleme yapabilmeye imkan sağlamaktadır. ibatis sizin için global hareketleri yönetmektedir Kümeler Eğer sorgu olmayan (insert/update/delete) pek çok işletilecek ifadeniz varsa, bilgisayar ağı trafiğini azaltabilmek için bunları kümeler halinde işletebilirsiniz. Kümeleme işlemleri ibatis Veri Haritalayıcısı ile oldukça kolaydır. Örneğin, executebatch() metodunu çağırarak tüm kümelenmiş ifadeler JDBC sürücüsü botunca işletilecektir. 18

19 İfadelerin işletilmesi SqlMapClient haritalanmış tüm ifadeleri işletebilmek için bir API sağlamaktadır. Aşağıda bu metodlar gösterilmektedir, Örnek 18. ibatis Veri Haritalayıcısı API sı Her bir durumda haritalanmış ifadenin ismi ilk parametre olarak geçilmektedir. Bu isim yukarıda açıklanan <statement> elemanın isim niteliğini karşılamaktadır insert(), update(), delete(): Bu metodlar sorgu olmayan ifadeler olarak adlandırılmaktadırlar. Bu metodları kullanmak için executeupdate() metodu kullanılır. Ayrıca metodun işletilmesi sonucunda kaç satırın bu işlemden etkilendiği bilgisi de geri dönmektedir queryforobject(): executequeryforobject() metodunun iki tane versiyonu vardır. Bunlardan ilki kendine yeni bulmuş bir nesne için çalışırken diğeri ise kendine parametre olarak geçilen ve önceden yaratılmış bir nesne üzerinde işlem yapar. Bu yaklaşım birden çok ifade tarafından yerleştirilen nesneler için kullanılması yararlı bir metodtur. 19

20 queryforlist(): queryforlist() metodunun üç tane versiyonu vardır.ilki sorguyu işletir ve bu sorgu için belirlenen tüm sonuçları dönderir. İkincisi belli bir sayısa sonucu atlayabilir(başta itibaren) ve dönecek maksimum sonuç sayısını belirleyebilir. Bu yöntem çok geniş veri kümeleri üzerinde çalışıldığında faydalı olur. İstemediğiniz fakat bütünlük açısından birlikte dönen sonuçları atlamanızı sağlar. Üçüncüsü ise parametre olarak bir RowHandler alan yöntemdir. Bu yöntem sayesinde dönen sonuç kümesini satır satır yönetebilirsiniz.satır düzenleyici, RowHandler arayüzünü gerçekleştiren bir sınıftır. RowHandler arayüzünün ise sadece tek bir metodu vardır.aşağıda görüldüğü gibi, queryformap(): Bu metod bir grup sonucu bir listeye yükelemek için bir alternatif sunmaktadır. Bu konudaki geniş açıklama örneklerle birlikte verilecektir Örnekler Örnek 19. insert, update, delete sorgularının işletilmesi Örnek 20. Nesn için sorgunun işletilmesi (select) Örnek 21. Daha önceden ayrılmış sonuç nesnesiyle bir nesne için sorgunun işletilmesi Örnek 22. List (select) için sorgunun işletilmesi 20

21 Örnek 23. Auto-commit Örnek 24. Result Boundaries ile List (select) için sorgunun işletilmesi Örnek 25. RowHandler (select) ile sorgunun işletilmesi Örnek 26. Harita için sorgunun işletilmesi 21

22 5. Örnek Uygulama Bu uygulamada kullanıcıya contactid sini soran bir jsp yaratacağız. Onaylama işinden sonra Contact adlı tabloda bu contactid ile ilgili bir contact var mı diye bakacağız. Arama sonucu başka bir jsp sayfasında görüntülenecetir. 1. Öncelikle ibatis-sqlmap-2.jar ve ibatis-common-2.jar kütüklerini web-inf/lib dizini altına kopyalayın. 2. Java Source dizini altında bir tane SqlMapConfig.xml kütüğü yaratın. Örnek, <sqlmapconfig> <settings usestatementnamespaces="false" /> <transactionmanager type="jdbc"> <datasource type="simple" > <property name="jdbc.driver" value="com.ibm.db2.jdbc.app.db2driver"/> <property name="jdbc.connectionurl" value="jdbc:db2:sample"/> <property name="jdbc.username" value="db2admin"/> <property name="jdbc.password" value="admin2db"/> </datasource> </transactionmanager> <sqlmap resource="contact.xml"/> </sqlmapconfig> 3. Contact.java adıyla bir JavaBean sınıfı yaratın. Bu sınıf firstname, lastname, v e contactid özelliklerini ve getter-setter metodlarını içersin. Bu sınıf ResultSet ten değerleri okumak ve sorgu parametrelerini geçmek için kullanılacaktır. public class Contact implements Serializable{ private String firstname; private String lastname; private int contactid; //Getter setter methods for firstname, //lastname and contactid property } 22

Daha göster