An ObjectToSet provides a java.util.Map from arbitrary objects to objects of class java.util.Set.
/*
* LingPipe v. 3.9
* Copyright (C) 2003-2010 Alias-i
*
* This program is licensed under the Alias-i Royalty Free License
* Version 1 WITHOUT ANY WARRANTY, without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the Alias-i
* Royalty Free License Version 1 for more details.
*
* You should have received a copy of the Alias-i Royalty Free License
* Version 1 along with this program; if not, visit
* http://alias-i.com/lingpipe/licenses/lingpipe-license-1.txt or contact
* Alias-i, Inc. at 181 North 11th Street, Suite 401, Brooklyn, NY 11211,
* +1 (718) 290-9170.
*/
//package com.aliasi.util;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Set;
/**
* An <code>ObjectToSet</code> provides a {@link java.util.Map} from
* arbitrary objects to objects of class {@link java.util.Set}.
* In addition to methods inherited from {@link java.util.Map},
* there are methods to add members to a set value and get
* set values directly.
*
* @author Bob Carpenter
* @version 3.8
* @since LingPipe1.0
* @param <K> the type of keys for this mapping
* @param <M> the type of members stored in the value sets for this
* map
*/
public class ObjectToSet<K,M> extends HashMap<K,Set<M>> {
static final long serialVersionUID = -5758024598554958671L;
/**
* Construct a new object to set mapping.
*/
public ObjectToSet() {
super();
}
/**
* Add a member to the value of the set mapped to by
* the specified key.
*
* @param key Key whose set value will have the object.
* @param member Object to add to the value of the key.
*/
public void addMember(K key, M member) {
if (containsKey(key)) {
get(key).add(member);
} else {
HashSet<M> val = new HashSet<M>();
val.add(member);
put(key,val);
}
}
/**
* Removes the specified value from the set of values assigned to
* the specified key. If it is the last key, it removes the mapping
* altogether.
*
* @param key Key whose members will have the value removed.
* @param member Value to remove from the set of members assigned
* to the key.
* @return <code>true</code> if the value was in the set of
* members for the key.
*/
public boolean removeMember(K key, M member) {
if (!containsKey(key)) return false;
boolean result = get(key).remove(member);
if (get(key).size() == 0)
remove(key);
return result;
}
/**
* Adds a set of members to the value of the set mapped to by
* the specified key.
*
* @param key Key whose set value will have the object.
* @param values Values to add to the set picked out by the key.
*/
public void addMembers(K key, Set<? extends M> values) {
Set<M> memberSet = get(key);
if (memberSet == null)
put(key,new HashSet<M>(values));
else
memberSet.addAll(values);
}
/**
* Returns a set constituting the union of all of the members of
* the set values for all of the keys.
*
* @return The union of the members of the set values.
*/
public Set<M> memberValues() {
Set<M> set = new HashSet<M>();
for (Set<M> members : values())
set.addAll(members);
return set;
}
/**
* Returns the set of values for the specified key, or the empty
* set if there have been none added. This behavior only differs
* from the basic {@link #get(Object)} method in that it returns the
* empty set rather than <code>null</code>.
*/
public Set<M> getSet(K key) {
Set<M> result = get(key);
return result != null
? result
: new HashSet<M>(0);
}
}
Related examples in the same category
1. | Set, HashSet and TreeSet | | |
2. | Things you can do with Sets | | |
3. | Set operations: union, intersection, difference, symmetric difference, is subset, is superset | | |
4. | Set implementation that use == instead of equals() | | |
5. | Set that compares object by identity rather than equality | | |
6. | Set union and intersection | | |
7. | Set with values iterated in insertion order. | | |
8. | Putting your own type in a Set | | |
9. | Use set | | |
10. | Another Set demo | | |
11. | Set subtraction | | |
12. | Working with HashSet and TreeSet | | |
13. | TreeSet Demo | | |
14. | Show the union and intersection of two sets | | |
15. | Demonstrate the Set interface | | |
16. | Array Set extends AbstractSet | | |
17. | Sync Test | | |
18. | Set Copy | | |
19. | Set and TreeSet | | |
20. | Tail | | |
21. | What you can do with a TreeSet | | |
22. | Remove all elements from a set | | |
23. | Copy all the elements from set2 to set1 (set1 += set2), set1 becomes the union of set1 and set2 | | |
24. | Remove all the elements in set1 from set2 (set1 -= set2), set1 becomes the asymmetric difference of set1 and set2 | | |
25. | Get the intersection of set1 and set2, set1 becomes the intersection of set1 and set2 | | |
26. | Extend AbstractSet to Create Simple Set | | |
27. | Int Set | | |
28. | One Item Set | | |
29. | Small sets whose elements are known to be unique by construction | | |
30. | List Set implements Set | | |
31. | Converts a char array to a Set | | |
32. | Converts a string to a Set | | |
33. | Implements the Set interface, backed by a ConcurrentHashMap instance | | |
34. | An IdentitySet that uses reference-equality instead of object-equality | | |
35. | An implementation of the java.util.Stack based on an ArrayList instead of a Vector, so it is not synchronized to protect against multi-threaded access. | | |
36. | A thin wrapper around a List transforming it into a modifiable Set. | | |
37. | A thread-safe Set that manages canonical objects | | |
38. | This program uses a set to print all unique words in System.in | | |
39. | Indexed Set | | |
40. | Sorted Multi Set | | |
41. | Fixed Size Sorted Set | | |
42. | Set operations | | |
43. | A NumberedSet is a generic container of Objects where each element is identified by an integer id. | | |
44. | Set which counts the number of times a values are added to it. | | |
45. | Set which counts the number of times a values are added to it and assigns them a unique positive index. | | |
46. | Indexed Set | | |
47. | A set acts like array. | | |
48. | Implements a Bloom filter. Which, as you may not know, is a space-efficient structure for storing a set. | | |
49. | Implementation of disjoint-set data structure | | |
50. | Call it an unordered list or a multiset, this collection is defined by oxymorons | | |