*/
package org.opendaylight.yangtools.util;
+import static java.util.Objects.requireNonNull;
+
import com.google.common.annotations.Beta;
-import com.google.common.base.Preconditions;
import com.google.common.collect.Iterators;
import java.io.Serializable;
import java.util.Collection;
import java.util.Iterator;
import java.util.Set;
-import javax.annotation.Nonnull;
+import java.util.Spliterator;
+import org.eclipse.jdt.annotation.NonNull;
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
import org.opendaylight.yangtools.concepts.Immutable;
/**
public abstract class SingletonSet<E> implements Set<E>, Immutable, Serializable {
private static final long serialVersionUID = 1L;
- private static final SingletonSet<?> NULL_SINGLETON = new SingletonSet<Object>() {
+ private static final SingletonSet<?> NULL_SINGLETON = new SingletonSet<>() {
private static final long serialVersionUID = 1L;
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public boolean contains(final Object o) {
return o == null;
}
@Override
+ @SuppressWarnings("checkstyle:equalsHashCode")
public int hashCode() {
return 0;
}
@Override
- public Object getElement() {
+ public @Nullable Object getElement() {
return null;
}
@Override
- public String toString() {
+ public @NonNull Spliterator<Object> spliterator() {
+ return SingletonSpliterators.immutableOfNull();
+ }
+
+ @Override
+ public @NonNull String toString() {
return "[null]";
}
};
@SuppressWarnings("unchecked")
- public static <E> SingletonSet<E> of(@Nonnull final E element) {
- if (element == null) {
- return (SingletonSet<E>) NULL_SINGLETON;
- }
- return new RegularSingletonSet<>(element);
+ public static <E> @NonNull SingletonSet<E> of(final @Nullable E element) {
+ return element == null ? (SingletonSet<E>) NULL_SINGLETON : new RegularSingletonSet<>(element);
}
+ /**
+ * Return the single element contained in this set.
+ *
+ * @return This set's element.
+ */
public abstract E getElement();
@Override
}
@Override
- public final Iterator<E> iterator() {
+ public final @NonNull Iterator<E> iterator() {
return Iterators.singletonIterator(getElement());
}
@Override
- public final Object[] toArray() {
+ public abstract @NonNull Spliterator<E> spliterator();
+
+ @Override
+ public final @NonNull Object[] toArray() {
return new Object[] { getElement() };
}
- @SuppressWarnings("unchecked")
+ @SuppressWarnings({ "unchecked", "checkstyle:parameterName" })
@Override
- public final <T> T[] toArray(final T[] a) {
+ public final <T> @NonNull T[] toArray(final T[] a) {
if (a.length > 0) {
a[0] = (T)getElement();
return a;
}
- return (T[]) new Object[] { (T) getElement() };
+ return (T[]) new Object[] {getElement()};
}
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public final boolean add(final E e) {
throw new UnsupportedOperationException();
}
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public final boolean remove(final Object o) {
throw new UnsupportedOperationException();
}
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public final boolean containsAll(final Collection<?> c) {
- if (c.isEmpty()) {
- return true;
- }
- if (c.size() != 1) {
- return false;
- }
-
- return otherContains(c);
+ return c.isEmpty() || c.size() == 1 && otherContains(c);
}
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public final boolean addAll(final Collection<? extends E> c) {
throw new UnsupportedOperationException();
}
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public final boolean retainAll(final Collection<?> c) {
throw new UnsupportedOperationException();
}
@Override
+ @SuppressWarnings("checkstyle:parameterName")
public final boolean removeAll(final Collection<?> c) {
throw new UnsupportedOperationException();
}
public abstract int hashCode();
@Override
+ @SuppressWarnings("checkstyle:equalsHashCode")
public final boolean equals(final Object obj) {
if (obj == this) {
return true;
return s.size() == 1 && otherContains(s);
}
- private boolean otherContains(final Collection<?> other) {
+ private boolean otherContains(final @NonNull Collection<?> other) {
try {
return other.contains(getElement());
} catch (ClassCastException | NullPointerException e) {
}
}
+ @NonNullByDefault
private static final class RegularSingletonSet<E> extends SingletonSet<E> {
private static final long serialVersionUID = 1L;
+
private final E element;
RegularSingletonSet(final E element) {
- this.element = Preconditions.checkNotNull(element);
+ this.element = requireNonNull(element);
}
@Override
- public boolean contains(final Object o) {
+ @SuppressWarnings("checkstyle:parameterName")
+ public boolean contains(final @Nullable Object o) {
return element.equals(o);
}
}
@Override
+ @SuppressWarnings("checkstyle:equalsHashCode")
public int hashCode() {
return getElement().hashCode();
}
public String toString() {
return "[" + element + ']';
}
+
+ @Override
+ public Spliterator<E> spliterator() {
+ return SingletonSpliterators.immutableOf(element);
+ }
}
}