Archived Website: This website is a static snapshot for archival purposes only. It is no longer maintained or updated.

knowledge
Class A_Box

java.lang.Object
  |
  +--knowledge.A_Box
public class A_Box
extends java.lang.Object
implements java.io.Serializable, java.lang.Cloneable

Die A-Box ist eine Liste aller Instanzen. Es gibt eine globale suchuebergreifende A-Box und fuer jede Planausfuehrung eine lokale.

Version:
2.2 [10.02.00]
Author:
Volkher Kaschlun, Ulla Mentel
See Also:
Serialized Form

Field Summary
 java.util.LinkedList ConcreteRolesList
           
(package private) static long serialVersionUID
          serialVersionUID
private  java.util.LinkedList theConstraintInstances
           
private  java.util.Hashtable theInstanceHashTable
          Der Hashtable aller Instanzen.
protected  T_Box theTBox
           
 
Constructor Summary
(package private) A_Box()
          Konstruktor der Klasse A_Box
  A_Box(T_Box t)
          Konstruktor der Klasse A_Box
 
Method Summary
 void clean(java.util.Calendar theDeleteDate, java.util.LinkedList theUndeleteConcepts)
          Entfernt Instanzen mit dem ältesten Datum des letzten Zugriffs (simuliert das Vergessen) Soll nur vom Instanzenlerner aufgerufen werden
 java.lang.Object clone()
          Liefert eine tiefe Kopie der globalen A-Box.
private  void computeNextInstanceID()
           
private  Instance createInstanceClone(Instance theInstance)
          Erzeugt ein neue Objekt der Klasse Instanz, wobei die ID, der Name und alle Flags von der uebergebenen Instanz kopiert werden.
private  void deleteInstance(Instance theInstance)
          deleteInstance loescht eine Instanz endgueltig aus der A-Box.
 java.util.LinkedList find(java.lang.String instanceName)
          Sucht zum gegeben Namen die Instanzen mit gleichem Namen.
 ConcreteRole getConcreteRole(Role theRole, Instance from, Instance to)
          Sucht die konkrete Rolle, die unter die übergebene Konzept-Rolle fällt und von der Instanz from zu der Instanz to verläuft.
 java.util.LinkedList getConcreteRoles(Role theRole)
          Zu einer Konzeptrolle wird eine Liste aller konkreten Rolle geliefert.
 java.util.LinkedList getConstraintInstances()
           
 NetEntity getContents(Instance i)
          liefert ein optional zu einer Instanz vorhandenes Inhaltsobjekt zurueck
 Instance getInstance(long id)
          liefert zu der ID die Instanz
 java.util.LinkedList getInstances(Concept theConcept)
           
 java.util.LinkedList getOneLevelInstances(Concept theConcept)
           
 T_Box getT_Box()
          Liefert einen Verweis auf die T-Box
 boolean insertNewRole(Role theRole, Instance from, Instance to, double probability)
          Fügt eine neue Rolle und ihre Inverse ein.
 void load(java.lang.String fileName)
          Lädt die globale A-Box.
 void markAsConstraint(Instance i)
          markiert eine Instanz als constraint
 void merge(A_Box theLocaleABox)
          Soll nur vom Instanzenlerner aufgerufen werden
private  void readObject(java.io.ObjectInputStream in)
           
 void save(java.lang.String fileName)
          Speichert die globale A-Box.
 void setContents(Instance i, NetEntity c)
          speichert ein optional vorhandenes Inhaltsobjekt zur gegebenen Instanz
 boolean setInstance(Instance theInstance)
          Fuegt eine neue Instanz in die A-Box ein, sollte schon eine Instanz unter diesem Schlü existieren, wird sie überschieben.
 java.lang.String toString()
          Gibt eine die A-Box beschreibenden String aus.
 void update(java.util.LinkedList theStartConcepts)
          Soll nur vom Instanzenlerner aufgerufen werden
 
Methods inherited from class java.lang.Object
, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, wait, wait, wait
 

Field Detail

serialVersionUID

static final long serialVersionUID
serialVersionUID

theInstanceHashTable

private java.util.Hashtable theInstanceHashTable
Der Hashtable aller Instanzen.

theTBox

protected T_Box theTBox

theConstraintInstances

private java.util.LinkedList theConstraintInstances

ConcreteRolesList

public java.util.LinkedList ConcreteRolesList
Constructor Detail

A_Box

public A_Box(T_Box t)
Konstruktor der Klasse A_Box
Parameters:
t - Die zugehörige T-Box
Since:
1.0
See Also:
T_Box

A_Box

A_Box()
Konstruktor der Klasse A_Box
Since:
1.0
Method Detail

getOneLevelInstances

public java.util.LinkedList getOneLevelInstances(Concept theConcept)
Parameters:
theConcept - Ein Konzept aus der T-Box
Returns:
Liste mit allen Instanzen, die genau zu dem gegebenen Konzept gehoeren und für die delete false ist.
Since:
1.0
See Also:
Concept, Instance, T_Box, LinkedList

setInstance

public boolean setInstance(Instance theInstance)
Fuegt eine neue Instanz in die A-Box ein, sollte schon eine Instanz unter diesem Schlü existieren, wird sie überschieben.
Parameters:
theInstance - Ein Objekt der Klasse Instance
Returns:
true, wenn die Instanz in der A-Box neue eingefügt wurde und false wenn sie schon vorhanden war.
Since:
1.0
See Also:
Instance

getInstances

public java.util.LinkedList getInstances(Concept theConcept)
Parameters:
theConcept - Ein Konzept aus der T-Box
Returns:
Liste mit allen Instanzen, für die delete false ist und das gegebene Konzept subsumieren.
Since:
1.0
See Also:
Concept, Instance, T_Box, LinkedList

getInstance

public Instance getInstance(long id)
liefert zu der ID die Instanz
Parameters:
id - Die ID zur gesuchten Instanz
Returns:
Die gesuchte Instanz oder null
Since:
1.0
See Also:
Instance

markAsConstraint

public void markAsConstraint(Instance i)
markiert eine Instanz als constraint
Parameters:
i - die zu markierende Instanz
Since:
1.0

getConstraintInstances

public java.util.LinkedList getConstraintInstances()
Returns:
LinkedList eine Liste mit den als constraint markierten Instanzen
Since:
1.0

insertNewRole

public boolean insertNewRole(Role theRole,
                             Instance from,
                             Instance to,
                             double probability)
                      throws RoleNotFoundException,
                             ConcreteRoleAddInstanceException
Fügt eine neue Rolle und ihre Inverse ein. Die Rolle kann auch in den Oberkonzepten von dem Objekt from definiert sein.
Parameters:
theRole - Die konzeptionelle Rolle
from - Die Instanz, von der die Rolle ausgeht
to - Die Instanz, auf die die Rolle verweist
probability - der Konfidenzwert dieser konkreten Rolle
Returns:
true wenn die Rolle neu eingefügt wurde, und false wenn sie schon vorhanden war.
Since:
1.0
See Also:
Instance, ConcreteRole, Role

find

public java.util.LinkedList find(java.lang.String instanceName)
Sucht zum gegeben Namen die Instanzen mit gleichem Namen.
Parameters:
instanceName - Der Name der gesuchten Instanz
Returns:
Eine Liste von Instanzen oder null, falls keine passende Instanz gefunden wurde.
Since:
1.0
See Also:
Instance

setContents

public void setContents(Instance i,
                        NetEntity c)
speichert ein optional vorhandenes Inhaltsobjekt zur gegebenen Instanz
Parameters:
i - die Instanz, zu der ein Inhalt gespeichert werden soll.
c - ein Objekt vom Typ NetEntity
Since:
2.1
See Also:
NetEntity, Instance

getContents

public NetEntity getContents(Instance i)
liefert ein optional zu einer Instanz vorhandenes Inhaltsobjekt zurueck
Parameters:
i - die Instanz, dessen Inhalt angefragt wird.
Returns:
ein Objekt vom Typ NetEntity
Since:
2.1
See Also:
Contents

getT_Box

public T_Box getT_Box()
Liefert einen Verweis auf die T-Box
Returns:
Referenz auf dazugehörigen T-Box
Since:
2.0
See Also:
T_Box

createInstanceClone

private Instance createInstanceClone(Instance theInstance)
Erzeugt ein neue Objekt der Klasse Instanz, wobei die ID, der Name und alle Flags von der uebergebenen Instanz kopiert werden.
Parameters:
theInstance - die Instanz, die kopiert werden soll
Since:
2.2

clone

public java.lang.Object clone()
Liefert eine tiefe Kopie der globalen A-Box.
Returns:
Ein Objekt der Klasse A_Box
Overrides:
clone in class java.lang.Object
Since:
1.0

load

public void load(java.lang.String fileName)
          throws java.io.IOException,
                 ABoxLoadErrorException
Lädt die globale A-Box.
Parameters:
fileName - Der Dateiname, unter welchem die Datei gespeichert ist. Wird kein vollständiger Pfad angegeben, wird vom aktuellen Verzeichnis ausgehend gesucht.
Since:
1.0

save

public void save(java.lang.String fileName)
          throws java.io.IOException
Speichert die globale A-Box.
Parameters:
fileName - Der Dateiname, unter welchem die Datei gespeichert ist. Wird kein vollständiger Pfad angegeben, wird vom aktuellen Verzeichnis ausgehend gesucht.
Since:
1.0

getConcreteRole

public ConcreteRole getConcreteRole(Role theRole,
                                    Instance from,
                                    Instance to)
Sucht die konkrete Rolle, die unter die übergebene Konzept-Rolle fällt und von der Instanz from zu der Instanz to verläuft.
Parameters:
theRole - Die konzeptionelle Rolle
from - Die Instanz, von der die Rolle ausgeht
to - Die Instanz, auf die die Rolle verweist
Returns:
Ein Objekt der Klasse ConcreteRole, wenn eine passende Rolle existier, ansonsten null
Since:
2.1

getConcreteRoles

public java.util.LinkedList getConcreteRoles(Role theRole)
Zu einer Konzeptrolle wird eine Liste aller konkreten Rolle geliefert.
Parameters:
theRole - Die Konzeptrolle, zu der alle konkreten Rollen gesucht werden sollen.
Returns:
LinkedList Liste aller konkreten Rollen
Since:
1.0
See Also:
Role, ConcreteRole

update

public void update(java.util.LinkedList theStartConcepts)
Soll nur vom Instanzenlerner aufgerufen werden
Parameters:
theStartConcepts - Liste mit den Konzepten, deren Instanzen nicht in die globale A-Box übernommen werden sollen.
Since:
1.0

merge

public void merge(A_Box theLocaleABox)
Soll nur vom Instanzenlerner aufgerufen werden
Parameters:
theLocaleABox - Die lokale A-Box, deren Inhalt in die globale transferiert werden soll
Since:
2.1

clean

public void clean(java.util.Calendar theDeleteDate,
                  java.util.LinkedList theUndeleteConcepts)
Entfernt Instanzen mit dem ältesten Datum des letzten Zugriffs (simuliert das Vergessen) Soll nur vom Instanzenlerner aufgerufen werden
Parameters:
theDeleteDate - Das Datum bestimmt, daß Instanzen gelöscht werden, deren letzter Zugriff zeitlich davor liegt.
theUndeleteConcepts - Die Konzepte, deren Instanzen niemals geloescht werden sollen.
Since:
2.1

toString

public java.lang.String toString()
Gibt eine die A-Box beschreibenden String aus.
Returns:
Ein String der Form "A-Box {, ... }"
Overrides:
toString in class java.lang.Object
Since:
1.0

deleteInstance

private void deleteInstance(Instance theInstance)
deleteInstance loescht eine Instanz endgueltig aus der A-Box. Auch alle konkreten Rollen die an dieser Instanz haengen, werden endgueltig geloescht.
Since:
2.1

computeNextInstanceID

private void computeNextInstanceID()
Since:
2.0

readObject

private void readObject(java.io.ObjectInputStream in)
                 throws java.io.IOException,
                        java.lang.ClassNotFoundException
Since:
2.0