org.nuiton.util

Class AliasMap<K,V,A>

java.lang.Object

java.util.AbstractMap<K,V>

java.util.HashMap<K,V>

org.nuiton.util.AliasMap<K,V,A>

All Implemented Interfaces:

Serializable, Cloneable, Map<K,V>

public class AliasMap<K,V,A>
extends HashMap<K,V>

Une map base sur une HashMap qui permet pour une valeur d'ajouter d'autres cles. Cette nouvelle cle est un alias, un alias peut-etre utilise pour plusieurs valeurs. Si l'on demande la valeur associe a un Alias, cela retourne une liste contenant toutes les valeurs pour lequel cette Alias est utilise. Cela permet de stocker des objets avec une cle principale et unique, puis avec des alias. Et ainsi recherche les valeurs qui ont un ensemble d'alias via la methode getValueAlias(java.lang.Object[]) ou supprimer les valeurs qui ont un ensemble d'Alias en commun via la methode removeValue(A...) Si la cle ne vous importe que peu, vous pouvez par exemple utiliser UUID.randomUUID() pour generer une cle unique.

Since:

3.6.9 Last update: $Date: 2013-03-03 16:20:18 +0100 (Sun, 03 Mar 2013) $ by : $Author: tchemit $

Version:

$Revision: 2521 $

Author:

poussin

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.util.AbstractMap

AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.collections.map.MultiValueMap	aliases key: alias, value: key
protected org.apache.commons.collections.map.MultiValueMap	keys key: key, value: alias

Constructor Summary

Constructors

Constructor and Description
AliasMap()

Method Summary

Methods

Modifier and Type	Method and Description
Collection<A>	getAlias(K key) Retourne la liste d'alias associee avec une cle
Collection<K>	getKeyAlias(A... alias) Retoure les cles en commun de tous les alias.
Collection<V>	getValueAlias(A... alias) Retoure les valeurs en commun de tous les alias.
V	put(K key, V value, A alias1, A... alias) Ajoute une valeur dans la map avec un ensemble d'alias associe
protected void	putAlias(K key, A alias1, A... alias) Ajoute des alias a une cle
V	remove(Object key) Retire une cle ainsi que tous ses alias
void	removeAlias(A... alias) Supprime des alias quelque soit leur cle
Collection<V>	removeValue(A... alias) Supprime toutes les valeurs et leur cle associe aux alias

Methods inherited from class java.util.HashMap

clear, clone, containsKey, containsValue, entrySet, get, isEmpty, keySet, put, putAll, size, values

Methods inherited from class java.util.AbstractMap

equals, hashCode, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Map

equals, hashCode

Field Detail

aliases

protected org.apache.commons.collections.map.MultiValueMap aliases

key: alias, value: key

keys

protected org.apache.commons.collections.map.MultiValueMap keys

key: key, value: alias

Constructor Detail

AliasMap

public AliasMap()

Method Detail

put

public V put(K key,
    V value,
    A alias1,
    A... alias)

Ajoute une valeur dans la map avec un ensemble d'alias associe

Parameters:

key - identifiant unique pour cette valeur

value - la valeur

alias - les alias de la valeur

Returns:

putAlias

protected void putAlias(K key,
            A alias1,
            A... alias)

Ajoute des alias a une cle

Parameters:

key -

alias1 -

alias -

getKeyAlias

public Collection<K> getKeyAlias(A... alias)

Retoure les cles en commun de tous les alias. Les cles retournees sont celle qui ont tous les alias.

 K1: a, b, c
 K2: b, c, d
 K3: c, d, e

 getKeyAlias(a, b, c) retourne [K1]
 getKeyAlias(b, c) retourne [K1, K2]
 getKeyAlias(c) retourne [K1, K2, K3]
 getKeyAlias(d) retourne [K2, K3]
 getKeyAlias(z) retourne []
 

Parameters:

alias -

Returns:

une liste vide si aucune valeur ne correspond au alias en argument

getValueAlias

public Collection<V> getValueAlias(A... alias)

Retoure les valeurs en commun de tous les alias. Les valeurs retournees sont celle qui ont tous les alias.

 V1: a, b, c
 V2: b, c, d
 V3: c, d, e

 getKeyAlias(a, b, c) retourne [V1]
 getKeyAlias(b, c) retourne [V1, V2]
 getKeyAlias(c) retourne [V1, V2, V3]
 getKeyAlias(d) retourne [V2, V3]
 getKeyAlias(z) retourne []
 

Parameters:

alias -

Returns:

une liste vide si aucune valeur ne correspond au alias en argument

getAlias

public Collection<A> getAlias(K key)

Retourne la liste d'alias associee avec une cle

 K1: a, b, c
 K2: b, c, d
 K3: c, d, e

 getAlias(K1) retourne [a, b, c]
 getAlias(k3) retourne [c, d, e]
 getKeyAlias(k9) retourne []
 

Parameters:

key -

Returns:

remove

public V remove(Object key)

Retire une cle ainsi que tous ses alias

 K1: a, b, c
 K2: b, c, d
 K3: c, d, e

 remove(K1) il reste K2: [b, c, d], K3: [c, d, e]
 

Specified by:

remove in interface Map<K,V>

Overrides:

remove in class HashMap<K,V>

Parameters:

key -

Returns:

removeValue

public Collection<V> removeValue(A... alias)

Supprime toutes les valeurs et leur cle associe aux alias

 K1: a, b, c
 K2: b, c, d
 K3: c, d, e

 removeValue(b, c) il reste K3: [c, d, e]
 

Parameters:

alias -

Returns:

la liste de valeur qui a ete supprime de la map

removeAlias

public void removeAlias(A... alias)

Supprime des alias quelque soit leur cle

 K1: a, b, c
 K2: b, c, d
 K3: c, d, e

 removeAlias(a, b) alors K1: [c], k2: [c, d], k3: [c, d, e]
 removeAlias(c) alors K1: [a, b], k2: [b, d], k3: [d, e]
 getKeyAlias(z) alors rien ne change car cette alias n'existe pas
 

Parameters:

alias -