11. JDBC. Grundsätzliche Nutzung von JDBC Verbindungsaufbau Anfragen Analyse des erhaltenen Ergebnisses Veränderungen des Ergebnisses

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 270

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

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 272

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:" + "@oracle-srv.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"); 273

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 274

6 Verbindungsanalyse durch Metadaten (Ausschnitt) DatabaseMetaData dbmd = con.getmetadata(); System.out.println("DB-Name: " + dbmd.getdatabaseproductname() + "\ndb-version: " + dbmd.getdatabasemajorversion() + "\ndb-release: " + dbmd.getdriverminorversion() + "\ntransaktionen erlaubt: " + dbmd.supportstransactions() + "\nbeachtet GroßKlein :" + dbmd.storesmixedcaseidentifiers() + "\nunterstützt UNION :" + dbmd.supportsunion() + "\nmax. Prozedurname: " + dbmd.getmaxprocedurenamelength()); DB-Name: Oracle DB-Version: 11 DB-Release: 2 Transaktionen erlaubt: true beachtet GroßKlein :false unterstützt UNION :true max. Prozedurname:

7 Statement / Anfrage ausführen 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..."); 276

8 Metadaten des Anfrageergebnisses ResultSet rs = stmt.executequery("select * FROM Continent"); ResultSetMetaData rsmd = rs.getmetadata(); int spalten = rsmd.getcolumncount(); for (int i = 1; i <= spalten; i++) { // nicht i=0 } System.out.println(i + ". Name: " + rsmd.getcolumnname(i) + " Typ: " + rsmd.getcolumntypename(i) + " Javatyp: " + rsmd.getcolumnclassname(i)); 1. Name: NAME Typ: VARCHAR2 Javatyp: java.lang.string 2. Name: AREA Typ: NUMBER Javatyp: java.math.bigdecimal 277

9 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 ab 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 278

10 Attributwerte auslesen (1/2) Spaltenwerte (Attribute) einer Zeile mit getxxx()-methoden lesen Treiber konvertiert Daten, falls möglich, deshalb (fast) immer getstring() nutzbar 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 279

11 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 280

12 Beispiel: Ausgabe eines Anfrageergebnisses ResultSet rs = stmt.executequery("select * FROM Continent"); ResultSetMetaData rsmd = rs.getmetadata(); int spalten = rsmd.getcolumncount(); while (rs.next()) { } for (int i = 1; i <= spalten; i++) { } System.out.print(rs.getString(i) + " "); System.out.print("\n"); Europe Asia Australia/Oceania Africa America

13 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 282

14 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 283

15 ResultSet: positionieren (2/3) boolean absolute(int pos) Positioniert ausgehend vom Anfang (pos positiv) oder vom 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 284

16 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 285

17 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] 286

18 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 287

19 Daten ändern ResultSet executequery(string) führt SELECT- Anweisung aus int executeupdate(string) führt INSERT-, UPDATEoder 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 288

20 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 >?"); 289

21 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(); 290

22 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 291

23 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:@oracle-srv.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) {... } 292

24 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(); } } 293

25 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 in sqldeveloper\jdbc\lib 294

26 Einbindung von Oracle-JDBC in NetBeans Rechtsklick im Projekt auf Libraries -> Add JAR/Folder manövrieren zum Verzeichnis mit JDBC-Treiber (sinnvoll Unterordner lib des Projekts) markieren und Öffnen 295

27 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; 296

28 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); 297

29 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; } 298

30 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! */ 299

31 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:@oracle-srv.edvsz.hs-osna" + "brueck.de:1521:ora11", nutzer, passwort); //Vorbereitung der PL/SQL-Nutzung ResultSet rset = null; CallableStatement cstmt = conn. preparecall("{call staedtein(?,?)}"); cstmt.registeroutparameter(2, OracleTypes.CURSOR); 300

32 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 } 301

33 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 302