ch.elexis.befunde
Class Messwert

java.lang.Object
  ch.elexis.data.PersistentObject
      ch.elexis.befunde.Messwert

All Implemented Interfaces:

IPersistentObject, ISelectable

public class Messwert
extends PersistentObject

Here we define our own data type for our "measurements"-Plugin. The Type is derived from ch.elexis.data.PersistentObject, and thereby the mananagement of the object persistence is completely delegated to elexis. The Method getSetup() creates (if necessary) a new table for our type. Some methods are required for every class derived from PersistentObject to work properly. Those methods are herafter marked with -required- Hier wird ein eigener Datentyp für unser "Messwerte"-Plugin definiert. Der Datentyp wird von PersistentObject abgeleitet, was das Persistenzmanagement an Elexis delegiert. In der Methode getSetup() wird wenn nötig eine neue Tabelle zur Speicherung der Daten dieses Datentyps erstellt. Einige Methoden _müssen_ vorhanden sein, damit eine von PersistentObject abgeleitetes Klasse korrekt funktioniert. Diese sind im Folgenden mit -Zwingend- markiert.

Nested Class Summary

Nested classes/interfaces inherited from class ch.elexis.data.PersistentObject

PersistentObject.FieldType

Field Summary

static java.lang.String	_FIELDS
static java.lang.String	FLD_BEFUNDE
static java.lang.String	FLD_NAME
static java.lang.String	FLD_PATIENT_ID
static java.lang.String	HASH_NAMES
static java.lang.String	PLUGIN_ID
static java.lang.String	SETUP_CHECKSEPARATOR
static java.lang.String	SETUP_SEPARATOR
static int	VERSION

Fields inherited from class ch.elexis.data.PersistentObject

CACHE_DEFAULT_LIFETIME, CACHE_MIN_LIFETIME, CFG_CONNECTSTRING, CFG_DRIVER, CFG_FOLDED_CONNECTION, CFG_PWD, CFG_TYPE, CFG_USER, DATE_COMPOUND, default_lifetime, DELETED, EXISTS, FLD_DATE, FLD_DELETED, FLD_EXTINFO, FLD_LASTUPDATE, INEXISTENT, INVALID_ID, log, MAPPING_ERROR_MARKER, MATCH_AUTO, MATCH_CONTAINS, MATCH_EXACT, MATCH_REGEXP, MATCH_START

Fields inherited from interface ch.elexis.core.data.IPersistentObject

FLD_ID, STATE_EXISTING, STATE_INEXISTENT, STATE_INVALID_ID

Constructor Summary

protected	Messwert() The empty constructor is only needed by the factory and should never be public.
	Messwert(Patient pat, java.lang.String name, java.lang.String date, java.util.Map bf) This is the only public constructor.
protected	Messwert(java.lang.String id) The constructror with a single String is used to load objects from the database and should never be called directly.

Method Summary

java.lang.String	getDate()
java.lang.String	getLabel() a concise, human readable indentification for the measurement.
java.lang.String	getResult(java.lang.String field)
static Messwert	getSetup() Here are configuration details read.
protected java.lang.String	getTableName() -required- Name of the table, where objects of this class should be persisted.
static Messwert	load(java.lang.String id) -required- This is the standard method to construct a PersistentObject from its representation in the database.

Methods inherited from class ch.elexis.data.PersistentObject

addChangeListener, addMapping, addSticker, addToList, addXid, begin, checkNull, checkZero, checkZeroDouble, clearCache, connect, connect, create, createOrModifyTable, delete, deleteList, disconnect, equals, executeScript, executeSQLScript, exists, exportData, flatten, fold, get, get, getBinary, getCacheTime, getConnection, getConstraint, getDefaultCacheLifetime, getExportFields, getExportUIDValue, getExportUIDVersion, getFieldType, getId, getInt, getLastUpdate, getList, getList, getMap, getSticker, getStickers, getVersionedResource, getWrappedId, getXid, getXid, getXids, hashCode, isAvailable, isDeleted, isDragOK, isMatching, isMatching, isMatching, isMatching, isValid, lock, map, removeChangeListener, removeFromList, removeFromList, removeSticker, removeTable, resetCache, set, set, setBinary, setConstraint, setDefaultCacheLifetime, setInt, setMap, setTrace, setVersionedResource, state, storeToString, tableExists, ts, undelete, unlock

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

HASH_NAMES

public static final java.lang.String HASH_NAMES

See Also:

Constant Field Values

_FIELDS

public static final java.lang.String _FIELDS

See Also:

Constant Field Values

FLD_BEFUNDE

public static final java.lang.String FLD_BEFUNDE

See Also:

Constant Field Values

FLD_NAME

public static final java.lang.String FLD_NAME

See Also:

Constant Field Values

FLD_PATIENT_ID

public static final java.lang.String FLD_PATIENT_ID

See Also:

Constant Field Values

VERSION

public static final int VERSION

See Also:

Constant Field Values

PLUGIN_ID

public static final java.lang.String PLUGIN_ID

See Also:

Constant Field Values

SETUP_SEPARATOR

public static final java.lang.String SETUP_SEPARATOR

See Also:

Constant Field Values

SETUP_CHECKSEPARATOR

public static final java.lang.String SETUP_CHECKSEPARATOR

See Also:

Constant Field Values

Constructor Detail

Messwert

public Messwert(Patient pat,
                java.lang.String name,
                java.lang.String date,
                java.util.Map bf)

This is the only public constructor. The parameterless constructor should never be used, as it does not create the object in the database. The constructor with a single string parameter should never be called from outside the class itself. Dies ist der einzige öffentliche Konstruktor. Der parameterlose Konstruktor sollte nie verwendet werden, da er das Objekt nicht persistiert, und der Konstruktor mit einem einzelnen String Element sollte nie direkt aufgerufen werden (s. dort)

Parameters:

pat - Der Patient, dem dieser Messwert zugeordnet werden soll

name - Name des Messwerts

date - Datum des Messwerts

bf - Der Messwert in beliebige komplexer Form, wird als Black Box betrachtet

Messwert

protected Messwert()

The empty constructor is only needed by the factory and should never be public. Der parameterlose Konstruktor wird nur von der Factory gebraucht und sollte nie public sein.

Messwert

protected Messwert(java.lang.String id)

The constructror with a single String is used to load objects from the database and should never be called directly. For that purpose is instead the static method load() to be used. This constructor should always be defined exactly the same way as shown below. It loads the object "lazily", what means that an access to the database will not occur until a member of the object is needed. This means, that the constructor will always succeed, even if the accessed object does not exist or is not valid. The caller could check this with exists() or isValid(), but this would mean an (in most cases unneccessary= database access. Der Konstruktor mit einem String dient dem Einlesen von Objekten aus der Datenbank und sollte nie direkt aufgerufen werden. Hierfür dient die statische Methode load(). Dieser Konstruktor sollte immer genauso definiert werden, wie hier gezeigt. Er lädt das Objekt "lazy", das heisst, ein tatsächlicher Zugriff auf die Datenbank erfolgt erst dann, wenn ein Member des Objekts benötigt wird. Dies bedeutet aber auch, dass der Konstruktor scheinbar erfolgreich war, das Objekt das er zurückliefert, aber nicht existieren oder nicht gültig sein muss. Dies kann mit isValid() bzw. exists() geprüft werden (Was allerdings einen meist unnötigen Datenbankzugriff bewirkt)

Parameters:

id -

Method Detail

getDate

public java.lang.String getDate()

getLabel

public java.lang.String getLabel()

a concise, human readable indentification for the measurement. Subclasses should always override this, because the abse implementation of PersistentObject gives only an empty string. Eine kurze menschenlesbare Identifikation für den Messwert liefern. Sollte überschrieben werden; die Standardimplementation von PersistentObject liefert einfach einen Leerstring zurück.

Specified by:

getLabel in interface IPersistentObject

Specified by:

getLabel in class PersistentObject

getResult

public java.lang.String getResult(java.lang.String field)

getTableName

protected java.lang.String getTableName()

-required- Name of the table, where objects of this class should be persisted. See remarks above near the field TABLENAME -Zwingend- Name der Tabelle, in der Objekte dieser Klasse persistiert werden sollen

Specified by:

getTableName in class PersistentObject

Returns:

Der Name einer bereits existierenden Tabelle der Datenbank

getSetup

public static Messwert getSetup()

Here are configuration details read. If reading fails, the method assumes, that the table does not exist yet an creates it. Hier werden Konfigurationseinzelheiten eingelesen. Wenn das Lesen fehlschlägt, nimmt die Methode an, dass die Tabelle noch nicht existiert und legt sie neu an.

Returns:

load

public static Messwert load(java.lang.String id)

-required- This is the standard method to construct a PersistentObject from its representation in the database. For semantic reasons we intenionally do not use the "new" constructor for that purpose. "New" should only be used to create really "new" Objects and not to load existing objects from the database. Internally, however, load simply calls new(String). The static method load(String) must exist in every sublclass of PersistentObject, but it can always be written just exacly as here. The method needs not to guarantee that the returned object exists. It can, if desired, return a null value to indicate a inexistent object. Here we return just whatever the superclass gives us. -Zwingend- Dies ist die Standardmethode zum Konstruieren eines PersistentObjects aus der Datenbank. Aus semantischen Gründen wurde hierfür bewusst nicht der "new" Konstruktor verwendet. "New" bleibt gegen aussen für die Erstellung "neuer" Objekte reserviert. Intern allerdings ruft load einfach new(String) auf. Das kann immer exakt so formuliert werden.

Parameters:

id - ID des zu ladenden Objektes

Returns:

Das Objekt (kann auch null oder inexistent sein)