dataanalysis.databases
Class GenericDatabase

java.lang.Object
  |
  +--dataanalysis.databases.GenericDatabase

Direct Known Subclasses:

ClassifierDatabase, DictionaryDatabase, OperatorDB, VectorizerDatabase

public abstract class GenericDatabase

extends java.lang.Object

implements java.io.Serializable

stellt einen Prototyp dar, aus dem alle Datenbanken abgeleitet werden. Dies sind in diesem Fall die Klassifikatoren-Datenbank, das Lexikon und der Vektorisierer.
Der bevorzugte Zugriff auf Elemente der Datenbank geschieht ueber den Namen des Elementes!
Ein Beispiel zum Laden-/Speichern gibt es in der ClassifierDatabase.

Version:

1.1 (29.7.1999)

Author:

Andre Masloch

See Also:

ClassifierDatabase, Serialized Form

Field Summary

protected java.util.TreeMap	elements in dieser Variable sind die Elemente der Datenbank gespeichert.
protected java.util.TreeMap	nameNumberTranslation Da jedes Datenbankelement einen Namen besitzt (der eindeutig ist), wird zur effizienten Nutzung eine weitere TreeMap benutzt, in der die Namen als Schluessel verwendet werden.

Constructor Summary

GenericDatabase()

Method Summary

int	add(DatabaseElement element, java.lang.String name) fuegt ein neues Objekt element mit dem dazugehoehrigen Namen name in eine Datenbank ein.
int	clearAll() loescht alle Elemente aus einer Datenbank.
int	count() gibt die Anzahl der Elemente in der Datenbank aus.
int	delete(java.lang.String elementname) loescht ein Element (Objekt) elementname aus einer Datenbank.
DatabaseElement	gdGet(int elementnumber) holt ein Objekt aus einer Datenbank, das unter der uebergebenen Elementnummer elementnumber abgelegt wurde.
DatabaseElement	gdGet(java.lang.String elementname) holt ein Objekt aus einer Datenbank, das unter dem uebergebenen Elementnamen elementname abgelegt wurde.
java.lang.String	gdNameOf(int elementnumber) ermittelt den Namen des unter der uebergebenen Nummer elementnumber abgelegten Elements.
int	gdNumberOf(java.lang.String elementname) ermittelt die Nummer eines Elements ueber den Elementnamen elementnamen.
int	last()
java.lang.String	nameOf(DatabaseElement element) Die Methode ermittelt den Namen des uebergebenen Elements element.
int	numberOf(DatabaseElement element) ermittelt die Nummer des uebergebenen Elementes element.
int	optimize() ermoeglicht eine Neustrukturierung einer Datenbank.
java.lang.String	toString()

Methods inherited from class java.lang.Object

, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, wait, wait, wait

Field Detail

elements

protected java.util.TreeMap elements

in dieser Variable sind die Elemente der Datenbank gespeichert. die Schl?ssel der TreeMap sind Integer, als Wert wird dann das Datenbankobjekt benutzt.

nameNumberTranslation

protected java.util.TreeMap nameNumberTranslation

Da jedes Datenbankelement einen Namen besitzt (der eindeutig ist), wird zur effizienten Nutzung eine weitere TreeMap benutzt, in der die Namen als Schluessel verwendet werden. Als Werte werden dann Integer benutzt.

Constructor Detail

GenericDatabase

public GenericDatabase()

Method Detail

add

public int add(DatabaseElement element,
               java.lang.String name)
        throws ElementExistsException

fuegt ein neues Objekt element mit dem dazugehoehrigen Namen name in eine Datenbank ein.

Parameters:

element - enthaelt das Element, dass in die Datenbank eingefuegt werden soll.

name - spezifiziert den Namen, den das Element bekommen soll. Jeder Name darf nur ein Mal existieren!

Returns:

die Nummer des Elements in der Datenbank (eindeutig, aber nicht konstant (d.h. die Nummer aendert sich, wenn das Element entfernt, und wieder hinzugefuegt wird)!).

Throws:

ElementExistsException - wenn ein Element eingefuegt werden soll, dessen Name in der Datenbank schon vergeben ist.

delete

public int delete(java.lang.String elementname)
           throws DatabasesElementNotFoundException

loescht ein Element (Objekt) elementname aus einer Datenbank.

Parameters:

elementname - enthaelt den Namen des Elements, das aus der Datenbank entfernt werden soll.

Returns:

moegliche Kodierung einer Mitteilung.

Throws:

DatabasesElementNotFoundException - wenn ein Element nicht gefunden werden konnte.

gdGet

public DatabaseElement gdGet(int elementnumber)
                      throws DatabasesElementNotFoundException

holt ein Objekt aus einer Datenbank, das unter der uebergebenen Elementnummer elementnumber abgelegt wurde.
Es besteht aber auch die Moeglichkeit das Element ueber seinen Namen aus einer Datenbank zu lesen.

Parameters:

elementnumber - steht fuer die Nummer des Elements, das gesucht wird.

Returns:

das Element, das unter der uebergebenen Nummer abgelegt war.

Throws:

DatabasesElementNotFoundException - wird ausgeloest, wenn ein Element angefordert wurde, dass nicht in der Datenbank vorhanden ist.

gdGet

public DatabaseElement gdGet(java.lang.String elementname)
                      throws DatabasesElementNotFoundException

holt ein Objekt aus einer Datenbank, das unter dem uebergebenen Elementnamen elementname abgelegt wurde.
Es besteht auch die Moeglichkeit das Element ueber seine Elementnummer aus einer Datenbank zu lesen.

Parameters:

elementname - steht fuer den Namen des Elements, das gesucht wird.

Returns:

das Element, das unter dem angegebenen Namen abgelegt war.

Throws:

DatabasesElementNotFoundException - wird ausgeloest, wenn ein Element angefordert wurde, dass nicht in der Datenbank vorhanden ist.

gdNameOf

public java.lang.String gdNameOf(int elementnumber)
                          throws DatabasesElementNotFoundException

ermittelt den Namen des unter der uebergebenen Nummer elementnumber abgelegten Elements.
Es besteht auch die Moeglichkeit den Namen zu ermitteln, indem das gesamte Element uebergeben wird.

Parameters:

elementnumber - steht fuer die Nummer des Elements, das ausgegeben werden soll.

Returns:

der Name des Elements mit der angebenen Nummer.

Throws:

DatabasesElementNotFoundException - wird ausgeloest, wenn ein Element angefordert wurde, dass nicht in der Datenbank vorhanden ist.

nameOf

public java.lang.String nameOf(DatabaseElement element)
                        throws DatabasesElementNotFoundException

Die Methode ermittelt den Namen des uebergebenen Elements element.
Es besteht auch die Moeglichkeit den Namen eines Elements ueber die Elementennummer zu erhalten.

Parameters:

element - steht fuer das Element, fuer den der Name ausgegeben werden soll.

Returns:

die Ausgabe des Namens des uebergebenen Elements

Throws:

DatabasesElementNotFoundException - wird ausgeloest, wenn ein Element angefordert wurde, dass nicht in der Datenbank vorhanden ist.

numberOf

public int numberOf(DatabaseElement element)
             throws DatabasesElementNotFoundException

ermittelt die Nummer des uebergebenen Elementes element.
Es besteht auch die Moeglichkeit die Nummer ueber den Elementnamen zu erhalten.

Parameters:

element - steht fuer das Element, von dem die Nummer gesucht werden soll.

Returns:

die Nummer des angegebenen Elements

Throws:

DatabasesElementNotFoundException - wird ausgeloest, wenn ein Element angefordert wurde, dass nicht in der Datenbank vorhanden ist.

See Also:

gdNumberOf(String)

gdNumberOf

public int gdNumberOf(java.lang.String elementname)
               throws DatabasesElementNotFoundException

ermittelt die Nummer eines Elements ueber den Elementnamen elementnamen.
Es besteht ebenfalls die Moeglichkeit die Nummer ueber das Element selbst auszulesen.

Parameters:

elementname - steht fuer den Namen eines Elements, fuer das die Nummer ausgegeben werden soll.

Returns:

Nummer des unter dem Elementnamen abgelegten Elements.

Throws:

DatabasesElementNotFoundException - wird ausgeloest, wenn ein Element angefordert wurde, dass nicht in der Datenbank vorhanden ist.

See Also:

numberOf(DatabaseElement)

clearAll

public int clearAll()
             throws DeleteErrorException

loescht alle Elemente aus einer Datenbank.

Returns:

Kodierung fuer eine Meldung (optional)

Throws:

DeleteErrorException - Bei dem Versuch, die Elemente zu loeschen ist ein Fehler aufgetreten.

optimize

public int optimize()

ermoeglicht eine Neustrukturierung einer Datenbank.

Returns:

Kodierung fuer eine moegliche Meldung (optional).

count

public int count()

gibt die Anzahl der Elemente in der Datenbank aus.

Returns:

die Anzahl aller Elemente einer Datenbank.

last

public int last()

Returns:

gibt die groesste Elementnummer aus.

Since:

1.1

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

Since:

1.2