3.2. PreparedStatement

Ein PreparedStatement ...

• erbt vom Statement Interface
• enthält eine SQL-Anweisung, die bereits compiliert, d.h. an das DBMS geschickt und dort zur Ausführung vorbereitet ("prepared") wurde -> execute(), executeQuery() und executeUpdate() müssen ohne SQL-Statement als Parameter benutzt werden
• ist dadurch effizienter als ein gewöhnliches Statement (vor allem bei mehrmaliger Nutzung)
• kann IN-Parameter enthalten (mit "?" gekennzeichnet)

Benutzung von IN-Parametern:

• vor der Ausführung müssen Parameter mit setXXX() gesetzt werden (XXX muss auf den entsprechenden SQL-Typ gemappt werden können!)
• wenn setObject() benutzt wird, kann als dritter Parameter der gewüschte JDBC-Typ angegeben werden (z.B. wenn Typ zur Compilezeit unbekannt)
• mittels setNull() kann JDBC NULL gesetzt werden (JDBC-Typ muss trotzdem angegeben werden), NULL wird auch gesendet, wenn Java null bei setXXX() übergeben wird
• Parameter bleiben solange erhalten, bis clearParameters() aufgerufen wird
• wenn das DBMS Statements nach commit() offen lässt, kann dasselbe Statement mehrmals ausgeführt werden -> Performancegewinn

PreparedStatement prepStatement = connection.prepareStatement("UPDATE Tabelle SET m = ? WHERE x = ?"); prepStatement.setString(1, "47"); // erster Parameter (m) auf "47" gesetzt for (int i = 0; i < 42; i++) { prepStatement.setInt(2, i); // zweiter Parameter (x) auf i gesetzt int rowCount = prepStatement.executeUpdate(); }

Benutzung von Streams:

• für sehr lange Werte
• enthalten zusätzlich noch die Gesamtlänge des Streams (einige Datenbanken benötigen diese Angabe)
• 3 verschiedene Arten:
  • setBinaryStream() für reinen Bytestrom
  • setAsciiStream() für ASCII-Zeichenstrom (1 Byte)
  • setUnicodeStream() für Unicode-Zeichenstrom (2 Byte)

File file = new File("/tmp/data"); int fileLength = file.length(); InputStream fin = new FileInputStream(file); PreparedStatement prepStatement = connection.prepareStatement("UPDATE Tabelle SET stuff = ? WHERE index = 4"); prepStatement.setBinaryStream(1, fin, fileLength); prepStatement.executeUpdate();