at.ac.univie.isc.asio.tool.Beans.java Source code

Introduction

Here is the source code for at.ac.univie.isc.asio.tool.Beans.java

Source

/*
 * #%L
 * asio common
 * %%
 * Copyright (C) 2013 - 2015 Research Group Scientific Computing, University of Vienna
 * %%
 * Licensed 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.
 * #L%
 */
package at.ac.univie.isc.asio.tool;

import com.google.common.collect.ImmutableMap;
import com.google.common.collect.ImmutableSet;

import java.util.Arrays;
import java.util.Map;
import java.util.Properties;

/**
 * Utility methods to work with beans and collections.
 */
public final class Beans {
    private Beans() {
        /* no instances */ }

    /**
     * Create a copy of given input properties.
     *
     * @param input source properties
     * @param exclude keys of properties that should be omitted
     * @return map of copied properties
     */
    public static Map<String, String> copyToMap(final Properties input, final String... exclude) {
        final ImmutableSet<String> excluded = ImmutableSet.copyOf(exclude);
        final ImmutableMap.Builder<String, String> clone = ImmutableMap.builder();
        for (String key : input.stringPropertyNames()) {
            if (!excluded.contains(key)) {
                clone.put(key, input.getProperty(key));
            }
        }
        return clone.build();
    }

    /**
     * Create a {@link Properties} instance holding all entries from the given map.
     *
     * @param map source map
     * @return properties with all entries of input map
     */
    public static Properties asProperties(final Map<String, String> map) {
        final Properties result = new Properties();
        result.putAll(map);
        return result;
    }

    /**
     * Create an array holding every member of the {@code input} array and every additional
     * {@code extension} argument. This method will always return a fresh array, even if no
     * {@code extension} arguments are given.
     *
     * @param input the source array
     * @param extension additional arguments to be merged with input
     * @param <T> type of array contents
     * @return new array containing all member of {@code input} and all other arguments.
     */
    @SafeVarargs
    public static <T> T[] extend(final T[] input, final T... extension) {
        final T[] result = Arrays.copyOf(input, input.length + extension.length);
        System.arraycopy(extension, 0, result, input.length, extension.length);
        return result;
    }
}