X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=source%2Fmir%2Fstorage%2FDatabaseAdaptor.java;h=cc8e4e9b32d982173d0cb20fa754d202f70f89d3;hb=5379fccb255fc05ef109129b93b576663819c7df;hp=46c606df6ac3927de2195c1b4c174a04e9247a44;hpb=5bf2a1fa11c1529a731ab6b4521b8254c1fa100f;p=mir.git diff --git a/source/mir/storage/DatabaseAdaptor.java b/source/mir/storage/DatabaseAdaptor.java index 46c606df..cc8e4e9b 100755 --- a/source/mir/storage/DatabaseAdaptor.java +++ b/source/mir/storage/DatabaseAdaptor.java @@ -1,76 +1,100 @@ -/* - * put your module comment here - */ - - -package mir.storage; - -import java.util.*; - - -/** - * Interfacedefinition für Datenbank-Adpatoren. Die Adaptoren legen - * jeweils das Verhalten und die Befehlsmächtigkeit der Datenbank - * fest. - * - * @author - * @version 27.6.1999 - */ - -public interface DatabaseAdaptor{ - - /* Liefert den Namen der Adaptorklasse - * @return Adaptorklasse als String - */ - public abstract String getDriver (); - - - /** - * Liefert die URL für JDBC zurück, in den die Parameter user, pass und host - * eingefügt werden. Die URL wird aus der Konfiguration geholt. - * - * @param user user als String - * @param pass passwort als String - * @param host host als String - * @return url als String - */ - public abstract String getURL (String user, String pass, String host); - - - /** - * Gibt zurück, ob das SQL der Datenbank den limit-Befehl beherrscht. - * @return true wenn ja, sonst false - */ - public abstract boolean hasLimit (); - - - /** - * Liefert zurück, ob der limit-Befehl erst start und dann offset - * hat (true), oder umgekehrt. Nur Relevant, wenn hasLimit true zurückliefert. - * - * @return true wenn erstes, sonst false - */ - public abstract boolean reverseLimit (); - - - /** - * Liefert ein Properties-Objekt zurueck mit user und password. - * @param user - * @param password - * @return Properties - */ - public abstract Properties getProperties (String user, String password); - - - /** - * Gibt SQL-Stringfragment zurück, mit dem nach einem insert-Befehl ermittelt - * werden kann, wie man den primary-Key des eingefügten Datensatzes bekommt. - * - * @param theDB Database-Objekt, aus dem ggf. noetige Informationen geholt - * werden können, wie z.B. der Tabellenname - * @return SQL-Statement als String - */ - public abstract String getLastInsertSQL (Database theDB); -} - - +/* + * Copyright (C) 2001, 2002 The Mir-coders group + * + * This file is part of Mir. + * + * Mir is free software; you can redistribute it and/or modify + * it under the terms of the GNU General Public License as published by + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * Mir is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with Mir; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * + * In addition, as a special exception, The Mir-coders gives permission to link + * the code of this program with the com.oreilly.servlet library, any library + * licensed under the Apache Software License, The Sun (tm) Java Advanced + * Imaging library (JAI), The Sun JIMI library (or with modified versions of + * the above that use the same license as the above), and distribute linked + * combinations including the two. You must obey the GNU General Public + * License in all respects for all of the code used other than the above + * mentioned libraries. If you modify this file, you may extend this exception + * to your version of the file, but you are not obligated to do so. If you do + * not wish to do so, delete this exception statement from your version. + */ + +package mir.storage; + +import java.util.Properties; + +import mir.config.MirPropertiesConfiguration.PropertiesConfigExc; + + +/** + * Interfacedefinition f?r Datenbank-Adpatoren. Die Adaptoren legen + * jeweils das Verhalten und die Befehlsm?chtigkeit der Datenbank + * fest. + * + * @author + * + * @version $Id: DatabaseAdaptor.java,v 1.4 2003/01/25 17:45:19 idfx Exp $ + */ + +public interface DatabaseAdaptor{ + + /* Liefert den Namen der Adaptorklasse + * @return Adaptorklasse als String + */ + public abstract String getDriver() throws PropertiesConfigExc; + + /** + * Liefert die URL f?r JDBC zur?ck, in den die Parameter user, pass und host + * eingef?gt werden. Die URL wird aus der Konfiguration geholt. + * + * @param user user als String + * @param pass passwort als String + * @param host host als String + * @return url als String + */ + public abstract String getURL(String user, String pass, String host) + throws PropertiesConfigExc; + + /** + * Gibt zur?ck, ob das SQL der Datenbank den limit-Befehl beherrscht. + * @return true wenn ja, sonst false + */ + public abstract boolean hasLimit(); + + /** + * Liefert zur?ck, ob der limit-Befehl erst start und dann offset + * hat (true), oder umgekehrt. Nur Relevant, wenn hasLimit true zur?ckliefert. + * + * @return true wenn erstes, sonst false + */ + public abstract boolean reverseLimit(); + + /** + * Liefert ein Properties-Objekt zurueck mit user und password. + * @param user + * @param password + * @return Properties + */ + public abstract Properties getProperties(String user, String password); + + /** + * Gibt SQL-Stringfragment zur?ck, mit dem nach einem insert-Befehl ermittelt + * werden kann, wie man den primary-Key des eingef?gten Datensatzes bekommt. + * + * @param theDB Database-Objekt, aus dem ggf. noetige Informationen geholt + * werden k?nnen, wie z.B. der Tabellenname + * @return SQL-Statement als String + */ + public abstract String getLastInsertSQL(Database theDB); +} +