You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by tn...@apache.org on 2013/05/06 00:07:53 UTC
svn commit: r1479407 -
/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/
Author: tn
Date: Sun May 5 22:07:53 2013
New Revision: 1479407
URL: http://svn.apache.org/r1479407
Log:
Add missing since tags.
Modified:
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazyMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazySortedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedSortedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedSortedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableEntrySet.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java
commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/DefaultedMap.java Sun May 5 22:07:53 2013
@@ -81,6 +81,7 @@ public class DefaultedMap<K, V> extends
* @param defaultValue the default value to return when the key is not found
* @return a new defaulting map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> DefaultedMap<K, V> defaultedMap(final Map<K, V> map, final V defaultValue) {
return new DefaultedMap<K, V>(map, ConstantTransformer.constantTransformer(defaultValue));
@@ -98,6 +99,7 @@ public class DefaultedMap<K, V> extends
* @param factory the factory to use to create entries, must not be null
* @return a new defaulting map
* @throws IllegalArgumentException if map or factory is null
+ * @since 4.0
*/
public static <K, V> DefaultedMap<K, V> defaultedMap(final Map<K, V> map, final Factory<? extends V> factory) {
if (factory == null) {
@@ -119,6 +121,7 @@ public class DefaultedMap<K, V> extends
* @param transformer the transformer to use as a factory to create entries, must not be null
* @return a new defaulting map
* @throws IllegalArgumentException if map or factory is null
+ * @since 4.0
*/
public static <K, V> Map<K, V> defaultedMap(final Map<K, V> map,
final Transformer<? super K, ? extends V> transformer) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeMap.java Sun May 5 22:07:53 2013
@@ -67,6 +67,7 @@ public class FixedSizeMap<K, V>
* @param map the map to decorate, must not be null
* @return a new fixed size map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> FixedSizeMap<K, V> fixedSizeMap(final Map<K, V> map) {
return new FixedSizeMap<K, V>(map);
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/FixedSizeSortedMap.java Sun May 5 22:07:53 2013
@@ -69,6 +69,7 @@ public class FixedSizeSortedMap<K, V>
* @param map the map to decorate, must not be null
* @return a new fixed size sorted map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> FixedSizeSortedMap<K, V> fixedSizeSortedMap(final SortedMap<K, V> map) {
return new FixedSizeSortedMap<K, V>(map);
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazyMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazyMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazyMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazyMap.java Sun May 5 22:07:53 2013
@@ -76,6 +76,7 @@ public class LazyMap<K, V> extends Abstr
* @param factory the factory to use, must not be null
* @return a new lazy map
* @throws IllegalArgumentException if map or factory is null
+ * @since 4.0
*/
public static <K, V> LazyMap<K, V> lazyMap(final Map<K, V> map, final Factory< ? extends V> factory) {
return new LazyMap<K,V>(map, factory);
@@ -90,6 +91,7 @@ public class LazyMap<K, V> extends Abstr
* @param factory the factory to use, must not be null
* @return a new lazy map
* @throws IllegalArgumentException if map or factory is null
+ * @since 4.0
*/
public static <V, K> LazyMap<K, V> lazyMap(final Map<K, V> map, final Transformer<? super K, ? extends V> factory) {
return new LazyMap<K,V>(map, factory);
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazySortedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazySortedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazySortedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/LazySortedMap.java Sun May 5 22:07:53 2013
@@ -70,6 +70,7 @@ public class LazySortedMap<K,V> extends
* @param factory the factory to use, must not be null
* @return a new lazy sorted map
* @throws IllegalArgumentException if map or factory is null
+ * @since 4.0
*/
public static <K, V> LazySortedMap<K, V> lazySortedMap(final SortedMap<K, V> map,
final Factory<? extends V> factory) {
@@ -85,6 +86,7 @@ public class LazySortedMap<K,V> extends
* @param factory the factory to use, must not be null
* @return a new lazy sorted map
* @throws IllegalArgumentException if map or factory is null
+ * @since 4.0
*/
public static <K, V> LazySortedMap<K, V> lazySortedMap(final SortedMap<K, V> map,
final Transformer<? super K, ? extends V> factory) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/ListOrderedMap.java Sun May 5 22:07:53 2013
@@ -95,6 +95,7 @@ public class ListOrderedMap<K, V>
* @param map the map to decorate, must not be null
* @return a new list ordered map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> ListOrderedMap<K, V> listOrderedMap(final Map<K, V> map) {
return new ListOrderedMap<K, V>(map);
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiKeyMap.java Sun May 5 22:07:53 2013
@@ -91,6 +91,7 @@ public class MultiKeyMap<K, V> extends A
* @param map the map to decorate, not null
* @return a new multi key map
* @throws IllegalArgumentException if the map is null or not empty
+ * @since 4.0
*/
public static <K, V> MultiKeyMap<K, V> multiKeyMap(final AbstractHashedMap<MultiKey<? extends K>, V> map) {
if (map == null) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/MultiValueMap.java Sun May 5 22:07:53 2013
@@ -81,6 +81,7 @@ public class MultiValueMap<K, V> extends
* @param <V> the value type
* @param map the map to wrap
* @return a new multi-value map
+ * @since 4.0
*/
@SuppressWarnings({ "unchecked", "rawtypes" })
public static <K, V> MultiValueMap<K, V> multiValueMap(final Map<K, ? super Collection<V>> map) {
@@ -97,6 +98,7 @@ public class MultiValueMap<K, V> extends
* @param map the map to wrap
* @param collectionClass the type of the collection class
* @return a new multi-value map
+ * @since 4.0
*/
public static <K, V, C extends Collection<V>> MultiValueMap<K, V> multiValueMap(final Map<K, ? super C> map,
final Class<C> collectionClass) {
@@ -113,6 +115,7 @@ public class MultiValueMap<K, V> extends
* @param map the map to decorate
* @param collectionFactory the collection factory (must return a Collection object).
* @return a new multi-value map
+ * @since 4.0
*/
public static <K, V, C extends Collection<V>> MultiValueMap<K, V> multiValueMap(final Map<K, ? super C> map,
final Factory<C> collectionFactory) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedMap.java Sun May 5 22:07:53 2013
@@ -73,6 +73,7 @@ public class PredicatedMap<K, V>
* @param valuePredicate the predicate to validate to values, null means no check
* @return a new predicated map
* @throws IllegalArgumentException if the map is null
+ * @since 4.0
*/
public static <K, V> PredicatedMap<K, V> predicatedMap(final Map<K, V> map,
final Predicate<? super K> keyPredicate,
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedSortedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedSortedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedSortedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/PredicatedSortedMap.java Sun May 5 22:07:53 2013
@@ -61,6 +61,7 @@ public class PredicatedSortedMap<K, V> e
* @param valuePredicate the predicate to validate to values, null means no check
* @return a new predicated sorted map
* @throws IllegalArgumentException if the map is null
+ * @since 4.0
*/
public static <K, V> PredicatedSortedMap<K, V> predicatedSortedMap(final SortedMap<K, V> map,
final Predicate<? super K> keyPredicate, final Predicate<? super V> valuePredicate) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedMap.java Sun May 5 22:07:53 2013
@@ -71,6 +71,7 @@ public class TransformedMap<K, V>
* @param valueTransformer the transformer to use for value conversion, null means no transformation
* @return a new transformed map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> TransformedMap<K, V> transformingMap(final Map<K, V> map,
final Transformer<? super K, ? extends K> keyTransformer,
@@ -93,7 +94,7 @@ public class TransformedMap<K, V>
* @param valueTransformer the transformer to use for value conversion, null means no transformation
* @return a new transformed map
* @throws IllegalArgumentException if map is null
- * @since 3.2
+ * @since 4.0
*/
public static <K, V> TransformedMap<K, V> transformedMap(final Map<K, V> map,
final Transformer<? super K, ? extends K> keyTransformer,
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedSortedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedSortedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedSortedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/TransformedSortedMap.java Sun May 5 22:07:53 2013
@@ -61,6 +61,7 @@ public class TransformedSortedMap<K, V>
* @param valueTransformer the predicate to validate to values, null means no transformation
* @return a new transformed sorted map
* @throws IllegalArgumentException if the map is null
+ * @since 4.0
*/
public static <K, V> TransformedSortedMap<K, V> transformingSortedMap(final SortedMap<K, V> map,
final Transformer<? super K, ? extends K> keyTransformer,
@@ -83,7 +84,7 @@ public class TransformedSortedMap<K, V>
* @param valueTransformer the transformer to use for value conversion, null means no transformation
* @return a new transformed sorted map
* @throws IllegalArgumentException if map is null
- * @since 3.2
+ * @since 4.0
*/
public static <K, V> TransformedSortedMap<K, V> transformedSortedMap(final SortedMap<K, V> map,
final Transformer<? super K, ? extends K> keyTransformer,
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableEntrySet.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableEntrySet.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableEntrySet.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableEntrySet.java Sun May 5 22:07:53 2013
@@ -49,6 +49,7 @@ public final class UnmodifiableEntrySet<
* @param set the set to decorate, must not be null
* @return a new unmodifiable entry set
* @throws IllegalArgumentException if set is null
+ * @since 4.0
*/
public static <K, V> Set<Map.Entry<K, V>> unmodifiableEntrySet(final Set<Map.Entry<K, V>> set) {
if (set instanceof Unmodifiable) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableMap.java Sun May 5 22:07:53 2013
@@ -57,6 +57,7 @@ public final class UnmodifiableMap<K, V>
* @param map the map to decorate, must not be null
* @return a new unmodifiable map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> Map<K, V> unmodifiableMap(final Map<K, V> map) {
if (map instanceof Unmodifiable) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableOrderedMap.java Sun May 5 22:07:53 2013
@@ -55,6 +55,7 @@ public final class UnmodifiableOrderedMa
* @param map the map to decorate, must not be null
* @return a new ordered map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> OrderedMap<K, V> unmodifiableOrderedMap(final OrderedMap<K, V> map) {
if (map instanceof Unmodifiable) {
Modified: commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java
URL: http://svn.apache.org/viewvc/commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java?rev=1479407&r1=1479406&r2=1479407&view=diff
==============================================================================
--- commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java (original)
+++ commons/proper/collections/trunk/src/main/java/org/apache/commons/collections4/map/UnmodifiableSortedMap.java Sun May 5 22:07:53 2013
@@ -55,6 +55,7 @@ public final class UnmodifiableSortedMap
* @param map the map to decorate, must not be null
* @return a new unmodifiable sorted map
* @throws IllegalArgumentException if map is null
+ * @since 4.0
*/
public static <K, V> SortedMap<K, V> unmodifiableSortedMap(final SortedMap<K, V> map) {
if (map instanceof Unmodifiable) {