Klasse SatzXml

java.lang.Object

gdv.xport.satz.Satz

gdv.xport.satz.Datensatz

gdv.xport.satz.xml.SatzXml

Alle implementierten Schnittstellen:

Cloneable

Bekannte direkte Unterklassen:

MyUnfallDatensatz

public class SatzXml
extends Datensatz

Im Gegensatz zum SOP-Ansatz und zur SatzX-Klasse wird hier eine XML- Beschreibung verwendet, um die einzelnen Teildatensaetze mit ihren Feldern zu bestimmen. Da die XML-Datei mit der Komplett-Beschreibung relativ gross ist (ca. 7 MB), verwenden wir hier nicht einen DOM-Parser. Und auch keinen XPath-Ansatz.

Seit:

1.0 (30.07.2014)

Autor:

oliver (oliver.boehm@gmail.com)

Konstruktorübersicht

Konstruktoren

Konstruktor	Beschreibung
SatzXml(Datensatz orig)	Dies ist der Copy-Constructor, mit dem man einen bestehenden Satz kopieren kann.
SatzXml(XMLEventReader parser)	Instantiiert einen neuen Satz.
SatzXml(XMLEventReader parser, StartElement element, Config config)	Instantiiert einen neuen Satz.

Methodenübersicht

Modifikator und Typ	Methode	Beschreibung
List<SatzTyp>	getSupportedSatzTypen()	Liefert eine Liste der unterstuetzten Satz-Typen.
static SatzXml	of(File file)	Hier kann man mithilfe einer XML-Beschreibung einen Satz generieren.
static SatzXml	of(String resource)	Hier kann man mithile einer XML-Beschreibung einen Satz generieren.
static SatzXml	of(URI resource)	Im Gegensatz zu of(String) und of(File) kann hier eine beliebige URI als Parameter uebergeben werden.
void	setFelder(Map<String,FeldXml> felder)	Verwendet die uebergebene Map, um die Teildatensaetze um fehlende Informationen zu ergaenzen.
protected void	setGdvSatzartName(String string)	Setzen des Namens einer Gdv-Satzart.

Von Klasse geerbte Methoden Datensatz

addFiller, getArt, getFolgenummer, getSatzTyp, getSparte, getSparteFeld, getVersicherungsscheinNummer, getVuNummer, hasArt, hasBausparenArt, hasKrankenFolgeNr, hasSparte, hasVuNummer, hasWagnisart, init, matchesNextTeildatensatz, setFolgenummer, setSparte, setSparte, setVersicherungsscheinNummer, setVuNummer

Modifikator und Typ	Methode	Beschreibung
void	addFiller()	Fuellt fuer alle leeren Stellen ein entsprechendes Fuellfeld auf.
int	getArt()	Manche Satzarten wie Bausparen haben eine Element fuer die Untersparte, im Feld Wagnisart oder Art abgespeichert.
int	getFolgenummer()	Gets the folgenummer.
SatzTyp	getSatzTyp()	Liefert den Satz-Typ zurueck.
int	getSparte()	Liefert den Inhalt des Sparten-Felds an Byte-Adresse 11.
NumFeld	getSparteFeld()	Gets the sparte feld.
String	getVersicherungsscheinNummer()	Gets the versicherungsschein nummer.
String	getVuNummer()	Gets the vu nummer.
boolean	hasArt()	Wenn der Datensatz ein Element fuer eine Untersparte hat, wird 'true' zurueckgegeben.
boolean	hasBausparenArt()	Schaut nach dem 9.
boolean	hasKrankenFolgeNr()	Schaut nach dem 10.
boolean	hasSparte()	Schaut nach einem Feld "SPARTE" und liefert true zurueck, falls es existiert.
boolean	hasVuNummer()	Nicht jeder Datensatz hat eine VU-Nummer.
boolean	hasWagnisart()	Schaut nach einem Feld "WAGNISART" und liefert true zurueck, falls es existiert.
void	init(SatzTyp satztyp)	Dient dazu, um mit den Informationen des Satztyps Sparte und andere Felder vorzubelegen.
protected boolean	matchesNextTeildatensatz(PushbackLineNumberReader reader, char[] lastFeld1To7, Character satznummer)	Prüfe ob die kommende Zeile ein Teildatensatz der letzten ist.
void	setFolgenummer(int nr)	Hiermit kann die Folgenummer gesetzt werden.
void	setSparte(int x)	Setzt die Sparte.
void	setSparte(String x)	Setzt die Sparte.
void	setVersicherungsscheinNummer(String nr)	Sets the versicherungsschein nummer.
void	setVuNummer(String s)	Sets the vu nummer.

Von Klasse geerbte Methoden Satz

add, add, add, addAll, clone, cloneTeildatensaetze, equals, export, export, export, export, getBausparenArt, getConfig, getFeld, getFeld, getFeld, getFeld, getFeld, getFeld, getFelder, getFeldInhalt, getFeldInhalt, getGdvSatzartName, getGdvSatzartNummer, getKrankenFolgeNr, getNumberOfTeildatensaetze, getSatzart, getSatzartFeld, getSatzversion, getTeildatensaetze, getTeildatensatz, getTeildatensatzBySatzNr, getVermittler, getVersion, getWagnisart, hasFeld, hasFeld, hashCode, importFrom, importFrom, importFrom, importFrom, importFrom, isComplete, isValid, mergeWith, remove, remove, removeAllTeildatensaetze, removeTeildatensatz, removeTeildatensatzBySatzNr, removeUnusedTeildatensaetze, resetGdvSatzartName, setFeld, setFeld, setFeld, setFeld, setVermittler, toLongString, toShortString, toString, validate, validate

Modifikator und Typ	Methode	Beschreibung
void	add(Feld feld)	Fuegt das uebergebene Feld zur Liste der Datenfelder hinzu.
void	add(Feld feld, int teildatensatzNr)	Fuegt das uebergebene Feld zur Liste der Datenfelder hinzu.
final void	add(Teildatensatz tds)	Und hierueber kann ein Teildatensatz hinzugefuegt werden.
void	addAll(Feld feld)	Fuegt das uebergebene Feld in jeden Teildatensatz hinzu.
Object	clone()	Legt eine Kopie des Satzes an.
protected final List<Teildatensatz>	cloneTeildatensaetze()	Hier wird eine Kopie aller Teildatensaetze zurueckgegeben.
boolean	equals(Object obj)	Zwei Saetze sind gleich, wenn sie die gleichen Daten besitzen.
void	export(File file)	Exportiert den Satz.
void	export(OutputStream ostream)
void	export(Writer writer)	Exportiert den Satz.
void	export(Writer writer, String eod)	Export.
final String	getBausparenArt()	Liefert den Inhalt des 9.
final Config	getConfig()	Liefert die aktuelle Konfiguration zurueck.
Feld	getFeld(Bezeichner bezeichner)	Liefert das gewuenschte Feld.
final Feld	getFeld(Bezeichner bezeichner, int nr)	Liefert das gewuenschte Feld.
<T extends Feld> T	getFeld(Bezeichner bezeichner, Class<T> clazz)	Liefert das gewuenschte Feld im gewuenschten Typ.
Feld	getFeld(ByteAdresse adresse)	Holt sich das entsprechende Feld aus dem Teildatensatz.
Feld	getFeld(String name)	Veraltet. bitte getFeld(Bezeichner) verwenden (TODO: wird mit v8 oder v9 entsorgt)
final Feld	getFeld(String name, int nr)	Veraltet. bitte getFeld(Bezeichner, int) verwenden (TODO: wird mit v8 oder v9 entsorgt)
Collection<Feld>	getFelder()	Liefert die Felder aller Teildatensaetze zurueck.
final String	getFeldInhalt(Bezeichner bezeichner)	Liefert den Inhalt des gewuenschten Feldes.
final String	getFeldInhalt(String name, int nr)	Liefert den Inhalt des gewuenschten Feldes.
String	getGdvSatzartName()
String	getGdvSatzartNummer()	Veraltet. bitte Satzartnummer ueber Satz.getSatzTyp() ermitteln
final String	getKrankenFolgeNr()	Liefert den Inhalt des Feldes, in dessen Bezeichnung "Folge-Nr" oder "Folgenummer" gefolgt von "zur laufenden" vorkommt (ByteAdresse 48), wenn es existiert.
final int	getNumberOfTeildatensaetze()	Liefert die Anzahl der Teildatensaetze.
int	getSatzart()	Liefert die Satzart zurueck.
NumFeld	getSatzartFeld()	Liefert die Satzart.
final AlphaNumFeld	getSatzversion()	Liefert die Satzversion
final List<Teildatensatz>	getTeildatensaetze()	Liefert alle Teildatensaetze zurueck.
final Teildatensatz	getTeildatensatz(int n)	Liefert den n-ten Teildatensatz aus der Liste der Teildatensätze zurueck.
final Teildatensatz	getTeildatensatzBySatzNr(int n)	Liefert den Teildatensatz mit der wirklichen Satznummer n zurueck.
final String	getVermittler()	Liefert den Vermittler zurueck.
final String	getVersion()	Liefert die Version des Satzes.
final String	getWagnisart()	Liefert den Inhalt des Wagnisart-Felds.
boolean	hasFeld(Bezeichner bezeichner)	Fraegt ab, ob das entsprechende Feld vorhanden ist.
boolean	hasFeld(ByteAdresse adresse)	Fraegt ab, ob das entsprechende Feld vorhanden ist.
int	hashCode()
final Satz	importFrom(PushbackLineNumberReader reader)	Der hier verwendete PushbackReader wird benoetigt, damit die gelesene Satzart und Sparte wieder zurueckgesetllt werden kann.
Satz	importFrom(File file)	Importiert einen Satz von der angegebenen Datei.
final Satz	importFrom(InputStream istream)	Import von einem InputStream.
final Satz	importFrom(Reader reader)	Import von einem Reader.
Satz	importFrom(String s)	Eigentlich wollte ich ja diese Methode "import" nennen, aber das kollidiert leider mit dem Schluesselwort "import" in Java.
boolean	isComplete()	Sind alle Teildatensaetze eines Satzes vorhanden und ausgefuellt, liefert diese Methode 'true' zurueck.
boolean	isValid()	Aus Performance-Gruenden stuetzt sich diese Methode nicht auf die validate()-Methode ab.
void	mergeWith(Satz other)	Vereinigt den anderen Satz mit dem aktuellen Satz, falls das moeglich ist.
void	remove(Bezeichner bezeichner)	Falls ein Feld zuviel gesetzt wurde, kann es mit 'remove" wieder entfernt werden.
void	remove(String name)	Falls ein Feld zuviel gesetzt wurde, kann es mit 'remove" wieder entfernt werden.
final void	removeAllTeildatensaetze()	Hiermit koennen Unterklassen alle Teildatensaetze wieder entfernen (wird z.B. vom Satz 0220.030 benoetigt).
final void	removeTeildatensatz(int n)	Entfernt den gewuenschten Teildatensatz.
final void	removeTeildatensatzBySatzNr(int n)	Entfernt den gewuenschten Teildatensatz mit der wirklichen Satznummer n.
protected void	removeUnusedTeildatensaetze(SortedSet<Integer> usedIndexes)
void	resetGdvSatzartName()
void	setFeld(Bezeichner name, Integer value)	Setzt den Inhalt des gewuenschten Feldes.
void	setFeld(Bezeichner name, String value)	Setzt das angegebene Feld in allen Teildatensaetzen, in denen es gefunden wird.
void	setFeld(ByteAdresse adresse, String value)	Setzt das angegebene Feld anhand der Adresse in allen Teildatensaetzen.
void	setFeld(String name, String value)	Setzt das angegebene Feld in allen Teildatensaetzen, in denen es gefunden wird.
final void	setVermittler(String vermittler)	Setzt den Vermittler in das entsprechende Feld.
String	toLongString()	To long string.
String	toShortString()	To short string.
final String	toString()
List<net.sf.oval.ConstraintViolation>	validate()	Validiert die einzelnen Teildatensaetze mit der eingestellten Standard-Konfiguration.
List<net.sf.oval.ConstraintViolation>	validate(Config validationConfig)	Im Unterschied zur normalen validate-Methode kann man hier eine die Validierung ueber Config.LAX oder Config.STRICT verschaerfen oder abmildern.

Von Klasse geerbte Methoden Object

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

Konstruktordetails

SatzXml

public SatzXml(XMLEventReader parser)
        throws XMLStreamException

Instantiiert einen neuen Satz.

Parameter:

parser - XML-Event-Parser

Löst aus:

XMLStreamException - the XML stream exception

SatzXml

public SatzXml(XMLEventReader parser,
 StartElement element,
 Config config)
        throws XMLStreamException

Instantiiert einen neuen Satz.

Parameter:

parser - XML-Event-Parser

element - the element

config - Konfiguration

Löst aus:

XMLStreamException - the XML stream exception

SatzXml

public SatzXml(Datensatz orig)

Dies ist der Copy-Constructor, mit dem man einen bestehenden Satz kopieren kann.

Parameter:

orig - der originale Satz

Methodendetails

setGdvSatzartName

protected void setGdvSatzartName(String string)

Setzen des Namens einer Gdv-Satzart.

Der string wird mit dem Trennzeichen '.' an den bisherigen Inhalt angehaengt.

Setzt außer Kraft:

setGdvSatzartName in Klasse Satz

Parameter:

string - Satzart-Name

setFelder

public void setFelder(Map<String,FeldXml> felder)

Verwendet die uebergebene Map, um die Teildatensaetze um fehlende Informationen zu ergaenzen.

Parameter:

felder - the felder

getSupportedSatzTypen

public List<SatzTyp> getSupportedSatzTypen()

Liefert eine Liste der unterstuetzten Satz-Typen. Dies ist vor allem fuer Satz 220 Sparte 10 von Bedeutung, die verschienden Wagnisarten unterstuetzen koennen.

Gibt zurück:

the supported satz typen

of

public static SatzXml of(File file)
                  throws IOException,
XMLStreamException

Hier kann man mithilfe einer XML-Beschreibung einen Satz generieren. Diese Methode dient dazu, um die Notwendigkeit der Enum-Beschreibung weiter zu reduzieren.

Parameter:

file - Datei mit XML-Beschreibung

Gibt zurück:

einen Satz gemaess der XML-Beschreibung

Löst aus:

IOException - the io exception

XMLStreamException - the xml stream exception

Seit:

5.0

of

public static SatzXml of(String resource)
                  throws IOException,
XMLStreamException

Hier kann man mithile einer XML-Beschreibung einen Satz generieren. Diese Methode dient dazu, um die Notwendigkeit der Enum-Beschreibung weiter zu reduzieren.

Parameter:

resource - Classpath-Resource mit XML-Beschreibung

Gibt zurück:

einen Satz gemaess der XML-Beschreibung

Löst aus:

IOException - the io exception

XMLStreamException - the xml stream exception

Seit:

5.0

of

public static SatzXml of(URI resource)
                  throws IOException,
XMLStreamException

Im Gegensatz zu of(String) und of(File) kann hier eine beliebige URI als Parameter uebergeben werden. Allerdings werden momentan nur "classpath:" und "file:" als Protokoll unterstuetzt.

Parameter:

resource - URI der Resource (z.B. "classpath:/mein/satz.xml")

Gibt zurück:

einen Satz gemaess der XML-Beschreibung

Löst aus:

IOException - the io exception

XMLStreamException - the xml stream exception

Seit:

6.1