Collection.java

package java.util;
import checkers.nullness.quals.*;
@checkers.quals.DefaultQualifier("checkers.nullness.quals.NonNull")

// Subclasses of this interface/class may opt to contain nonnull references.
public interface Collection<E extends @NonNull Object> extends Iterable<E> {
  public abstract int size();
  public abstract boolean isEmpty();
  // not true, because map could contain nulls:  AssertParametersNonNull("get(#0)")
  public abstract boolean contains(@Nullable Object a1);
  public abstract Iterator<E> iterator();
  // The Nullness Checker does NOT use these signatures for either version
  // of toArray; rather, the checker has hard-coded rules for those two
  // methods, because the most useful type for toArray is not expressible
  // in the surface syntax that the nullness annotations support.
  public abstract Object [] toArray();
  public abstract <T> @Nullable T [] toArray(T[] a1);
  public abstract boolean add(E a1);
  public abstract boolean remove(@Nullable Object a1);
  public abstract boolean containsAll(Collection<?> a1);
  public abstract boolean addAll(Collection<? extends E> a1);
  public abstract boolean removeAll(Collection<?> a1);
  public abstract boolean retainAll(Collection<?> a1);
  public abstract void clear();
  public abstract boolean equals(@Nullable Object a1);
  public abstract int hashCode();
}