21.13Vorbereitete Datenbankverbindungen 

Die Arbeit mit dem DriverManager sah bisher so aus, dass wir ihn mit der genauen Datenquelle parametrisiert haben. Wir mussten also immer den Namen der Datenbank sowie (optional) den Benutzernamen und das Passwort angeben. Diese feste Verdrahtung im Quellcode ist allerdings nicht so toll, weil Änderungen zwangsläufig zu einer neuen Übersetzung führen (was sich allerdings mit Konfigurationsdateien verändern ließe), doch die Daten stehen auf der Client-Seite, wo sie nicht immer gut aufgehoben sind. Besser ist eine zentrale Stelle für die Konfigurationsdaten und auch für die Datenbank. Nehmen wir an, ein Unternehmen rüstet spontan von Oracle auf DB2 um, so müsste ein Client-Programm an allen Stellen, an denen der Datenbanktreiber geladen und die URL für die Datenbank aufgebaut wird, im Quellcode geändert werden. Das ist unflexibel.

 

21.13.1DataSource 

So gibt es in Java eine weitere Möglichkeit, nämlich die Konfigurationsdaten an einer zentralen Stelle zu hinterlegen – und das heißt in Java Zugriff über JNDI. Im zentralen Namensdienst werden Informationen über den Treibernamen, Datenbanknamen usw. als DataSource abgelegt und dann zum nötigen Zeitpunkt erfragt. Wenn sich die Datenbank einmal ändern sollte, muss nur an dieser zentralen Stelle eine Änderung eingespielt werden, und alle, die anschließend den JNDI-Dienst erfragen, bekommen die neue Information.

Die DataSource-Trilogie

Die Verbindung zu einem Datengeber (es muss nicht unbedingt eine Datenbank sein) realisieren Objekte vom Typ DataSource-Objekt. Von der Schnittstelle DataSource gibt es drei unterschiedliche Ausführungen:

1. ein Standard-DataSource-Objekt – mindestens das muss ein JDBC-2.0-kompatibler Treiber anbieten.

2. ein DataSource-Objekt, das gepoolte Datenbankverbindungen zulässt (ConnectionPoolData-Source), sodass eine beendete Verbindung nicht wirklich beendet, sondern nur in einen Pool zur Wiederverwendung gelegt wird. Damit die Verbindung zurückgelegt werden kann, muss die Verbindung einfach nur geschlossen werden – ein Vorgang, der in jedem Programm mit Verbindungen zu finden sein sollte.

3. ein DataSource-Objekt für verteilte Transaktionen (XADataSource)

Das Schöne daran ist, dass der konkrete Typ verborgen bleiben kann und der Server ohne Änderung des Clients statt einer einfachen DataSource etwa eine ConnectionPoolDataSource in dem Namensdienst ablegen kann.

Verbindung über JNDI

Das DataSource-Objekt ist über JNDI zu erfragen. Mit getConnection(…) wird anschließend das Connection-Objekt besorgt, und wir sind an der gleichen Stelle, an die uns auch der DriverManager geführt hat:

Das javax.naming.Context-Objekt und dessen Methode lookup(…) erfragen das mit dem Namen assoziierte Objekt vom Verzeichnisdienst. Vorher muss natürlich irgendjemand dieses Objekt dort abgelegt – auf Neudeutsch »deployed« – haben, doch das sehen wir uns später an. Mit dem Verweis auf das DataSource-Objekt können wir getConnection(…) aufrufen und Benutzername und Passwort angeben.

• Connection getConnection(String username, String password)
  Versucht, unter Angabe des Benutzernamens und Passwortes eine Verbindung aufzubauen.

• Connection getConnection()
  Versucht, eine Verbindung ohne Angabe von Benutzernamen und Passwort aufzubauen.

Eine DataSource im JNDI-Kontext deployen *

Der Administrator ist nun dafür verantwortlich, dass das DataSource-Objekt, also die Beschreibung der Datenbankparameter, im Namensdienst eingetragen ist. Im Allgemeinen macht das der Container über eine XML-Beschreibungsdatei oder über ein GUI, sodass kein Programmieraufwand von Hand nötig ist. Wie die JNDI-DataSource in den Webcontainer Tomcat integriert werden kann, zeigt die Webseite http://tomcat.apache.org/tomcat-7.0-doc/jndi-resources-howto.html.

Zum Testen wollen wir den einfachen Namensdienst Simple-JNDI (http://code.google.com/p/osjava/wiki/SimpleJNDI) nutzen, der die Daten im Speicher hält und keinen Server startet. Aus dem ZIP-Archiv von der Webseite http://code.google.com/p/osjava/downloads/detail?name=simple-jndi-0.11.4.1.zip muss dazu das Archiv simple-jndi-0.11.4.1.jar zusätzlich zum Datenbanktreiber in den Klassenpfad aufgenommen werden. In den Klassenpfad setzen wir auch die Datei jndi.properties, die Java bei Bildung eines Exemplars von InitialContext automatisch lädt:

Listing 21.8src/jndi.properties

In das Projektverzeichnis legen wir unter einem neuen Verzeichnis config die Datei Tutego-DS.properties. Damit kann Simple-JNDI die Datenquelle automatisch initialisieren:

Listing 21.9config/TutegoDS.properties

Wir könnten den Namensdienst zwar dank der Implementierung der JNDI-API auch selbst konfigurieren, aber eine passende Datei macht das automatisch. Aufgrund des Dateinamens legt Simple-JNDI automatisch für uns eine Datenquelle »TutegoDS« im Namenskontext an. Der Zugriff gestaltet sich einfach:

Listing 21.10com/tutego/insel/jdbc/JdbcWithDS.java, main()

An diesem Beispiel ist gut abzulesen, dass die Konfiguration nun extern ist. Der Datenbanktreiber muss nun nicht mehr von uns geladen werden, und die Verbindungsdaten sind auch nicht mehr sichtbar.

 

21.13.2Gepoolte Datenbankverbindungen 

Da der Auf- und Abbau von Datenbankverbindungen relativ teuer ist, soll eine Java-Applikation die Verbindung nur vordergründig schließen, ein spezieller poolingfähiger Datenbanktreiber soll die Verbindung allerdings für die nächste Operation offen halten. Für gepoolte Datenbankverbindungen gibt es eine Reihe quelloffener Implementierungen; zu ihnen zählen Apache Commons DBCP (http://commons.apache.org/dbcp/), c3p0 (http://sourceforge.net/projects/c3p0/) und Proxool (http://proxool.sourceforge.net/).

In der Regel sind für den Programmierer gepoolte Datenbankverbindungen transparent, denn ein poolender Treiber verhält sich wie ein ganz normaler JDBC-Treiber. Jeder Java EE-Container nutzt standardmäßig gepoolte Verbindungen, sodass sich Enterprise-Entwickler damit nicht beschäftigen müssen – nur Administratoren müssen spezielle Eigenschaften wie die maximale Anzahl offener Verbindungen konfigurieren. In Client-Anwendungen ist die Nutzung anders, auch der Bezug einer Verbindung. Bei Proxool wird zum Beispiel statt der JDBC-Treiberklasse die Proxool-Treiberklasse genannt, und die der Verbindungs-URL kodiert dann die eigentliche JDBC-Treiberklasse; das sieht etwa so aus:

Anders ist das bei c3po, hier wird eine spezielle Klasse ComboPooledDataSource eingesetzt, die vom Typ DataSource ist.[ 151 ](Weitere Details unter http://www.mchange.com/projects/c3p0/index.html.)

Simple-JNDI unterstützt DBCP direkt, sodass wir es an dieser Stelle einsetzen wollen. Eine zusätzliche Zeile pool=true in der Konfigurationsdatei veranlasst Simple-JNDI dazu:

Listing 21.11TutegoDS.properties

Dazu müssen in den Klassenpfad das Hauptarchiv commons-dbcp-1.4.jar (Download unter http://commons.apache.org/proper/commons-dbcp/download_dbcp.cgi) und zusätzlich das Java-Archiv commons-pool-1.3.jar (von Apache Commons Pool, Download unter http://commons. apache.org/proper/commons-pool/download_pool.cgi) aufgenommen werden.