20.8 Datenbankabfragen

Mit einer gelungenen Verbindung lassen sich nun SQL-Kommandos absetzen, und die Datenbank kann gesteuert werden.

20.8.1 Abfragen über das Statement-Objekt

Für SELECT-Abfragen ist ein Statement-Objekt anzulegen. JDBC bietet dazu die Methode createStatement() an, die eine SQLException auslösen kann. Dies ist eine Methode des Connection-Objekts.

Statement stmt = con.createStatement();

interface java.sql.Connection

Statement createStatement() throws SQLException Liefert ein Statement-Objekt, um SQL-Anweisungen zur Datenbank zu schicken.

SQL-Anweisungen ohne Parameter werden normalerweise über das Statement-Objekt ausgeführt. Wird das gleiche SQL-Statement mehrmals ausgeführt, lohnt es sich, ein PreparedStatement zu konstruieren.

SQL-Anweisungen ausführen

Um Informationen auszulesen, benutzen wir die SELECT-Befehle aus SQL und geben sie durch die executeQuery()-Methode der Statement-Schnittstelle an. Der Aufruf liefert uns die Ergebnisse als Zeilen in Form eines ResultSet-Objekts. Wir benutzen executeQuery() für Abfragen und executeUpdate() bei Update-, Insert- oder Delete-Operationen. Wieder dürfen wir das Auffangen von SQLException nicht vergessen.

String query = "SELECT * FROM Tabellenname";
ResultSet rs = stmt.executeQuery( query );

An dieser Stelle sei noch einmal darauf hingewiesen, dass JDBC nicht in die Zeichenketten hineinsieht, die es an den Treiber weiterleitet. Sind die SQL-Anfragen also falsch, lassen sich Fehler schwer finden. So kann zum Beispiel schon die falsche Groß- beziehungsweise Kleinschreibung zu Fehlern in der Datenbank führen. Solche Fehler sind natürlich schwer zu entdecken. Daher bietet es sich an, zum Testen erst die Kommandos auf der Konsole auszugeben. Insbesondere bei zusammengesetzten Ausdrücken finden sich dann schon die Fehler.

interface java.sql.Statement

ResultSet executeQuery( String sql ) throws SQLException Führt ein SQL-Statement aus, das ein einzelnes ResultSet-Objekt zurückgibt.

20.8.2 Ergebnisse einer Abfrage in ResultSet

Das Ergebnis einer Abfrage durch executeQuery() wird in einer Ergebnistabelle vom Typ ResultSet zurückgegeben. Mit Methoden von ResultSet lassen sich die unterschiedlichen Spalten ansprechen und die Zeilen auswerten.

SELECT Pflanzenname, Preis FROM Pflanzen

System.out.println( rSet.getString(1) + "\n" + rSet.getString(2) );

Ist die Abfrage über alle Elemente einer Zeile formuliert, zum Beispiel

SELECT * FROM Pflanzen

so muss erst über Connection.getMetaData() die Struktur der Tabelle ermittelt werden. Erst dann können wir mit den angemessenen Methoden auslesen. Dazu später mehr.

Um das ResultSet auszuwerten, müssen wir zunächst in die erste Zeile springen. Dies geschieht mit der next()-Methode von ResultSet. Danach sind wir mit getXXX() in der Lage, die Spalten dieser Zeile auszuwerten. Um weitere Zeilen zu erhalten, nutzen wir wieder next(). Die Methode gibt false zurück, falls es keine neue Zeile mehr gibt. Die Abfragen befinden sich somit oft in einer while-Schleife.

while ( rSet.next() )
  System.out.print( rSet.getString(1) + "\n" + rSet.getString(2) );

interface java.sql.ResultSet

String getString( int column ) throws SQLException Liefert aus der aktuellen Zeile den Inhalt der Spalte column als String. Die erste Spalte ist mit 1 adressiert. Ist in der Tabelle der SQL-Eintrag NULL, so ist das Ergebnis der Methode auch null.

String getString( String columnName ) throws SQLException Liefert in der aktuellen Zeile den Inhalt der Spalte mit dem Namen columnName als String.

boolean next() throws SQLException Der erste Aufruf muss next() sein, damit der Cursor auf die erste Zeile gesetzt wird. Die folgenden Aufrufe setzen den Cursor immer eine Zeile tiefer. Ist der Eingabestrom der vorangehenden Zeile noch geöffnet, wird dieser automatisch geschlossen.

20.8.3 Unicode in der Spalte korrekt auslesen

Der Aufruf von getString() führt bei Unicode-kodierten Zeichenfolgen in der Datenbank unter Umständen zu Problemen. Bemerkbar macht sich dies durch seltsame Zeichen wie ? oder Hexadezimal 0x3f, die an Stelle der Sonderzeichen im String auftauchen. Das liegt oft daran, dass der JDBC-Treiber die Kodierung nicht kennt und einfach jedes ASCII-Byte in ein Char umwandelt, obwohl in der Datenbank Umlaute als 2-Byte Unicode oder Latin-1 kodiert werden.

Bei eigenen Datenbanken funktioniert es, die Kodierung beim Verbindungsaufbau ausdrücklich zu setzen, um damit eine Konvertierung vorzuschreiben. getString() sollte dann die richtige Zeichenkette liefern. Bei anderen Datenbanken funktioniert es wiederum, den Text als Bytefeld zu holen und dann ausdrücklich umzukodieren. Das Folgende ist etwa eine Lösung für PostgreSQL.

new String( read_rs.getBytes(1),"ISO-8859-1" )

20.8.4 wasNull() bei ResultSet

Ist der Wert einer Spalte Null, dann kann eine Anfrage mit der getXXX()-Methode keinen Wert liefern. Dennoch wird ein Aufruf mit getXXX() eingesetzt, denn die Behandlung von Nullwerten ist in JDBC recht ungewöhnlich gelöst. Wir würden erwarten, dass es eine Funktion isNull(Spalte) auf einem ResultSet-Objekt gibt, die uns ja oder nein liefert hinsichtlich der Frage, ob ein Spalteninhalt unbelegt ist. Dass die Methode wasNull() heißt, ist vielleicht noch zu verkraften, aber dass sie parameterlos ist, erstaunt. Der allgemeine Vorgang bei der Null-Abfrage einer Spalte ist:

rs.getXXX( Spalte )
is ( rs.wasNull() )
  out( "Null" );

20.8.5 Wie viele Zeilen hat ein ResultSet?

Um herauszufinden, wie viele Zeilen ein ResultSet liefern kann, lassen sich trickreiche JDBC2-Eigenschaften nutzen. Soll in der Variablen row die Anzahl Zeilen stehen, schreiben wir:

rs.last();
int rows = rs.getRow();
rs.beforeFirst();

Bei dieser Programmierung muss natürlich ein Treiber JDBC2-fähig sein und scrollbare Cursor unterstützen, das heißt Cursor, die auch rückwärts laufen können. Gleichzeitig muss dann aber auch beim Statement ein scrollbarer Cursor angemeldet werden. Dazu dient die Zeile:

stmt = con.createStatement( ResultSet.TYPE_SCROLL_INSENSITIVE,
                            ResultSet.CONCUR_UPDATABLE );

Unterstützt ein Treiber kein JDBC2, kann immer noch über eine Zeile wie SELECT COUNT(*) erfragt werden, wie viele Ergebnisse die Datenbank produziert.