de.pkjs.pl

Class PLTransactionContext

java.lang.Object

de.pkjs.pl.PLTransactionContext

All Implemented Interfaces:

IPLContext, PLTransactionContextMBean

public final class PLTransactionContext
extends java.lang.Object
implements IPLContext, PLTransactionContextMBean

Author:

ikunin

Constructor Summary

Constructors

Constructor and Description
PLTransactionContext(PL parentPL) Constructor für remote Transactionen

Method Summary

Methods

Modifier and Type	Method and Description
Request	addRequest(JDataRow metadataRow) Erzeugt einen Request aus Metadaten
void	clearCache(java.lang.String datasetname) Der angegebene Cache wird geleert
boolean	commitTransaction(java.lang.String _transName) Beendet die Transaktion mit dem angegebenen Namen, die zuvor mit startTransaktion gestartet wurde.
int	executeBatchStatement(java.lang.String name) Führt ein Batch-Statement aus.
int	executeBatchStatement(java.lang.String name, ParameterList list) Führt ein Batch-Statement aus.
int	executeSql(java.lang.String sqlCommand) Führt ein beliebiges (NonQuery) SQL-Statement aus, welches kein Ergebnis liefern sollte.
int	executeSql(java.lang.String sqlCommand, ParameterList parameters) Führt ein beliebiges SQL-Command aus (Update, Insert, Delete).
int	executeSqlPara(java.lang.String sqlCommand, java.util.Vector<java.lang.Object> parameter) Führt ein beliebiges SQL-Statement aus, wobei die Parameter für dieses Statement in einem Vector übergeben werden.
int	executeStatement(java.lang.String name) Führt ein benanntes Statement (UPDATE, INSERT, DELETE) aus.
int	executeStatement(java.lang.String name, ParameterList parameters) Führt ein benanntes Statement (UPDATE, INSERT, DELETE) aus.
long	getAbortedTransactions()
JDataSet	getAll(java.lang.String datasetname) Liefert einen Dataset ohne Angabe eines Schlüssels; also vor allem eine Menge von Datensätzen - bis zum Inhalt einer kompletten Tabelle.
long	getCommitedTransactions()
long	getConnectionTimeOut()
java.util.Date	getCreatedTimeStamp()
Database	getCurrentDatabase() Liefert die Datenbank
java.lang.String	getCurrentDatabaseName() Liefert den Namen der verwendeten Datenbank.
java.lang.String	getDatabaseMetaData() Liefert die Metadaten der Current Database als String
electric.xml.Document	getDatabaseMetaDataDoc() Liefert die Metadaten der Current Database als XML-Document
DataRowIterator	getDataRowIterator(java.lang.String datasetname, java.lang.String tablename, java.lang.String sql, ParameterList list) Während 'normalerweise' ein DataSet vom Persistenz-Layer immer fertig aufbereitet und komplett mit allen Daten übergeben wird, ist dieses Vorgehen bei großen Datenmengen nicht angebracht, nicht nur, daß das zu lange dauert, sondern weil auch ein OutOfMemory droht.
DataRowIterator	getDataRowIteratorStatement(java.lang.String statementName, ParameterList list)
JDataSet	getDataset(java.lang.String datasetname, long oid) Liefert einen Dataset mit dem angegebenen Namen und dem angegebenen Primärschlüssel der Wurzeltabelle.
JDataSet	getDataset(java.lang.String datasetname, long[] oids) Liefert einen Dataset mit den angegebenen Primärschlüsseln.
JDataSet	getDataset(java.lang.String datasetname, ParameterList parameters) Liefert einen Dataset mit dem angegebenen Namen sowie unter Angabe eine Liste von Parametern.
JDataSet	getDataset(java.lang.String datasetname, java.lang.String key) Liefert einen Dataset mit dem angegebenen Namen und dem angegebenen Primärschlüssel der Wurzeltabelle.
java.lang.String	getDatasetDefinitionFileName()
java.util.ArrayList<java.lang.String>	getDatasetNames() Liefert die Menge der definierten Datenbank-Zugriffe.
JDataSet	getDatasetSql(java.lang.String datasetname, java.lang.String sql) Liefert einen flachen Dataset auf Basis eines beliebigen SQL-Statements.
JDataSet	getDatasetSql(java.lang.String datasetname, java.lang.String sql, int limit)
JDataSet	getDatasetSql(java.lang.String datasetname, java.lang.String sql, ParameterList list) Liefert einen flachen Dataset auf Basis eines beliebigen SQL-Statements.
JDataSet	getDatasetSql(java.lang.String datasetname, java.lang.String sql, ParameterList list, int limit, int queryTimeout)
JDataSet	getDatasetSql(java.lang.String tablename, java.lang.String columns, java.lang.String from) Deprecated.
JDataSet	getDatasetStatement(Database.NamedStatement nst, ParameterList list) Liefert einen DataSet unter Angabe eines benannten Statements.
JDataSet	getDatasetStatement(java.lang.String name) Liefert einen DataSet unter Angabe des Namens eines benannten Statements.
JDataSet	getDatasetStatement(java.lang.String name, ParameterList list) Liefert einen DataSet unter Angabe des Namens eines benannten Statements.
java.lang.String	getDatasetString(java.lang.String datasetname, long oid)
JDataSet	getDatasetWhere(java.lang.String datasetname, java.lang.String where) Deprecated.
java.text.SimpleDateFormat	getDateFormat() Liefert das DateFormat aus PLConfig.xml
JDataSet	getEmptyDataset(java.lang.String datasetname) Liefert einen Dataset ohne Werte aber mit den Metadaten.
java.lang.String	getLayerName()
int	getMaxActive()
int	getMaxIdle()
JDataRow	getMetaDataRow() Liefert eine DataRow mit den Eigenschaften des PL.
JDataSet	getMetaDataSet() Liefert einen Dataset, der alle definierten MetaDaten des Persistenz Layers umfaßt: Attribute der Klasse PL Attribute der Klasse Database (als Child von PL) Named Sequences DataTables Attribute der Klasse Request (als Child von PL) Attribute der Klasse TableRequest (als Child von Request und mit Selbst-Referenzierung) Attribute der Klasse JDataColumn (als Child von TableRequest)
static JDataTable	getMetaDataTable()
int	getMinIdle()
Database.NamedStatement	getNamedStatement(java.lang.String name) Liefert ein benanntes Statement aus PLConfix.xml
java.lang.String	getNowString()
int	getNumActive()
int	getNumIdle()
long	getOID() Liefert einen neuen eindeutigen Schlüssel für den Client.
long	getOID(java.lang.String sequenceName) Liefert einen neuen eindeutigen Key aus der angegebenen Sequence.
java.lang.String	getPLMetaData() Liefert alle Informationen zum Persistenz-Layer als XML-Document.
electric.xml.Document	getPLMetaDataDoc() Liefert den gesamten Persistenz-Layer mit all seinen Eigenschaften: Optionen des PL selbst Die Datenbank mit ihren Tabellen (aus JDBC-Metadaten) Die definierten Zugriffe (aus DatabaseConfig.xml)
Request	getRequest(java.lang.String datasetname) Liefert einen Request zu dem angegebenen Namen.
java.util.Date	getResetTimeStamp()
long	getRollbackedTransaktions()
long	getStartedTransactions()
java.text.SimpleDateFormat	getTimeFormat()
java.text.SimpleDateFormat	getTimestampFormat()
java.lang.String	getTodayNowString()
java.lang.String	getTodayString() Liefert das heutige Datum im aus PLConfig.xml.
java.util.Collection<TransactionInfo>	getTransactionInfos()
java.lang.String	getTransactionName()
int	importJournal(java.util.List<electric.xml.Document> docs)
boolean	isDebug() Liefert den Debug-Modus
java.lang.String	pingDatabase() Führt das "Ping"-Statement der Datenbank aus, wie in PLConfig unter definiert.
void	reset() Setzt den Persistenzlayer zurück.
boolean	rollbackTransaction(java.lang.String _transName) Rollback der zuvor gestarteten Transaktion.
static java.util.ArrayList<JDataValue>	rs2ArrayList(java.sql.ResultSet rs, java.sql.ResultSetMetaData meta, JDataTable tbl)
int	setDataset(JDataSet dataset) Der vom Client geänderter Dataset wird in die Datenbank zurückgeschrieben.
int	setDataset(java.lang.String dataset)
void	setDatasetAsync(JDataSet dataset) Nur bei PL verfügbar
void	setDebug(boolean state) Setzt den Debug-Modus des Persistenzlayers.
void	shutdown() Die Connection zur Datenbank wird geschlossen.
IPLContext	startNewTransaction(java.lang.String _transName)
void	startTransaction(java.lang.String _transName) Startet eine Transaktion mit dem angegebenen Namen.
boolean	testCommit() Überpüft, ob eine Transaktion mit commitTransaktion(name) beendet werden kann.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

PLTransactionContext

public PLTransactionContext(PL parentPL)

Constructor für remote Transactionen

Parameters:

parentPL -

Method Detail

getCurrentDatabase

public Database getCurrentDatabase()

Description copied from interface: IPLContext

Liefert die Datenbank

Specified by:

getCurrentDatabase in interface IPLContext

Returns:

getCurrentDatabaseName

public java.lang.String getCurrentDatabaseName()

Description copied from interface: IPLContext

Liefert den Namen der verwendeten Datenbank.

Specified by:

getCurrentDatabaseName in interface IPLContext

Specified by:

getCurrentDatabaseName in interface PLTransactionContextMBean

Returns:

String

getDatasetNames

public java.util.ArrayList<java.lang.String> getDatasetNames()

Description copied from interface: IPLContext

Liefert die Menge der definierten Datenbank-Zugriffe.

Specified by:

getDatasetNames in interface IPLContext

Returns:

isDebug

public boolean isDebug()

Description copied from interface: IPLContext

Liefert den Debug-Modus

Specified by:

isDebug in interface IPLContext

Specified by:

isDebug in interface PLTransactionContextMBean

getRequest

public Request getRequest(java.lang.String datasetname)

Description copied from interface: IPLContext

Liefert einen Request zu dem angegebenen Namen. Ist der Request noch nicht vorhanden, wird er erzeugt und in den Cache von Requests geschrieben.

Specified by:

getRequest in interface IPLContext

Returns:

getDataset

public JDataSet getDataset(java.lang.String datasetname,
                  long oid)
                    throws PLException

Description copied from interface: IPLContext

Liefert einen Dataset mit dem angegebenen Namen und dem angegebenen Primärschlüssel der Wurzeltabelle.

Specified by:

getDataset in interface IPLContext

Returns:

Throws:

PLException

getDataset

public JDataSet getDataset(java.lang.String datasetname,
                  long[] oids)
                    throws PLException

Description copied from interface: IPLContext

Liefert einen Dataset mit den angegebenen Primärschlüsseln.
TODO: Wenn kein ORDER BY definiert hängt die Reihenfolge der Rows von der Implmentierung der Datenbank ab.

Specified by:

getDataset in interface IPLContext

Returns:

Throws:

PLException

getDataset

public JDataSet getDataset(java.lang.String datasetname,
                  java.lang.String key)
                    throws PLException

Description copied from interface: IPLContext

Liefert einen Dataset mit dem angegebenen Namen und dem angegebenen Primärschlüssel der Wurzeltabelle.

Specified by:

getDataset in interface IPLContext

Returns:

Throws:

PLException

getDatasetString

public java.lang.String getDatasetString(java.lang.String datasetname,
                                long oid)
                                  throws PLException

Specified by:

getDatasetString in interface IPLContext

Throws:

PLException

getDataset

public JDataSet getDataset(java.lang.String datasetname,
                  ParameterList parameters)
                    throws PLException

Description copied from interface: IPLContext

Liefert einen Dataset mit dem angegebenen Namen sowie unter Angabe eine Liste von Parametern.

Specified by:

getDataset in interface IPLContext

Returns:

Throws:

PLException

getDatasetWhere

public JDataSet getDatasetWhere(java.lang.String datasetname,
                       java.lang.String where)
                         throws PLException

Deprecated.

Liefert einen Dataset mit der angegebenen WHERE-Bedingung.

Parameters:

datasetname -

where - Bedingung ohne das Wörtchen WHERE

Returns:

Dataset

Throws:

PLException

getNamedStatement

public Database.NamedStatement getNamedStatement(java.lang.String name)

Description copied from interface: IPLContext

Liefert ein benanntes Statement aus PLConfix.xml

Specified by:

getNamedStatement in interface IPLContext

Returns:

getDatasetStatement

public JDataSet getDatasetStatement(Database.NamedStatement nst,
                           ParameterList list)
                             throws PLException

Description copied from interface: IPLContext

Liefert einen DataSet unter Angabe eines benannten Statements.

Hinweis:
Das NameStatement kann auch aus einem abweichenden PL stammen

Specified by:

getDatasetStatement in interface IPLContext

Returns:

Throws:

PLException

getDatasetStatement

public JDataSet getDatasetStatement(java.lang.String name)
                             throws PLException

Description copied from interface: IPLContext

Liefert einen DataSet unter Angabe des Namens eines benannten Statements.

Specified by:

getDatasetStatement in interface IPLContext

Returns:

Throws:

PLException

getDatasetStatement

public JDataSet getDatasetStatement(java.lang.String name,
                           ParameterList list)
                             throws PLException

Description copied from interface: IPLContext

Liefert einen DataSet unter Angabe des Namens eines benannten Statements.

Specified by:

getDatasetStatement in interface IPLContext

list - Argumentliste für dieses Statement

Returns:

Throws:

PLException

getEmptyDataset

public JDataSet getEmptyDataset(java.lang.String datasetname)

Description copied from interface: IPLContext

Liefert einen Dataset ohne Werte aber mit den Metadaten. Wird bei der Erstellung eines neuen Datensatzes benötigt.

Specified by:

getEmptyDataset in interface IPLContext

Parameters:

datasetname - Der gewünschte Dataset

Returns:

JDataSet

getDatasetSql

public JDataSet getDatasetSql(java.lang.String tablename,
                     java.lang.String columns,
                     java.lang.String from)
                       throws PLException

Deprecated.

Description copied from interface: IPLContext

Liefert einen flachen Dataset auf Basis eines beliebigen SQL-Statements.

Specified by:

getDatasetSql in interface IPLContext

Parameters:

tablename - Tabelle zu den Columns

columns - Spaltennamen mit Komma getrennt

from - beliebige Bedingung

Returns:

Throws:

PLException

getDatasetSql

public JDataSet getDatasetSql(java.lang.String datasetname,
                     java.lang.String sql)
                       throws PLException

Description copied from interface: IPLContext

Liefert einen flachen Dataset auf Basis eines beliebigen SQL-Statements.

Achtung!
Bei Sybase müssen die angebenen Column-Namen eindeutig sein!

Specified by:

getDatasetSql in interface IPLContext

Parameters:

datasetname - ( = TableName)

sql - "SELECT a,b FROM c,d WHERE ... ORDER BY ...

Returns:

Throws:

PLException

getDatasetSql

public JDataSet getDatasetSql(java.lang.String datasetname,
                     java.lang.String sql,
                     int limit)
                       throws PLException

Specified by:

getDatasetSql in interface IPLContext

limit - Maximale Größe des ResultSet vordefinieren

Returns:

Throws:

PLException

getDatasetSql

public JDataSet getDatasetSql(java.lang.String datasetname,
                     java.lang.String sql,
                     ParameterList list)
                       throws PLException

Description copied from interface: IPLContext

Liefert einen flachen Dataset auf Basis eines beliebigen SQL-Statements.

Achtung!
Bei Sybase müssen die angebenen Column-Namen eindeutig sein!

Specified by:

getDatasetSql in interface IPLContext

Parameters:

datasetname - ( = TableName)

Returns:

Throws:

PLException

getDatasetSql

public JDataSet getDatasetSql(java.lang.String datasetname,
                     java.lang.String sql,
                     ParameterList list,
                     int limit,
                     int queryTimeout)
                       throws PLException

Throws:

PLException

getDataRowIteratorStatement

public DataRowIterator getDataRowIteratorStatement(java.lang.String statementName,
                                          ParameterList list)
                                            throws PLException

Specified by:

getDataRowIteratorStatement in interface IPLContext

Parameters:

statementName - Der Name eines benannten Statements

list - ParameterList oder null, wenn ohne Parameter

Returns:

Throws:

PLException

See Also:

#getDataRowIterator(String, String, ParameterList)

getDataRowIterator

public DataRowIterator getDataRowIterator(java.lang.String datasetname,
                                 java.lang.String tablename,
                                 java.lang.String sql,
                                 ParameterList list)
                                   throws PLException

Description copied from interface: IPLContext

Während 'normalerweise' ein DataSet vom Persistenz-Layer immer fertig aufbereitet und komplett mit allen Daten übergeben wird, ist dieses Vorgehen bei großen Datenmengen nicht angebracht, nicht nur, daß das zu lange dauert, sondern weil auch ein OutOfMemory droht.

Der RowIterator schafft dort Abhilfe.
Es wird ein DataRowIterator geliefert unter Angabe von:

Specified by:

getDataRowIterator in interface IPLContext

Parameters:

datasetname - Namens des DataSet für den RowIterator

tablename - Name der RootTable des Dataset

sql - SELECT-Statement

list - ParameterListe (darf auch null sein)

Returns:

Den RowIterator mit den gewünschten Daten.

Throws:

PLException

pingDatabase

public java.lang.String pingDatabase()
                              throws PLException

Description copied from interface: IPLContext

Führt das "Ping"-Statement der Datenbank aus, wie in PLConfig unter definiert.

Specified by:

pingDatabase in interface IPLContext

Specified by:

pingDatabase in interface PLTransactionContextMBean

Returns:

Liefert "pong" wenn alles OK, "No PingStatement defined" wenn in PLConfig keine PingStatement definiert ist.

Throws:

PLException

rs2ArrayList

public static java.util.ArrayList<JDataValue> rs2ArrayList(java.sql.ResultSet rs,
                                           java.sql.ResultSetMetaData meta,
                                           JDataTable tbl)
                                                    throws java.sql.SQLException

Parameters:

rs -

meta -

tbl -

Returns:

Throws:

java.sql.SQLException

See Also:

DataRowIterator

setDataset

public int setDataset(JDataSet dataset)
               throws PLException

Description copied from interface: IPLContext

Der vom Client geänderter Dataset wird in die Datenbank zurückgeschrieben.

Specified by:

setDataset in interface IPLContext

Throws:

PLException

setDatasetAsync

public void setDatasetAsync(JDataSet dataset)
                     throws PLException

Nur bei PL verfügbar

Specified by:

setDatasetAsync in interface IPLContext

Parameters:

dataset -

Throws:

PLException

setDataset

public int setDataset(java.lang.String dataset)
               throws PLException

Specified by:

setDataset in interface IPLContext

Throws:

PLException

importJournal

public int importJournal(java.util.List<electric.xml.Document> docs)
                  throws PLException

Specified by:

importJournal in interface IPLContext

Throws:

PLException

clearCache

public void clearCache(java.lang.String datasetname)
                throws PLException

Description copied from interface: IPLContext

Der angegebene Cache wird geleert

Specified by:

clearCache in interface IPLContext

Throws:

PLException

getAll

public JDataSet getAll(java.lang.String datasetname)
                throws PLException

Description copied from interface: IPLContext

Liefert einen Dataset ohne Angabe eines Schlüssels; also vor allem eine Menge von Datensätzen - bis zum Inhalt einer kompletten Tabelle.

Specified by:

getAll in interface IPLContext

Returns:

String

Throws:

PLException

getOID

public long getOID()
            throws PLException

Description copied from interface: IPLContext

Liefert einen neuen eindeutigen Schlüssel für den Client.

Specified by:

getOID in interface IPLContext

Returns:

long

Throws:

PLException

getOID

public long getOID(java.lang.String sequenceName)
            throws PLException

Description copied from interface: IPLContext

Liefert einen neuen eindeutigen Key aus der angegebenen Sequence. Wirft eine Exception, wenn Sequence fehlt.

Specified by:

getOID in interface IPLContext

Returns:

Throws:

PLException

executeSql

public int executeSql(java.lang.String sqlCommand)
               throws PLException

Führt ein beliebiges (NonQuery) SQL-Statement aus, welches kein Ergebnis liefern sollte.

Specified by:

executeSql in interface IPLContext

Parameters:

sqlCommand -

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

See Also:

IPLContext.getDatasetSql(java.lang.String, java.lang.String, java.lang.String)

executeSql

public int executeSql(java.lang.String sqlCommand,
             ParameterList parameters)
               throws PLException

Description copied from interface: IPLContext

Führt ein beliebiges SQL-Command aus (Update, Insert, Delete). Um beliebige Daten einzulesen siehe:

Specified by:

executeSql in interface IPLContext

Parameters:

sqlCommand - SQL-Befehl

parameters - Parameter für PreparedStatement

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

See Also:

IPLContext.getDatasetSql(java.lang.String, java.lang.String, java.lang.String)

executeSqlPara

public int executeSqlPara(java.lang.String sqlCommand,
                 java.util.Vector<java.lang.Object> parameter)
                   throws PLException

Führt ein beliebiges SQL-Statement aus, wobei die Parameter für dieses Statement in einem Vector übergeben werden.

Beispiel:

 String sql = "INSERT INTO MyTable (DateCreated) VALUES (?)";
 Vector v = new Vector();
 v.add(new Date());
 int cnt = pl.executeSqlPara(sql, v);
 

Specified by:

executeSqlPara in interface IPLContext

Parameters:

sqlCommand -

parameter -

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

executeStatement

public int executeStatement(java.lang.String name)
                     throws PLException

Description copied from interface: IPLContext

Führt ein benanntes Statement (UPDATE, INSERT, DELETE) aus.

Specified by:

executeStatement in interface IPLContext

Parameters:

name - Statement-Name

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

executeStatement

public int executeStatement(java.lang.String name,
                   ParameterList parameters)
                     throws PLException

Description copied from interface: IPLContext

Führt ein benanntes Statement (UPDATE, INSERT, DELETE) aus.

Specified by:

executeStatement in interface IPLContext

Parameters:

name - name Statement-Name

parameters - Paramter für das Statement

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

executeBatchStatement

public int executeBatchStatement(java.lang.String name)
                          throws PLException

Description copied from interface: IPLContext

Führt ein Batch-Statement aus.

Batch-Statements sind eine Menge von NamedStatements, die nacheinander als Batch ausgeführt werden.

Specified by:

executeBatchStatement in interface IPLContext

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

executeBatchStatement

public int executeBatchStatement(java.lang.String name,
                        ParameterList list)
                          throws PLException

Description copied from interface: IPLContext

Führt ein Batch-Statement aus.

Batch-Statements sind eine Menge von NamedStatements, die nacheinander als Batch ausgeführt werden.

Specified by:

executeBatchStatement in interface IPLContext

list - Eine Liste von Parametern für die Menge aller Parameter, die für die verschiedenen Statements insgesamt benötigt werden.

Returns:

Anzahl geänderter Datensätze oder 0

Throws:

PLException

startTransaction

public void startTransaction(java.lang.String _transName)
                      throws PLException

Description copied from interface: IPLContext

Startet eine Transaktion mit dem angegebenen Namen. Bei geschachtelten Transaktionen müssen die Namen eindeutig sein.

Specified by:

startTransaction in interface IPLContext

Throws:

PLException

testCommit

public boolean testCommit()
                   throws PLException

Description copied from interface: IPLContext

Überpüft, ob eine Transaktion mit commitTransaktion(name) beendet werden kann. Voraussetzung ist:

• Es ist noch mindestens eine geschachtelte Transaktion offen
• Es wurde von den anderen geschachtelten Tranaksaktionen zuvor kein Rollback ausgelöst

Specified by:

testCommit in interface IPLContext

Returns:

Throws:

PLException

commitTransaction

public boolean commitTransaction(java.lang.String _transName)
                          throws PLException

Description copied from interface: IPLContext

Beendet die Transaktion mit dem angegebenen Namen, die zuvor mit startTransaktion gestartet wurde.

Bei Angabe eines falschen Transaktionsnamens wird eine Exception geworfen.
Bei geschachtelten Transaktion wird dann eine Exception geworfen, wenn zuvor ein Rollback ausgeführt wurde.

Specified by:

commitTransaction in interface IPLContext

Throws:

PLException

rollbackTransaction

public boolean rollbackTransaction(java.lang.String _transName)
                            throws PLException

Description copied from interface: IPLContext

Rollback der zuvor gestarteten Transaktion.

Specified by:

rollbackTransaction in interface IPLContext

Throws:

PLException

startNewTransaction

public IPLContext startNewTransaction(java.lang.String _transName)
                               throws PLException

Specified by:

startNewTransaction in interface IPLContext

Throws:

PLException

getDatasetDefinitionFileName

public java.lang.String getDatasetDefinitionFileName()

Specified by:

getDatasetDefinitionFileName in interface PLTransactionContextMBean

getDateFormat

public java.text.SimpleDateFormat getDateFormat()

Description copied from interface: IPLContext

Liefert das DateFormat aus PLConfig.xml

Specified by:

getDateFormat in interface IPLContext

Returns:

getTimeFormat

public java.text.SimpleDateFormat getTimeFormat()

Specified by:

getTimeFormat in interface IPLContext

Returns:

getTimestampFormat

public java.text.SimpleDateFormat getTimestampFormat()

Specified by:

getTimestampFormat in interface IPLContext

Returns:

getMetaDataTable

public static JDataTable getMetaDataTable()

getMetaDataRow

public JDataRow getMetaDataRow()

Liefert eine DataRow mit den Eigenschaften des PL.

Returns:

getMetaDataSet

public JDataSet getMetaDataSet()

Liefert einen Dataset, der alle definierten MetaDaten des Persistenz Layers umfaßt:

• Attribute der Klasse PL
• Attribute der Klasse Database (als Child von PL)
  • Named Sequences
  • DataTables
• Attribute der Klasse Request (als Child von PL)
• Attribute der Klasse TableRequest (als Child von Request und mit Selbst-Referenzierung)
• Attribute der Klasse JDataColumn (als Child von TableRequest)

Specified by:

getMetaDataSet in interface IPLContext

Returns:

getDatabaseMetaData

public java.lang.String getDatabaseMetaData()

Liefert die Metadaten der Current Database als String

Specified by:

getDatabaseMetaData in interface IPLContext

Returns:

getDatabaseMetaDataDoc

public electric.xml.Document getDatabaseMetaDataDoc()

Liefert die Metadaten der Current Database als XML-Document

Specified by:

getDatabaseMetaDataDoc in interface IPLContext

addRequest

public Request addRequest(JDataRow metadataRow)
                   throws PLException

Erzeugt einen Request aus Metadaten

Specified by:

addRequest in interface IPLContext

Parameters:

metadataRow -

Returns:

Throws:

PLException

See Also:

Request.getMetaDataRow()

shutdown

public void shutdown()
              throws PLException

Description copied from interface: IPLContext

Die Connection zur Datenbank wird geschlossen.

Specified by:

shutdown in interface IPLContext

Throws:

PLException

getPLMetaData

public java.lang.String getPLMetaData()

Description copied from interface: IPLContext

Liefert alle Informationen zum Persistenz-Layer als XML-Document.

Specified by:

getPLMetaData in interface IPLContext

Returns:

ein XML-Dokument als String

getPLMetaDataDoc

public electric.xml.Document getPLMetaDataDoc()

Liefert den gesamten Persistenz-Layer mit all seinen Eigenschaften:

• Optionen des PL selbst
• Die Datenbank mit ihren Tabellen (aus JDBC-Metadaten)
• Die definierten Zugriffe (aus DatabaseConfig.xml)

Specified by:

getPLMetaDataDoc in interface IPLContext

Returns:

getTodayString

public java.lang.String getTodayString()

Description copied from interface: IPLContext

Liefert das heutige Datum im aus PLConfig.xml.

Achtung!
Da der PersistenzLayer üblicherweise auf einem Server läuft, kann ein Client auf diese Art aktuelle Angaben über Datum und Uhrzeit des Servers ermitteln. Dieses ist in der Regel besser als die lokale Zeit des Client zu verwenden.

Specified by:

getTodayString in interface IPLContext

Specified by:

getTodayString in interface PLTransactionContextMBean

getNowString

public java.lang.String getNowString()

Specified by:

getNowString in interface IPLContext

Specified by:

getNowString in interface PLTransactionContextMBean

getTodayNowString

public java.lang.String getTodayNowString()

Specified by:

getTodayNowString in interface IPLContext

Specified by:

getTodayNowString in interface PLTransactionContextMBean

setDebug

public void setDebug(boolean state)

Description copied from interface: IPLContext

Setzt den Debug-Modus des Persistenzlayers.

Specified by:

setDebug in interface IPLContext

Specified by:

setDebug in interface PLTransactionContextMBean

reset

public void reset()
           throws PLException

Description copied from interface: IPLContext

Setzt den Persistenzlayer zurück.

Es wird der Cache der PreparedStatements gelöscht.

Specified by:

reset in interface IPLContext

Throws:

PLException

getNumActive

public int getNumActive()

Specified by:

getNumActive in interface IPLContext

Specified by:

getNumActive in interface PLTransactionContextMBean

getNumIdle

public int getNumIdle()

Specified by:

getNumIdle in interface IPLContext

Specified by:

getNumIdle in interface PLTransactionContextMBean

getMaxActive

public int getMaxActive()

Specified by:

getMaxActive in interface IPLContext

Specified by:

getMaxActive in interface PLTransactionContextMBean

getMaxIdle

public int getMaxIdle()

Specified by:

getMaxIdle in interface IPLContext

Specified by:

getMaxIdle in interface PLTransactionContextMBean

getMinIdle

public int getMinIdle()

Specified by:

getMinIdle in interface IPLContext

Specified by:

getMinIdle in interface PLTransactionContextMBean

See Also:

IPLContext.getMinIdle()

getConnectionTimeOut

public long getConnectionTimeOut()

Specified by:

getConnectionTimeOut in interface IPLContext

getTransactionInfos

public java.util.Collection<TransactionInfo> getTransactionInfos()

Specified by:

getTransactionInfos in interface IPLContext

getAbortedTransactions

public long getAbortedTransactions()

Specified by:

getAbortedTransactions in interface PLTransactionContextMBean

Returns:

Returns the abortedTransactions.

getCommitedTransactions

public long getCommitedTransactions()

Specified by:

getCommitedTransactions in interface PLTransactionContextMBean

Returns:

Returns the commitedTransactions.

getRollbackedTransaktions

public long getRollbackedTransaktions()

Specified by:

getRollbackedTransaktions in interface PLTransactionContextMBean

Returns:

Returns the rollbackedTransaktions.

getStartedTransactions

public long getStartedTransactions()

Specified by:

getStartedTransactions in interface PLTransactionContextMBean

Returns:

Returns the startedTransactions.

getCreatedTimeStamp

public java.util.Date getCreatedTimeStamp()

Specified by:

getCreatedTimeStamp in interface PLTransactionContextMBean

Returns:

Returns the createdTimeStamp.

getResetTimeStamp

public java.util.Date getResetTimeStamp()

Specified by:

getResetTimeStamp in interface PLTransactionContextMBean

Returns:

Returns the resetTimeStamp.

getLayerName

public java.lang.String getLayerName()

getTransactionName

public java.lang.String getTransactionName()

Specified by:

getTransactionName in interface IPLContext

Returns:

bei autocommit null

See Also:

IPLContext.startNewTransaction(String)