SOSConnection Zugriffsschicht für Datenbanken JAVA-KLASSEN. Klassendokumentation 14. August Software- und Organisations-Service GmbH

Transkript

1 Software- und Organisations-Service GmbH JAVA-KLASSEN SOSConnection Zugriffsschicht für Datenbanken Klassendokumentation 14. August 2007 Software- und Organisations-Service GmbH Giesebrechtstr. 15 D Berlin Telefon (030) Telefax (030)

2 Connection - Zugriffsschicht für Datenbanken 2 Inhaltsverzeichnis 1 Zielsetzung Datenbankabstraktion Performance Funktionalität Kompatibilität Schlussfolgerung für die Abstraktion Unterstützte Datenbanksysteme Klassenhierarchie und Deployment Methoden Standardisierte Aufrufe createinstance() connect() disconnect() execute() executeupdate() executequery() closequery() get() getresultset() getsingle() getsingleasproperties() getsinglevalue() getarray() getarrayasproperties() getarrayasvector() getarrayvalue() updateblob() updateblob() getblob() getblob() updateclob() updateclob() getclob() getclob() getlastsequencevalue() getstatements() commit() rollback () SQL-Funktionen %lower( String string ) %upper( String string ) %now() %timestamp( String timestamp ) %timestamp_iso( String iso_timestamp ) %cast( String expression ) %updlock() Tracing Profiling Konfigurationsdatei...14

3 Connection - Zugriffsschicht für Datenbanken 3 10 Besonderheiten beim Verbindungsaufbau MSSQL MySQL Oracle DB Firebird PostgreSQL Wie werden weitere Datenbanken angeschlossen? Implementierung der Konstruktoren public SOSMyDatabaseConnection() public SOSMyDatabaseConnection(Connection connection, SOSLogger logger) public SOSMyDatabaseConnection(Connection connection) public SOSMyDatabaseConnection(String configfilename, SOSLogger logger) public SOSMyDatabaseConnection(String configfilename) public SOSMyDatabaseConnection(String driver, String url, String dbuser, String dbpassword, SOSLogger logger) public SOSMyDatabaseConnection(String driver, String url, String dbuser, String dbpassword) Implementierung abstrakter Methoden der Basisklasse public void connect() public void prepare(connection connection) protected boolean preparegetstatements(stringbuffer contentsb, StringBuffer splitsb, StringBuffer endsb) public String getlastsequencequery(string sequence) public String[] getreplacement() rotected String replacecasts(string expression) public String todate(string datestring) Implementierung optionaler Methoden protected GregorianCalendar getdatetime(string format) public Vector getoutput() public int parsemajorversion(string productversion) public int parseminorversion(string productversion)...17

4 Connection - Zugriffsschicht für Datenbanken 4 Kontakt Software- und Organisations-Service GmbH Giesebrechtstr Berlin Germany Telephon Telefax Mail Web info@sos-berlin.com Letze Änderung: 14. August 2007

5 Connection - Zugriffsschicht für Datenbanken 5 1 Zielsetzung Die Klassen des Pakets SOSConnection implementieren ein einheitliches Interface für den Zugriff auf unterschiedliche Datenbanksysteme. Durch Verwendung dieser Klassen ist es möglich, Java-Anwendungen für den parallelen Einsatz mit mehreren Datenbanksystemen zu entwickeln. Die Klassen stellen eine Abstraktionsschicht dar, ohne zwanghaft Einschränkungen in der Entwicklung von Anwendungen aufzuerlegen. Als ergänzende Beschreibung steht die API-Dokumentation im JavaDoc-Format zur Verfügung. 2 Datenbankabstraktion Es ist grundsätzlich nicht Ziel einer Abstraktionsschicht unterschiedliche Zugriffsdialekte für Datenbanken auf kleinstem gemeinsamem Nenner zu nivellieren: jede Datenbank hat individuelle Stärken, ein Verzicht auf diese "features" wäre schlicht kontraproduktiv. Entscheidend für die Anwendung ist es eine klare Priorität zwischen der Orientierung an Performance, Funktionalität und Kompatibilität zu finden. 2.1 Performance Datenbanksysteme beherrschen unterschiedliche "features" zur Performance-Optimierung. Ein Beispiel hierfür ist die LIMIT-Klausel von MySQL: select * from sample_table limit 200 durch Verwendung der Klausel kann die Anzahl zurückzuliefernder Datensätze einer Abfrage im vornherein eingeschränkt werden. Die Klausel wirkt nicht erst beim Abholen von Datensätzen aus einer Ergebnismenge, sondern wird bereits in der Datenbankengine zur Optimierung der Suchstrategie verwendet und die Suche bereits abgebrochen wenn die Trefferzahl erreicht ist. Wenn in Web-Seiten beschränkte Ergebnismengen angezeigt werden sollen, ist diese Klausel sinnvoll einzusetzen, selbst wenn sie nicht kompatibel zum SQL- Standard ist: der Geschwindigkeitsvorteil rechtfertigt den Aufwand diese Klausel bedingt in einer Anwendung zu programmieren. Ein analoges Konstrukt für Oracle ist die Klausel: select * from ( select * from sample_table ) where rownum <= 200 die im Ergebnis zwar ebenfalls eine Einschränkung der Ergebnismenge bewirkt, die aber erst beim Auslesen der vollständigen Ergebnismenge der inneren Abfrage durch die äußere Abfrage erfolgt. Wenn eine solche Abfrage aufgrund der Suchbedingungen eine gesamte Tabelle durchliest (full table scan), dann wird deutlich, dass das professionellere Datenbanksystem nicht in jeder Situation das schnellere sein muß. 2.2 Funktionalität Manche Funktionen sind bei Datenbankherstellern schlichtweg aufgrund von Designentscheidungen entfallen obwohl sie sehr nützlich in der Anwendungsentwicklung sind: Als Beispiel sei die MySQL-Funktion affectedrows() genannt, die es erlaubt auch nach ändernden SQL- Statements wie UPDATE und DELETE die Anzahl der betroffenen Sätze festzustellen. Eine Anwendung die gezielt nur einen Datensatz ändern will, kann mit dieser Funktion feststellen, ob dies zutrifft. SQL ist aufgrund seiner mengentheoretischen Herkunft nicht in der Lage diese Information in einem SQL-Statement zu liefern. Als Ersatzkonstrukt wird oft darauf verwiesen das Statement select count(*) zu verwenden. Diese führt allerdings zu einer Vergrößerung der Zugriffszeiten, da dieselbe Abfrage ein zweites Mal ausgeführt wird.

6 Connection - Zugriffsschicht für Datenbanken Kompatibilität Weder Oracle noch MySQL sind 100%ig kompatibel zu einem SQL-Standard. Standards wie SQL92 und SQL99 sind von beiden Datenbanken nicht vollständig implementiert. Als Beispiel sei auf Left Outer Join- Abfragen verwiesen, die Oracle erst ab Version 9.2 standardkonform unterstützt. Eine solche Join-Abfrage liefert zu einer Menge von Sätzen aus zwei Tabellen auch dann ein Ergebnis, wenn in der rechten Tabelle kein entsprechender Treffersatz gefunden wird. Die Oracle-Syntax hierfür lautet: select * from left_table lt, right_table rt where lt.key=rt.key(+) Die SQL99 standardkonforme Syntax lautet: select * from left_table lt left outer join right_table rt on lt.key=rt.key Dieser Zugriff ist daher ohne Rücksicht auf das eingesetzte Datenbanksystem nicht implementierbar. 2.4 Schlussfolgerung für die Abstraktion Von den vorstehenden Beispielen ausgehend könnte man meinen eine Abstraktion vom konkreten Datenbanksystem sei nicht erreichbar. Dies ist zutreffend solange der Begriff Abstraktion fordert, Datenbanken müssten hinsichtlich Ihrer Syntax gleich sein. Fordert man dagegen, dass sie sich gleich verhalten gegenüber einer Anwendung, dann lässt sich dieses Verhalten durch Implementierung einer Zugriffsschicht herstellen. Die SOSConnection-Klassen stellen entsprechend keine Einschränkung dar hinsichtlich der Frage, welche Syntax für SQL-Statements verwendet wird, sondern standardisieren - welche Methoden verfügbar sind, wie sie parametrisiert werden und welche Rückgaben sie liefern - in welchen Formaten Daten zurückgeliefert werden (scalare Typen, arrays) - in welchen Formaten SQL-Funktionen wie upper(), lower() angesprochen werden - wie Zeitstempel an die Datenbank übergeben werden - wie das Fehlermanagement implementiert ist - wie das Tracing von Datenbankaufrufen erfolgt - wie eine vergleichende Messung der Zugriffszeiten (profiling) betrieben werden kann.

7 Connection - Zugriffsschicht für Datenbanken 7 3 Unterstützte Datenbanksysteme Für folgende Datenbanksysteme sind SOSConnection-Klassen verfügbar: Oracle ab Version 8.1.7, incl. 9.2, 10.x MySQL ab Version 3.25, Transaktionsunterstützung ab Version 4.01 MS SQL-Server ab Version 7, incl. 2000, 2005 DB2 ab Version 8 Firebird ab Version 1.5 ODBC-Datenbanken 4 Klassenhierarchie und Deployment Die Basisklasse SOSConnection stellt Zugriffsmethoden zur Verfügung, von dieser Klasse werden weitere DBMS-spezifische Klassen abgeleitet, z.b. SOSOracleConnection, SOSMySQLConnection etc. - Methodenimplementierungen der Basisklasse SOSConnection werden per Vererbung genutzt - Abstrakte Methoden der Basisklasse müssen von abgeleiteten Klassen implementiert werden Alle Klassen werden unter dem Paketnamen sos.connection vorgehalten und mit dem Archiv sos.connection.jar ausgeliefert. Das Paket wird für den Betrieb mit JRE 1.4.2_05 und höher bereitgestellt. 5 Methoden 5.1 Standardisierte Aufrufe Die Methoden aller SOSConnection-Klassen sind in gleicher Weise parametrisiert und liefern dieselben Funktionsergebnisse. Die vollständige Auflistung und die Beschreibung der Parameter kann der API-Dokumentation im JavaDoc-Format entnommen werden createinstance() SOSConnection createinstance(string class, String driver, String url, String dbuser, String dbpassword) SOSConnection createinstance(string configfilename) sowie weitere createinstance() Methoden mit ähnlicher Signatur. Die Methode liefert das Objekt einer DBMS-spezifischen SOSConnection-Klasse zurück. Die Verbindung wird aus den Einstellungen einer Konfigurationsdatei oder aus den Methodenargumenten hergestellt, siehe Kapitel "Konfigurationsdatei" für Details bzgl. der erforderlichen Einträge in einer Konfigurationsdatei connect() void connect ()

8 Connection - Zugriffsschicht für Datenbanken 8 Die Methode besorgt den Verbindungsaufbau zur Datenbank. Anmerkungen Nach dem Verbindungsaufbau werden automatisch folgende Voreinstellungen vorgenommen: Datumsformate: ISO (yyyy-mm-dd hh24:mm:ss) Zahlenformate:. (Punkt) als Dezimalzeichen Transaktionen: automatischer Transaktionsbeginn, kein automatisches Transaktionsende (auto commit=false), nach dem Verbindungsaufbau werden Transaktionen von der Applikation gehandhabt disconnect() void disconnect () Die Methode baut die Verbindung zur Datenbank ab execute() void execute ( String statement ) Die Methode führt ein Statement aus, z.b. den Aufruf einer Stored Procedure. Diese Methode soll nicht für DML Statements verwendet werden, siehe executeupdate(), und nicht für Abfragen, für die eine Ergebnismenge vorgehalten werden muss, siehe executequery() executeupdate() int executeupdate ( String query ) Die Methode führt ein DML Statement aus wie UPDATE, INSERT, DELETE. Die Anzahl betroffener Sätze executequery() void executequery ( String query ) Die Methode führt eine Abfrage aus und erhält die Ergebnismenge. Die Methode kann mit nachfolgenden Aufrufen der get() Methode kombiniert werden, um nacheinander Sätze einer Ergebnismenge zu lesen closequery() void closequery () Die Methode schließt eine Ergebnismenge, die durch einen vorherigen Aufruf der executequery() Methode erzeugt wurde. Bitte beachten Sie, dass für den Betrieb mit einem Connection Pool, z.b. mit einem Application Server oder Servlet Container, für jede Verbindung, die an den Connection Pool zurückgegeben wird, alle offenen Ergebnismengen und Transaktionen geschlossen sein müssen get() HashMap get ()

9 Connection - Zugriffsschicht für Datenbanken 9 Die Methode liest den nächsten Satz der Ergebnismenge einer Abfrage HashMap bestehend aus Feldnamen und Werten des nächsten Datensatzes. Die Methode wird üblicherweise mit einem while() Konstrukt zum schrittweisen Lesen der Ergebnismenge eingesetzt. Anmerkung Die Feldnamen werden per Voreinstellung in Kleinbuchstaben geliefert; die Schreibweise der Feldnamen kann jedoch mit den Methoden setkeystouppercase() und setkeystolowercase() geändert werden getresultset() ResultSet getresultset () Die Methode liefert das Objekt der Ergebnismenge, die durch einen vorherigen Aufruf der Methode execute- Query() erzeugt wurde. Objekt der Ergebnismenge einer vorherigen Abfrage oder null getsingle() HashMap getsingle ( String query ) Die Methode liest einen Datensatz der Ergebnismenge einer Abfrage HashMap bestehend aus Feldnamen und Werten des ersten Datensatzes, leere HashMap bei leerer Ergebnismenge getsingleasproperties() Properties getsingle ( String query ) Die Methode liest den ersten Satz der Ergebnismenge einer Abfrage. Properties Collection bestehend aus Feldnamen und Werten des ersten Satzes oder leere Collection bei leerer Ergebnismenge getsinglevalue() String getsinglevalue ( String query ) Die Methode liest einen skalaren Wert, i.d.r. ein Feld, des ersten Satzes der Ergebnismenge einer Abfrage String oder leerer String im Fall einer leerer Ergebnismenge

10 Connection - Zugriffsschicht für Datenbanken getarray() ArrayList getarray ( String query ) Liefert alle Treffer der Abfrage als ArrayList aus HashMaps zurück. ArrayList von HashMaps oder leere ArrayList im Fall einer leeren Ergebnismenge getarrayasproperties() Properties getarrayasproperties ( String query ) Liefert alle Treffer der Abfrage als Collection von Properties zurück. Eine Properties Collection oder eine leere Collection im Fall einer leeren Ergebnismenge getarrayasvector() Vector getarrayasvectory ( String query ) Liefert aller Treffer der Abfrage als Vector von HashMaps zurück. Ein Vector von HashMaps oder ein leerer Vector im Fall einer leeren Ergebnismenge getarrayvalue() ArrayList getarrayvalue ( String query ) Liefert alle Treffer als ArrayList-Objekt zurück. Die Abfrage darf nur ein Feld aus jeweils einem Satz lesen. ArrayList der Treffer oder leere ArrayList im Fall einer leeren Ergebnismenge updateblob() long updateblob( String tablename, String columnname, String filename, String condition ) Die Methode speichert den Inhalt einer Datei in ein Datenbankfeld vom Typ BLOB. Anzahl gespeicherter Byte updateblob() long updateblob ( String tablename, String columnname, byte[] data, String condition ) Die Methode aktualisiert den Inhalt eines Byte Arrays in einem BLOB-Feld. Anzahl gespeicherter Byte

11 Connection - Zugriffsschicht für Datenbanken getblob() byte[] getblob ( String query ) Die Methode liefert den Inhalt eines BLOB-Felds. Der Inhalt des BLOB-Felds als Byte Array getblob() long getblob ( String query, String filename ) Die Methode speichert den Inhalt eines Datenbankfelds vom Typ BLOB in einer neuen Datei. Anzahl geschriebener Bytes updateclob() long updateclob( String tablename, String columnname, String filename, String condition ) Die Methode speichert den Inhalt einer Datei einem CLOB-Feld. Anzahl gespeicherter Bytes updateclob() long updateclob ( String tablename, String columnname, byte[] data, String condition ) Der Inhalt eines Byte Arrays wird in einem CLOB-Feld aktualisiert. Anzahl gespeicherter Bytes getclob() String getclob ( String query ) Die Methode liefert den Inhalt eines CLOB-Felds. Inhalt des CLOB-Felds als String getclob() long getclob ( String query, String filename ) Die Methode schreibt den Inhalt eines CLOB-Felds in eine Datei.

12 Connection - Zugriffsschicht für Datenbanken 12 Anzahl geschriebener Bytes getlastsequencevalue() String getlastsequencevalue ( String sequence ) Die Methode liefert den letzten Wert eines Sequenzgenerators. Für MySQL ist dies der Wert der Funktion LAST_INSERT_ID(). Für Oracle wird der Name der Sequence angegeben, bei Datenbanken ohne benannte Sequences sollte dieses Argument null sein. Der letzte Wert eines Sequenzgenerators getstatements() ArrayList getstatements ( String statements ) Die Methode liefert einzelne Statements aus einer Reihe von Statements, die als Argument übergeben werden. Die Methode implementiert einen Parser der Statements isoliert und DDL Statements (create procedure etc.) und DML Statements berücksichtigt. ArrayList isolierter Statements commit() void commit () Schließt eine Transaktion ab Anmerkungen Der Aufruf wird bei Einsatz der Klasse SOSHistory ignoriert, der Transaktionsabschluss stattdessen in der Historie gespeichert und zu einem späteren Zeitpunkt ausgeführt rollback () void rollback () Rollt eine Transaktion zurück 6 SQL-Funktionen Die nachfolgenden Pseudo-Funktionen werden automatisch auf die Syntax der unterstützten Datenbanksysteme abgebildet. Funktionsnamen werden zur Unterscheidung von SQL-Funktionen durch % präfiziert. 6.1 %lower( String string ) Liefert die SQL-Funktion für die Darstellung des Parameters in Kleinbuchstaben.

13 Connection - Zugriffsschicht für Datenbanken %upper( String string ) Liefert die SQL-Funktion für die Darstellung des Parameters in Großbuchstaben. 6.3 %now() Liefert den SQL-Code für den aktuellen Zeitstempel, z.b. SYSDATE für Oracle. 6.4 %timestamp( String timestamp ) Konvertiert den Inhalt des übergebenen Zeitstempels aus dem Format dd.mm.yyyy hh24:mm:ss im ISO- Format yyyy-mm-dd hh24:mm:ss und liefert den SQL Code für die Darstellung. Für Oracle könnte dies sein TO_DATE(' :44:22', 'yyyy-mm-dd HH24:MI:SS'). 6.5 %timestamp_iso( String iso_timestamp ) Liefert den SQL Code für die Darstellung des Zeitstempels, der als Argument im ISO-Format yyyy-mm-dd hh24:mm:ss erwartet wird. Für Oracle könnte dies sein TO_DATE(' :44:22', 'yyyy-mm-dd HH24:MI:SS'). 6.6 %cast( String expression ) Liefert die SQL-Funktion für einen Konvertierungsausdruck des im Argument übergebenen Datentypnamens. VARCHAR, CHARACTER and INTEGER sind unterstützte Datentypnamen. 6.7 %updlock() Liefert die SQL-Syntax für eine Sperre, z.b. ist dies für Oracle FOR UPDATE. 7 Tracing Die SOSConnection-Klassen unterstützen ein einheitliches Tracing: durch Setzen der loglevel Eigenschaft im verwendeten Logger wird die Protokollierungstiefe eingestellt. Ab Stufe 6 werden alle Methodenaufrufe und Parameter von SOSConnection-Klassen protokolliert. Ab Stufe 8 werden auch methodeninterne Datenbankaufrufe protokolliert. 8 Profiling Mit der Klasse SOSProfiler steht ein Instrument zur Performance-Messung und zur Fehlersuche in SQL- Statements zur Verfügung. Alle SOSConnection-Klassen sind für Profiling vorbereitet und liefern pro Methodenaufruf das Intervall zwischen Beginn der Ausführung eines SQL-Statements und dem Verlassen der Methode in Millisekunden. Eine vergleichende Messung von Anwendungen unter Last ist dadurch möglich.

14 Connection - Zugriffsschicht für Datenbanken 14 Die Klasse SOSProfiler ist separat dokumentiert. Das Profiling wird durch Zuweisung eines Profiler-Objekts über die Methode setprofiler() einer SOSConnection-Klasse aktiviert. 9 Konfigurationsdatei Die Konfiguration der Datenbankverbindung erfolgt über eine Einstellungsdatei. Deren Name wird der statischen Methode SOSConnection.createInstance() übergeben, die eine Instanz einer entsprechenden abgeleiteten Klasse von SOSConnection erzeugt. Die Einstellungsdatei enthält durch Zeilenumbrüche getrennte Name-Wert Paare der Form name=wert Folgende Parameter sind zu setzen: Parameter class= driver= url= user= password= Wert SOS Klasse für die Datenbankverbindung MSSQL: SOSMSSQLConnection MySQL: SOSMySQLConnection Oracle: SOSOracleConnection DB2: SOSDB2Connection Firebird: SOSFbSQLConnection PostgreSQL: SOSPgSQLConnection ODBC: SOSODBCConnection JDBC-Treiber für die Datenbankverbindung MSSQL: com.microsoft.jdbc.sqlserver.sqlserverdriver (nur SQL 2000) MSSQL: com.microsoft.sqlserver.jdbc.sqlserverdriver (SQL 2005, 2000) MySQL: com.mysql.jdbc.driver Oracle: oracle.jdbc.driver.oracledriver DB2: com.ibm.db2.jcc.db2driver Firebird: org.firebirdsql.jdbc.fbdriver PostgreSQL: org.postgresql.driver ODBC: sun.jdbc.odbc.jdbcodbcdriver JDBC-URL zur Datenbank Name des Datenbankbenutzers Kennwort des Datenbankbenutzers 10 Besonderheiten beim Verbindungsaufbau Um unabhängig von Einstellungen der Datenbank oder des Datenbank-Clients zu sein, werden beim Verbindungsaufbau durch die SOSConnection-Klassen einige Einstellungen explizit gesetzt: 10.1 MSSQL Transaction Isolation Level: TRANSACTION_READ_COMMITTED

15 Connection - Zugriffsschicht für Datenbanken 15 Select Method: Cursor Datumsformat ymd (ISO-Datumsformat) Sprache: British (für Zahlenformatierungen) LOCK_TIMOUT 3000 (Es wird 3000ms gewartet, falls auf eine gesperrte Tabelle zugegriffen werden soll) 10.2 MySQL Transaction Isolation Level: TRANSACTION_READ_COMMITTED (Serializable ist in MySQL InnoDB falsch implementiert) SQL_Mode='ANSI_QUOTES' (client-seitiger SQL Kompatibilitätsschalter) 10.3 Oracle Transaction Isolation Level: TRANSACTION_SERIALIZABLE Datumsformat: yyyy-mm-dd hh24:mm:ss (ISO Datumsformat) Zahlen:. als Dezimalzeichen 10.4 DB2 Transaction Isolation Level: TRANSACTION_READ_COMMITTED 10.5 Firebird Transaction Isolation Level: TRANSACTION_REPEATABLE_READ 10.6 PostgreSQL Transaction Isolation Level: TRANSACTION_REPEATABLE_READ Datumsformat: yyyy-mm-dd hh24:mm:ss (ISO Datumsformat) Zahlen:. als Dezimalzeichen 11 Wie werden weitere Datenbanken angeschlossen? Beachten Sie bitte die folgenden Hinweise, falls Sie planen SOSConnection durch eigene abgeleitete Klassen für andere Datenbanken zu erweitern Implementierung der Konstruktoren Alle Konstruktor-Methoden der Basisklasse müssen implementiert werden. Die nachfolgenden Beispiele gehen von einer abgeleiteten Klasse mit dem Namen SOSMyDatabaseConnection aus:

16 Connection - Zugriffsschicht für Datenbanken public SOSMyDatabaseConnection() public SOSMyDatabaseConnection(Connection connection, SOSLogger logger) public SOSMyDatabaseConnection(Connection connection) public SOSMyDatabaseConnection(String configfilename, SOSLogger logger) public SOSMyDatabaseConnection(String configfilename) public SOSMyDatabaseConnection(String driver, String url, String dbuser, String dbpassword, SOSLogger logger) public SOSMyDatabaseConnection(String driver, String url, String dbuser, String dbpassword) 11.2 Implementierung abstrakter Methoden der Basisklasse Folgende abstrakte Methoden müssen implementiert werden: public void connect() Baut die Verbindung zur Datenbank auf public void prepare(connection connection) Diese Methode wird bei connect() aufgerufen und zum Senden einleitender Statements verwendet, z.b. zur Festlegung des Dezimalzeichens für die Zahlendarstellung, des Datumsformats und des gewünschten Transaktionsisolationslevels. Eine leere Implementierung ist zulässig protected boolean preparegetstatements(stringbuffer contentsb, StringBuffer splitsb, StringBuffer endsb) Die Methode wird eingesetzt, um das Verhalten des SQL Statement Parsers in der Basisklasse SOSConnection für mehrere oder mehrzeilige Statements anzupassen. Beachten Sie bitte, dass Benutzer der Klasse nicht nur SELECT Statements verwenden, sondern mit der Klasse Tabellen und Prozeduren, Funktionen etc. einrichten. Der Parser muss daher die Statements analysieren und ggf. isolieren bevor sie ausgeführt werden. Diese Methode wird verwendet, um die Zeichenfolgen festzulegen, die mehrere Statements voneinander trennen bzw. ein Statement terminieren. Für Oracle ist die Trennzeichenfolge "\n/\n" (new line, "/" gefolgt von new line) ohne Terminierungszeichenfolge. Für MySQL ist dies "\n\\\\g\n" (new line, "\g" (mit verdoppelten backslashes) gefolgt von new line) als Trennzeichenfolgen und "\n\\g\n" als Terminierungszeichenfolge public String getlastsequencequery(string sequence) Liefert den SQL Code, der den letzten Wert liefert, der in ein Feld vom Typ Autoincrement eingefügt wurde public String[] getreplacement() Liefert einen Array von Strings mit SQL Funktionen für %lcase, %ucase, %now, %updlock, siehe Kapitel SQL Funktionen.

17 Connection - Zugriffsschicht für Datenbanken rotected String replacecasts(string expression) Liefert die SQL Funktion für einen Konvertierungsausdruck des Datentypnamens im angegebenen Argument. VARCHAR, CHARACTER and INTEGER sind unterstützte Datentypenamen. Der dieser Methode wird für die Pseudo-Funktion %cast verwendet, siehe Kapitel SQL Funktionen public String todate(string datestring) Liefert die SQL Syntax für einen Datentyp Datum oder Zeitstempel mit dem angegebenen Wert Implementierung optionaler Methoden Die folgenden Methodenimplementierungen sind optional. Sie werden von SOSConnection implementiert und können ggf. von abgeleiteteten Klassen überschrieben werden protected GregorianCalendar getdatetime(string format) Liefert den aktuellen Zeitstempel der Datenbank als Calendar Objekt public Vector getoutput() Liest die Ausgaben, die von der Datenbank als Antwort auf Statements erzeugt wurden. Für Oracle verwendet diese Methode das Paket dbms.output public int parsemajorversion(string productversion) Extrahiert die Hauptversionsnummer des DBMS aus der Produktkennzeichnung. Die Basisklasse implementiert dies durch Extrahieren der Zahl, die vor dem ersten Punkt der Produktkennzeichnung auftritt public int parseminorversion(string productversion) Extrahiert die Nebenversionsnummer des DBMS aus der Produktkennzeichnung. Die Basisklasse implementiert dies durch Extrahieren der Zahl, die nach dem ersten Punkt der Produktkennzeichnung auftritt.