public interface Data extends java.lang.Iterable<Data>
ClientDavInterface.createData(de.bsvrz.dav.daf.main.config.AttributeGroup)
benutzt werden. Nach dem Empfang von Daten kann mit der Methode ResultData.getData()
der im Ergebnis enthaltene
Datensatz abgefragt werden.Modifier and Type | Interface and Description |
---|---|
static interface |
Data.Array
Interface-Klasse für die Array-Ansicht eines Datums.
|
static class |
Data.FormatException
Ausnahme, die ein fehlerhaften Zugriff oder eine nicht zugelassene Konvertierung von Elementen eines Datensatzes signalisiert.
|
static interface |
Data.NumberArray
Interface-Klasse für die Skalierte- und Unskalierte-Array-Ansicht eines Datums.
|
static interface |
Data.NumberValue
Interface-Klasse für die Skalierte- und Unskalierte-Ansicht eines Datums.
|
static interface |
Data.ReferenceArray
Interface-Klasse für die Referenz-Array-Ansicht eines Datums.
|
static interface |
Data.ReferenceValue
Interface-Klasse für die Referenz-Ansicht eines Datums.
|
static interface |
Data.TextArray
Interface-Klasse für die Text-Array-Ansicht eines Datums.
|
static interface |
Data.TextValue
Interface-Klasse für die Text-Ansicht eines Datums.
|
static interface |
Data.TimeArray
Interface-Klasse für die Zeit-Array-Ansicht eines Datums.
|
static interface |
Data.TimeValue
Interface-Klasse für die Zeit-Ansicht eines Datums.
|
Modifier and Type | Method and Description |
---|---|
Data.Array |
asArray()
Liefert eine Array-Ansicht auf dieses Array zurück.
|
Data.ReferenceArray |
asReferenceArray()
Liefert eine Referenz-Array-Ansicht auf dieses Array zurück.
|
Data.ReferenceValue |
asReferenceValue()
Liefert eine Referenz-Ansicht auf dieses einfache Datum zurück.
|
Data.NumberArray |
asScaledArray()
Liefert eine Skalierte-Array-Ansicht auf dieses Array zurück.
|
Data.NumberValue |
asScaledValue()
Liefert eine Skalierte-Ansicht auf dieses einfache Datum zurück.
|
Data.TextArray |
asTextArray()
Liefert eine Text-Array-Ansicht auf dieses Array zurück.
|
Data.TextValue |
asTextValue()
Liefert eine Text-Ansicht auf dieses einfache Datum zurück.
|
Data.TimeArray |
asTimeArray()
Liefert eine Time-Array-Ansicht auf dieses Array zurück.
|
Data.TimeValue |
asTimeValue()
Liefert eine Zeit-Ansicht auf dieses einfache Datum zurück.
|
Data.NumberArray |
asUnscaledArray()
Liefert eine Unskalierte-Array-Ansicht auf dieses Array zurück.
|
Data.NumberValue |
asUnscaledValue()
Liefert eine Unskalierte-Ansicht auf dieses einfache Datum zurück.
|
default boolean |
containsItem(java.lang.String itemName)
Ermittelt, ob es ein Sub-Datum mit dem angegebenen Nameb gibt.
|
Data |
createModifiableCopy()
Liefert eine modifizierbare Kopie eines Datensatzes zurück.
|
Data |
createUnmodifiableCopy()
Liefert eine nicht modifizierbare Kopie eines Datensatzes zurück.
|
Data.Array |
getArray(java.lang.String itemName)
Liefert eine Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
default AttributeGroup |
getAttributeGroup()
Liefert die Attributgruppe eines Datums zurück.
|
AttributeType |
getAttributeType()
Liefert den Attribut-Typ eines Datums zurück.
|
Data |
getItem(java.lang.String itemName)
Bestimmt das Sub-Datum dieser Liste mit dem angegebenen Namen.
|
java.lang.String |
getName()
Liefert den Namen eines Datums zurück.
|
Data.ReferenceArray |
getReferenceArray(java.lang.String itemName)
Liefert eine Referenz-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.ReferenceValue |
getReferenceValue(java.lang.String itemName)
Liefert eine Referenz-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.NumberArray |
getScaledArray(java.lang.String itemName)
Liefert eine Skalierte-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.NumberValue |
getScaledValue(java.lang.String itemName)
Liefert eine Skalierte-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.TextArray |
getTextArray(java.lang.String itemName)
Liefert eine Text-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.TextValue |
getTextValue(java.lang.String itemName)
Liefert eine Text-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.TimeArray |
getTimeArray(java.lang.String itemName)
Liefert eine Time-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.TimeValue |
getTimeValue(java.lang.String itemName)
Liefert eine Zeit-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.NumberArray |
getUnscaledArray(java.lang.String itemName)
Liefert eine Unskalierte-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
Data.NumberValue |
getUnscaledValue(java.lang.String itemName)
Liefert eine Unskalierte-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
|
boolean |
isArray()
Prüft, ob das Datum ein Array ist.
|
boolean |
isDefined()
Prüft, ob das Datum über den Datenverteiler verschickt werden kann.
|
boolean |
isList()
Prüft, ob das Datum eine Liste ist, d.h. aus Sub-Daten besteht.
|
boolean |
isPlain()
Prüft, ob das Datum ein einfaches Datum ohne untergeordnete Sub-Daten ist.
|
java.util.Iterator<Data> |
iterator()
Liefert einen Iterator zurück, der über die Sub-Daten dieser Liste oder die Element-Daten dieses Arrays iteriert.
|
void |
setToDefault()
Setzt bei einem Datum alle Werte auf die definierte Default-Werte.
|
java.lang.String |
toString()
Liefert eine textliche Darstellung des Datums mit Name und Wert.
|
default Data |
updated(ClientDavInterface connection)
Diese Methode prüft, ob das Datum in einer älteren Version der Attributgruppe vorliegt, und überträgt das Datum auf die
aktuelle Version der Attributgruppe, falls notwendig und möglich.
|
java.lang.String |
valueToString()
Liefert eine textliche Darstellung des Werts eines Datums zurück.
|
Data createModifiableCopy()
java.lang.IllegalStateException
- wenn das Data-Objekt keinen ganzen Datensatz enthält.default Data updated(ClientDavInterface connection)
Beispiel-Code:
Data oldData = ...;
Data updatedData = oldData.updated(connection);
if (oldData == updatedData) {
// Das Datum war bereits auf der aktuellen Attributgruppen-Version
}
else if (updatedData.isDefined()) {
// Das Datum wurde erfolgreich aktualisiert
}
else {
// Es sind Attribute hinzugekommen oder geändert worden, für die keine Werte ermittelt werden konnten.
// Das Datum muss vor dem Benutzen also z. B. händisch korrigiert werden
}
connection
- Datenverteiler-Verbindungthis
zurückgegeben! In diesem Fall ist nicht garantiert, dass das Datum änderbar ist, oder die Bearbeitung keine
Nebeneffekte hat. Der Aufrufer muss ggf. mit if (oldData == updatedData) ...
prüfen, ob das Datum verändert wurde.
Ebenfalls sollte der Anwender vermutlich mit isDefined()
prüfen, ob das neue Datum gültig ist, ober ob einzelne
Attribute korrigiert werden müssen.IllegalStateException,
- wenn das Data-Objekt keinen ganzen Datensatz enthält.Data createUnmodifiableCopy()
java.lang.IllegalStateException
- wenn das Data-Objekt keinen ganzen Datensatz enthält.java.lang.String getName()
java.lang.String valueToString()
java.lang.String toString()
toString
in class java.lang.Object
AttributeType getAttributeType()
default AttributeGroup getAttributeGroup()
Data
handelt, und wenn es sich um den strukturierten Datensatz handelt, der direkt die Attributgruppe repräsentiert (keinen innerhalb der Hierarchie liegenden Datensatz, sondern die "Wurzel")boolean isDefined()
true
zurück, wenn jedes Attribut einen Wert besitzt, der
ungleich dem "undefiniert" Wert ist. Ist das Datum ein Array oder eine Liste, so wird jedes Element geprüft ob es einen gültigen Wert besitzt. Die Prüfung
findet auf alle "Sub-Daten" des Datums statt.void setToDefault()
isDefined()
boolean isList()
true
, falls das Datum eine Liste ist, sonst false
.boolean isArray()
true
, falls das Datum ein Array ist, sonst false
.boolean isPlain()
true
, falls das Datum eine einfaches Datum ist, sonst false
.Data getItem(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.java.util.NoSuchElementException
- falls nicht vorhanden.default boolean containsItem(java.lang.String itemName)
itemName
- Data.TextValue asTextValue()
Data.TextValue getTextValue(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.TimeValue asTimeValue()
Data.TimeValue getTimeValue(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.NumberValue asScaledValue()
Data.NumberValue getScaledValue(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.NumberValue asUnscaledValue()
Data.NumberValue getUnscaledValue(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.ReferenceValue asReferenceValue()
Data.ReferenceValue getReferenceValue(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.Array asArray()
Data.Array getArray(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.TextArray asTextArray()
Data.TextArray getTextArray(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.TimeArray asTimeArray()
Data.TimeArray getTimeArray(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.NumberArray asScaledArray()
Data.NumberArray getScaledArray(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.NumberArray asUnscaledArray()
Data.NumberArray getUnscaledArray(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.Data.ReferenceArray asReferenceArray()
Data.ReferenceArray getReferenceArray(java.lang.String itemName)
itemName
- Name des gewünschten Sub-Datums.java.util.Iterator<Data> iterator()
iterator
in interface java.lang.Iterable<Data>