Java Tutorial: Hibernate, MySQL, XML

Hibernate Struktur Mit Hibernate ist es möglich, Objekte direkt in der Datenbank abzulegen. Dieses Beispiel soll einfach mal ein funktionierendes Beispiel beschreiben ohne dabei zu sehr in die Tiefe zu gehen. Für die Tiefe gibt es später eine Reihe weiterer guter Webseiten und Bücher.

Systemvoraussetzungen: MySQL Datenbank, Java 5 oder höher, Entwicklungsumgebung mit XML und Java Support, JDBC MySQL Treiber, Hibernate Core, Hibernate Annotations sollte man alles bei der Suchmaschine seines Vertrauens finden können.

Bei den Bezeichnungen der einzelnen Dateien orientiere ich mich an der obigen Grafik. Um uns späteren Ärgern zu ersparen sollte man zuerst die ganzen JARs in sein Projekt einbinden. Normalerweise sollte man immer so wenig einbinden aber da uns die Performance im Moment egal ist und wir erstmal nur sehen wollen wie es funktioniert, binden wir wahllos alles ein.

Als nächstes brauchen wir ein Objekt, den Tisch.

// File: Tisch.java

package obj;

import java.io.Serializable;
import java.text.MessageFormat;

public class Tisch implements Serializable{

	private static final long serialVersionUID = 1L;

	private Integer id;
	private Integer Fuesse;
	private String Material;
	private Tisch tisch;
	
	public Tisch(){}
	
	private Integer getId() {return id;}

	private void setId(Integer id) {this.id = id;}

	public Integer getFuesse() {return Fuesse;}

	public void setFuesse(Integer fuesse) {Fuesse = fuesse;}

	public String getMaterial() {return Material;}

	public void setMaterial(String material) {this.Material = material;}

	private Tisch getTisch() {return tisch;}

	private void setTisch(Tisch tisch) {this.tisch = tisch;}
	
	public String toString() {
		return MessageFormat.format("{0}: Fuesse={1}, Material={2}", new Object[] {
				getClass().getSimpleName(), Fuesse, Material });
	}
}

Aus Gründen der Übersichtlichkeit habe ich den Code hier etwas zusammengefasst. Anschließend müssen wir mittels XML sagen wie der Tisch in unserer Datenbank gemapped werden soll.

<!-- File: Tisch.hbm.xml -->

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd" >
<hibernate-mapping package="obj">
  <class name="Tisch" table="tische" >
    <id name="id" >
	     <generator class="native" />
    </id>
    <property name="fuesse" type="integer"></property>
    <property name="material" type="string"></property>
  </class>
</hibernate-mapping>

Damit später nur eine Verbindung zur Datenbank vorhanden ist muss man die Session als Singleton implementieren.

// File: SingSessionFactory.java

package hibe;

import org.hibernate.SessionFactory;
import org.hibernate.cfg.Configuration;

public class SingSessionFactory {

	private static org.hibernate.SessionFactory sessionFactory;
	
	private SingSessionFactory() {}
	static {

		final Configuration cfg = new Configuration();
		cfg.configure("/hibernate.cfg.xml");
		cfg.buildSessionFactory();
		sessionFactory = cfg.buildSessionFactory();
	}	
	
	public static SessionFactory getInstance() {
		return sessionFactory;
	}
}

Anschließend können wir unsere Main implementieren.

// File: HibeMySQL.java

package exa;

import hibe.SingSessionFactory;
import org.apache.log4j.Logger;
import org.hibernate.Session;
import org.hibernate.Transaction;

import obj.Tisch;

public class HibeMySQL {

	private static Logger log = Logger.getLogger(HibeMySQL.class);
	
	public static void main(String[] args) {
		Tisch wohnzimmer = new Tisch();
		wohnzimmer.setMaterial("Eiche");
		wohnzimmer.setFuesse(3);
		
		Session ses = SingSessionFactory.getInstance().getCurrentSession();
		Transaction tx = ses.beginTransaction();
		
		ses.save(wohnzimmer);
		
		tx.commit();
	}
}

Am Schluss brauchen wir noch zwei Konfigurationsdateien. Die erste für Hibernate und der MySQL Verbindung.

<!-- File: hibernate.cfg.xml -->

<?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>
    <!--  MySQL connection -->
      <property name="connection.url">jdbc:mysql://localhost:3306/bank</property>
      <property name="connection.username">root</property>
      <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
      <property name="dialect">org.hibernate.dialect.MySQLDialect</property>
      <property name="connection.password"></property>

    <property name="transaction.factory_class">org.hibernate.transaction.JDBCTransactionFactory</property>
    <property name="current_session_context_class">thread</property>
    <property name="transaction.auto_close_session">true</property>
    
    <!-- this will show us all sql statements -->
    <property name="show_sql">true</property>
    <!-- this will create the database tables for us -->
    <property name="hbm2ddl.auto">update</property>
    <mapping resource="obj/Tisch.hbm.xml" />
  </session-factory>
</hibernate-configuration>

Als letztens brauchen wir noch eine Konfiguration für Log4j damit wir eine schöne Ausgabe erhalten was die Datenbank so treibt.

# File: log4j.properties

### direct log messages to stdout ###
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.Target=System.out
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n

### direct messages to file hibernate.log ###
#log4j.appender.file=org.apache.log4j.FileAppender
#log4j.appender.file.File=hibernate.log
#log4j.appender.file.layout=org.apache.log4j.PatternLayout
#log4j.appender.file.layout.ConversionPattern=%d{ABSOLUTE} %5p %c{1}:%L - %m%n

### set log levels - for more verbose logging change 'info' to 'debug' ###

log4j.rootLogger=debug, stdout

log4j.logger.org.hibernate=info
#log4j.logger.org.hibernate=debug

### log HQL query parser activity
#log4j.logger.org.hibernate.hql.ast.AST=debug

### log just the SQL
log4j.logger.org.hibernate.SQL=debug

### log JDBC bind parameters ###
log4j.logger.org.hibernate.type=info
#log4j.logger.org.hibernate.type=debug

### log schema export/update ###
log4j.logger.org.hibernate.tool.hbm2ddl=info

### log HQL parse trees
#log4j.logger.org.hibernate.hql=debug

### log cache activity ###
log4j.logger.org.hibernate.cache=info

### log transaction activity
#log4j.logger.org.hibernate.transaction=debug

### log JDBC resource acquisition
#log4j.logger.org.hibernate.jdbc=debug

### enable the following line if you want to track down connection ###
### leakages when using DriverManagerConnectionProvider ###
#log4j.logger.org.hibernate.connection.DriverManagerConnectionProvider=trace

Die Konfigurationseinstellungen sind zum größten Teil aus anderen Beispielen entliehen. Es geht hier prinzipiell nur darum mal ein ein einfaches Beispiel zu zeigen.