Klasse NumFeld

java.lang.Object

gdv.xport.feld.Feld

gdv.xport.feld.NumFeld

Alle implementierten Schnittstellen:

Serializable, Cloneable, Comparable<Feld>

Bekannte direkte Unterklassen:

Betrag, Datum

public class NumFeld
extends Feld

Klasse fuer numerische Zeichen. Die Default-Einstellung fuer die Darstellung ist rechtsbuendig.

Siehe Broschuere_gdv-datensatz_vu-vermittler.pdf, Seite 16 ("Datenfelder/Feldformate").

Autor:

oliver

Siehe auch:

• Serialisierte Form

Verschachtelte Klassen - Übersicht

Verschachtelte Klassen

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

Feldübersicht

Von Klasse geerbte Felder gdv.xport.feld.Feld

config, inhalt, NULL_FELD

Konstruktorübersicht

Konstruktoren

Modifizierer	Konstruktor	Beschreibung
	NumFeld(Bezeichner bezeichner, int length, int start)	Veraltet. durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
	NumFeld(Bezeichner bezeichner, int length, int start, int value)	Veraltet. durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
	NumFeld(Bezeichner name, int length, int start, int value, int nachkommastellen)	Veraltet. durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
protected	NumFeld(Bezeichner name, int length, int start, int nachkommastellen, Config config)	Veraltet.
	NumFeld(Bezeichner bezeichner, int length, ByteAdresse start)	Legt ein neues numerisches Feld an.
	NumFeld(Bezeichner bezeichner, int length, ByteAdresse start, int value)	Legt ein neues numerisches Feld an.
	NumFeld(Bezeichner name, int length, ByteAdresse start, int value, int nachkommastellen)	Legt ein neues numerisches Feld an.
protected	NumFeld(Bezeichner name, int length, ByteAdresse start, int nachkommastellen, Config config)
	NumFeld(Bezeichner name, int start, String value, int nachkommastellen)	Veraltet. durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
	NumFeld(Bezeichner name, ByteAdresse start, String value, int nachkommastellen)	Instantiiert ein neues numerisches Feld.
	NumFeld(Feld other)	Dies ist der Copy-Constructor, mit dem man ein bestehendes Feld kopieren kann.
protected	NumFeld(Feld other, Config config)
	NumFeld(String name, int start, String value)	Veraltet. durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)
	NumFeld(String name, String s)	Veraltet. bitte anderen Constructor verwenden (TODO: wird mit v8 entsorgt)
	NumFeld(String name, String s, int nachkommastellen)	Veraltet. durch entsprechenden Constructor mit Bezeichner ersetzt (TODO: wird mit v8 entsorgt)

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
BigDecimal	add(BigDecimal summand)	Addiert den Summand auf und liefert die Summe zurueck.
Object	clone()	Die clone-Methode hat gegenueber dem CopyConstructor Feld(Feld) den Vorteil, dass es den richtigen Typ fuer die abgeleiteten Klassen zurueckliefert.
String	format()	Diese Methode ist dafuer vorgesehen, das Feld als normalen String ausgeben zu koennen.
String	getInhalt()	Liefert den Inhalt, so wie er im Record steht (ungetrimm't).
int	getNachkommastellen()	Liefert die Anzahl der Nachkommastellen.
NumFeld	mitConfig(Config c)	Liefert eine neues NumFeld mit neuer Konfiguration
NumFeld	mitNachkommastellen(int n)	Liefert ein neues NumFeld mit der gewuenschten Anzahl von Nachkommastellen zurueck.
protected String	pack(String s)
void	setInhalt(char c)	Setzt den Inhalt mit der uebergebenen Ziffer.
void	setInhalt(double x)	Setzt den Inhalt eines Feldes als Double.
void	setInhalt(long n)	Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.
void	setInhalt(BigDecimal n)	Setzt den Inhalt mit der uebergebenen Zahl.
void	setInhalt(BigInteger n)	Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.
BigDecimal	toBigDecimal()	Wenn eine Zahl Nachkommastellen hat, sollte sie auch als BigDecimal ausgegeben werden koennen.
BigInteger	toBigInteger()	Fuer grosse Zahlen kann auch schon mal ein BigInteger noetig sein.
double	toDouble()	Wenn eine Zahl Nachkommastellen hat, sollte sie auch als Double ausgegeben werden koennen.
int	toInt()	Wandelt den Inhalt in einen Integer (ohne Beruecksichtigung etwaiger Nachkommastellen).
long	toLong()	Wandelt den Inhalt in einen Long (ohne Beruecksichtigung etwaiger Nachkommastellen).
protected String	truncate(String s)	Schneidet einen zu langen String unabhaengig vom Alignment rechts ab.

Von Klasse geerbte Methoden gdv.xport.feld.Feld

compareTo, equals, getAnzahlBytes, getAusrichtung, getBezeichner, getBezeichnung, getByteAdresse, getEndAdresse, getValidator, hashCode, hasValue, isEmpty, isInvalid, isValid, overlapsWith, resetInhalt, setAusrichtung, setInhalt, setInhalt, toShortString, toString, validate, validate, withInhalt, write

Von Klasse geerbte Methoden java.lang.Object

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

Konstruktordetails

NumFeld

@Deprecated
public NumFeld(String name,
 String s)

Veraltet.

bitte anderen Constructor verwenden (TODO: wird mit v8 entsorgt)

Parameter:

name - Feld-Bezeichner (z.B. "Anzahl Saetze")

s - z.B. "4"

NumFeld

@Deprecated
public NumFeld(Bezeichner bezeichner,
 int length,
 int start)

Veraltet.

durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Legt ein neues numerisches Feld an.

Parameter:

bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")

length - Anzahl Bytes

start - Start-Byte (beginnend bei 1)

Seit:

1.0

NumFeld

public NumFeld(Bezeichner bezeichner,
 int length,
 ByteAdresse start)

Legt ein neues numerisches Feld an.

Parameter:

bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")

length - Anzahl Bytes

start - Start-Adresse

Seit:

7.0 (07-Jan-2024)

NumFeld

@Deprecated
public NumFeld(Bezeichner bezeichner,
 int length,
 int start,
 int value)

Veraltet.

durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Legt ein neues numerisches Feld an.

Parameter:

bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")

length - Anzahl Bytes

start - Start-Byte (beginnend bei 1)

value - z.B. "01"

Seit:

1.0

NumFeld

public NumFeld(Bezeichner bezeichner,
 int length,
 ByteAdresse start,
 int value)

Legt ein neues numerisches Feld an.

Parameter:

bezeichner - Feld-Bezeichner (z.B. "Anzahl Saetze")

length - Anzahl Bytes

start - Start-Byte (beginnend bei 1)

value - z.B. "01"

Seit:

7.0 (07-Jan-2024)

NumFeld

@Deprecated
public NumFeld(String name,
 int start,
 String value)

Veraltet.

durch entsprechenden Constructor mit Bezeichner und ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Parameter:

name - Feld-Bezeichner (z.B. "Anzahl Saetze")

start - Start-Byte (beginnend bei 1)

value - z.B. "01"

Seit:

0.4

NumFeld

@Deprecated
public NumFeld(String name,
 String s,
 int nachkommastellen)

Veraltet.

durch entsprechenden Constructor mit Bezeichner ersetzt (TODO: wird mit v8 entsorgt)

Parameter:

name - Feld-Bezeichner (z.B. "pi")

s - der Inhalt (z.B. "314")

nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)

Seit:

0.4

NumFeld

@Deprecated
public NumFeld(Bezeichner name,
 int start,
 String value,
 int nachkommastellen)

Veraltet.

durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Instantiiert ein neues numerisches Feld.

Parameter:

name - Feld-Bezeichner (z.B. "pi")

start - Start-Byte (beginnend ab 1)

value - der Inhalt (z.B. "314")

nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)

Seit:

4.0

NumFeld

public NumFeld(Bezeichner name,
 ByteAdresse start,
 String value,
 int nachkommastellen)

Instantiiert ein neues numerisches Feld.

Parameter:

name - Feld-Bezeichner (z.B. "pi")

start - Start-Byte (beginnend ab 1)

value - der Inhalt (z.B. "314")

nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)

Seit:

7.0 (07-Jan-2024)

NumFeld

@Deprecated
public NumFeld(Bezeichner name,
 int length,
 int start,
 int value,
 int nachkommastellen)

Veraltet.

durch entsprechenden Constructor mit ByteAdresse ersetzt (TODO: wird mit v8 entsorgt)

Legt ein neues numerisches Feld an.

Parameter:

name - Feld-Bezeichner (z.B. "pi")

length - Gesamtlaenge

start - Start-Byte (beginnend ab 1)

value - der Inhalt (z.B. 314)

nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)

Seit:

1.0

NumFeld

public NumFeld(Bezeichner name,
 int length,
 ByteAdresse start,
 int value,
 int nachkommastellen)

Legt ein neues numerisches Feld an.

Parameter:

name - Feld-Bezeichner (z.B. "pi")

length - Gesamtlaenge

start - Start-Byte (beginnend ab 1)

value - der Inhalt (z.B. 314)

nachkommastellen - Anzahl der Nachkommastellen (z.B. 2)

Seit:

7.0 (07-Jan-2024)

NumFeld

@Deprecated
protected NumFeld(Bezeichner name,
 int length,
 int start,
 int nachkommastellen,
 Config config)

Veraltet.

NumFeld

protected NumFeld(Bezeichner name,
 int length,
 ByteAdresse start,
 int nachkommastellen,
 Config config)

NumFeld

public NumFeld(Feld other)

Dies ist der Copy-Constructor, mit dem man ein bestehendes Feld kopieren kann.

Parameter:

other - das originale Feld

NumFeld

protected NumFeld(Feld other,
 Config config)

Methodendetails

mitNachkommastellen

public NumFeld mitNachkommastellen(int n)

Liefert ein neues NumFeld mit der gewuenschten Anzahl von Nachkommastellen zurueck.

Parameter:

n - Anzahl der Nachkommastellen

Gibt zurück:

neues NumFeld mit n Nachkommastellen

Seit:

0.4

mitConfig

public NumFeld mitConfig(Config c)

Liefert eine neues NumFeld mit neuer Konfiguration

Setzt außer Kraft:

mitConfig in Klasse Feld

Parameter:

c - neue Konfiguration

Gibt zurück:

neues NumFeld

Seit:

5.3

getNachkommastellen

public int getNachkommastellen()

Liefert die Anzahl der Nachkommastellen.

Gibt zurück:

Anzahl der Nachkommastellen

setInhalt

public void setInhalt(char c)

Setzt den Inhalt mit der uebergebenen Ziffer.

Setzt außer Kraft:

setInhalt in Klasse Feld

Parameter:

c - neuer Inhalt

setInhalt

public void setInhalt(long n)

Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.

ACHTUNG: Ab 5.1 werden hier die Nachkommastellen beruecksichtigt.

Setzt außer Kraft:

setInhalt in Klasse Feld

Parameter:

n - neuer Inhalt

Löst aus:

IllegalArgumentException - wenn n < 0

setInhalt

public void setInhalt(BigInteger n)

Setzt den Inhalt mit der uebergebenen Zahl unter Beruecksichtigung der Nachkommastellen.

ACHTUNG: Ab 5.1 werden hier die Nachkommastellen beruecksichtigt.

Setzt außer Kraft:

setInhalt in Klasse Feld

Parameter:

n - neuer Inhalt

Löst aus:

IllegalArgumentException - wenn n < 0

setInhalt

public void setInhalt(BigDecimal n)

Setzt den Inhalt mit der uebergebenen Zahl.

Setzt außer Kraft:

setInhalt in Klasse Feld

Parameter:

n - Zahl

Löst aus:

IllegalArgumentException - wenn n < 0

Seit:

5.0

setInhalt

public void setInhalt(double x)

Setzt den Inhalt eines Feldes als Double. Nach Moeglichkeit soll setInhalt(BigDecimal) verwendet werden, da die interne Darstellung von double-Werten nie exakt sind.

Parameter:

x - der neue Inhalt

Löst aus:

IllegalArgumentException - wenn n < 0

Seit:

6.1

pack

protected String pack(String s)

Setzt außer Kraft:

pack in Klasse Feld

getInhalt

public String getInhalt()

Beschreibung aus Klasse kopiert: Feld

Liefert den Inhalt, so wie er im Record steht (ungetrimm't).

Setzt außer Kraft:

getInhalt in Klasse Feld

Gibt zurück:

den Inhalt

truncate

protected String truncate(String s)

Beschreibung aus Klasse kopiert: Feld

Schneidet einen zu langen String unabhaengig vom Alignment rechts ab.

Setzt außer Kraft:

truncate in Klasse Feld

Parameter:

s - String, der evtl. gekuerzt wird

Gibt zurück:

String der Laenge Feld.getAnzahlBytes()

toInt

public int toInt()

Wandelt den Inhalt in einen Integer (ohne Beruecksichtigung etwaiger Nachkommastellen).

Gibt zurück:

den Inhalt als int

toLong

public long toLong()

Wandelt den Inhalt in einen Long (ohne Beruecksichtigung etwaiger Nachkommastellen).

Gibt zurück:

den Inhalt als long

toDouble

public double toDouble()

Wenn eine Zahl Nachkommastellen hat, sollte sie auch als Double ausgegeben werden koennen.

Gibt zurück:

die Zahl als Double

Seit:

0.4

toBigInteger

public BigInteger toBigInteger()

Fuer grosse Zahlen kann auch schon mal ein BigInteger noetig sein.

Gibt zurück:

die Zahl als BigInteger

Seit:

5.4

toBigDecimal

public BigDecimal toBigDecimal()

Wenn eine Zahl Nachkommastellen hat, sollte sie auch als BigDecimal ausgegeben werden koennen.

Gibt zurück:

die Zahl als BigDecimal

Seit:

5.0

add

public BigDecimal add(BigDecimal summand)

Addiert den Summand auf und liefert die Summe zurueck.

Parameter:

summand - der aufaddiert wird

Gibt zurück:

Summe

Seit:

5.0

format

public String format()

Beschreibung aus Klasse kopiert: Feld

Diese Methode ist dafuer vorgesehen, das Feld als normalen String ausgeben zu koennen. Zahlen koennen so z.B. in der Form "123,45" ausgegeben werden, unter Beruecksichtigung der eingestellten "Locale".

Setzt außer Kraft:

format in Klasse Feld

Gibt zurück:

Inhalt des Feldes

clone

public Object clone()

Beschreibung aus Klasse kopiert: Feld

Die clone-Methode hat gegenueber dem CopyConstructor Feld(Feld) den Vorteil, dass es den richtigen Typ fuer die abgeleiteten Klassen zurueckliefert.

Setzt außer Kraft:

clone in Klasse Feld

Gibt zurück:

eine Kopie