/**
* Base class the entities are derived from. Provides base functionality of
- * an entity<p>
+ * an entity. Entities are used to represent rows of a database table.<p>
*/
}
/**
- * Konstruktor
+ * Constructor
+ * @param StorageObject The StorageObject of the Entity.
*/
public Entity (StorageObject StorageObject) {
this();
}
/*
- * Setzt das StorageObject der Entity.
+ * Sets the StorageObject of the Entity.
*/
public void setStorage (StorageObject storage) {
this.theStorageObject = storage;
}
/**
- * Setzt die Werte der Entity
- * @param theStringValues
+ * Sets the values of the Entity.
+ * @param theStringValues HashMap containing the new values of the Entity
*/
public void setValues(HashMap theStringValues)
}
/**
- * Liefert boolschen Wert, ob sich der Inhalt der Entity geändert hat.
+ * Returns whether the content of the Entity has changed.
* @return true wenn ja, sonst false
*/
public boolean changed () {
}
/**
- * Liefert den Primärschluessel der Entity zurueck
+ * Returns the primary key of the Entity.
* @return String Id
*/
public String getId () {
}
/**
- * Setzt den Primaerschluessel der Entity
+ * Defines the primary key of the Entity
* @param id
*/
public void setId (String id) {
}
/**
- * Liefert den Wert für einen Feldnamen zurueck
- * @param theFieldString
- * @return Wert für Feld
+ * Returns the value of a field by field name.
+ * @param field The name of the field
+ * @return value of the field
*/
public String getValue (String field) {
String returnValue = null;
}
/**
- * Fügt Entity via StorageObject in Datenbank ein.
- * @return Primary Key der Entity
+ * Insers Entity into the database via StorageObject
+ * @return Primary Key of the Entity
* @exception StorageObjectException
*/
public String insert () throws StorageObjectException {
}
/**
- * Aktualisiert Aenderungen an der Entity in der Datenbank
+ * Saves changes of this Entity to the database
* @exception StorageObjectException
*/
public void update () throws StorageObjectException {
}
/**
- * Setzt den Wert fuer ein Feld
- * @param theProp
- * @param theValue
+ * Sets the value for a field. Issues a log message if the field name supplied was not found in the Entity.
+ * @param theProp The field name whose value has to be set
+ * @param theValue The new value of the field
* @exception StorageObjectException
*/
public void setValueForProperty (String theProp, String theValue) throws StorageObjectException {
}
/**
- * Gibt die Feldnamen der Entity als ArrayList zurueck
- * @return ArrayList mit Feldnamen
- * @exception StorageObjectException wird geworfen, wenn kein Zugriff auf die Datenbank
- * möglich.
+ * Returns the field names of the Entity as ArrayListe.
+ * @return ArrayList with field names
+ * @exception StorageObjectException is throuwn if database access was impossible
*/
public ArrayList getFields () throws StorageObjectException {
return theStorageObject.getFields();
}
/**
- * Liefert ein int[] mit den Typen der Felder zurueck
- * @return int[] mit den Feldtypen
+ * Returns an int[] with the types of the fields
+ * @return int[] that contains the types of the fields
* @exception StorageObjectException
*/
public int[] getTypes () throws StorageObjectException {
}
/**
- * Liefert ArrayListe mit Feldnamen zurueck.
- * @return Liste mit Feldnamen
+ * Returns an ArrayList with field names
+ * @return List with field names
* @exception StorageObjectException
*/
public ArrayList getLabels () throws StorageObjectException {
}
/**
- * Liefert eine Hashmap mit allen Werten der Entity zurueck
- * @return HashMap mit Feldname/Wert
+ * Returns a Hashmap with all values of the Entity.
+ * @return HashMap with field name as key and the corresponding values
*
* @deprecated This method is deprecated and will be deleted in the next release.
* Entity interfaces freemarker.template.TemplateHashModel now and can
}
/**
+ * Returns an ArrayList with all database fields that can
+ * be evaluated as streamedInput.
+ * Could be automated by the types (blob, etc.)
+ * Until now to be created manually in the inheriting class
+ *
* Liefert einen ArrayList mit allen Datenbankfeldern, die
* als streamedInput ausgelesen werden muessen.
* Waere automatisierbar ueber die types (blob, etc.)
return streamedInput;
}
- /* Fragt ab, ob fieldName einem Feld entspricht
+ /** Returns whether fieldName is a valid field name of this Entity.
* @param fieldName
- * @return true, wennn ja, sonst false
+ * @return true in case fieldName is a field name, else false.
* @exception StorageObjectException
*/
public boolean isField (String fieldName) throws StorageObjectException {
return theStorageObject.getFields().contains(fieldName);
}
- /** Liefert Anzahl der Instanzen zurück
- * @return int
+ /** Returns the number of instances of this Entity
+ * @return int The number of instances
*/
public int getInstances() {
return instances;
}
/**
- * Gibt eine Instanz frei
+ * Frees an instance
*/
/*public void finalize () {
instances--;