public static class ArgumentList.Argument
extends java.lang.Object
Klasse zum Zugriff auf Name und Wert eines Aufrufarguments.
Modifier and Type | Method and Description |
---|---|
long |
asAbsoluteTime()
Interpretiert den Wert des Arguments als absolute Zeitangabe.
|
java.io.File |
asChangeableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück.
|
java.io.File |
asChangeableFile(boolean createIfNotExistent)
Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück.
|
java.io.File |
asDirectory()
Gibt den Wert des Arguments als Datei-Identifikation eines Dateiverzeichnisses zurück.
|
<E> E |
asEnum(java.lang.Class<E> typeClass)
Bestimmt den Wert des Arguments als Enum-Konstante.
|
java.io.File |
asExistingFile()
Gibt den Wert des Arguments als Datei-Identifikation einer existierenden Datei zurück.
|
java.io.File |
asFile()
Gibt den Wert des Arguments als Datei-Identifikation zurück.
|
java.lang.String |
asNonEmptyString()
Bestimmt den Wert des Arguments als nicht leere Zeichenkette.
|
java.io.File |
asReadableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer lesbaren Datei zurück.
|
long |
asRelativeTime()
Interpretiert den Wert des Arguments als relative Zeitangabe.
|
java.lang.String |
asString()
Bestimmt den Wert des Arguments als Zeichenkette.
|
long |
asTime()
Interpretiert den Wert des Arguments als Zeitangabe.
|
ArgumentList.ValueCase |
asValueCase(ArgumentList.ValueSelection validValues) |
java.io.File |
asWritableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück.
|
java.io.File |
asWritableFile(boolean createIfNotExistent)
Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück.
|
boolean |
booleanValue()
Gibt den Wert des Arguments als
boolean Wert zurück. |
byte |
byteValue()
Gibt den Wert des Arguments als
byte Wert zurück. |
byte |
byteValueBetween(byte minimum,
byte maximum)
Gibt den Wert des Arguments als
byte Wert zurück. |
double |
doubleValue()
Gibt den Wert des Arguments als
double Wert zurück. |
double |
doubleValueBetween(double minimum,
double maximum)
Gibt den Wert des Arguments als
double Wert zurück. |
float |
floatValue()
Gibt den Wert des Arguments als
float Wert zurück. |
float |
floatValueBetween(float minimum,
float maximum)
Gibt den Wert des Arguments als
float Wert zurück. |
java.lang.String |
getName()
Bestimmt den Namen des Arguments.
|
java.lang.String |
getValue()
Bestimmt den Wert des Arguments.
|
boolean |
hasValue()
Überprüft, ob das Argument einen Wert hat.
|
int |
intValue()
Gibt den Wert des Arguments als
int Wert zurück. |
int |
intValueBetween(int minimum,
int maximum)
Gibt den Wert des Arguments als
int Wert zurück. |
long |
longValue()
Gibt den Wert des Arguments als
long Wert zurück. |
long |
longValueBetween(long minimum,
long maximum)
Gibt den Wert des Arguments als
long Wert zurück. |
short |
shortValue()
Gibt den Wert des Arguments als
short Wert zurück. |
short |
shortValueBetween(short minimum,
short maximum)
Gibt den Wert des Arguments als
short Wert zurück. |
ArgumentList.Argument |
toArgumentWithNameAsValue()
Erzeugt ein neues Argument dessen Wert aus dem Namen dieses Arguments übernommen wird.
|
java.lang.String |
toString()
Erzeugt eine Zeichenkette, die den Namen und den Wert des Arguments enthält.
|
public ArgumentList.Argument toArgumentWithNameAsValue()
Erzeugt ein neues Argument dessen Wert aus dem Namen dieses Arguments übernommen wird.
public java.lang.String getName()
Bestimmt den Namen des Arguments.
public boolean hasValue()
Überprüft, ob das Argument einen Wert hat. Wenn das Argument keinen Wert hat, kann nur noch mit der Methode #booleanValue()
auf den Wert zugegriffen werden, ohne daß eine Ausnahme generiert wird.
true
, falls das Argument einen Wert hat; sonst false
.public java.lang.String getValue()
Bestimmt den Wert des Arguments.
java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public boolean booleanValue() throws java.lang.IllegalArgumentException
Gibt den Wert des Arguments als boolean
Wert zurück. Die Argumentwerte “wahr”, “ja”, “1” werden zum Boolschen Wert true
konvertiert; die Argumentwerte “falsch”, “nein”, “0” werden zum Boolschen Wert false
konvertiert. Die Groß-/Kleinschreibung des Argumentwerts hat beim Vergleich keine Relevanz. Wenn das Argument keinen Wert hat, dann wird als Ergebnis der Konvertierung true
zurückgegeben.
java.lang.IllegalArgumentException
- Wenn der Argumentwert nicht konvertiert werden konnte.public byte byteValue() throws java.lang.NumberFormatException
Gibt den Wert des Arguments als byte
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ byte
konvertiert.
java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public short shortValue() throws java.lang.NumberFormatException
Gibt den Wert des Arguments als short
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ short
konvertiert.
java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public int intValue() throws java.lang.NumberFormatException
Gibt den Wert des Arguments als int
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ int
konvertiert.
java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public long longValue() throws java.lang.NumberFormatException
Gibt den Wert des Arguments als long
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ long
konvertiert.
java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public float floatValue() throws java.lang.NumberFormatException
Gibt den Wert des Arguments als float
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ float
konvertiert.
java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public double doubleValue() throws java.lang.NumberFormatException
Gibt den Wert des Arguments als double
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ double
konvertiert.
java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public byte byteValueBetween(byte minimum, byte maximum) throws java.lang.NumberFormatException
Gibt den Wert des Arguments als byte
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ byte
konvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.
minimum
- Kleinster erlaubter Wert.maximum
- Größter erlaubter Wert.java.lang.IllegalArgumentException
- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public short shortValueBetween(short minimum, short maximum) throws java.lang.NumberFormatException
Gibt den Wert des Arguments als short
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ short
konvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.
minimum
- Kleinster erlaubter Wert.maximum
- Größter erlaubter Wert.java.lang.IllegalArgumentException
- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public int intValueBetween(int minimum, int maximum) throws java.lang.NumberFormatException
Gibt den Wert des Arguments als int
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ int
konvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.
minimum
- Kleinster erlaubter Wert.maximum
- Größter erlaubter Wert.java.lang.IllegalArgumentException
- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public long longValueBetween(long minimum, long maximum) throws java.lang.NumberFormatException
Gibt den Wert des Arguments als long
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ long
konvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.
minimum
- Kleinster erlaubter Wert.maximum
- Größter erlaubter Wert.java.lang.IllegalArgumentException
- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public float floatValueBetween(float minimum, float maximum) throws java.lang.NumberFormatException
Gibt den Wert des Arguments als float
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ float
konvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.
minimum
- Kleinster erlaubter Wert.maximum
- Größter erlaubter Wert.java.lang.IllegalArgumentException
- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public double doubleValueBetween(double minimum, double maximum) throws java.lang.NumberFormatException
Gibt den Wert des Arguments als double
Wert zurück. Der Argumentwert wird in einen Zahlwert vom Typ double
konvertiert und überprüft, ob der Wert nicht ausserhalb der angegebenen Grenzen liegt.
minimum
- Kleinster erlaubter Wert.maximum
- Größter erlaubter Wert.java.lang.IllegalArgumentException
- Wenn der Wert kleiner als das Minimum oder größer als das Maximum ist.java.lang.NumberFormatException
- Wenn der Argumentwert nicht konvertiert werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asFile()
Gibt den Wert des Arguments als Datei-Identifikation zurück. Der Argumentwert wird als Dateiname der Datei interpretiert.
java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asExistingFile()
Gibt den Wert des Arguments als Datei-Identifikation einer existierenden Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert.
java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asReadableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer lesbaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein lesender Zugriff erlaubt ist.
java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert oder nicht lesbar ist.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asWritableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein schreibender Zugriff erlaubt ist.
java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert oder nicht beschreibar ist.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asWritableFile(boolean createIfNotExistent) throws java.io.IOException
Gibt den Wert des Arguments als Datei-Identifikation einer beschreibaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein schreibender Zugriff erlaubt ist.
createIfNotExistent
- Wenn die spezifizierte Datei nicht existiert und dieser Parameter den Wert true
hat, wird eine neue Datei erzeugt.java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert und nicht angelegt werden sollte oder nicht beschreibar ist.java.io.IOException
- Wenn die Datei nicht angelegt werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asChangeableFile()
Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein lesender und schreibender Zugriff erlaubt ist.
java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert oder nicht nicht lesbar oder nicht beschreibar ist.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asChangeableFile(boolean createIfNotExistent) throws java.io.IOException
Gibt den Wert des Arguments als Datei-Identifikation einer änderbaren Datei zurück. Der Argumentwert wird als Dateiname der Datei interpretiert. Es wird geprüft, ob die Datei existiert und ob ein lesender und schreibender Zugriff erlaubt ist.
createIfNotExistent
- Wenn die spezifizierte Datei nicht existiert und dieser Parameter den Wert true
hat, wird eine neue Datei erzeugt.java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert und nicht angelegt werden sollte oder nicht lesbar oder nicht beschreibar ist.java.io.IOException
- Wenn die Datei nicht angelegt werden konnte.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.io.File asDirectory()
Gibt den Wert des Arguments als Datei-Identifikation eines Dateiverzeichnisses zurück. Der Argumentwert wird als Dateiname des Dateiverzeichnisses interpretiert. Es wird geprüft, ob die spezifizierte Datei existiert und ein Verzeichnis ist.
java.lang.IllegalArgumentException
- Wenn die identifizierte Datei nicht existiert oder kein Verzeichnis ist.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.lang.String asString()
Bestimmt den Wert des Arguments als Zeichenkette.
java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public java.lang.String asNonEmptyString()
Bestimmt den Wert des Arguments als nicht leere Zeichenkette.
java.lang.IllegalArgumentException
- Wenn der Argumentwert leer ist.java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.public ArgumentList.ValueCase asValueCase(ArgumentList.ValueSelection validValues)
public <E> E asEnum(java.lang.Class<E> typeClass)
Bestimmt den Wert des Arguments als Enum-Konstante.
typeClass
- Klasse von dem der Enum-Wert eingelesen werden soll. Unterstützt native Enum-Klassen und Enum-ähnliche Klassen, mit festen öffentlichen Konstanten. Groß- und Kleinschreibung wird ignoriert.java.lang.IllegalArgumentException
- Wenn der Argumentwert leer oder ungültig ist.public long asTime()
Interpretiert den Wert des Arguments als Zeitangabe. Erkannt werden absolute Zeitangabe wie in der Methode asAbsoluteTime()
und relative Zeitangaben wie in der Methode @{link #asRelativeTime}. Wenn eine relative Zeitangabe angegeben wurde, wird der angegebene Wert vom aktuellen Zeitpunkt abgezogen d.h. das Ergebnis liegt bei positiven Angaben in der Vergangenheit liegt.
public long asAbsoluteTime()
Interpretiert den Wert des Arguments als absolute Zeitangabe. Das Argument muss aus einer Zeitangabe im Format HH:MM[:SS[,mmm]] und/oder aus einer Datumsangabe im Format TT.MM.[YY]YY bestehen. Die Reihenfolge von Datum und Zeit ist egal. Wenn nur eine Zeitangabe im Argument enthalten ist, wird als Datum der Tag benutzt, an dem das Programm gestartet wurde. Wenn nur eine Datumsangabe im Argument enthalten ist, dann wird als Zeitangabe 0:00 Uhr Lokalzeit benutzt. Bei Datumsangaben mit zweistelliger Jahreszahl wird ein Jahr gewählt, das im Bereich von 80 Jahren vor und 20 Jahren nach dem aktuellen Jahr liegt. Als spezieller Wert wird der Text “jetzt” erkannt und durch die beim Aufruf der Methode aktuelle Zeit interpretiert.
public long asRelativeTime()
Interpretiert den Wert des Arguments als relative Zeitangabe. Das Argument muss aus einer Liste von Zahlen und Einheiten bestehen. Als Einheiten sind “t” und “Tag[e]” für Tage, “h” und “Stunde[n]” für Stunden, “m” und “Minute[n]” für Minuten, “s” und “Sekunde[n]” für Sekunden sowie “ms” und “Millisekunden[e]” für Millisekunden erkannt. Die Einzelnen Werte werden in Millisekunden umgerechnet und aufsummiert. Als spezieller Wert wird der Text “jetzt” erkannt und als “0 Sekunden” interpretiert.
public java.lang.String toString()
Erzeugt eine Zeichenkette, die den Namen und den Wert des Arguments enthält.
toString
in class java.lang.Object
java.lang.IllegalStateException
- Wenn das Argument keinen Wert hat.