Klasse FeldXml

java.lang.Object

gdv.xport.feld.Feld

gdv.xport.satz.xml.FeldXml

Alle implementierten Schnittstellen:

Serializable, Cloneable, Comparable<Feld>

public final class FeldXml
extends Feld

Im Gegensatz zur Feld-Klasse kommen hier die einzelnen Werte als XML-Strem rein.

Seit:

1.0 (11.08.2014)

Autor:

oliver (oliver.boehm@gmail.com)

Siehe auch:

• Serialisierte Form

Verschachtelte Klassen - Übersicht

Von Klasse geerbte verschachtelte Klassen/Schnittstellen Feld

Feld.Validator

Modifikator und Typ	Klasse	Beschreibung
static class	Feld.Validator	Die Validierung von Werten wurde jetzt in einer eingenen Validator- Klasse zusammengefasst.

Feldübersicht

Von Klasse geerbte Felder Feld

config, inhalt, NULL_FELD

Modifikator und Typ	Feld	Beschreibung
protected final Config	config
protected String	inhalt
static final Feld	NULL_FELD	statt "null".

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
FeldXml(XMLEventReader parser)	Instantiiert eine Objekt mit den Werten, die ueber den uebergebenen Parser gelesen werden.
FeldXml(XMLEventReader parser, StartElement element)	Instantiiert eine Objekt mit den Werten, die ueber den uebergebenen Parser gelesen werden.

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
Datentyp	getDatentyp()	Liefert den Datentyp.
String	getId()	Liefert die Referenz (Id).
int	getNachkommastellen()	Liefert die Anzahl der Nachkommastellen oder 0, falls es sich um kein numerisches Feld handelt.
Feld	toFeld(int byteAddress)	Veraltet. bitte Methode mit ByteAdresse verwenden (TODO: wird mit v9 entsorgt)
Feld	toFeld(int byteAddress, Bezeichner neuerBezeichner)	Veraltet. alte Version (TODO: wird mit v8 entsorgt)
Feld	toFeld(int byteAddress, FeldReferenz referenz)	Veraltet. bitte Methode mit ByteAdresse verwenden (TODO: wird mit v9 entsorgt)
Feld	toFeld(int byteAddress, FeldReferenz referenz, TeildatensatzXml tdXml)	Veraltet. bitte Methode mit ByteAdresse-Parameter verwenden (TODO: wird mit v9 entsorgt)
Feld	toFeld(ByteAdresse byteAddress)	Wandelt das FeldXml-Objekt in ein Feld-Objekt um.
Feld	toFeld(ByteAdresse byteAddress, FeldReferenz referenz)	Wandelt das FeldXml-Objekt in ein Feld-Objekt um.
Feld	toFeld(ByteAdresse byteAddress, FeldReferenz referenz, TeildatensatzXml tdXml)	Wandelt das FeldXml-Objekt in ein Feld-Objekt um, dessen Bezeichner eindeutig im aktuellen Teildatensatz ist.
String	toString()

Von Klasse geerbte Methoden Feld

clone, compareTo, equals, format, getAnzahlBytes, getAusrichtung, getBezeichner, getBezeichnung, getByteAdresse, getEndAdresse, getInhalt, getValidator, hashCode, hasValue, isEmpty, isInvalid, isValid, mitConfig, overlapsWith, pack, resetInhalt, setAusrichtung, setInhalt, setInhalt, setInhalt, setInhalt, setInhalt, setInhalt, toShortString, truncate, validate, validate, withInhalt, write

Modifikator und Typ	Methode	Beschreibung
Object	clone()	Die clone-Methode hat gegenueber dem CopyConstructor Feld(Feld) den Vorteil, dass es den richtigen Typ fuer die abgeleiteten Klassen zurueckliefert.
final int	compareTo(Feld other)	Es gilt fuer Feld a und b: a < b, wenn die Start-Adresse von a vor b liegt.
boolean	equals(Object obj)	Zwei Felder sind gleich, wenn sie die gleiche Adresse und den gleichen Inhalt haben.
String	format()	Diese Methode ist dafuer vorgesehen, das Feld als normalen String ausgeben zu koennen.
final int	getAnzahlBytes()	Gets the anzahl bytes.
Align	getAusrichtung()	Liefert die Ausrichtung eines Feldes.
Bezeichner	getBezeichner()	Liefert den Bezeichner eines Feldes zurueck.
String	getBezeichnung()	Gets the bezeichnung.
final int	getByteAdresse()	Gets the byte adresse.
final int	getEndAdresse()	Gets the end adresse.
String	getInhalt()	Liefert den Inhalt, so wie er im Record steht (ungetrimm't).
Feld.Validator	getValidator()	Hierueber kann der Validator zur Pruefung im Vorfeld geholt werden.
int	hashCode()
final boolean	hasValue()	Dient zum Ermittel, ob ein Wert schon gesetzt wurde.
boolean	isEmpty()	Checks if is empty.
boolean	isInvalid()	Checks if is invalid.
boolean	isValid()	Valid bedeutet: Byte-Adresse >= 1, Feld geht nicht ueber (Teil-)Datensatz-Grenze hinaus, Ausrichtung ist bekannt.
Feld	mitConfig(Config c)	Liefert eine neues Feld mit neuer Konfiguration
final boolean	overlapsWith(Feld other)	Ueberprueft, ob sich zwei Felder mit unterschiedlichen Start-Adressen ueberlagern.
protected String	pack(String s)
final void	resetInhalt()	Reset inhalt.
void	setAusrichtung(Align alignment)	Hiermit kann man die Ausrichtung umstellen.
void	setInhalt(char c)	Sets the inhalt.
void	setInhalt(char c, int i)	Sets the inhalt.
void	setInhalt(long n)	Setzt den Inhalt aus der uebergebenen Zahl.
void	setInhalt(String neuerInhalt)	Setzt den Inhalt.
void	setInhalt(BigDecimal n)	Setzt den Inhalt aus der uebergebenen Zahl.
void	setInhalt(BigInteger n)	Setzt den Inhalt mit der uebergebenen Zahl.
String	toShortString()
protected String	truncate(String s)	Schneidet einen zu langen String unabhaengig vom Alignment rechts ab.
List<net.sf.oval.ConstraintViolation>	validate()	Validate.
List<net.sf.oval.ConstraintViolation>	validate(Config validationConfig)	Validiert das Feld mit der angegebenen Konfiguration.
Feld	withInhalt(String inhalt)	Setzt das Feld und liefert es als Ergebnis zurueck.
final void	write(Writer writer)	Write.

Von Klasse geerbte Methoden Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Konstruktordetails

FeldXml

public FeldXml(XMLEventReader parser)
        throws XMLStreamException

Instantiiert eine Objekt mit den Werten, die ueber den uebergebenen Parser gelesen werden.

Parameter:

parser - the parser

Löst aus:

XMLStreamException - the XML stream exception

FeldXml

public FeldXml(XMLEventReader parser,
 StartElement element)
        throws XMLStreamException

Instantiiert eine Objekt mit den Werten, die ueber den uebergebenen Parser gelesen werden.

Parameter:

parser - the parser

element - das Start-Element <feldreferenz referenz=... >

Löst aus:

XMLStreamException - the XML stream exception

Methodendetails

getId

public String getId()

Liefert die Referenz (Id).

Gibt zurück:

z.B. "BN-2003.02.11.22.49.47.214"

getDatentyp

public Datentyp getDatentyp()

Liefert den Datentyp.

Gibt zurück:

the datentyp

getNachkommastellen

public int getNachkommastellen()

Liefert die Anzahl der Nachkommastellen oder 0, falls es sich um kein numerisches Feld handelt.

Gibt zurück:

the nachkommastellen

toFeld

@Deprecated
public Feld toFeld(int byteAddress)

Veraltet.

bitte Methode mit ByteAdresse verwenden (TODO: wird mit v9 entsorgt)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um.

Parameter:

byteAddress - die Byte-Adresse

Gibt zurück:

das entsprechende Feld

toFeld

public Feld toFeld(ByteAdresse byteAddress)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um.

Parameter:

byteAddress - die Byte-Adresse

Gibt zurück:

das entsprechende Feld

Seit:

7.1

toFeld

@Deprecated
public Feld toFeld(int byteAddress,
 Bezeichner neuerBezeichner)

Veraltet.

alte Version (TODO: wird mit v8 entsorgt)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um.

Parameter:

byteAddress - die Byte-Adresse

neuerBezeichner - the neuer bezeichner

Gibt zurück:

das entsprechende Feld

toFeld

@Deprecated
public Feld toFeld(int byteAddress,
 FeldReferenz referenz)

Veraltet.

bitte Methode mit ByteAdresse verwenden (TODO: wird mit v9 entsorgt)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um.

Parameter:

byteAddress - die Byte-Adresse

referenz - mit Bezeichner und Bemerkung

Gibt zurück:

das entsprechende Feld

toFeld

public Feld toFeld(ByteAdresse byteAddress,
 FeldReferenz referenz)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um.

Parameter:

byteAddress - die Byte-Adresse

referenz - mit Bezeichner und Bemerkung

Gibt zurück:

das entsprechende Feld

Seit:

7.1

toFeld

@Deprecated
public Feld toFeld(int byteAddress,
 FeldReferenz referenz,
 TeildatensatzXml tdXml)

Veraltet.

bitte Methode mit ByteAdresse-Parameter verwenden (TODO: wird mit v9 entsorgt)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um, dessen Bezeichner eindeutig im aktuellen Teildatensatz ist.

In Feldern innerhalb der TDs von SA > "0001" wird der technischen Namen aus der Feld-Bezeichnung ermitteln. Dadurch kann ein Feld, dessen Bezeichnung im Teildatensatz eindeutig ist, sicher durch die Feld-Bezeichnung aus GDV-Online adressiert werden. Felder mit mehrdeutigem Namen im Teildatensatz (s.u.) koennen nur via ByteAdresse adressiert werden (wie bisher auch).

Eine Ausnahme ist das Feld an Position 43 in SA0220.030, TD9. Dieses Feld ist durch einen Kopierfehler beim GDV entstanden. Aus 'historischen' Gruenden und wg. Abwaertskompatibilitaet muss der technische Name hier identisch sein zu Bezeichner.LFD_NUMMER_VP_PERSONENGRUPPE9. Ergo wird hier wie bisher der Bezeichner aus der Referenz verwendet.

Parameter:

byteAddress - die Byte-Adresse

referenz - mit Bezeichner und Bemerkung

tdXml - der aktuelle Teildatensatz

Gibt zurück:

das entsprechende Feld

toFeld

public Feld toFeld(ByteAdresse byteAddress,
 FeldReferenz referenz,
 TeildatensatzXml tdXml)

Wandelt das FeldXml-Objekt in ein Feld-Objekt um, dessen Bezeichner eindeutig im aktuellen Teildatensatz ist.

In Feldern innerhalb der TDs von SA > "0001" wird der technischen Namen aus der Feld-Bezeichnung ermitteln. Dadurch kann ein Feld, dessen Bezeichnung im Teildatensatz eindeutig ist, sicher durch die Feld-Bezeichnung aus GDV-Online adressiert werden. Felder mit mehrdeutigem Namen im Teildatensatz (s.u.) koennen nur via ByteAdresse adressiert werden (wie bisher auch).

Parameter:

byteAddress - die Byte-Adresse

referenz - mit Bezeichner und Bemerkung

tdXml - der aktuelle Teildatensatz

Gibt zurück:

das entsprechende Feld

Seit:

7.1

toString

public String toString()

Setzt außer Kraft:

toString in Klasse Feld