com.android.jack.api.v01.ChainedException Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jack-api Show documentation
API to dynamically load Jack
The newest version!
/*
 * Copyright (C) 2014 The Android Open Source Project
 *
 * 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.android.jack.api.v01;

import java.util.ArrayList;
import java.util.Iterator;

import javax.annotation.CheckForNull;
import javax.annotation.Nonnegative;
import javax.annotation.Nonnull;

/**
 * Abstract class to easily chain exceptions together.
 *
 * The exception can be managed like any other exception. In this case, the first one will be the
 * only one used.
 *
 * Special management can use the {@link #iterator()} or the {@link #getNextException()} to browse
 * all chained exceptions and dispatch them.
 *
 * See {@link ChainedExceptionBuilder} to build the chain of exceptions.
 */
public abstract class ChainedException extends Exception
    implements Iterable {
  private static final long serialVersionUID = 1L;

  @Nonnull
  private String message;

  @Nonnegative
  private int count = 1;

  @Nonnull
  private ChainedException tail = this;

  @CheckForNull
  private ChainedException next = null;

  /**
   * Construct the exception with a {@link String} message.
   * @param message the message
   */
  public ChainedException(@Nonnull String message) {
    super("");
    this.message = message;
  }

  /**
   * Construct the exception with a {@link String} message and a {@link Throwable} cause.
   * @param message the message
   * @param cause the cause
   */
  public ChainedException(@Nonnull String message, @Nonnull Throwable cause) {
    super("", cause);
    this.message = message;
  }

  /**
   * Construct the exception with a {@link Throwable} cause.
   * @param cause the cause
   */
  public ChainedException(@Nonnull Throwable cause) {
    super(cause);
    this.message = cause.getMessage();
  }

  @Override
  @Nonnull
  public String getMessage() {
    return message;
  }

  @Override
  @Nonnull
  public String getLocalizedMessage() {
    return message;
  }

  /**
   * Set the {@link String} message.
   * @param message the message
   */
  public void setMessage(@Nonnull String message) {
    this.message = message;
  }

  @Nonnull
  protected ChainedException putAsLastExceptionOf(
      @CheckForNull ChainedException head) {
    if (head == null) {
      this.tail  = this;
      this.next  = null;
      this.count = 1;

      return this;
    } else {
      head.tail.next = this;
      head.tail = this;
      head.count++;

      return head;
    }
  }

  /**
   * Get the next exception chained to this exception.
   * @return the next exception
   */
  @CheckForNull
  public ChainedException getNextException() {
    return next;
  }

  /**
   * @return the number of chained exception
   */
  @Nonnegative
  public int getNextExceptionCount() {
    return count;
  }

  @Override
  @Nonnull
  public Iterator iterator() {
    ArrayList list = new ArrayList(count);

    ChainedException exception = this;
    do {
      list.add(exception);
      exception = exception.next;
    } while (exception != null);

    return list.iterator();
  }

  /**
   * Builder to construct a chain of exceptions.
   * @param  the type of a {@link ChainedException}
   */
  public static class ChainedExceptionBuilder {
    @CheckForNull
    private T head = null;

    /**
     * Append a chain of exceptions to the current chain of exceptions.
     * @param exceptions the chain of exceptions to append
     */
    @SuppressWarnings("unchecked")
    public void appendException(@Nonnull T exceptions) {
      for (ChainedException exception : exceptions) {
        head = (T) exception.putAsLastExceptionOf(head);
      }
    }

    /**
     * Throw the head of the chain of exceptions is at least one has been appended.
     * @throws T the exception
     */
    public void throwIfNecessary() throws T {
      if (head != null) {
        throw head;
      }
    }

    /**
     * @return the head of the chain of exceptions
     */
    @Nonnull
    public T getException() {
      assert head != null;
      return head;
    }
  }
}