Class ByteArrayData
- java.lang.Object
-
- de.bsvrz.dav.daf.communication.dataRepresentation.data.byteArray.ByteArrayData
-
- Direct Known Subclasses:
ByteArrayPrimitiveData
,ByteArrayStructuredData
public abstract class ByteArrayData extends java.lang.Object implements Data
Klasse, die noch zu dokumentieren ist.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface de.bsvrz.dav.daf.main.Data
Data.Array, Data.FormatException, Data.NumberArray, Data.NumberValue, Data.ReferenceArray, Data.ReferenceValue, Data.TextArray, Data.TextValue, Data.TimeArray, Data.TimeValue
-
-
Field Summary
Fields Modifier and Type Field Description protected byte[]
_bytes
protected AttributeInfo
_info
protected int
_offset
-
Constructor Summary
Constructors Modifier Constructor Description protected
ByteArrayData(byte[] bytes, int offset, AttributeInfo info)
-
Method Summary
Modifier and Type Method Description protected static ByteArrayData
create(byte[] bytes, int offset, AttributeInfo attributeInfo)
protected static ByteArrayData
create(byte[] bytes, int offset, AttributeInfo attributeInfo, int itemIndex)
static ByteArrayData
create(byte[] bytes, AttributeInfo attributeGroupInfo)
Data
createModifiableCopy()
Liefert eine modifizierbare Kopie eines Datensatzes zurück.Data
createUnmodifiableCopy()
Liefert eine nicht modifizierbare Kopie eines Datensatzes zurück.void
dump(int indent, int depth)
boolean
equals(java.lang.Object obj)
Data.Array
getArray(java.lang.String itemName)
Liefert eine Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.AttributeGroup
getAttributeGroup()
Liefert die Attributgruppe eines Datums zurück.AttributeType
getAttributeType()
Liefert den Attribut-Typ eines Datums zurück.byte[]
getBytes()
protected AttributeInfo
getInfo()
Data
getItem(int itemIndex)
abstract 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.int
getOffset()
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.abstract boolean
isArray()
Prüft, ob das Datum ein Array ist.boolean
isDefined()
Prüft, ob das Datum über den Datenverteiler verschickt werden kann.abstract boolean
isList()
Prüft, ob das Datum eine Liste ist, d.h. aus Sub-Daten besteht.abstract boolean
isPlain()
Prüft, ob das Datum ein einfaches Datum ohne untergeordnete Sub-Daten ist.abstract 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
resolveReferences()
Diese Methode betrachtet rekursiv alle Attribute und sorgt mit entsprechenden Konfigurationsanfragen dafür, dass Referenzen auf lokal noch nicht bekannte Objekte aufgelöst werden.void
setToDefault()
Setzt bei einem Datum alle Werte auf die definierte Default-Werte.java.lang.String
toDebugString()
protected java.lang.String
toParamString()
java.lang.String
toString()
Liefert eine textliche Darstellung des Datums mit Name und Wert.abstract java.lang.String
valueToString()
Liefert eine textliche Darstellung des Werts eines Datums zurück.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface de.bsvrz.dav.daf.main.Data
asArray, asReferenceArray, asReferenceValue, asScaledArray, asScaledValue, asTextArray, asTextValue, asTimeArray, asTimeValue, asUnscaledArray, asUnscaledValue, containsItem, updated, updated
-
-
-
-
Field Detail
-
_bytes
protected final byte[] _bytes
-
_offset
protected final int _offset
-
_info
protected final AttributeInfo _info
-
-
Constructor Detail
-
ByteArrayData
protected ByteArrayData(byte[] bytes, int offset, AttributeInfo info)
-
-
Method Detail
-
create
public static ByteArrayData create(byte[] bytes, AttributeInfo attributeGroupInfo)
-
create
protected static ByteArrayData create(byte[] bytes, int offset, AttributeInfo attributeInfo)
-
create
protected static ByteArrayData create(byte[] bytes, int offset, AttributeInfo attributeInfo, int itemIndex)
-
createModifiableCopy
public Data createModifiableCopy()
Description copied from interface:Data
Liefert eine modifizierbare Kopie eines Datensatzes zurück. Diese Methode kann verwendet werden, um eine Kopie von einem empfangenen (nicht modifizierbaren) Datensatz zu erstellen und die Kopie mit eventuell veränderten Attributwerten wieder zu versenden. Die Methode funktioniert i.a. nur auf ganzen Datensätzen. Bei Data-Objekten, die nur Teile oder einzelne Attributwerte repräsentieren wird eine IllegalStateException generiert.- Specified by:
createModifiableCopy
in interfaceData
- Returns:
- Veränderbare Kopie des Datensatzes.
-
createUnmodifiableCopy
public Data createUnmodifiableCopy()
Description copied from interface:Data
Liefert eine nicht modifizierbare Kopie eines Datensatzes zurück. Die Methode funktioniert i.a. nur auf ganzen Datensätzen. Bei Data-Objekten, die nur Teile oder einzelne Attributwerte repräsentieren wird eine IllegalStateException generiert.- Specified by:
createUnmodifiableCopy
in interfaceData
- Returns:
- Nicht änderbare Kopie des Datensatzes.
-
getName
public java.lang.String getName()
Description copied from interface:Data
Liefert den Namen eines Datums zurück.
-
getAttributeType
public AttributeType getAttributeType()
Description copied from interface:Data
Liefert den Attribut-Typ eines Datums zurück.- Specified by:
getAttributeType
in interfaceData
- Returns:
- Attribut-Typ des Datums
-
getAttributeGroup
public AttributeGroup getAttributeGroup()
Description copied from interface:Data
Liefert die Attributgruppe eines Datums zurück. Die Attributgruppe ist hier nur ermittelbar, wenn es sich um eine unterstützte Implementierung vonData
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")- Specified by:
getAttributeGroup
in interfaceData
- Returns:
- Die Attributgruppe eines Datums, oder `null`, falls nicht ermittelbar.
-
setToDefault
public void setToDefault()
Description copied from interface:Data
Setzt bei einem Datum alle Werte auf die definierte Default-Werte. Wurde weder beim Attribut noch beim Attributtyp ein Default-Wert definiert so wird der "undefiniert" Wert gesetzt. Ist das Datum eine Liste oder ein Array, so wird bei jedem Element der Default-Wert gesetzt. Der Vorgang wird solange fortgesetzt, bis alle "Sub-Daten" mit einem Default-Wert/Undefiniert-Wert definiert sind.- Specified by:
setToDefault
in interfaceData
- See Also:
Data.isDefined()
-
isDefined
public boolean isDefined()
Description copied from interface:Data
Prüft, ob das Datum über den Datenverteiler verschickt werden kann. Die Methode gibttrue
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.
-
getBytes
public final byte[] getBytes()
-
getOffset
public final int getOffset()
-
getInfo
protected final AttributeInfo getInfo()
-
toDebugString
public java.lang.String toDebugString()
-
toParamString
protected java.lang.String toParamString()
-
getItem
public abstract Data getItem(java.lang.String itemName)
Description copied from interface:Data
Bestimmt das Sub-Datum dieser Liste mit dem angegebenen Namen.
-
iterator
public abstract java.util.Iterator<Data> iterator()
Description copied from interface:Data
Liefert einen Iterator zurück, der über die Sub-Daten dieser Liste oder die Element-Daten dieses Arrays iteriert.
-
getItem
public Data getItem(int itemIndex)
-
isList
public abstract boolean isList()
Description copied from interface:Data
Prüft, ob das Datum eine Liste ist, d.h. aus Sub-Daten besteht.
-
isArray
public abstract boolean isArray()
Description copied from interface:Data
Prüft, ob das Datum ein Array ist.
-
isPlain
public abstract boolean isPlain()
Description copied from interface:Data
Prüft, ob das Datum ein einfaches Datum ohne untergeordnete Sub-Daten ist.
-
dump
public void dump(int indent, int depth)
-
valueToString
public abstract java.lang.String valueToString()
Description copied from interface:Data
Liefert eine textliche Darstellung des Werts eines Datums zurück.- Specified by:
valueToString
in interfaceData
- Returns:
- Wert des Datums
-
toString
public java.lang.String toString()
Description copied from interface:Data
Liefert eine textliche Darstellung des Datums mit Name und Wert.
-
getArray
public Data.Array getArray(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.
-
getUnscaledValue
public Data.NumberValue getUnscaledValue(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Unskalierte-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getUnscaledValue
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Unskalierte-Ansicht des Sub-Datums.
-
getUnscaledArray
public Data.NumberArray getUnscaledArray(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Unskalierte-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getUnscaledArray
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Unskalierte-Array-Ansicht des Sub-Datums.
-
getTimeValue
public Data.TimeValue getTimeValue(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Zeit-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getTimeValue
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Zeit-Ansicht des Sub-Datums.
-
getTimeArray
public Data.TimeArray getTimeArray(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Time-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getTimeArray
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Time-Array-Ansicht des Sub-Datums.
-
getTextValue
public Data.TextValue getTextValue(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Text-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getTextValue
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Text-Ansicht des Sub-Datums.
-
getTextArray
public Data.TextArray getTextArray(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Text-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getTextArray
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Text-Array-Ansicht des Sub-Datums.
-
getScaledValue
public Data.NumberValue getScaledValue(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Skalierte-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getScaledValue
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Skalierte-Ansicht des Sub-Datums.
-
getScaledArray
public Data.NumberArray getScaledArray(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Skalierte-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getScaledArray
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Skalierte-Array-Ansicht des Sub-Datums.
-
getReferenceValue
public Data.ReferenceValue getReferenceValue(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Referenz-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getReferenceValue
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Referenz-Ansicht des Sub-Datums.
-
getReferenceArray
public Data.ReferenceArray getReferenceArray(java.lang.String itemName)
Description copied from interface:Data
Liefert eine Referenz-Array-Ansicht auf das Sub-Datum dieser Liste mit dem angegebenen Namen zurück.- Specified by:
getReferenceArray
in interfaceData
- Parameters:
itemName
- Name des gewünschten Sub-Datums.- Returns:
- Referenz-Array-Ansicht des Sub-Datums.
-
equals
public boolean equals(java.lang.Object obj)
- Overrides:
equals
in classjava.lang.Object
-
resolveReferences
public void resolveReferences()
Diese Methode betrachtet rekursiv alle Attribute und sorgt mit entsprechenden Konfigurationsanfragen dafür, dass Referenzen auf lokal noch nicht bekannte Objekte aufgelöst werden.
-
-