/*
 * Copyright (c) 2010, 2017 Oracle and/or its affiliates. All rights reserved.
 *
 * This program and the accompanying materials are made available under the
 * terms of the Eclipse Public License v. 2.0, which is available at
 * http://www.eclipse.org/legal/epl-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception, which is available at
 * https://www.gnu.org/software/classpath/license.html.
 *
 * SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0
 */

package org.glassfish.grizzly.utils;

import java.lang.reflect.Array;
import java.util.Arrays;
import java.util.Collection;
import java.util.Iterator;
import java.util.NoSuchElementException;
import java.util.Set;

The thread safe set implementation, which uses array to hold its elements. This set could be used, for cases, which require minimum set modifications.
Author:Alexey Stashok
/** * The thread safe set implementation, which uses array to hold its elements. * This set could be used, for cases, which require minimum set modifications. * * @author Alexey Stashok */
public class ArraySet<T> implements Set<T> { private volatile T[] array; private final Object sync = new Object(); private final Class<T> clazz; private final boolean replaceElementIfEquals; @SuppressWarnings("unchecked") public ArraySet(final Class<T> clazz) { this(clazz, true); } @SuppressWarnings("unchecked") public ArraySet(final Class<T> clazz, final boolean replaceElementIfEquals) { this.clazz = clazz; this.replaceElementIfEquals = replaceElementIfEquals; }
Add the element(s) to the set.
Params:
  • elements – the elements to add.
Returns:true, if at least one element was added to the set and, as result, the size of the set was increased, or false, all element(s) was/were present in the set and, as the result, the set values were just reset.
/** * Add the element(s) to the set. * * @param elements the elements to add. * @return <tt>true</tt>, if at least one element was added to the set and, * as result, the size of the set was increased, or <tt>false</tt>, all * element(s) was/were present in the set and, as the result, the set values * were just reset. */
@SuppressWarnings("unchecked") public final boolean addAll(final T... elements) { if (elements == null || elements.length == 0) { return false; } synchronized (sync) { int startIdx = 0; if (array == null) { array = (T[]) Array.newInstance(clazz, 1); array[0] = elements[0]; startIdx = 1; } boolean result = false; for (int i = startIdx; i < elements.length; i++) { final T element = elements[i]; final T[] oldArray = array; array = ArrayUtils.addUnique(array, element, replaceElementIfEquals); result |= (oldArray != array); } return result; } }
{@inheritDoc}
/** * {@inheritDoc} */
@Override @SuppressWarnings("unchecked") public boolean addAll(Collection<? extends T> collection) { if (collection.isEmpty()) { return false; } synchronized (sync) { boolean initArray = array == null; if (initArray) { array = (T[]) Array.newInstance(clazz, 1); } boolean result = false; for (T element : collection) { if (initArray) { initArray = false; array[0] = element; continue; } final T[] oldArray = array; array = ArrayUtils.addUnique(array, element, replaceElementIfEquals); result |= (oldArray != array); } return result; } }
Add all the elements from the source ArraySet.
Params:
  • source – the elements to add.
Returns:true, if at least one element was added to the set and, as result, the size of the set was increased, or false, all element(s) was/were present in the set and, as the result, the set values were just reset.
/** * Add all the elements from the source <tt>ArraySet</tt>. * * @param source the elements to add. * @return <tt>true</tt>, if at least one element was added to the set and, * as result, the size of the set was increased, or <tt>false</tt>, all * element(s) was/were present in the set and, as the result, the set values * were just reset. */
public final boolean add(ArraySet<T> source) { final T[] sourceArraySet = source.getArray(); if (sourceArraySet == null) { return false; } synchronized (sync) { if (array == null) { array = Arrays.copyOf(sourceArraySet, sourceArraySet.length); return true; } boolean result = false; for (int i = 0; i < sourceArraySet.length; i++) { final T element = sourceArraySet[i]; final T[] oldArray = array; array = ArrayUtils.addUnique(array, element, replaceElementIfEquals); result |= (oldArray != array); } return result; } }
Remove element(s) from the set.
Params:
  • elements – the element(s) to remove.
Returns:true, if at least one element was found and removed, or false otherwise.
/** * Remove element(s) from the set. * * @param elements the element(s) to remove. * @return <tt>true</tt>, if at least one element was found and removed, * or <tt>false</tt> otherwise. */
public final boolean removeAll(Object... elements) { if (elements.length == 0) { return false; } synchronized (sync) { if (array == null) { return false; } boolean result = false; for (Object element : elements) { final T[] oldArray = array; array = ArrayUtils.remove(array, element); result |= (oldArray != array); } return result; } }
Get the underlying array. Please note, it's not appropriate to modify the returned array's content. Please use add(Object) and remove(Object) instead.
Returns:the array.
/** * Get the underlying array. * Please note, it's not appropriate to modify the returned array's content. * Please use {@link #add(Object)} and {@link #remove(Object)} instead. * * @return the array. */
public final T[] getArray() { return array; }
Get the copy of the underlying array. If the underlying array is null - then null will be returned.
Returns:the copy of the underlying array. If the underlying array is null - then null will be returned.
/** * Get the copy of the underlying array. If the underlying array is * <tt>null</tt> - then <tt>null</tt> will be returned. * * @return the copy of the underlying array. If the underlying array is * <tt>null</tt> - then <tt>null</tt> will be returned. */
public final T[] getArrayCopy() { final T[] localArray = array; if (localArray == null) { return null; } return Arrays.copyOf(localArray, localArray.length); }
Get the copy of the underlying array. If the underlying array is null - then empty array will be returned.
Returns:the copy of the underlying array. If the underlying array is null - then empty array will be returned.
/** * Get the copy of the underlying array. If the underlying array is * <tt>null</tt> - then empty array will be returned. * * @return the copy of the underlying array. If the underlying array is * <tt>null</tt> - then empty array will be returned. */
@SuppressWarnings("unchecked") public final T[] obtainArrayCopy() { final T[] localArray = array; if (localArray == null) return (T[]) Array.newInstance(clazz, 0); return Arrays.copyOf(localArray, localArray.length); }
Remove all the set elements.
/** * Remove all the set elements. */
@Override public void clear() { array = null; } //===================== java.util.Set =================================
{@inheritDoc}
/** * {@inheritDoc} */
@Override public int size() { final T[] localArray = array; return localArray != null ? localArray.length : 0; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public boolean isEmpty() { return size() == 0; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override @SuppressWarnings("unchecked") public boolean add(final T element) { if (element == null) { return false; } synchronized (sync) { if (array == null) { array = (T[]) Array.newInstance(clazz, 1); array[0] = element; return true; } final T[] oldArray = array; array = ArrayUtils.addUnique(array, element, replaceElementIfEquals); return oldArray != array; } }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public boolean contains(Object o) { final Object[] localArray = array; if (localArray == null) { return false; } for (int i = 0; i < localArray.length; i++) { if (localArray[i].equals(o)) { return true; } } return false; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public Object[] toArray() { final Object[] localArray = array; return Arrays.copyOf(localArray, localArray.length); }
{@inheritDoc}
/** * {@inheritDoc} */
@Override @SuppressWarnings("unchecked") public <K> K[] toArray(K[] a) { final Object[] localArray = array; if (localArray == null) { return a; } final int size = localArray.length; if (a.length < size) { // Make a new array of a's runtime type, but my contents: return (K[]) Arrays.copyOf(localArray, size, a.getClass()); } System.arraycopy(localArray, 0, a, 0, localArray.length); if (a.length > size) { a[size] = null; } return a; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public boolean remove(Object o) { return removeAll(o); }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public boolean containsAll(Collection<?> collection) { if (collection.isEmpty()) { return true; } final Object[] localArray = array; for (Object element : collection) { if (ArrayUtils.indexOf(localArray, element) == -1) { return false; } } return true; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override @SuppressWarnings("unchecked") public boolean retainAll(final Collection<?> collection) { final T[] localArray = array; if (localArray == null) { return false; } final T[] newArray = (T[]) Array.newInstance(clazz, Math.min(localArray.length, collection.size())); int newSize = 0; for (int i = 0; i < localArray.length; i++) { final T elem = localArray[i]; if (collection.contains(elem)) { newArray[newSize++] = elem; } } if (newSize == localArray.length) { return false; } array = Arrays.copyOf(newArray, newSize); return true; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override @SuppressWarnings("unchecked") public boolean removeAll(Collection<?> collection) { final T[] localArray = array; if (localArray == null) { return false; } final T[] newArray = (T[]) Array.newInstance(clazz, localArray.length); int newSize = 0; for (int i = 0; i < localArray.length; i++) { final T elem = localArray[i]; if (!collection.contains(elem)) { newArray[newSize++] = elem; } } if (newSize == localArray.length) { return false; } array = Arrays.copyOf(newArray, newSize); return true; }
{@inheritDoc}
/** * {@inheritDoc} */
@Override public Iterator<T> iterator() { return new Itr(); }
Iterator
/** * Iterator */
private class Itr implements Iterator<T> { int cursor; // index of next element to return T lastRet; // last returned element T nextElem; public Itr() { advance(); } @Override public boolean hasNext() { return nextElem != null; } @SuppressWarnings("unchecked") @Override public T next() { if (nextElem == null) throw new NoSuchElementException(); lastRet = nextElem; advance(); return lastRet; } @Override public void remove() { if (lastRet == null) { throw new IllegalStateException(); } ArraySet.this.remove(lastRet); cursor--; lastRet = null; } @SuppressWarnings("unchecked") private void advance() { final Object[] localArray = array; if (localArray == null || cursor >= localArray.length) { nextElem = null; return; } nextElem = (T) localArray[cursor++]; } } }