All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.hazelcast.cache.impl.CacheProxy Maven / Gradle / Ivy

There is a newer version: 5.0-BETA-1
Show newest version
/*
 * Copyright (c) 2008-2017, 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.cache.impl;

import com.hazelcast.cache.impl.event.CachePartitionLostEventFilter;
import com.hazelcast.cache.impl.event.CachePartitionLostListener;
import com.hazelcast.cache.impl.event.InternalCachePartitionLostListenerAdapter;
import com.hazelcast.cache.impl.operation.CacheListenerRegistrationOperation;
import com.hazelcast.config.CacheConfig;
import com.hazelcast.core.Member;
import com.hazelcast.logging.ILogger;
import com.hazelcast.nio.serialization.Data;
import com.hazelcast.spi.EventFilter;
import com.hazelcast.spi.EventRegistration;
import com.hazelcast.spi.InternalCompletableFuture;
import com.hazelcast.spi.NodeEngine;
import com.hazelcast.spi.Operation;
import com.hazelcast.spi.OperationService;
import com.hazelcast.util.ExceptionUtil;

import javax.cache.CacheException;
import javax.cache.configuration.CacheEntryListenerConfiguration;
import javax.cache.configuration.Configuration;
import javax.cache.expiry.ExpiryPolicy;
import javax.cache.integration.CompletionListener;
import javax.cache.processor.EntryProcessor;
import javax.cache.processor.EntryProcessorException;
import javax.cache.processor.EntryProcessorResult;
import java.util.ArrayList;
import java.util.Collection;
import java.util.HashMap;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.Future;

import static com.hazelcast.cache.impl.CacheProxyUtil.validateNotNull;
import static com.hazelcast.util.Preconditions.checkNotNull;

/**
 * 

ICache implementation

*

* This proxy is the implementation of ICache and javax.cache.Cache which is returned by * HazelcastServerCacheManager. It represents a cache for server or embedded mode. *

*

* Each cache method actually is an operation which is sent to related partition(s) or node(s). * Operations are executed on partition's or node's executor pools and the results are delivered to the user. *

*

* In order to access a {@linkplain CacheProxy} by name, a cacheManager should be used. It's advised to use * {@link com.hazelcast.cache.ICache} instead. *

* * @param the type of key. * @param the type of value. */ public class CacheProxy extends AbstractCacheProxy { protected final ILogger logger; CacheProxy(CacheConfig cacheConfig, NodeEngine nodeEngine, ICacheService cacheService) { super(cacheConfig, nodeEngine, cacheService); logger = getNodeEngine().getLogger(getClass()); } @Override public V get(K key) { return get(key, null); } @Override public Map getAll(Set keys) { return getAll(keys, null); } @Override public boolean containsKey(K key) { ensureOpen(); validateNotNull(key); final Data k = serializationService.toData(key); Operation operation = operationProvider.createContainsKeyOperation(k); OperationService operationService = getNodeEngine().getOperationService(); int partitionId = getPartitionId(k); InternalCompletableFuture f = operationService.invokeOnPartition(getServiceName(), operation, partitionId); return f.join(); } @Override public void loadAll(Set keys, boolean replaceExistingValues, CompletionListener completionListener) { ensureOpen(); validateNotNull(keys); for (K key : keys) { CacheProxyUtil.validateConfiguredTypes(cacheConfig, key); } HashSet keysData = new HashSet(keys.size()); for (K key : keys) { keysData.add(serializationService.toData(key)); } LoadAllTask loadAllTask = new LoadAllTask(operationProvider, keysData, replaceExistingValues, completionListener); try { submitLoadAllTask(loadAllTask); } catch (Exception e) { if (completionListener != null) { completionListener.onException(e); } throw new CacheException(e); } } @Override public void put(K key, V value) { put(key, value, null); } @Override public V getAndPut(K key, V value) { return getAndPut(key, value, null); } @Override public void putAll(Map map) { putAll(map, null); } @Override public boolean putIfAbsent(K key, V value) { return putIfAbsent(key, value, null); } @Override public boolean remove(K key) { final InternalCompletableFuture f = removeAsyncInternal(key, null, false, false, true); try { return f.get(); } catch (Throwable e) { throw ExceptionUtil.rethrowAllowedTypeFirst(e, CacheException.class); } } @Override public boolean remove(K key, V oldValue) { final InternalCompletableFuture f = removeAsyncInternal(key, oldValue, true, false, true); try { return f.get(); } catch (Throwable e) { throw ExceptionUtil.rethrowAllowedTypeFirst(e, CacheException.class); } } @Override public V getAndRemove(K key) { final InternalCompletableFuture f = removeAsyncInternal(key, null, false, true, true); try { return f.get(); } catch (Throwable e) { throw ExceptionUtil.rethrowAllowedTypeFirst(e, CacheException.class); } } @Override public boolean replace(K key, V oldValue, V newValue) { return replace(key, oldValue, newValue, null); } @Override public boolean replace(K key, V value) { final ExpiryPolicy expiryPolicy = null; return replace(key, value, expiryPolicy); } @Override public V getAndReplace(K key, V value) { return getAndReplace(key, value, null); } @Override public void removeAll(Set keys) { ensureOpen(); validateNotNull(keys); removeAllInternal(keys); } @Override public void removeAll() { ensureOpen(); removeAllInternal(null); } @Override public void clear() { ensureOpen(); clearInternal(); } @Override public > C getConfiguration(Class clazz) { if (clazz.isInstance(cacheConfig)) { return clazz.cast(cacheConfig.getAsReadOnly()); } throw new IllegalArgumentException("The configuration class " + clazz + " is not supported by this implementation"); } @Override public T invoke(K key, EntryProcessor entryProcessor, Object... arguments) throws EntryProcessorException { ensureOpen(); validateNotNull(key); checkNotNull(entryProcessor, "Entry Processor is null"); final Data keyData = serializationService.toData(key); final Integer completionId = registerCompletionLatch(1); Operation op = operationProvider.createEntryProcessorOperation(keyData, completionId, entryProcessor, arguments); try { OperationService operationService = getNodeEngine().getOperationService(); int partitionId = getPartitionId(keyData); final InternalCompletableFuture f = operationService.invokeOnPartition(getServiceName(), op, partitionId); final T safely = f.join(); waitCompletionLatch(completionId); return safely; } catch (CacheException ce) { deregisterCompletionLatch(completionId); throw ce; } catch (Exception e) { deregisterCompletionLatch(completionId); throw new EntryProcessorException(e); } } @Override public Map> invokeAll(Set keys, EntryProcessor entryProcessor, Object... arguments) { // TODO Implement a multiple (batch) invoke operation and its factory ensureOpen(); validateNotNull(keys); checkNotNull(entryProcessor, "Entry Processor is null"); Map> allResult = new HashMap>(); for (K key : keys) { CacheEntryProcessorResult ceResult; try { final T result = invoke(key, entryProcessor, arguments); ceResult = result != null ? new CacheEntryProcessorResult(result) : null; } catch (Exception e) { ceResult = new CacheEntryProcessorResult(e); } if (ceResult != null) { allResult.put(key, ceResult); } } return allResult; } @Override public T unwrap(Class clazz) { if (clazz.isAssignableFrom(((Object) this).getClass())) { return clazz.cast(this); } throw new IllegalArgumentException("Unwrapping to " + clazz + " is not supported by this implementation"); } @Override public void registerCacheEntryListener(CacheEntryListenerConfiguration cacheEntryListenerConfiguration) { registerCacheEntryListener(cacheEntryListenerConfiguration, true); } @Override public void registerCacheEntryListener(CacheEntryListenerConfiguration cacheEntryListenerConfiguration, boolean addToConfig) { ensureOpen(); checkNotNull(cacheEntryListenerConfiguration, "CacheEntryListenerConfiguration can't be null"); final ICacheService service = getService(); final CacheEventListenerAdaptor entryListener = new CacheEventListenerAdaptor(this, cacheEntryListenerConfiguration, getNodeEngine().getSerializationService(), getNodeEngine().getHazelcastInstance()); final String regId = service.registerListener(getDistributedObjectName(), entryListener, entryListener, false); if (regId != null) { if (addToConfig) { cacheConfig.addCacheEntryListenerConfiguration(cacheEntryListenerConfiguration); } addListenerLocally(regId, cacheEntryListenerConfiguration); if (addToConfig) { updateCacheListenerConfigOnOtherNodes(cacheEntryListenerConfiguration, true); } } } @Override public void deregisterCacheEntryListener(CacheEntryListenerConfiguration cacheEntryListenerConfiguration) { checkNotNull(cacheEntryListenerConfiguration, "CacheEntryListenerConfiguration can't be null"); final ICacheService service = getService(); final String regId = getListenerIdLocal(cacheEntryListenerConfiguration); if (regId != null) { if (service.deregisterListener(getDistributedObjectName(), regId)) { removeListenerLocally(cacheEntryListenerConfiguration); cacheConfig.removeCacheEntryListenerConfiguration(cacheEntryListenerConfiguration); updateCacheListenerConfigOnOtherNodes(cacheEntryListenerConfiguration, false); } } } protected void updateCacheListenerConfigOnOtherNodes(CacheEntryListenerConfiguration cacheEntryListenerConfiguration, boolean isRegister) { final OperationService operationService = getNodeEngine().getOperationService(); final Collection members = getNodeEngine().getClusterService().getMembers(); Collection futures = new ArrayList(); for (Member member : members) { if (!member.localMember()) { final Operation op = new CacheListenerRegistrationOperation(getDistributedObjectName(), cacheEntryListenerConfiguration, isRegister); final InternalCompletableFuture future = operationService.invokeOnTarget(CacheService.SERVICE_NAME, op, member.getAddress()); futures.add(future); } } } @Override public Iterator> iterator() { ensureOpen(); return new ClusterWideIterator(this, false); } @Override public Iterator> iterator(int fetchSize) { ensureOpen(); return new ClusterWideIterator(this, fetchSize, false); } public Iterator> iterator(int fetchSize, int partitionId, boolean prefetchValues) { ensureOpen(); return new CachePartitionIterator(this, fetchSize, partitionId, prefetchValues); } @Override public String addPartitionLostListener(CachePartitionLostListener listener) { checkNotNull(listener, "CachePartitionLostListener can't be null"); final InternalCachePartitionLostListenerAdapter listenerAdapter = new InternalCachePartitionLostListenerAdapter(listener); final EventFilter filter = new CachePartitionLostEventFilter(); final ICacheService service = getService(); injectDependencies(listener); final EventRegistration registration = service.getNodeEngine().getEventService() .registerListener(AbstractCacheService.SERVICE_NAME, name, filter, listenerAdapter); return registration.getId(); } @Override public boolean removePartitionLostListener(String id) { checkNotNull(id, "Listener id should not be null!"); final ICacheService service = getService(); return service.getNodeEngine().getEventService() .deregisterListener(AbstractCacheService.SERVICE_NAME, name, id); } }