001package org.cache2k;
002
003/*
004 * #%L
005 * cache2k API
006 * %%
007 * Copyright (C) 2000 - 2016 headissue GmbH, Munich
008 * %%
009 * Licensed under the Apache License, Version 2.0 (the "License");
010 * you may not use this file except in compliance with the License.
011 * You may obtain a copy of the License at
012 * 
013 *      http://www.apache.org/licenses/LICENSE-2.0
014 * 
015 * Unless required by applicable law or agreed to in writing, software
016 * distributed under the License is distributed on an "AS IS" BASIS,
017 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
018 * See the License for the specific language governing permissions and
019 * limitations under the License.
020 * #L%
021 */
022
023import java.util.Map;
024
025/**
026 * Key/value source with bulk get and prefetching.
027 *
028 * @author Jens Wilke
029 * @since 1.0
030 */
031public interface AdvancedKeyValueSource<K,V> extends KeyValueSource<K,V> {
032
033  /**
034   * Retrieves all objects via the key. For a more detailed descriptions see
035   * the cache interface.
036   *
037   * @see Cache#getAll(Iterable)
038   */
039  Map<K, V> getAll(Iterable<? extends K> keys);
040
041  /**
042   * Notify about the intend to retrieve the value for this key in the
043   * near future. For a more detailed descriptions see
044   * the cache interface.
045   *
046   * @see Cache#prefetch(Object)
047   */
048  void prefetch(K key);
049
050  /**
051   * Notify about the intend to retrieve the value for the keys in the
052   * near future.
053   *
054   * @see Cache#prefetchAll(CacheOperationCompletionListener, Iterable)
055   */
056  void prefetchAll(CacheOperationCompletionListener listener, Iterable<? extends K> keys);
057
058}