org.makumba.Database
Should use org.makumba.Transaction instead This class models operations with a database. To obtain such
an object, use methods from MakumbaSystem.
Stricly speaking this class represents a database connection (later on, transaction). Obtaining more such
objects for the same database configurations will result in opening more connections. Connections must be
given back to the system using the Database.close() method. That will be done automatically by the
object's finalizer. In makumba business logic, connections passed to the BL methods are automatically
closed by the system after the BL operations (including eventual automatic DB acceses) were completed. To
open a "sibling" of a connection conn of this type, use
MakumbaSystem.getConnectionTo(conn.getName()). In most cases, you will have to close the sibling
yourself.
At the level of this API, data is represented as java.util.Dictionary, both for reading and writing. Most
methods throw DBError if a fatal database error occurs. If the connection to the database is
lost, an attempt is made to reconnect before throwing a DBError.
All methods throw subclasses of either Error or RuntimeException, so nothing needs to be caught
explicitely. |
