javax.cache.Cache Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of javaee-api Show documentation
There is a newer version: 8.0-6
/*
 *
 * Apache Geronimo JCache Spec 1.0
 *
 * Copyright (C) 2003 - 2014 The Apache Software Foundation
 *
 * 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 javax.cache;


import javax.cache.configuration.CacheEntryListenerConfiguration;
import javax.cache.configuration.Configuration;
import javax.cache.integration.CompletionListener;
import javax.cache.processor.EntryProcessor;
import javax.cache.processor.EntryProcessorException;
import javax.cache.processor.EntryProcessorResult;
import java.io.Closeable;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;


public interface Cache extends Iterable>, Closeable {

    V get(K key);


    Map getAll(Set keys);


    boolean containsKey(K key);


    void loadAll(Set keys, boolean replaceExistingValues,
                 CompletionListener completionListener);


    void put(K key, V value);


    V getAndPut(K key, V value);


    void putAll(java.util.Map map);


    boolean putIfAbsent(K key, V value);


    boolean remove(K key);


    boolean remove(K key, V oldValue);


    V getAndRemove(K key);


    boolean replace(K key, V oldValue, V newValue);


    boolean replace(K key, V value);


    V getAndReplace(K key, V value);


    void removeAll(Set keys);


    void removeAll();


    void clear();


    > C getConfiguration(Class clazz);


     T invoke(K key,
                 EntryProcessor entryProcessor,
                 Object... arguments) throws EntryProcessorException;


     Map> invokeAll(Set keys,
                                                  EntryProcessor
                                                          entryProcessor,
                                                  Object... arguments);


    String getName();


    CacheManager getCacheManager();


    void close();


    boolean isClosed();


     T unwrap(java.lang.Class clazz);


    void registerCacheEntryListener(
            CacheEntryListenerConfiguration cacheEntryListenerConfiguration);


    void deregisterCacheEntryListener(CacheEntryListenerConfiguration
                                              cacheEntryListenerConfiguration);


    Iterator> iterator();


    interface Entry {


        K getKey();


        V getValue();


         T unwrap(Class clazz);
    }
}