com.gs.collections.impl.set.mutable.SynchronizedMutableSet Maven / Gradle / Ivy
Show all versions of gs-collections Show documentation
/*
* Copyright 2015 Goldman Sachs.
*
* 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.gs.collections.impl.set.mutable;
import java.io.Serializable;
import java.util.Collection;
import java.util.Collections;
import java.util.Set;
import java.util.concurrent.ExecutorService;
import com.gs.collections.api.LazyIterable;
import com.gs.collections.api.block.function.Function;
import com.gs.collections.api.block.function.Function2;
import com.gs.collections.api.block.function.primitive.BooleanFunction;
import com.gs.collections.api.block.function.primitive.ByteFunction;
import com.gs.collections.api.block.function.primitive.CharFunction;
import com.gs.collections.api.block.function.primitive.DoubleFunction;
import com.gs.collections.api.block.function.primitive.FloatFunction;
import com.gs.collections.api.block.function.primitive.IntFunction;
import com.gs.collections.api.block.function.primitive.LongFunction;
import com.gs.collections.api.block.function.primitive.ShortFunction;
import com.gs.collections.api.block.predicate.Predicate;
import com.gs.collections.api.block.predicate.Predicate2;
import com.gs.collections.api.block.procedure.Procedure;
import com.gs.collections.api.multimap.set.MutableSetMultimap;
import com.gs.collections.api.ordered.OrderedIterable;
import com.gs.collections.api.partition.set.PartitionMutableSet;
import com.gs.collections.api.set.ImmutableSet;
import com.gs.collections.api.set.MutableSet;
import com.gs.collections.api.set.ParallelUnsortedSetIterable;
import com.gs.collections.api.set.SetIterable;
import com.gs.collections.api.set.UnsortedSetIterable;
import com.gs.collections.api.set.primitive.MutableBooleanSet;
import com.gs.collections.api.set.primitive.MutableByteSet;
import com.gs.collections.api.set.primitive.MutableCharSet;
import com.gs.collections.api.set.primitive.MutableDoubleSet;
import com.gs.collections.api.set.primitive.MutableFloatSet;
import com.gs.collections.api.set.primitive.MutableIntSet;
import com.gs.collections.api.set.primitive.MutableLongSet;
import com.gs.collections.api.set.primitive.MutableShortSet;
import com.gs.collections.api.tuple.Pair;
import com.gs.collections.impl.collection.mutable.AbstractSynchronizedMutableCollection;
import com.gs.collections.impl.collection.mutable.SynchronizedCollectionSerializationProxy;
import com.gs.collections.impl.factory.Sets;
import com.gs.collections.impl.lazy.parallel.set.SynchronizedParallelUnsortedSetIterable;
import net.jcip.annotations.GuardedBy;
import net.jcip.annotations.ThreadSafe;
/**
* A synchronized view of a {@link MutableSet}. It is imperative that the user manually synchronize on the collection when iterating over it using the
* standard JDK iterator or JDK 5 for loop, as per {@link Collections#synchronizedCollection(Collection)}.
*
* @see MutableSet#asSynchronized()
*/
@ThreadSafe
public class SynchronizedMutableSet
extends AbstractSynchronizedMutableCollection
implements MutableSet, Serializable
{
private static final long serialVersionUID = 2L;
SynchronizedMutableSet(MutableSet set)
{
super(set);
}
SynchronizedMutableSet(MutableSet set, Object newLock)
{
super(set, newLock);
}
/**
* This method will take a MutableSet and wrap it directly in a SynchronizedMutableSet. It will
* take any other non-GS-collection and first adapt it will a SetAdapter, and then return a
* SynchronizedMutableSet that wraps the adapter.
*/
public static > SynchronizedMutableSet of(S set)
{
return new SynchronizedMutableSet(SetAdapter.adapt(set));
}
/**
* This method will take a MutableSet and wrap it directly in a SynchronizedMutableSet. It will
* take any other non-GS-collection and first adapt it will a SetAdapter, and then return a
* SynchronizedMutableSet that wraps the adapter. Additionally, a developer specifies which lock to use
* with the collection.
*/
public static > SynchronizedMutableSet of(S set, Object lock)
{
return new SynchronizedMutableSet(SetAdapter.adapt(set), lock);
}
@GuardedBy("getLock()")
private MutableSet getMutableSet()
{
return (MutableSet) this.getDelegate();
}
public MutableSet with(T element)
{
this.add(element);
return this;
}
public MutableSet without(T element)
{
this.remove(element);
return this;
}
public MutableSet withAll(Iterable elements)
{
this.addAllIterable(elements);
return this;
}
public MutableSet withoutAll(Iterable elements)
{
this.removeAllIterable(elements);
return this;
}
public MutableSet newEmpty()
{
synchronized (this.getLock())
{
return this.getMutableSet().newEmpty().asSynchronized();
}
}
@Override
public MutableSet clone()
{
synchronized (this.getLock())
{
return SynchronizedMutableSet.of(this.getMutableSet().clone());
}
}
protected Object writeReplace()
{
return new SynchronizedCollectionSerializationProxy(this.getMutableSet());
}
public MutableSet tap(Procedure procedure)
{
synchronized (this.getLock())
{
this.forEach(procedure);
return this;
}
}
public MutableSet select(Predicate predicate)
{
synchronized (this.getLock())
{
return this.getMutableSet().select(predicate);
}
}
public MutableSet selectWith(Predicate2 predicate, P parameter)
{
synchronized (this.getLock())
{
return this.getMutableSet().selectWith(predicate, parameter);
}
}
public MutableSet reject(Predicate predicate)
{
synchronized (this.getLock())
{
return this.getMutableSet().reject(predicate);
}
}
public MutableSet rejectWith(Predicate2 predicate, P parameter)
{
synchronized (this.getLock())
{
return this.getMutableSet().rejectWith(predicate, parameter);
}
}
public PartitionMutableSet partition(Predicate predicate)
{
synchronized (this.getLock())
{
return this.getMutableSet().partition(predicate);
}
}
public PartitionMutableSet partitionWith(Predicate2 predicate, P parameter)
{
synchronized (this.getLock())
{
return this.getMutableSet().partitionWith(predicate, parameter);
}
}
public MutableBooleanSet collectBoolean(BooleanFunction booleanFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectBoolean(booleanFunction);
}
}
public MutableByteSet collectByte(ByteFunction byteFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectByte(byteFunction);
}
}
public MutableCharSet collectChar(CharFunction charFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectChar(charFunction);
}
}
public MutableDoubleSet collectDouble(DoubleFunction doubleFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectDouble(doubleFunction);
}
}
public MutableFloatSet collectFloat(FloatFunction floatFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectFloat(floatFunction);
}
}
public MutableIntSet collectInt(IntFunction intFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectInt(intFunction);
}
}
public MutableLongSet collectLong(LongFunction longFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectLong(longFunction);
}
}
public MutableShortSet collectShort(ShortFunction shortFunction)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectShort(shortFunction);
}
}
public MutableSet selectInstancesOf(Class clazz)
{
synchronized (this.getLock())
{
return this.getMutableSet().selectInstancesOf(clazz);
}
}
public MutableSet collect(Function function)
{
synchronized (this.getLock())
{
return this.getMutableSet().collect(function);
}
}
/**
* @deprecated in 6.0. Use {@link OrderedIterable#zipWithIndex()} instead.
*/
@Deprecated
public MutableSet> zipWithIndex()
{
synchronized (this.getLock())
{
return this.getMutableSet().zipWithIndex();
}
}
public MutableSet collectWith(Function2 function, P parameter)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectWith(function, parameter);
}
}
public MutableSet collectIf(
Predicate predicate,
Function function)
{
synchronized (this.getLock())
{
return this.getMutableSet().collectIf(predicate, function);
}
}
public MutableSet flatCollect(Function> function)
{
synchronized (this.getLock())
{
return this.getMutableSet().flatCollect(function);
}
}
public MutableSetMultimap groupBy(Function function)
{
synchronized (this.getLock())
{
return this.getMutableSet().groupBy(function);
}
}
public MutableSetMultimap groupByEach(Function> function)
{
synchronized (this.getLock())
{
return this.getMutableSet().groupByEach(function);
}
}
/**
* @deprecated in 6.0. Use {@link OrderedIterable#zip(Iterable)} instead.
*/
@Deprecated
public MutableSet> zip(Iterable that)
{
synchronized (this.getLock())
{
return this.getMutableSet().zip(that);
}
}
public > R unionInto(SetIterable set, R targetSet)
{
synchronized (this.getLock())
{
return this.getMutableSet().unionInto(set, targetSet);
}
}
public > R intersectInto(SetIterable set, R targetSet)
{
synchronized (this.getLock())
{
return this.getMutableSet().intersectInto(set, targetSet);
}
}
public > R differenceInto(SetIterable subtrahendSet, R targetSet)
{
synchronized (this.getLock())
{
return this.getMutableSet().differenceInto(subtrahendSet, targetSet);
}
}
public > R symmetricDifferenceInto(SetIterable set, R targetSet)
{
synchronized (this.getLock())
{
return this.getMutableSet().symmetricDifferenceInto(set, targetSet);
}
}
public boolean isSubsetOf(SetIterable candidateSuperset)
{
synchronized (this.getLock())
{
return this.getMutableSet().isSubsetOf(candidateSuperset);
}
}
public boolean isProperSubsetOf(SetIterable candidateSuperset)
{
synchronized (this.getLock())
{
return this.getMutableSet().isProperSubsetOf(candidateSuperset);
}
}
public LazyIterable> cartesianProduct(SetIterable set)
{
synchronized (this.getLock())
{
return this.getMutableSet().cartesianProduct(set);
}
}
public MutableSet union(SetIterable set)
{
synchronized (this.getLock())
{
return this.getMutableSet().union(set);
}
}
public MutableSet intersect(SetIterable set)
{
synchronized (this.getLock())
{
return this.getMutableSet().intersect(set);
}
}
public MutableSet difference(SetIterable subtrahendSet)
{
synchronized (this.getLock())
{
return this.getMutableSet().difference(subtrahendSet);
}
}
public MutableSet symmetricDifference(SetIterable setB)
{
synchronized (this.getLock())
{
return this.getMutableSet().symmetricDifference(setB);
}
}
public MutableSet> powerSet()
{
synchronized (this.getLock())
{
return this.getMutableSet().powerSet();
}
}
public ParallelUnsortedSetIterable asParallel(ExecutorService executorService, int batchSize)
{
return new SynchronizedParallelUnsortedSetIterable(this.getMutableSet().asParallel(executorService, batchSize), this.getLock());
}
public MutableSet asUnmodifiable()
{
synchronized (this.getLock())
{
return UnmodifiableMutableSet.of(this);
}
}
public MutableSet asSynchronized()
{
return this;
}
public ImmutableSet toImmutable()
{
synchronized (this.getLock())
{
return Sets.immutable.withAll(this.getMutableSet());
}
}
}