Datentyp List

Wertebereich des Datentyps List

In FirstSpirit können Elemente der Vorlagenentwicklung in:

• Listen (List)
• Mengen (Set)
• Maps

gruppiert werden.

Für die Bearbeitung von Werten, die eine geordnete, indizierte Menge von Listenelemente repräsentieren, stellt FirstSpirit den Datentyp List zur Verfügung. Dieser Datentyp ermöglicht eine Gruppierung von Elementen. Listen sind sehr flexibel und beliebig erweiterbar. Über die Angabe eines Indexwertes, der die Position innerhalb der Liste bestimmt, kann definiert werden, an welcher Position der Liste ein Element eingefügt oder ausgelesen werden soll. Im Gegensatz zum Datentyp Set können Elemente innerhalb einer Liste mehrfach vorkommen.

Der Datentyp List kann auch in der Sun API-Dokumentation nachgeschlagen werden:

java.util.List

Definition

Listen lassen sich auch über [ ] (eckige Klammern) erzeugen. Dabei muss folgende Syntax erfüllt sein:

LISTE := '[]' | [ AUSDRUCK [',' AUSDRUCK ]* ] ']' | '[' AUSDRUCK' .. ' AUSDRUCK ']'

Das folgende Codebeispiel erzeugt eine leere Liste und weist diese der Variablen empty_list zu:

$CMS_SET(empty_list, [])$

Soll eine gefüllte Liste erzeugt werden, also eine Liste, die bereits Elemente enthält, werden die Elemente einfach als kommaseparierte Liste innerhalb der eckigen Klammern übergeben. Das Codebeispiel erzeugt eine neue, gefüllte Liste list:

$CMS_SET(list, [1,2,3])$

Durch die Angabe des Indexes kann die Position bestimmt werden, an der der übergebene Wert eingefügt werden soll. Bereits bestehende Werte werden dabei überschrieben. Codebeispiel:

$CMS_SET(list[0], "4")$

Ausgabe:

[4, 2, 3]

Zugriff auf Elemente der Liste

Der Zugriff auf die Elemente einer Liste erfolgt über den Index der Liste.

Der Index kann durch einen konstanten Wert:

list[2] 

oder über eine Variable definiert werden:

list[i]

analog dazu:

list.get(2)

list.get(i)

Beispiele:

$CMS_VALUE(list.get(2))$ 

oder:

$CMS_SET(i, 2)$
$CMS_VALUE(list, [i])$

Beide Beispiele liefern das dritte Element der Liste zurück (Index beginnt immer mit 0!).

Analog dazu kann ein neues Listenelement über den Index an eine bestimmte Position der Liste gesetzt werden:

$CMS_SET(list[0], "new")$

Die Zeichenkette new wird mit dieser Anweisung an die erste Position der Liste gesetzt.

Es können auch alle Element einer Liste gleichzeitig gesetzt werden. Die Position ist dann abhängig von der Reihenfolge der Elemente innerhalb der Anweisung $CMS_SET(list, [...])$.

$CMS_SET(list, ["a","b","c"])$

Sortieren der Listenelemente

Mit der Methode sort lassen sich Listen aufsteigend sortieren:

$CMS_SET(list, ["C", "E", "B", "D", "A"])$
$CMS_VALUE(list.sort)$

Die Ausgabe lautet:

[A, B, C, D, E]

Die Methode reverse kehrt die Reihenfolge der Listenelemente um:

$CMS_SET(list, ["C", "E", "B", "D", "A"])$
$CMS_VALUE(list.reverse)$

Ausgabe:

[A, D, B, E, C]

Durch Kombination beider Methoden erhält man eine absteigende Sortierung:

$CMS_SET(list, ["C", "E", "B", "D", "A"])$
$CMS_VALUE(list.sort.reverse)$

Ausgabe:

[E, D, C, B, A]

Methoden auf List-Objekten

In der unten angegebenen Tabelle werden alle Methoden aufgelistet, die auf Objekten von Datentyp List aufgerufen werden können:

add(List)

Übersicht

add(Object)

Übersicht

add(int, Object)

Übersicht

addAll(Collection)

Übersicht

addAll(int, Collection)

Übersicht

clear

Übersicht

contains(Object)

Übersicht

containsAll(Collection)

Übersicht

copy

Übersicht

copyOf(Collection)

Übersicht

distinct(Lambda)

Über diese Methode können Duplikate einer Liste entsprechend einer Bedingung eliminiert bzw. ignoriert werden. Sie kann z. B. für Glossare oder Übersichten verwendet werden, die dann beispielsweise verlinkt auch als Navigationselement dienen können.

Siehe Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

equals(Object)

Übersicht

filter(String)

Übersicht

filter(Lambda)

Haben Listen mehrere Attribute pro Element (vergleichbar einem Datensatz mit mehreren Spalten), können die Elemente mit der Methode .filter(Lambda) nach den einzelnen Attributen gefiltert werden.

Siehe dazu Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

first

Übersicht

fold(Lambda, Map)

Siehe Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

forEach(Consumer)

Übersicht

get(Range)

Übersicht

get(int)

Übersicht

getClass

Die Methode .getClass() (in Bean-Syntax: .class) liefert die Klasse des aufrufendes Objektes zurück (vgl. java.lang.Class).

Aufruf:

$CMS_VALUE(myString.class)$
$CMS_VALUE(myString.getClass())$

Ausgabe:

java.lang.String

Übersicht

hashCode

Übersicht

indexOf(Object)

Übersicht

isCase(Object)

Übersicht

isEmpty

Die Methode .isEmpty() (in Bean-Syntax: .isEmpty) prüft, ob ein Ausdruck bzw. Objekt leer ist, z. B. storeElement.isEmpty(). Das Ergebnis der semantischen Prüfung hängt vom Ausdruck bzw. Objekt ab, z. B. eine Zeichenkette ist dann leer, wenn sie kein Zeichen enthält. Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt, wann es leer ist. Der Datentyp DomElement enthält beispielsweise immer ein leeres Dokument, ist also nie null. Die Prüfung einer leeren DOM-Editor-Eingabekomponente mit der Methode .isNull() liefert daher den Wert false, während die Prüfung der Komponente auf .isEmpty() den Wert true liefern würde.

Die Methode .isEmpty() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt leer ist und false (=unwahr) wenn nicht.

Übersicht

isNull

Die Methode .isNull() (in Bean-Syntax: .isNull) prüft, ob ein Ausdruck bzw. Objekt Null ist, z. B. storeElement.isNull(). Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt, wann es null ist. Der Datentyp DomElement enthält beispielsweise immer ein leeres Dokument, ist also nie null. Die Prüfung einer leeren DOM-Editor-Eingabekomponente mit der Methode .isNull() liefert daher den Wert false, während die Prüfung der Komponente auf .isEmpty() den Wert true liefern würde.

Die Methode .isNull() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt Null ist und false (=unwahr) wenn nicht.

Übersicht

iterator

Übersicht

last

Übersicht

lastIndexOf(Object)

Übersicht

length

Übersicht

listIterator

Übersicht

listIterator(int)

Übersicht

map(String)

Übersicht

map(Lambda)

Siehe Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

max

Übersicht

max(Comparator)

Übersicht

max(Lambda)

Siehe Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

min

Übersicht

min(Comparator)

Übersicht

min(Lambda)

Siehe Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

of

Übersicht

of(Object[])

Übersicht

of(Object)

Übersicht

of(Object, Object)

Übersicht

of(Object, Object, Object)

Übersicht

of(Object, Object, Object, Object)

Übersicht

of(Object, Object, Object, Object, Object)

Übersicht

of(Object, Object, Object, Object, Object, Object)

Übersicht

of(Object, Object, Object, Object, Object, Object, Object)

Übersicht

of(Object, Object, Object, Object, Object, Object, Object, Object)

Übersicht

of(Object, Object, Object, Object, Object, Object, Object, Object, Object)

Übersicht

of(Object, Object, Object, Object, Object, Object, Object, Object, Object, Object)

Übersicht

plus(Collection)

Übersicht

plus(Object)

Übersicht

print

Übersicht

print(Object)

Übersicht

remove(int)

Übersicht

remove(Object)

Übersicht

removeAll(Collection)

Übersicht

removeIf(Predicate)

Übersicht

replaceAll(UnaryOperator)

Übersicht

retainAll(Collection)

Übersicht

reverse

Übersicht

set(int, Object)

Übersicht

set(String, Object)

Übersicht

size

Übersicht

sort

Übersicht

sort(String)

Übersicht

sort(Comparator)

Übersicht

sort(Lambda)

Haben Listen mehrere Attribute pro Element (vergleichbar einem Datensatz mit mehreren Spalten), können die Elemente mit der Methode .sort(Lambda) nach den einzelnen Attributen sortiert werden.

Siehe dazu Seite Abbildungs-Ausdrücke (Lambda).

Übersicht

spliterator

Übersicht

subList(int)

Übersicht

subList(int, int)

Übersicht

sublist(int)

Übersicht

sublist(int, int)

Übersicht

toArray

Übersicht

toArray(Object[])

Übersicht

toArray(IntFunction)

Übersicht

toJSON

Übersicht

toList

Übersicht

toString

Übersicht

toString(String)

Unter der Angabe eines individuell wählbaren Trennzeichens können die einzelnen Elemente, z.B. einer Liste, zu einem String zusammengeführt werden, wobei das Trennzeichen zur Abtrennung der einzelnen Elemente verwendet wird.

Beispiel:

$CMS_SET(myList, ["Haus","Schlüssel","Fenster"])$
$CMS_VALUE(myList.toString("; "))$

Die Elemente der Liste myList werden mit Semikolon und Leerzeichen voneinander getrennt ausgegeben:

Haus; Schlüssel; Fenster

Übersicht

toString(String, String)

Übersicht

type

Übersicht