20.9 Java und SQL-Datentypen

Jeder Datentyp in SQL hat einen mehr oder weniger passenden Datentyp in Java. Die Klasse java.sql.Types identifiziert alle SQL-Typen. So konvertiert der JDBC-Treiber bei jeder getXXX()-Methode diese zu einem Datentyp, aber auch nur dann, wenn diese Konvertierung möglich ist. So lässt er es nicht zu, bei einem kommenden String eine getInteger()-Methode auszuführen. Umgekehrt lassen sich alle Datentypen als String auslesen. Die folgende Tabelle zeigt die Übereinstimmungen. Einige SQL-Datentypen können durch mehrere Zugriffsmethoden geholt werden: Ein INTEGER lässt sich mit getInt() oder getBigDecimal() holen und TIMESTAMP mit getDate(), getTime() oder getTimestamp().

Tabelle 20.4 Datentypen in SQL und ihre Entsprechung in Java

In der Regel passen die Typen recht gut in das Java-System. So liefert getInt() ein int und getString() ein String-Objekt. Für einige Daten wurden jedoch spezielle Klassen entworfen; am auffälligsten ist die Klasse java.sql.Date, auf die wir gleich noch zu sprechen kommen.

ResultSet result = stmt.executeQuery( "SELECT Name, GebTag FROM Personen" );
result.next();
String   name1 = result.getString( "Name" );
Date  whatDay1 = result.getDate( "GebTag" );

20.9.1 Die getXXX()-Methoden

Die nun folgenden Funktionen sind die getXXX()-Methoden der Klasse ResultSet. Sie existieren in zwei Ausführungen: Bei der ersten Variante ist eine Ganzzahl als Parameter aufgeführt. Dieser gibt die Spalte der Operation an. Sie beginnt immer bei 1. Die zweite Variante erlaubt es, den Namen der Spalte anzugeben. Alle Methoden können eine SQLException in dem Fall auslösen, dass etwas mit der Datenbank nicht stimmt. Der throws-Ausdruck ist also nicht mehr explizit angegeben. Ist ein Eintrag in der Datenbank mit NULL belegt, so liefert die Methode null zurück.

interface java.sql.ResultSet

String getString( int Spalte | String ) Liefert den Wert in der Spalte als Java String.

boolean getBoolean( int | String ) Liefert den Wert in der Spalte als Java boolean.

byte getByte( int | String ) Liefert den Wert in der Spalte als Java byte.

short getShort( int | String ) Liefert den Wert in der Spalte als Java short.

int getInt( int | String ) Liefert den Wert in der Spalte als Java int.

long getLong( int | String ) Liefert den Wert in der Spalte als Java long.

float getFloat( int | String ) Liefert den Wert in der Spalte als Java float.

double getDouble( int | String ) Liefert den Wert in der Spalte als Java double.

BigDecimal getBigDecimal( int | String, int scale) Liefert den Wert in der Spalte als java.lang.BigDecimal-Objekt.

byte[] getBytes( int | String ) Liefert den Wert in der Spalte als Bytefeld. Es besteht aus uninterpretierten Rohdaten.

Date getDate( int | String ) Liefert den Wert in der Spalte als java.sql.Date-Objekt.

Time getTime( int | String ) Liefert den Wert in der Spalte als java.sql.Time-Objekt.

Timestamp getTimestamp( int | String ) Liefert den Wert in der Spalte als java.sql.Timestamp-Objekt.

InputStream getAsciiStream( int | String ) Die Methode gibt über einen InputStream Zugriff auf den Inhalt der Spalte. Nützlich ist dies für den Datentyp LONGVARCHAR. Der JDBC-Treiber konvertiert die Daten mitunter in das ASCII-Format.

InputStream getBinaryStream( int | String ) Die Methode erlaubt es, auf den Inhalt der Spalte als InputStream zuzugreifen. Nützlich ist dies für den Datentyp LONGVARBINARY. Der JDBC-Treiber konvertiert die Daten mitunter in das ASCII-Format. Bevor aus einer anderen Spalte Daten ausgelesen werden, müssen die Daten vom Stream gelesen werden. Ein weiterer Aufruf schließt selbstständig den Datenstrom. Die Methode available() liefert die Rückgabe null, falls keine Daten anliegen.

Die Verwandtschaft von java.sql.Date und java.util.Date

Ein Datenbankprogramm, das die Klasse java.sql.Date nutzt und ebenfalls java.util eingebunden hat, wird bei der Compilierung zu einem Fehler führen, da der Compiler den Bezug auf die Klasse Date nicht zuordnen kann. Denkbar sind zwei Lösungen. Wird util nur deswegen eingebunden, weil Datenstrukturen, aber nicht die Date-Klasse genutzt werden, dann ließe sich die import-Anweisung umbauen, so dass die von util genutzten Klassen direkt in import genannt werden, etwa import java.util.ArrayList. Bei vielen benutzten Klassen aus dem util-Paket ist aber eine andere Lösung einfacher. Wir setzen vor die Klasse, die uns Ärger bereitet, einfach die volle Qualifizierung, schreiben also zum Beispiel:

java.sql.Date date = rs.getDate( "Geburtsdatum" );

Ein weiteres Problem betrifft die Konvertierung der beiden Klassen. Wollen wir beispielsweise eine Zeichenkette aus der Eingabe in eine Datenbank schreiben, dann haben wir das Problem, dass die Konvertierung mittels DateFormat nur ein java.util.Date liefert. Das Einzige, was uns bleibt, ist, von der Klasse Date aus dem util-Paket mittels getTime() die Millisekunden seit dem 1. Januar 1970, 00:00:00 GMT zu holen (natürlich mit der Einschränkung, dass wir zeitlich nicht vor 1970 liegen).

java.sql.Date sqlDate = new java.sql.Date( utilDate.getTime() );

Der Konstruktor von java.sql.Date() mit den Millisekunden ist auch der einzige Konstruktor, der nicht veraltet ist. Daneben hat die Klasse java.sql.Date aber noch drei andere Methoden:

class java.sql.Date
extends java.util.Date

static Date valueOf( String s ) Wandelt einen String im JDBC (also yyyy-mm-dd) in ein Date-Objekt um.

String toString() Liefert das Datum im JDBC-Datenformat.

void setTime( long date ) Setzt das Datum mit den Millisekunden.

Date, Time und Timestamp

Datums-Angaben einer Datenbank werden durch Date, Time und Timestamp repräsentiert. java.sql.Date liefert eine Genauigkeit auf Millisekunden wie auch java.util.Date. Time leitet von java.util.Date ab - nicht von java.sql.Date, was intuitiv wäre - und implementiert Formatierungs- und Parsing-Funktionalität. Timestamp (auch eine Unterklasse von java.util.Date) liefert genauere Angaben als java.sql.Date, nämlich noch die Nanosekunden dazu.