com.amazonaws.util.ImmutableMapParameter Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of aws-java-sdk-core Show documentation
Show all versions of aws-java-sdk-core Show documentation
The AWS SDK for Java - Core module holds the classes that are used by the individual service clients to interact with Amazon Web Services. Users need to depend on aws-java-sdk artifact for accessing individual client classes.
/*
* Copyright 2010-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License").
* You may not use this file except in compliance with the License.
* A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed
* on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
* express or implied. See the License for the specific language governing
* permissions and limitations under the License.
*/
package com.amazonaws.util;
import java.util.Collection;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;
import java.util.Set;
/**
* An immutable map that could be built by convenient constructors.
*
* Example of using map Builder:
*
*
* {
* @code
* Map<String, AttributeValue> item = new ImmutableMapParameter.Builder<String, AttributeValue>()
* .put("one", new AttributeValue("1"))
* .put("two", new AttributeValue("2"))
* .put("three", new AttributeValue("3")).build();
* }
*
*
* For small immutable maps (up to five entries), the
* {@code ImmutableMapParamter.of()} methods are preferred:
*
*
* {@code
* Map item =
* ImmutableMapParameter
* .of("one", new AttributeValue("1"),
* "two", new AttributeValue("2"),
* "three", new AttributeValue("3"),
* }
*
*
* @param
* Class of the key for the map.
* @param
* Class of the value for the map.
*/
public class ImmutableMapParameter implements Map {
private static final String UNMODIFIABLE_MESSAGE = "This is an immutable map.";
private static final String DUPLICATED_KEY_MESSAGE = "Duplicate keys are provided.";
private final Map map;
private ImmutableMapParameter(Map map) {
this.map = map;
}
/**
* Returns a new MapParameterBuilder instance.
*/
public static Builder builder() {
return new Builder();
}
/**
* Returns an ImmutableMapParameter instance containing a single entry.
*
* @param k0
* Key of the single entry.
* @param v0
* Value of the single entry.
*/
public static ImmutableMapParameter of(K k0, V v0) {
Map map = Collections.singletonMap(k0, v0);
return new ImmutableMapParameter(map);
}
/**
* Returns an ImmutableMapParameter instance containing two entries.
*
* @param k0
* Key of the first entry.
* @param v0
* Value of the first entry.
* @param k1
* Key of the second entry.
* @param v1
* Value of the second entry.
*/
public static ImmutableMapParameter of(K k0, V v0, K k1, V v1) {
Map map = new HashMap();
putAndWarnDuplicateKeys(map, k0, v0);
putAndWarnDuplicateKeys(map, k1, v1);
return new ImmutableMapParameter(map);
}
/**
* Returns an ImmutableMapParameter instance containing three entries.
*
* @param k0
* Key of the first entry.
* @param v0
* Value of the first entry.
* @param k1
* Key of the second entry.
* @param v1
* Value of the second entry.
* @param k2
* Key of the third entry.
* @param v2
* Value of the third entry.
*/
public static ImmutableMapParameter of(K k0, V v0, K k1, V v1,
K k2, V v2) {
Map map = new HashMap();
putAndWarnDuplicateKeys(map, k0, v0);
putAndWarnDuplicateKeys(map, k1, v1);
putAndWarnDuplicateKeys(map, k2, v2);
return new ImmutableMapParameter(map);
}
/**
* Returns an ImmutableMapParameter instance containing four entries.
*
* @param k0
* Key of the first entry.
* @param v0
* Value of the first entry.
* @param k1
* Key of the second entry.
* @param v1
* Value of the second entry.
* @param k2
* Key of the third entry.
* @param v2
* Value of the third entry.
* @param k3
* Key of the fourth entry.
* @param v3
* Value of the fourth entry.
*/
public static ImmutableMapParameter of(K k0, V v0, K k1, V v1,
K k2, V v2, K k3, V v3) {
Map map = new HashMap();
putAndWarnDuplicateKeys(map, k0, v0);
putAndWarnDuplicateKeys(map, k1, v1);
putAndWarnDuplicateKeys(map, k2, v2);
putAndWarnDuplicateKeys(map, k3, v3);
return new ImmutableMapParameter(map);
}
/**
* Returns an ImmutableMapParameter instance containing five entries.
*
* @param k0
* Key of the first entry.
* @param v0
* Value of the first entry.
* @param k1
* Key of the second entry.
* @param v1
* Value of the second entry.
* @param k2
* Key of the third entry.
* @param v2
* Value of the third entry.
* @param k3
* Key of the fourth entry.
* @param v3
* Value of the fourth entry.
* @param k4
* Key of the fifth entry.
* @param v4
* Value of the fifth entry.
*/
public static ImmutableMapParameter of(K k0, V v0, K k1, V v1,
K k2, V v2, K k3, V v3, K k4, V v4) {
Map map = new HashMap();
putAndWarnDuplicateKeys(map, k0, v0);
putAndWarnDuplicateKeys(map, k1, v1);
putAndWarnDuplicateKeys(map, k2, v2);
putAndWarnDuplicateKeys(map, k3, v3);
putAndWarnDuplicateKeys(map, k4, v4);
return new ImmutableMapParameter(map);
}
/** Inherited methods **/
public boolean containsKey(Object key) {
return map.containsKey(key);
}
public boolean containsValue(Object value) {
return map.containsValue(value);
}
public Set> entrySet() {
return map.entrySet();
}
public V get(Object key) {
return map.get(key);
}
public boolean isEmpty() {
return map.isEmpty();
}
public Set keySet() {
return map.keySet();
}
public int size() {
return map.size();
}
public Collection values() {
return map.values();
}
/** Unsupported methods **/
public void clear() {
throw new UnsupportedOperationException(UNMODIFIABLE_MESSAGE);
}
public V put(K key, V value) {
throw new UnsupportedOperationException(UNMODIFIABLE_MESSAGE);
}
public void putAll(Map map) {
throw new UnsupportedOperationException(UNMODIFIABLE_MESSAGE);
}
public V remove(Object key) {
throw new UnsupportedOperationException(UNMODIFIABLE_MESSAGE);
}
private static void putAndWarnDuplicateKeys(Map map, K key,
V value) {
if (map.containsKey(key))
throw new IllegalArgumentException(DUPLICATED_KEY_MESSAGE);
map.put(key, value);
}
@Override
public boolean equals(Object o) {
return map.equals(o);
}
@Override
public int hashCode() {
return map.hashCode();
}
@Override
public String toString() {
return map.toString();
}
/**
* A convenient builder for creating ImmutableMapParameter instances.
*/
public static class Builder {
private final Map entries;
public Builder() {
this.entries = new HashMap();
}
/**
* Add a key-value pair into the built map. The method will throw
* IllegalArgumentException immediately when duplicate keys are
* provided.
*
* @return Returns a reference to this object so that method calls can
* be chained together.
*/
public Builder put(K key, V value) {
putAndWarnDuplicateKeys(entries, key, value);
return this;
}
/**
* Generates and returns a new ImmutableMapParameter instance which
* contains all the entries added into the Builder by {@code put()}
* method.
*/
public ImmutableMapParameter build() {
HashMap builtMap = new HashMap();
builtMap.putAll(entries);
return new ImmutableMapParameter(builtMap);
}
}
}