de.xima.fc.utils

Class CollectionUtils

java.lang.Object

de.xima.fc.utils.CollectionUtils

public final class CollectionUtils
extends Object

Hilfsklasse für die Verarbeitung von Collection-basierten Entitäten.

Method Summary

Methods

Modifier and Type	Method and Description
static <T> void	addAll(Collection<? super T> targetColl, T[] elemsToAdd) Fügt der übergebenen Collection Elemente hinzu.
static void	addIndexed(Collection<IIndexed> indexedColl, IIndexed newIndexed) Setzt am übergebenen Element den Wert für IIndexed.idxNum auf '[aktuell höchste IIndexed.idxNum in der Collection] + 1' und fügt es in die übergebene Collection ein.
static boolean	contains(List<? extends AbstractLockableEntity> ael, AbstractLockableEntity entity) Prüft, ob die übergebene Liste ein Element enthält, das gleich dem übergebenen Element im folgenden Sinne ist: beide Elemente müssen vom gleichen Typ sein beide Elemente müssen die gleiche Entitäts-ID besitzen
static ArrayList<? extends IIndexed>	createSortedList(Collection<? extends IIndexed> indexedColl) Erstellt eine (in jedem Fall neue) IIndexed-Liste mit aufsteigenden Indizes.
static void	defrag(Collection<? extends IIndexed> indexedColl) Setzt die Indizes der übergebenen Elemente in der Form, dass die Reihenfolge unverändert bleibt, jede idxNum (bis auf die des ersten Elements, die 0 ist) aber nur jeweils um Eins größer als die idxNum des vorhergehenden Elementes ist.
static boolean	intersect(List<? extends AbstractLockableEntity> ael1, List<? extends AbstractLockableEntity> ael2) Prüft, ob mindestens ein Element der ersten Liste in der zweiten Liste enthalten ist, wobei mittels contains(List, AbstractLockableEntity) verglichen wird.
static int	maxIndex(Collection<IIndexed> indexedColl) Liefert den aktuell höchsten idxNum-Wert, der innerhalb der übergebenen Collection vergeben wurde.
static void	swapIndex(IIndexed firstIndexed, IIndexed secIndexed) Vertauscht die Indizes der übergebenen Elemente.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

addAll

public static <T> void addAll(Collection<? super T> targetColl,
              T[] elemsToAdd)

Fügt der übergebenen Collection Elemente hinzu.

Type Parameters:

T - Der (Super-)Typ der Elemente in der Ziel-Collection.

Parameters:

targetColl - - Ziel-Collection

elemsToAdd - - Die Elemente, die der Ziel-Collection hinzugefügt werden sollen.

maxIndex

public static int maxIndex(Collection<IIndexed> indexedColl)

Liefert den aktuell höchsten idxNum-Wert, der innerhalb der übergebenen Collection vergeben wurde. Ist die Collection leer, wird die Zahl 0 zurückgegeben.

Parameters:

indexedColl - - die zu untersuchende Collection.

Returns:

Den höchsten innerhalb der Collection vergebenen Wert für das Attribut IIndexed.idxNum.

addIndexed

public static void addIndexed(Collection<IIndexed> indexedColl,
              IIndexed newIndexed)

Setzt am übergebenen Element den Wert für IIndexed.idxNum auf '[aktuell höchste IIndexed.idxNum in der Collection] + 1' und fügt es in die übergebene Collection ein.

Wurde für das neue Element bereits ein Index vergeben, wird dieser Wert überschrieben.

Gibt der Aufruf von 'indexedColl.add(newIndexed)' false zurück (bspw. wenn diese Collection das Element bereits enthält, aber keine Duplikate unterstützt) wird eine IllegalArgumentException geworfen.

Parameters:

indexedColl - Ziel-Collection.

newIndexed - neues Element.

swapIndex

public static void swapIndex(IIndexed firstIndexed,
             IIndexed secIndexed)

Vertauscht die Indizes der übergebenen Elemente.

Parameters:

firstIndexed - erstes Element

secIndexed - zweites Element

createSortedList

public static ArrayList<? extends IIndexed> createSortedList(Collection<? extends IIndexed> indexedColl)

Erstellt eine (in jedem Fall neue) IIndexed-Liste mit aufsteigenden Indizes. Evtl. in der Quell- Collection enthaltene null-Werte werden ignoriert, was dazu führen kann, dass die Ergebnisliste weniger Elemente enthält, als die -Collection.

Parameters:

indexedColl - Quell-Collection.

Returns:

die resultierende Liste.

defrag

public static void defrag(Collection<? extends IIndexed> indexedColl)

Setzt die Indizes der übergebenen Elemente in der Form, dass die Reihenfolge unverändert bleibt, jede idxNum (bis auf die des ersten Elements, die 0 ist) aber nur jeweils um Eins größer als die idxNum des vorhergehenden Elementes ist. Elemente, die null sind werden ignoriert.

Parameters:

indexedColl - Die Elemente.

intersect

public static boolean intersect(List<? extends AbstractLockableEntity> ael1,
                List<? extends AbstractLockableEntity> ael2)

Prüft, ob mindestens ein Element der ersten Liste in der zweiten Liste enthalten ist, wobei mittels contains(List, AbstractLockableEntity) verglichen wird.

Parameters:

ael1 - erste Entitätenliste.

ael2 - zweite Entitätenliste.

Returns:

true, wenn mindestens ein Element der ersten Liste in der zweiten Liste enthalten ist, ansonsten false.

contains

public static boolean contains(List<? extends AbstractLockableEntity> ael,
               AbstractLockableEntity entity)

Prüft, ob die übergebene Liste ein Element enthält, das gleich dem übergebenen Element im folgenden Sinne ist:

1. beide Elemente müssen vom gleichen Typ sein
2. beide Elemente müssen die gleiche Entitäts-ID besitzen

Parameters:

ael - die Entitätenliste.

entity - Die Entität, nach der gesucht werden soll.

Returns:

true, wenn mindestens ein Element der Liste gleich dem übergebenen Element (im oben genannten Sinne) ist, ansonsten false.

Throws:

NullPointerException - wenn entity null ist.