com.google.android.gcm.server.Result 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.List;

/**
 * Result of a GCM message request that returned HTTP status code 200.
 *
 * 
 * If the message is successfully created, the {@link #getMessageId()} returns
 * the message id and {@link #getErrorCodeName()} returns {@literal null};
 * otherwise, {@link #getMessageId()} returns {@literal null} and 
 * {@link #getErrorCodeName()} returns the code of the error.
 *
 * 

 * There are cases when a request is accept and the message successfully
 * created, but GCM has a canonical registration id for that device. In this
 * case, the server should update the registration id to avoid rejected requests
 * in the future.
 * 
 * 

 * In a nutshell, the workflow to handle a result is:
 * 
 *   - Call {@link #getMessageId()}:
 *     - {@literal null} means error, call {@link #getErrorCodeName()}
 *     - non-{@literal null} means the message was created:
 *       - Call {@link #getCanonicalRegistrationId()}
 *         - if it returns {@literal null}, do nothing.
 *         - otherwise, update the server datastore with the new id.
 * 
 */
public final class Result implements Serializable {

  private final String messageId;
  private final String canonicalRegistrationId;
  private final String errorCode;
  private final Integer success;
  private final Integer failure;
  private final List failedRegistrationIds;

  public static final class Builder {

    // optional parameters
    private String messageId;
    private String canonicalRegistrationId;
    private String errorCode;
    private Integer success;
    private Integer failure;
    private List failedRegistrationIds;

    public Builder canonicalRegistrationId(String value) {
      canonicalRegistrationId = value;
      return this;
    }

    public Builder messageId(String value) {
      messageId = value;
      return this;
    }

    public Builder errorCode(String value) {
      errorCode = value;
      return this;
    }

    public Builder success(Integer value) {
      success = value;
      return this;
    }

    public Builder failure(Integer value) {
      failure = value;
      return this;
    }

    public Builder failedRegistrationIds(List value) {
      failedRegistrationIds = value;
      return this;
    }

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

  private Result(Builder builder) {
    canonicalRegistrationId = builder.canonicalRegistrationId;
    messageId = builder.messageId;
    errorCode = builder.errorCode;
    success = builder.success;
    failure = builder.failure;
    failedRegistrationIds = builder.failedRegistrationIds;
  }

  /**
   * Gets the message id, if any.
   */
  public String getMessageId() {
    return messageId;
  }

  /**
   * Gets the canonical registration id, if any.
   */
  public String getCanonicalRegistrationId() {
    return canonicalRegistrationId;
  }

  /**
   * Gets the error code, if any.
   */
  public String getErrorCodeName() {
    return errorCode;
  }

  public Integer getSuccess() {
    return success;
  }

  public Integer getFailure() {
    return failure;
  }

  public List getFailedRegistrationIds() {
    return failedRegistrationIds;
  }

  @Override
  public String toString() {
    StringBuilder builder = new StringBuilder("[");
    if (messageId != null) { 
      builder.append(" messageId=").append(messageId);
    }
    if (canonicalRegistrationId != null) {
      builder.append(" canonicalRegistrationId=")
          .append(canonicalRegistrationId);
    }
    if (errorCode != null) { 
      builder.append(" errorCode=").append(errorCode);
    }
    if (success != null) {
      builder.append(" groupSuccess=").append(success);
    }
    if (failure != null) {
      builder.append(" groupFailure=").append(failure);
    }
    if (failedRegistrationIds != null) {
      builder.append(" failedRegistrationIds=").append(failedRegistrationIds);
    }
    return builder.append(" ]").toString();
  }

}