org.elasticsearch.common.collect.XMaps Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of elasticsearch
ElasticSearch - Open Source, Distributed, RESTful Search Engine
There is a newer version: 8.14.1
/*
 * Licensed to ElasticSearch and Shay Banon under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership. ElasticSearch licenses this
 * file to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License 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 org.elasticsearch.common.collect;

import gnu.trove.impl.Constants;

import java.util.Map;

import org.elasticsearch.ElasticSearchIllegalArgumentException;
import org.elasticsearch.common.trove.ExtTHashMap;

import com.google.common.collect.ForwardingMap;

/**
 * This class provides factory methods for Maps. The returned {@link Map}
 * instances are general purpose maps and non of the method guarantees a
 * concrete implementation unless the return type is a concrete type. The
 * implementations used might change over time, if you rely on a specific
 * Implementation you should use a concrete constructor.
 */
public final class XMaps {

    public static final int DEFAULT_CAPACITY = Constants.DEFAULT_CAPACITY;

    /**
     * Returns a new map with the given initial capacity
     */
    public static  Map newMap(int capacity) {
        return new ExtTHashMap(capacity, Constants.DEFAULT_LOAD_FACTOR);
    }

    /**
     * Returns a new map with a default initial capacity of
     * {@value #DEFAULT_CAPACITY}
     */
    public static  Map newMap() {
        return newMap(DEFAULT_CAPACITY);
    }

    /**
     * Returns a map like {@link #newMap()} that does not accept null keys
     */
    public static  Map newNoNullKeysMap() {
        Map delegate = newMap();
        return ensureNoNullKeys(delegate);
    }

    /**
     * Returns a map like {@link #newMap(in)} that does not accept null keys
     */
    public static  Map newNoNullKeysMap(int capacity) {
        Map delegate = newMap(capacity);
        return ensureNoNullKeys(delegate);
    }

    /**
     * Wraps the given map and prevent adding of null keys.
     */
    public static  Map ensureNoNullKeys(final Map delegate) {
        return new ForwardingMap() {
            @Override
            public V put(K key, V value) {
                if (key == null) {
                    throw new ElasticSearchIllegalArgumentException("Map key must not be null");
                }
                return super.put(key, value);
            }

            @Override
            protected Map delegate() {
                return delegate;
            }
        };
    }
}