com.hazelcast.util.ConcurrencyUtil Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2020, Hazelcast, Inc. All Rights Reserved.
*
* 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.hazelcast.util;
import java.util.concurrent.ConcurrentMap;
import java.util.concurrent.Executor;
import java.util.concurrent.atomic.AtomicLong;
import java.util.concurrent.atomic.AtomicLongFieldUpdater;
/**
* Utility methods to getOrPutSynchronized and getOrPutIfAbsent in a thread safe way
* from a {@link ConcurrentMap} with a {@link ConstructorFunction}.
*/
public final class ConcurrencyUtil {
/**
* The Caller runs executor is an Executor that executes the task on the calling thread.
* This is useful when an Executor is required, but offloading to a different thread
* is very costly and it is faster to run on the calling thread.
*/
public static final Executor CALLER_RUNS = new Executor() {
@Override
public void execute(Runnable command) {
command.run();
}
@Override
public String toString() {
return "CALLER_RUNS";
}
};
private ConcurrencyUtil() {
}
/**
* Atomically sets the max value.
*
* If the current value is larger than the provided value, the call is ignored.
* So it will not happen that a smaller value will overwrite a larger value.
*/
public static void setMax(E obj, AtomicLongFieldUpdater updater, long value) {
for (; ; ) {
long current = updater.get(obj);
if (current >= value) {
return;
}
if (updater.compareAndSet(obj, current, value)) {
return;
}
}
}
public static boolean setIfEqualOrGreaterThan(AtomicLong oldValue, long newValue) {
while (true) {
long local = oldValue.get();
if (newValue < local) {
return false;
}
if (oldValue.compareAndSet(local, newValue)) {
return true;
}
}
}
public static V getOrPutSynchronized(ConcurrentMap map, K key, final Object mutex,
ConstructorFunction func) {
if (mutex == null) {
throw new NullPointerException();
}
V value = map.get(key);
if (value == null) {
synchronized (mutex) {
value = map.get(key);
if (value == null) {
value = func.createNew(key);
map.put(key, value);
}
}
}
return value;
}
public static V getOrPutSynchronized(ConcurrentMap map, K key, ContextMutexFactory contextMutexFactory,
ConstructorFunction func) {
if (contextMutexFactory == null) {
throw new NullPointerException();
}
V value = map.get(key);
if (value == null) {
ContextMutexFactory.Mutex mutex = contextMutexFactory.mutexFor(key);
try {
synchronized (mutex) {
value = map.get(key);
if (value == null) {
value = func.createNew(key);
map.put(key, value);
}
}
} finally {
mutex.close();
}
}
return value;
}
public static V getOrPutIfAbsent(ConcurrentMap map, K key, ConstructorFunction func) {
V value = map.get(key);
if (value == null) {
value = func.createNew(key);
V current = map.putIfAbsent(key, value);
value = current == null ? value : current;
}
return value;
}
}