com.urbanairship.api.channel.model.attributes.Attribute Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of java-client Show documentation
The Urban Airship Java client library
There is a newer version: 9.7.0
package com.urbanairship.api.channel.model.attributes;

import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.google.common.base.Preconditions;
import com.urbanairship.api.common.parse.DateFormats;
import org.joda.time.DateTime;

import java.util.Map;
import java.util.Optional;

/**
 * Object that represents individual attributes.
 */
public class Attribute {
    private final AttributeAction action;
    private final String key;
    private final Optional value;
    private final Optional timeStamp;

    private Attribute(Builder builder) {
        this.action = builder.action;
        this.key = builder.key;
        this.value = Optional.ofNullable(builder.value);
        this.timeStamp = Optional.ofNullable(builder.timeStamp);
    }

    /**
     * New attribute builder.
     *
     * @return Builder
     */
    public static Builder newBuilder() {
        return new Builder();
    }

    /**
     * Get the attribute action.
     *
     * @return AttributeAction action
     */
    public AttributeAction getAction() {
        return action;
    }

    /**
     * Get the attribute key.
     *
     * @return String key
     */
    public String getKey() {
        return key;
    }

    /**
     * Get the value for the attribute.
     *
     * @return Optional String value
     */
    public Optional getValue() {
        return value;
    }

    /**
     * Get the timestamp when the attribute changed.
     *
     * @return Optional DateTime timestamp
     */
    public Optional getTimeStamp() {
        return timeStamp;
    }

    /**
     * Create Attribute Builder
     */
    public static class Builder {
        AttributeAction action;
        String key;
        JsonNode value;
        DateTime timeStamp;
        private static final ObjectMapper MAPPER = new ObjectMapper();

        /**
         * Indicates that you want to set or remove an attribute on the audience.
         *
         * @param action AttributeAction
         * @return Builder
         */
        public Builder setAction(AttributeAction action) {
            this.action = action;
            return this;
        }

        /**
         * The attribute key you want to set.
         *
         * @param key String
         * @return Builder
         */
        public Builder setKey(String key) {
            this.key = key;
            return this;
        }

        /**
         * Set the timestamp when the attribute changed. If no timestamp is provided, Airship uses the current time.
         *
         * @param timeStamp DateTime
         * @return Builder
         */
        public Builder setTimeStamp(DateTime timeStamp) {
            this.timeStamp = timeStamp;
            return this;
        }

        /**
         * The value that you want to set for an attribute. Accepts strings for integer/number type attributes,
         * but your string must be convertible to a number or the request will fail.
         *
         * @param value String
         * @return Builder
         */
        public Builder setValue(String value) {
            this.value = MAPPER.convertValue(value, JsonNode.class);
            return this;
        }

        /**
         * The value that you want to set for an attribute. Accepts numbers for integer/number type attributes.
         *
         * @param value Number
         * @return Builder
         */
        public Builder setValue(Number value) {
            this.value = MAPPER.convertValue(value, JsonNode.class);
            return this;
        }

        /**
         * The value that you want to set for an attribute. Accepts booleans.
         *
         * @param value Boolean
         * @return Builder
         */
        public Builder setValue(Boolean value) {
            this.value = MAPPER.convertValue(value, JsonNode.class);
            return this;
        }

        /**
         * Sets the value as a string representation of the DateTime object.
         *
         * @param value DateTime
         * @return Builder
         */
        public Builder setValue(DateTime value) {
            String formatted = DateFormats.DATE_FORMATTER.print(value);
            this.value = MAPPER.convertValue(formatted, JsonNode.class);
            return this;
        }

        /**
         * Sets the value as a JSON object node.
         *
         * @param node JsonNode
         * @return Builder
         */
        public Builder setValue(JsonNode node) {
            this.value = node;
            return this;
        }

        /**
         * Sets the value from a Map, converting it to a JSON object.
         *
         * @param map Map of properties
         * @return Builder
         */
        public Builder setValue(Map map) {
            this.value = MAPPER.valueToTree(map);
            return this;
        }


        public Attribute build() {
            Preconditions.checkNotNull(action, "Attribute action must be set.");
            Preconditions.checkNotNull(key, "key must be set.");

            if (action.equals(AttributeAction.SET)) {
                Preconditions.checkNotNull(value, "Value must not be null when setting attributes");
            }

            return new Attribute(this);
        }
    }
}