Merhaba arkadaşlar, bu yazıda sizlerle birlikte Hibernate işlemini bir kısmını elle konfigure etmeyi göstereceğim. Bildiğiniz üzere Hibernate için Microsoft tarafında ADO.NET Entity Framework adında bir altyapı sunuldu. Mantık olarak derleyici tarafında yazılmış olan sınıfları veritabanı tabloları ve kayıtları olarak işlemeyi sağlar. Hibernate teknolojiside bu yapının atasıdır. 

Bu yazıda Microsoft'un veritabanı yönetim sistemi olan SQL Server 2005 üzerine Java tarafından model oluşturup. Bunu Hibernate API'leriyle kullanmayı göstereceğim. Aslında, bakıldığında ADO.NET Entity Framework ile birebir sorunsuz çalışan bir veritabanı için ters platform entegrasyonu yapacağız. Yani, hem Java hem de Hibernate API kulağa biraz ilginç geliyor olsa gerek. Ama bunu yapmak imkansız değil. Niye bunu yapıyoruz diyecek olursanız, ki diyeceksinizdir. Hibernate'in mantığını ve low-level seviyede bir çözümü göstermek için bu yazıyı hazırlamaya karar verdim.

Data Model ?

MVC tasarım deseni bir çok kişi tarafından duyulmuştur. Açılımı incelendiğinde Model-View-Controller şeklindedir. İşte Hibernate ile hazırlayacağımız Model bu üçlünün Veri Modeli kısmını ifade eder. Ara katman yazılımı gerçekleştirme anlamına gelir. 

Öncelikle Yapılması Gerekenler ...

Bu yazıyı hazırlarken, testlerini yapmış olduğum örnek projede bir kaç önemli hata ile karşılaştım. Bu hataları ve projeye eklenmesi gereken kütüphaneleri aşağıda sırayla açıkladım. Adım adım uygulamanız halinde hiçbir sorun yaşanmayacaktır.  

1-) Eclipse IDE'de yeni bir Java projesi yaratılır ve JTDS aşağıdaki maddede anlatıldığı gibi indirilir ve projeye eklenir. 

2-) Öncelikle SQL Server ile Java arasında veritabanı iletişimini sağlayacak olan kütüphane JTDS'dir. JTDS kütüphanesi aşağıdaki linkten indirilir ve uygun bir dizine çıkarılır.  http://sourceforge.net/projects/jtds/files/

3-) Eclipse'de açılmış olan Java projesine Hibernate ilgili olan aşağıdaki maddede açıklanmış olan JAR dosyaları indirilir ve projeye eklenir. 

4-) Ardından, Hibernate için gerekli olan JAR dosyaları indirilir. Aşağıdaki linkte verilmiştir. "lib" klasörü içindeki bütün JAR dosyasını projeye ekleme yaptım. Bir önceki makalemde hangilerinin eklenmesi gerektiği listelenmiştir.  Makale linki : http://batuhanduzgun.net/post/2012/06/06/Java-ile-JPA-Hibernate.aspx

Download linki : http://sourceforge.net/projects/hibernate/files/hibernate4/  (Son sürüm indirilmesi tavsiye edilir.)

5-) SQL Server 2005 ile ilgili bir kaç ayar yapılması gerekir, yoksa bağlantı "Refuse" hatası alınabilir. Bu adımda SQL Server 2005 yazılımın portunu 1433 portuna göre ayarlanacaktır. Bunun için "Configuration Manager" yazılımı çalıştırılır. Aşağıda örneği verilmiştir. Benim SQL Server 2005 yazılımımda BATUHAN ve SQLEXPRESS adında iki instance bulunuyor. Ben BATUHAN adlı instance üzerinde ayarlama yapacağım. 

İnstance'a çift tıklanır. Ardından aşağıdaki gibi TCP/IP seçeneğine sağ tıklayıp"Properties" seçilir. Port bilgisine 1433 değeri girilir.

6-) Bu adımda önemlidir. JTDS içinde "x86//SSO" dizininde yer alan "ntlmauth.dll" dosyası, kopyalanıp, "Java//jre6//bin"  dizinine yapıştırılır. Böylece, Hibernateçalıştırıldığında Java'nın JRE dizinindeki "bin" klasöründe bu DLL aranacaktır.

Projeye ait kodlamanın yapılması ...

Projede çok uzun bir kodlama yerine mantığı anlatan basit bir POJO sınıfı tasarlandı.  "sampleTable" adında bir POJO sınıf aşağıdaki gibi kodlanmıştır. Gerekli açıklamalar kod üzerinde mevcuttur.

package mssql.main;

//Hibernate için kullanacak paketlerdir.

import javax.persistence.*;

import javax.persistence.Entity;

import javax.persistence.Table;

import org.hibernate.annotations.*;

//Tablo olarak kaydedilecek sınıf başına Entity eki konur.

//Tablo ismi için Table eki içinde name alanına ilgili değer girilir.

@Entity

@Table(name="sampleTable")

public class sampleTable {

    // Tabloya ait Id alanını belirtir.

    @Id

    // Bu değişkenin bir sütun olarak algılanmasını sağlar.

    @Column(name="ID")

    private int id;

    // userName adında bir sütun açar ve türü karakter katarıdır.

    @Column(name="userName", length=80)

    private String userName;

    // userPassword adında bir sütun açar ve türü karakter katarıdır.

    @Column(name="userPassword", length=80)

    private String userPassword;

    // eMail adında bir sütun açar ve türü karakter katarıdır.

    @Column(name="eMail", length=80)

    private String eMail;

    // userAge adında bir sütun açar ve türü tam sayıdır.

    @Column(name="userAge")

    private int userAge;

    // İlgili sütunlara verilerin girilmesini sağlayan metodlardır.

    public void setId(int id) {

          this.id = id;

    }

    public void setUserName(String username) {

          this.userName = username;

    }

    public void setUserPassword(String userpassword) {

          this.userPassword = userpassword;

    }

    public void setUserEmail(String email) {

          this.eMail = email;

    }

    public void setUserAge(int userAge) {

          this.userAge = userAge;

    }

}

Ardından Model ile işlemleri yürütecek olan Session nesnesi yaratılır. Bunun aşağıdaki sınıf yapısı kodlanmıştır.

package mssql.main;

import org.hibernate.Session;

import org.hibernate.SessionFactory;

import org.hibernate.cfg.Configuration;

public class SessionFactoryBuilder {

       private SessionFactory sessionBuilder = null;

       public SessionFactoryBuilder() {

             if(sessionBuilder == null) {

                    sessionBuilder = new Configuration().configure("mssqlConfig.xml").buildSessionFactory();

             }

       }

       public Session getInstance() {

             return sessionBuilder.getCurrentSession();

       }

       public void openSession() {

             sessionBuilder.openSession();

       }

       public void closeSession() {

             if(sessionBuilder != null) {

                    sessionBuilder.close();

             }

       }

}

Son olarak "main"  metodun bulunduğu sınıfa ait kodlar aşağıdaki gibidir.

package mssql.main;

import org.hibernate.Session;

public class mssqlHibernate {

       /**

        * Batuhan Düzgün

        */

       static SessionFactoryBuilder sessionBuilder;

    public static void main(String[] args) {

          // Varolan Session nesnesini alır.

          sessionBuilder = new SessionFactoryBuilder();

          Session currentSession = sessionBuilder.getInstance();

          // Transaction begin ile veritabanı ile etkileşime geçilir.

          currentSession.getTransaction().begin();

          // sampleTable adındaki POJO sınıfından bir nesne yaratılır.

          sampleTable sam = new sampleTable();

          // Alt alanları yani sütun bilgileri set edilir.

          sam.setId(12);

          sam.setUserAge(24);

          sam.setUserEmail("batux");

          sam.setUserName("batuhan");

          sam.setUserPassword("batux45");

          // Veritabanına kayıt ekleme işlemi yapılır.

          currentSession.persist(sam);

          currentSession.getTransaction().commit();

    }

}

POJO sınıflar yazıldı. Fakat, birde XML ile bunları veritabanına eşleme işlemi kaldı. Bunuda bir XML dosya ile yapılabilir. Projeye bir XML dosyası eklenir ve aşağıdaki gibi hazırlanır.

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE hibernate-configuration PUBLIC

             "-//Hibernate/Hibernate Configuration DTD 3.0//EN"

             "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>

    <session-factory>

        <property name="hibernate.connection.driver_class">net.sourceforge.jtds.jdbc.Driver</property>

        <property name="hibernate.connection.password"></property>

        <property name="hibernate.connection.url">jdbc:jtds:sqlserver://127.0.0.1:1433/OgrenciBilgiSistemi;instance=BATUHAN;</property>

        <property name="hibernate.dialect">org.hibernate.dialect.SQLServer2005Dialect</property>

        <property name="hibernate.connection.username"></property>

        <property name="current_session_context_class">thread</property>

        <property name="hibernate.hbm2ddl.auto">update</property>

        <property name="hibernate.show_sql">true</property>

        <property name="hibernate.format_sql">true</property>

        <mapping class="mssql.main.sampleTable" />

    </session-factory>

</hibernate-configuration>

Yukarıdaki XML dosyada "driver_class" etiketine ait bilgi hangi veritabanı bağlantı JAR kütüphanesinin kullanılacağını belirtir.  Bu driver paket yolu ve ismi farklı veritabanlarına göre değişir.Mesela MySQL için  "com.mysql.jdbc.Driver" şeklindedir. Daha sonra  "connection.url" bilgisi önemlidir. Bu bilgide veritabanı çeşidine göre farklılık gösterebilir. Benim hazırladığım cümle SQL Server 2005 için Windows Authentication şeklindedir. MySQL için bağlantı cümlesi "jdbc:mysql://localhost:3306/sampledb" şeklinde olabilir.

Bir diğer önemli alan ise "dialect" alanıdır. Bu alan veritabanı çeşidine göre farklılık gösterir. Uygun olanı netten veya dökümandan bulup kullanabilirsiniz.

Mapping etiketi ile hangi POJO sınıfın veritabanı tarafına yansıtılacağı belirtilir.

Projeyi run edip çalıştırdıktan sonra sonuç aşağıdaki gibi olacaktır.

Veritabanında bulunan kayıt main içinde yarattığımız POJO nesnesinin ta kendisidir. Umarım yararlı bir yazı olmuştur. Bir sonraki makalemde görüşmek dileğiyle ...

Batuhan Düzgün

Bilgisayar Mühendisi

Endüstri Mühendisi