info.freelibrary.vertx.s3.UserMetadata Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of vertx-super-s3 Show documentation
An S3 client library for the Vert.x toolkit
There is a newer version: 1.3.3

package info.freelibrary.vertx.s3;

import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import java.util.Objects;

import info.freelibrary.util.Logger;
import info.freelibrary.util.LoggerFactory;
import info.freelibrary.util.StringUtils;

/**
 * S3 user metadata.
 */
public class UserMetadata {

    private static final Logger LOGGER = LoggerFactory.getLogger(UserMetadata.class, Constants.BUNDLE_NAME);

    private static final String AWS_VALUE_DELIMITER = ",";

    private static final Locale DEFAULT_LOCALE = Locale.getDefault();

    private final List myMetadata;

    /**
     * Creates new user metadata for attaching to S3 objects.
     */
    public UserMetadata() {
        myMetadata = new ArrayList<>();
    }

    /**
     * Creates new user metadata using the supplied metadata name and value. AWS canonical metadata rules requires
     * that the supplied name is lower-cased (so this is done automatically).
     *
     * @param aName
     * @param aValue
     */
    public UserMetadata(final String aName, final String aValue) {
        Objects.requireNonNull(aName, LOGGER.getMessage(MessageCodes.SS3_003));

        myMetadata = new ArrayList<>();
        myMetadata.add(new NameValuePair(aName, aValue));
    }

    /**
     * Adds a new key-value pair to the S3 user metadata. If you add a metadata name that already exists, the new
     * value is added to the old one, with a comma as the delimiter.
     *
     * @param aName A metadata property name
     * @param aValue A metadata value
     * @return The user metadata object itself
     */
    @SuppressWarnings("PMD.ForLoopCanBeForeach")
    public UserMetadata add(final String aName, final String aValue) {
        Objects.requireNonNull(aName, LOGGER.getMessage(MessageCodes.SS3_003));

        boolean found = false;

        // Check to make sure we don't already have metadata with the same name
        for (int index = 0; index < myMetadata.size(); index++) {
            if (myMetadata.get(index).myName.equals(aName.toLowerCase(DEFAULT_LOCALE))) {
                final String oldValue = myMetadata.get(index).getValue();
                final String newValue = aValue != null ? StringUtils.trimTo(aValue, "") : "";

                if (!"".equals(newValue)) {
                    myMetadata.get(index).setValue(oldValue + AWS_VALUE_DELIMITER + newValue);
                }

                found = true;
            }
        }

        // If we don't have metadata with this name already, add it
        if (!found) {
            myMetadata.add(new NameValuePair(aName, aValue));
        }

        return this;
    }

    /**
     * Remove the user metadata associated with the supplied property name.
     *
     * @param aName A metadata property name
     * @return The user metadata object itself
     */
    public UserMetadata remove(final String aName) {
        Objects.requireNonNull(aName, LOGGER.getMessage(MessageCodes.SS3_003));

        myMetadata.remove(indexOf(aName));

        return this;
    }

    /**
     * Gets the value of the supplied name.
     *
     * @param aName A property name
     * @return The value of the supplied name
     */
    public String getValue(final String aName) {
        Objects.requireNonNull(aName, LOGGER.getMessage(MessageCodes.SS3_003));

        final int index = indexOf(aName);

        return index == -1 ? null : myMetadata.get(index).getValue();
    }

    /**
     * Gets the name at the supplied index position.
     *
     * @param aIndex An index position
     * @return The property name at the supplied index position
     */
    public String getValue(final int aIndex) {
        return myMetadata.get(aIndex).getValue();
    }

    /**
     * Gets the name at the supplied index position.
     *
     * @param aIndex An index position
     * @return The property name at the supplied index position
     */
    public String getName(final int aIndex) {
        return myMetadata.get(aIndex).getName();
    }

    /**
     * The number of metadata properties in the user metadata object.
     *
     * @return The number of metadata properties in the user metadata object
     */
    public int count() {
        return myMetadata.size();
    }

    /**
     * Whether the user metadata contains the supplied metadata name.
     *
     * @param aName A metadata property to check
     * @return True if the metadata property exists; else, false
     */
    public boolean contains(final String aName) {
        Objects.requireNonNull(aName, LOGGER.getMessage(MessageCodes.SS3_003));
        return indexOf(aName) != -1;
    }

    /**
     * Get the index position of the supplied name.
     *
     * @param aName A metadata property name
     * @return The index position of the supplied name
     */
    public int indexOf(final String aName) {
        Objects.requireNonNull(aName, LOGGER.getMessage(MessageCodes.SS3_003));

        final String name = aName.toLowerCase(DEFAULT_LOCALE);

        for (int index = 0; index < myMetadata.size(); index++) {
            if (myMetadata.get(index).getName().equals(name)) {
                return index;
            }
        }

        return -1;
    }

    class NameValuePair {

        private final String myName;

        private String myValue;

        NameValuePair(final String aName, final String aValue) {
            myName = aName.toLowerCase(DEFAULT_LOCALE);
            myValue = aValue;
        }

        private String getName() {
            return myName;
        }

        private String getValue() {
            return myValue;
        }

        private NameValuePair setValue(final String aValue) {
            myValue = aValue;
            return this;
        }
    }
}