org.attribyte.api.http.NamedValues.java Source code

Introduction

Here is the source code for org.attribyte.api.http.NamedValues.java

Source

/*
 * Copyright 2014 Attribyte, LLC
 *
 * 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.
 *
 */

package org.attribyte.api.http;

import com.google.common.base.Joiner;
import com.google.common.base.Strings;
import com.google.common.collect.ImmutableList;

import java.util.Collection;

/**
 * Utilities for headers and parameters.
 */
public class NamedValues {

    /**
     * Copies values from an array to an immutable list.
     * Empty or <code>null</code> values are ignored.
     * @param values The input values.
     * @return The internal values.
     */
    static final ImmutableList<String> copyValues(final String[] values) {
        if (values == null || values.length == 0) {
            return ImmutableList.of();
        } else {
            ImmutableList.Builder<String> builder = ImmutableList.builder();
            for (final String value : values) {
                if (!Strings.isNullOrEmpty(value)) {
                    builder.add(value);
                }
            }
            return builder.build();
        }
    }

    /**
     * Copies values from a collection to an immutable list.
     * Empty or <code>null</code> values are ignored.
     * @param values The input values.
     * @return The internal values.
     */
    static final ImmutableList<String> copyValues(final Collection<String> values) {
        if (values == null) {
            return ImmutableList.of();
        } else {
            ImmutableList.Builder<String> builder = ImmutableList.builder();
            for (final String value : values) {
                if (!Strings.isNullOrEmpty(value)) {
                    builder.add(value);
                }
            }
            return builder.build();
        }
    }

    static final Joiner valueJoiner = Joiner.on(',').useForNull("[null]");

    /**
     * Creates a string for named values.
     * @param name The name.
     * @param values The collection of values.
     * @return The string.
     */
    static final String toString(final String name, final Collection<String> values) {
        return values != null ? name + "=" + valueJoiner.join(values) : name + "=";
    }
}