com.google.android.gcm.server.Message Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of gcm-server Show documentation
Project for releasing Maven artifact of gcm-server package
The newest version!
/*
 * Copyright Google Inc.
 *
 * 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 com.google.android.gcm.server;

import java.io.Serializable;
import java.util.Collections;
import java.util.LinkedHashMap;
import java.util.Map;

/**
 * GCM message.
 *
 * 
 * Instances of this class are immutable and should be created using a
 * {@link Builder}. Examples:
 *
 * Simplest message:
 * 

 * Message message = new Message.Builder().build();
 * 
 *
 * Message with optional attributes:
 * 
 * Message message = new Message.Builder()
 *    .collapseKey(collapseKey)
 *    .timeToLive(3)
 *    .delayWhileIdle(true)
 *    .dryRun(true)
 *    .restrictedPackageName(restrictedPackageName)
 *    .build();
 * 
 *
 * Message with optional attributes and payload data:
 * 
 * Message message = new Message.Builder()
 *    .priority("normal")
 *    .collapseKey(collapseKey)
 *    .timeToLive(3)
 *    .delayWhileIdle(true)
 *    .dryRun(true)
 *    .restrictedPackageName(restrictedPackageName)
 *    .addData("key1", "value1")
 *    .addData("key2", "value2")
 *    .build();
 * 
 */
public final class Message implements Serializable {

  private final String collapseKey;
  private final Boolean delayWhileIdle;
  private final Integer timeToLive;
  private final Map data;
  private final Boolean dryRun;
  private final String restrictedPackageName;
  private final String priority;
  private final Notification notification;

  public enum Priority {
    NORMAL, HIGH
  }

  public static final class Builder {

    private final Map data;

    // optional parameters
    private String collapseKey;
    private Boolean delayWhileIdle;
    private Integer timeToLive;
    private Boolean dryRun;
    private String restrictedPackageName;
    private String priority;
    private Notification notification;

    public Builder() {
      this.data = new LinkedHashMap();
    }

    /**
     * Sets the collapseKey property.
     */
    public Builder collapseKey(String value) {
      collapseKey = value;
      return this;
    }

    /**
     * Sets the delayWhileIdle property (default value is {@literal false}).
     */
    public Builder delayWhileIdle(boolean value) {
      delayWhileIdle = value;
      return this;
    }

    /**
     * Sets the time to live, in seconds.
     */
    public Builder timeToLive(int value) {
      timeToLive = value;
      return this;
    }

    /**
     * Adds a key/value pair to the payload data.
     */
    public Builder addData(String key, String value) {
      data.put(key, value);
      return this;
    }

    /**
     * Sets the dryRun property (default value is {@literal false}).
     */
    public Builder dryRun(boolean value) {
      dryRun = value;
      return this;
    }

    /**
     * Sets the restrictedPackageName property.
     */
    public Builder restrictedPackageName(String value) {
      restrictedPackageName = value;
      return this;
    }

    /**
     * Sets the priority property.
     */
    public Builder priority(Priority value) {
      switch(value) {
        case NORMAL:
          priority = Constants.MESSAGE_PRIORITY_NORMAL;
          break;
        case HIGH:
          priority = Constants.MESSAGE_PRIORITY_HIGH;
          break;
      }
      return this;
    }

    /**
     * Sets the notification property.
     */
    public Builder notification(Notification value) {
      notification = value;
      return this;
    }

    public Message build() {
      return new Message(this);
    }

  }

  private Message(Builder builder) {
    collapseKey = builder.collapseKey;
    delayWhileIdle = builder.delayWhileIdle;
    data = Collections.unmodifiableMap(builder.data);
    timeToLive = builder.timeToLive;
    dryRun = builder.dryRun;
    restrictedPackageName = builder.restrictedPackageName;
    priority = builder.priority;
    notification = builder.notification;
  }

  /**
   * Gets the collapse key.
   */
  public String getCollapseKey() {
    return collapseKey;
  }

  /**
   * Gets the delayWhileIdle flag.
   */
  public Boolean isDelayWhileIdle() {
    return delayWhileIdle;
  }

  /**
   * Gets the time to live (in seconds).
   */
  public Integer getTimeToLive() {
    return timeToLive;
  }

  /**
   * Gets the dryRun flag.
   */
  public Boolean isDryRun() {
    return dryRun;
  }

  /**
   * Gets the restricted package name.
   */
  public String getRestrictedPackageName() {
    return restrictedPackageName;
  }

  /**
   * Gets the message priority value.
   */
  public String getPriority() {
    return priority;
  }

  /**
   * Gets the payload data, which is immutable.
   */
  public Map getData() {
    return data;
  }

  /**
   * Gets notification payload, which is immutable.
   */
  public Notification getNotification() {
    return notification;
  }

  @Override
  public String toString() {
    StringBuilder builder = new StringBuilder("Message(");
    if (priority != null) {
      builder.append("priority=").append(priority).append(", ");
    }
    if (collapseKey != null) {
      builder.append("collapseKey=").append(collapseKey).append(", ");
    }
    if (timeToLive != null) {
      builder.append("timeToLive=").append(timeToLive).append(", ");
    }
    if (delayWhileIdle != null) {
      builder.append("delayWhileIdle=").append(delayWhileIdle).append(", ");
    }
    if (dryRun != null) {
      builder.append("dryRun=").append(dryRun).append(", ");
    }
    if (restrictedPackageName != null) {
      builder.append("restrictedPackageName=").append(restrictedPackageName).append(", ");
    }
    if (notification != null) {
      builder.append("notification: ").append(notification).append(", ");
    }
    if (!data.isEmpty()) {
      builder.append("data: {");
      for (Map.Entry entry : data.entrySet()) {
        builder.append(entry.getKey()).append("=").append(entry.getValue())
            .append(",");
      }
      builder.delete(builder.length() - 1, builder.length());
      builder.append("}");
    }
    if (builder.charAt(builder.length() - 1) == ' ') {
      builder.delete(builder.length() - 2, builder.length());
    }
    builder.append(")");
    return builder.toString();
  }

}