| java.lang.Object
 com.teamkonzept.db.TKQuery
All known Subclasses: com.teamkonzept.db.TKPrepQuery, com.teamkonzept.db.CompositeQuery, com.teamkonzept.db.TKUnprepQuery,
| TKQuery | | abstract public class TKQuery implements QueryConstants(Code) | | Abstrakte Query Klasse.
Stellt eine Basis zum Erstellen und Ausführen von SQL-Queries
zur Verfügung.
|
| Constructor Summary | |
| public | TKQuery()
|
| Method Summary | |
| public void | close()
Wie specClose, aber mit Fehlerbehandlung. | | protected void | deregisterQuery()
Methode zum Abmelden. | | abstract public boolean | execute()
Abstrakte Methode, welche die Query ausführt. | | public void | executeAsTran()
Methode die die Query in einer eigenen Transaktion ausfuehrt. | | public ResultSet | fetchResultSet()
Methode zum Auslesen des Ergebnisses der Query. | | abstract public void | initQuery(Connection conn)
Abstrakte Methode zur Initialisierung der Query. | | abstract public void | initQuery(TKSQLTypeConverter conv, TKDBConnection tkdbConn, Object queryID)
Abstrakte Methode zur Initialisierung der Query.
Diese Methode wird üblicherweise vom DB-Manager aufgerufen,
um eine Query zu initialisieren. | | public void | initQuery(Connection conn, Object[][] paramTypes, boolean[] setRelevants)
| | public void | printSqlException(SQLException sqle, String s)
Methode, welche eine SQLException in einen TKSQLError
konvertiert und diesen wirft. | | protected int | registerQuery()
Methode zur Registrierung der Query fuer spaeteres
automatisches Schliessen, und zur Kontrolle ob
sensible Queries in einer korrekten Transaktion ausgefuehrt
werden. | | public void | setQueryParams(String param, Object val)
Methode, welche einem Query-Parameter einen Wert zuweist. | | abstract public void | specClose()
| | public void | throwawayResults()
Holt alle Results (das sind ResultSets und UpdateCounts)
ab. |
| CAT | | final protected static Category CAT(Code) | | Logging Category
|
| DBFORM_IDENT | | final public static int DBFORM_IDENT(Code) | | |
| DBFRAGMENT_IDENT | | final public static int DBFRAGMENT_IDENT(Code) | | |
| DBSTRUC_IDENT | | final public static int DBSTRUC_IDENT(Code) | | |
| aTKDBConnection | | protected TKDBConnection aTKDBConnection(Code) | | Objekt welches Datenstrukturen im Bezug auf die Connection enth‰lt
|
| currIsResultSet | | protected boolean currIsResultSet(Code) | | |
| currPos | | protected int currPos(Code) | | |
| deregisterIndex | | protected int deregisterIndex(Code) | | |
| paramTypes | | protected TKHashtable paramTypes(Code) | | Hashtable, welche Typinformation der Query-Parameter zur
Verfügung stellt.
key: String parameter_name
value: java.sql.Types parameter_typ
See Also: java.sql.Types |
| queryParams | | protected TKHashtable queryParams(Code) | | Hashtable, welche zur jedem Query-Parametername dessen
Wert verwaltet.
|
| sensitiveQuery | | protected boolean sensitiveQuery(Code) | | Flag welches festlegt ob die Query als senslibel betrachtet wird.
Als sensible sollten solche Queries markiert werde, die
Datenbankinhalte veraendern. Diese muessen dann innerhalb
einer expliziten Transaktionsumgebung ausgefuehrt werden.
|
| setRelevants | | protected boolean[] setRelevants(Code) | | |
| sqlString | | protected String sqlString(Code) | | SQL-String, welches die Query definiert.
Dieser String ist nicht unbedingt über die gesammte Lebenszeit
des Objektes definiert, bzw. enthäalnt nicht zu jedem Zeitpunkt
einen gültigen SQL-String.
|
| stmt | | protected Statement stmt(Code) | | JDBC-Statement, das der Query zugrundeliegt.
|
| TKQuery | | public TKQuery()(Code) | | Konstruktor zur Erstellung einer nicht initialisierten Query
|
| close | | public void close() throws SQLException(Code) | | Wie specClose, aber mit Fehlerbehandlung.
Innerhalb von Transaktionen wird der Verbindungsabbau
der Rollback - Methode ueberlassen.
|
| deregisterQuery | | protected void deregisterQuery()(Code) | | Methode zum Abmelden. Wird von close() gerufen.
|
| execute | | abstract public boolean execute() throws SQLException(Code) | | Abstrakte Methode, welche die Query ausführt.
true, falls die Query ein java.sql.ResultSet geliefert hat,false, falls das Resultat der Query ein "Update Count" istoder leer ist.
exception:
java.sql.SQLException - |
| executeAsTran | | public void executeAsTran() throws SQLException(Code) | | Methode die die Query in einer eigenen Transaktion ausfuehrt.
Kann nur dann benutzt werden, wenn man kein Resultset braucht.
|
| initQuery | | abstract public void initQuery(TKSQLTypeConverter conv, TKDBConnection tkdbConn, Object queryID)(Code) | | Abstrakte Methode zur Initialisierung der Query.
Diese Methode wird üblicherweise vom DB-Manager aufgerufen,
um eine Query zu initialisieren. Sie wird
u.a. implementiert von com.teamkonzept.db.TKUnprepQuery u.
com.teamkonzept.db.TKPrepQuery .
Parameters:
tkdbConn - enth‰lt u.a. Verbindung zu der DB
Parameters:
conv - der der DB zugeordnete Typ-Konverter
Parameters:
queryID - Name der Query Klasse, erleichtert die Wiederverwendung des Objektes
See Also: com.teamkonzept.db.TKDBManager
See Also: com.teamkonzept.db.TKDBManager.newQuery |
| initQuery | | public void initQuery(Connection conn, Object[][] paramTypes, boolean[] setRelevants)(Code) | | Methode zur Initialisierung des Queryobjektes
Parameters:
conn - - Verbindung zur DB
Parameters:
paramTypes - - Liste von Parametername, Parametertyp Paaren
Parameters:
setRelevants - - geordnete Liste, welche angibt, welcheSQl(Teil)Queries relevante ResultSets liefern. |
| printSqlException | | public void printSqlException(SQLException sqle, String s)(Code) | | Methode, welche eine SQLException in einen TKSQLError
konvertiert und diesen wirft.
java.sql.SQLException sqle - die zu konvertierende SQLException java.lang.String s - String, welcher beschreibt, bei welcher Aktiondie Ausnahme aufgetreten ist.
exception:
com.teamkonzept.db.TKSQLError - |
| registerQuery | | protected int registerQuery()(Code) | | Methode zur Registrierung der Query fuer spaeteres
automatisches Schliessen, und zur Kontrolle ob
sensible Queries in einer korrekten Transaktion ausgefuehrt
werden. (Wird von execute() aufgrufen)
i > -1 bei nichtsensibler Query ein Index mitwelchem die Query wieder deregistriert werden kann -1 bei sensibler Query |
| setQueryParams | | public void setQueryParams(String param, Object val)(Code) | | Methode, welche einem Query-Parameter einen Wert zuweist.
java.lang.String param - Name des Parameters java.lang.Object val - Wert des Parameters |
| specClose | | abstract public void specClose() throws SQLException(Code) | | Methode um die Query abzuschliessen und bei
TKDConnection Objekt abzumelden
|
| throwawayResults | | public void throwawayResults() throws SQLException(Code) | | Holt alle Results (das sind ResultSets und UpdateCounts)
ab. Das ist z.B. erforderlich damit ein PreparedStatement als
abgeschlossen gilt.
ACHTUNG: mit getResultSet() anstelle von getMoreResults()
h‰tte diese Methode nicht funktuiniert! Ein Bug?
exception:
java.sql.SQLException - |
|
|