Ziel: Verständnis für Konzepte von JDBC aufbauen

Transkript

1 11. JDBC Grundsätzliche Nutzung von JDBC Verbindungsaufbau Anfragen Analyse des erhaltenen Ergebnisses Veränderungen des Ergebnisses Ziel: Verständnis für Konzepte von JDBC aufbauen 253

2 Überblick: Datenbankanfragen mit JDBC Datenbankverbindung herstellen class DriverManager Connection con= DriverManager.getConnection(...); Statement stmt= con.createstatement(); Datenbankanfrage ResultSet rs = stmt.executequery(...); Ergebnisse verarbeiten rs.next(); int n = rs.getint("knr"); Verbindung zur DB schließen con.close(); 254

3 Verbindungsaufbau mit einer Datenbank Laden des Datenbanktreibers DriverManager.registerDriver( new oracle.jdbc.driver.oracledriver()); Aufbau einer Verbindung Connection con = DriverManager.getConnection ("jdbc:postgresql://rechner:5712/eshop", "user", "password"); JDBC-URL identifiziert Datenbank Aufbau: jdbc:subprotocol:subname Treibermanager übergibt JDBC-URL der Reihe nach an registrierte Treiber Driver.acceptsURL(String url) liefert true, falls der Treiber den String akzeptiert 255

4 Auslesen der Oracle-Verbindungsdaten Oracle versteckt irgendwo Verbindungsdaten in tnsnames.ora benötigt wird IP-Adresse, Port (default 1521), Name der DB- Instanz (z. B. in SID) + Nutzername und Passwort Daraus abgeleiteter Connection-String für HS-DB (SID: Ora11) Connection con = DriverManager.getConnection( "jdbc:oracle:thin:@srv20.edvsz.hs-osnabrueck.de" +":1521:Ora11", "username", "passwort"); Connection-String für DB auf lokalem Rechner (Oracle XE) Connection con = DriverManager. getconnection("jdbc:oracle:thin:@localhost:1521:xe", "username", "passwort"); 256

5 Connection Ergebnis von DriverManager.getConnection() ist eine Connection con (oder eine SQLException) Connection ist Verbindung zur Datenbank Connection ist teure Ressource: Aufbau der Verbindung kostet viel Zeit Anzahl gleichzeitiger Verbindungen häufig beschränkt Wichtigste Aufgaben: Erzeugen von Statement-Objekten Beschreibungen von Datenbank und DBMS erfragen Transaktionen handhaben 257

6 Statement Statement stmt = con.createstatement(); Wird immer aus bestehender Connection erzeugt Aufgabe: Ausführen einer SQL-Anweisung über die Connection Mehrere parallele Statements pro Connection möglich SELECT-Anweisung ausführen: ResultSet rs = stmt.executequery("select * FROM Kunde"); Daten ändern: int updates = stmt.executeupdate("delete FROM Kunde..."); 258

7 Analyse von ResultSet ResultSet rs = stmt.executequery("select * FROM Kunde"); Ergebnis einer Selektionsanweisung: Tabelle ResultSet enthält einen Datensatz-Zeiger (Cursor) zum Durchlauf der Tabelle Voreinstellung: sequenziell und lesend JDBC 2: nichtsequenzielle und aktualisierbare ResultSets Zeiger steht initial vor der ersten Tabellenzeile. rs.next() positioniert zur nächsten Zeile, liefert false, falls bereits auf letzter Zeile 259

8 Attributwerte auslesen (1/2) Spaltenwerte (Attribute) einer Zeile mit getxxx()- Methoden lesen Treiber konvertiert Daten, falls möglich Beispiel: Lesen einer ganzen Zahl in DB-Spalte kundennr: int n = rs.getint("kundennr"); Effizientere Methode, falls Spaltenindex bekannt: int n = rs.getint(4); Spaltenindex zum Spaltennamen finden int findcolumn(string columnname) Strategie: Spaltenindex einmalig ermitteln und merken, Werte danach immer über den Index abrufen 260

9 Attributwerte auslesen (2/2) Methode getobject() Liest jeden beliebigen SQL-Datentyp Liefert Ergebnis als entsprechenden Java-Typ Nullwerte Spalte kann leere Zellen enthalten (Nullwert, SQL- NULL) Bei leerer Zelle liefert getint() ebenfalls das Ergebnis 0. Unterscheidung zu echter 0 möglich durch wasnull() true, falls zuletzt mit getxxx() gelesene Zelle SQL-NULL enthielt false sonst 261

10 Daten ändern ResultSet executequery(string) führt SELECT- Anweisung aus int Statement.executeUpdate(String) führt INSERT-, UPDATE- oder DELETE-Anweisung aus Liefert Anzahl betroffener Zeilen (Update count) Auch für sonstige Befehle (CREATE...) geeignet boolean execute(string) führt beliebige SQL- Anweisung aus. Liefert true, falls Ergebnis ein ResultSet ist, dann mit getresultset() Ergebnis abrufbar Liefert false, falls Ergebnis ein Update count ist 262

11 ResultSet: positionieren und ändern Statement createstatement(int resultsettype, int resultsetconcurrency) Parameter (ResultSet-Konstanten) ermöglichen beliebiges Positionieren (Scrolling) und Ändern der Datensätze. TYPE_FORWARD_ONLY: sequentieller Durchlauf TYPE_SCROLL_INSENSITIVE: positionierbar, Änderungen an Datenbank werden nicht bemerkt. TYPE_SCROLL_SENSITIVE: positionierbar, Änderungen an Datenbank werden bemerkt. CONCUR_READ_ONLY: nur lesen CONCUR_UPDATABLE: Änderungen möglich 263

12 ResultSet: positionieren (1/3) void beforefirst() Positioniert vor den ersten Satz. boolean first() Positioniert auf den ersten Satz. boolean last() Positioniert auf den letzten Satz. void afterlast() Positioniert hinter den letzten Satz. 264

13 ResultSet: positionieren (2/3) boolean absolute(int pos) Positioniert relativ zum Anfang (pos positiv) oder relativ zum Ende (pos negativ). boolean relative(int rows) Positioniert relativ zum aktuellen Satz vorwärts (rows positiv) oder rückwärts (rows negativ). boolean next() Positioniert auf den nächsten Satz. boolean previous() Positioniert auf den vorigen Satz. 265

14 ResultSet: positionieren (3/3) int getrow() Liefert aktuelle Satznummer boolean isbeforefirst() Liefert true, falls vor dem ersten Satz. boolean isfirst() Liefert true, falls auf dem ersten Satz. boolean islast() Liefert true, falls auf dem letzten Satz. boolean isafterlast() Liefert true, falls hinter dem letzten Satz. 266

15 ResultSet: Datensatz ändern Methoden updatexxx() ändern Werte in aktueller Zeile. rs.absolute(5); rs.updatestring("name", "Heinz"); rs.updateint(2, 42); rs.updatenull(3); rs.updaterow(); void updaterow() Schreibt geänderte Zeile in die Datenbank (*) void cancelrowupdates() Macht Änderungen rückgängig nur vor updaterow(). void deleterow() Löscht aktuelle Zeile aus ResultSet (*) Ob Bearbeitung des ResultSet sich direkt auf die Datenbank auswirkt, hängt von Autocommit-Einstellung ab [später] 267

16 ResultSet: Datensatz einfügen Einfügezeile: im ResultSet, nicht in der Datenbank rs.movetoinsertrow(); rs.updatestring("name", "Callaghan"); rs.updateint(2, 42); rs.insertrow(); rs.movetocurrentrow(); void movetoinsertrow() Positioniert auf die Einfügezeile void insertrow() Schreibt Einfügezeile in ResultSet und Datenbank (abhängig von Autocommit-Einstellung) void movetocurrentrow() Positioniert von der Einfügezeile auf die aktuelle Zeile im ResultSet 268

17 PreparedStatement (1/2) PreparedStatement Objekt enthält vorübersetzte SQL-Befehle geeignet, wenn Statement mehr als einmal ausgeführt werden muss PreparedStatement kann Variablen enthalten, die jedesmal bei Ausführung definiert werden Ansatz: Erzeuge PreparedStatement, identifiziere Variablen mit? PreparedStatement pstmt = con.preparestatement ("UPDATE Kunde SET Status =? where Umsatz >?"); 269

18 PreparedStatement (2/2) 1. Variablen-Werte übergeben pstmt.setxxx(index,value); 2. Statement ausführen pstmt.executequery(); pstmt.executeupdate(); int goldenerkunde=42000; PreparedStatement pstmt = con.preparestatement ("UPDATE Kunde SET Status =? where Umsatz >?"); pstmt.setstring (1, "Gold"); pstmt.setint (2, goldenerkunde); pstmt.executeupdate(); 270

19 COMMIT Für Connection con ist automatisch ein Auto- COMMIT eingestellt, alle Aktionen direkt auf der Datenbank Mit con.setautocommit(boolean) einstellbar Starteinstellung über con.getautocommit() ermitteln (bei Oracle default: true!) con.commit() zum erfolgreichen Abschließen con.rollback() zum Verwerfen der Änderungen seit dem letzten Commit 271

20 Verbindungsaufbau (Ausschnitt) import oracle.jdbc.*; // besser ausschreiben import java.sql.*;... try { // Oracle JDBC-Treiber laden DriverManager. registerdriver(new oracle.jdbc.driver.oracledriver()); Connection con = DriverManager. getconnection("jdbc:oracle:thin:@srv20.edvsz" +".hs-osnabrueck.de:1521:ora11", "kleuker", "passwort"); // Oracle DatabaseMetaData fuer Meta-Informationen DatabaseMetaData meta = con.getmetadata(); // Beispielmetainformation: Treiberversion System.out.println("JDBC driver version is "+ meta.getdriverversion()+"\n"); befehl=con.createstatement(); //private Statement befehl } catch (SQLException e) {... } 272

21 Einfache Verbindungsnutzung (Ausschnitt) ResultSet result; ResultSetMetaData metaresult; try { result=befehl.executequery("select * FROM City"); metaresult=result.getmetadata(); int spalten = metaresult.getcolumncount(); while(result.next()){ for(int i=1; i<=spalten;i++) ausgabe.append(result.getstring(i)+" "); ausgabe.append("\n"); } ausgabe.append("bearbeitung abgeschlossen\n"); result.close(); } catch (SQLException es) { while (es!=null){ //evtl. mehr als eine Exception fehler.append("fehlercode: "+es.geterrorcode()+"\n"); fehler.append("sql State: "+es.getsqlstate()+"\n"); fehler.append(es+"\n"); es= es.getnextexception(); } } 273

22 Einbindung von Oracle-JDBC in Eclipse Rechtsklick auf Projekt, dann Properies wählen, Java Build Path, dann Reiter Libraries, dann Add External JARs... Quellen: Oracle Web-Seiten C:\sqldeveloper\jdbc\lib\ojdbc6.jar Dann passenden Treiber suchen, z. B. ojdbc6.jar 274

23 Erinnerung: PL/SQL-Funktion CREATE OR REPLACE FUNCTION anzahlnasen(namepar Angestellte.Name%TYPE) RETURN INTEGER /* oder NUMBER */ IS ergebnis INTEGER; BEGIN IF namepar = 'Meier' THEN RAISE_APPLICATION_ERROR(-20300, 'Meiers nicht zählbar'); END IF; SELECT COUNT(*) INTO ergebnis FROM Angestellte WHERE Angestellte.Name=namePar; RETURN ergebnis; END; 275

24 PL/SQL in Java Grundsätzlich besteht bei der Ausführung große Ähnlichkeit zu PreparedStatements benötigt wird Connection-Objekt con CallableStatement stmt=con.preparecall( "{? = call anzahlnasen(?)}"); man beachte geschweifte Klammern, bei Prozeduraufruf wird? = am Anfang weggelassen in Oracle auch möglich: CallableStatement stmt=con.preparecall( "BEGIN? := anzahlnasen(?); END;"); Ausgabeparameter müssen registriert werden stmt.registeroutparameter(1,types.integer); 276

25 Beispiel public int nasenzaehlen(string nachname){ int ergebnis=0; try { CallableStatement stmt=con.preparecall( "{? = call anzahlnasen(?)}"); stmt.registeroutparameter(1,types.integer); stmt.setstring(2,nachname); stmt.execute(); ergebnis=stmt.getint(1); } catch (SQLException e) { if(e.geterrorcode()==20300) // von RAISE_APPLICATION_ERROR ergebnis=-1; else{ ausnahmeausgeben(e); ergebnis=integer.min_value; } } return ergebnis; } 277

26 Nutzung von Cursor als Ergebnis (1/3) import java.sql.callablestatement; import java.sql.connection; import java.sql.drivermanager; import java.sql.resultset; import java.util.scanner; import oracle.jdbc.oracletypes; /* in Oracle fuer das MondialBeispiel CREATE OR REPLACE PROCEDURE STAEDTEIN( Land IN VARCHAR, stadtcursor IN OUT SYS_REFCURSOR) AS BEGIN OPEN stadtcursor for SELECT * FROM City WHERE City.Country=Land; END STAEDTEIN; */ /* Hinweis: Cursor nur lesbar, nicht schreibbar! */ 278

27 Nutzung von Cursor als Ergebnis (2/3) public class PLSQLCursorNutzungInJava { // public static void main(string[] s){ String nutzer="kleuker"; String passwort="kleuker"; try { DriverManager.registerDriver(new oracle.jdbc.driver.oracledriver()); //Verbindung aufbauen in der HS zur DB Connection conn = DriverManager.getConnection ("jdbc:oracle:thin:@srv20.edvsz.hs-osnabrueck" +".de:1521:ora11", nutzer, passwort); //Vorbereitung der PL/SQL-Nutzung ResultSet rset = null; CallableStatement cstmt = conn. preparecall("{call staedtein(?,?)}"); cstmt.registeroutparameter(2, OracleTypes.CURSOR); 279

28 Nutzung von Cursor als Ergebnis (3/3) } //Testprogramm String eingabe=""; while(!eingabe.equalsignorecase("ende")){ System.out.print( "Laenderkuerzel (Ende mit \"Ende\"): "); eingabe=(new Scanner(System.in)).next(); } cstmt.setstring(1,eingabe); cstmt.execute(); rset = (ResultSet) cstmt.getobject(2); while(rset.next()) System.out.println("Stadt: " +rset.getstring("name") +" Einwohner:" +rset.getint("population")); } conn.close(); } catch(exception e){ // ausarbeiten, wie immer } 280

29 Beispieldialog Laenderkuerzel (Ende mit "Ende"): GR Stadt: Piraeus Einwohner: Stadt: Patrai Einwohner: Stadt: Larisa Einwohner: Stadt: Iraklion Einwohner: Stadt: Volos Einwohner:71378 Stadt: Kavalla Einwohner:56705 Stadt: Athens Einwohner: Stadt: Thessaloniki Einwohner: Laenderkuerzel (Ende mit "Ende"): LAR Stadt: Tripoli Einwohner:0 Stadt: Bengasi Einwohner:0 Laenderkuerzel (Ende mit "Ende"): AND Stadt: Andorra la Vella Einwohner:15600 Laenderkuerzel (Ende mit "Ende"): ende 281