001package org.cache2k;
002
003/*
004 * #%L
005 * cache2k API only package
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.List;
024
025/**
026 * @author Jens Wilke; created: 2014-03-18
027 */
028public interface BulkCacheSource<K, T> {
029
030  /**
031   * Retrieve the values for the given cache entries. The cache
032   * entry list contains all keys for the entries to retrieve.
033   * If an exception is thrown this may affect all entries, that
034   * have currently no valid or expired data.
035   *
036   * <p/>The entry key is never null. Returned list must be
037   * of identical length then entries list.
038   *
039   * @param entries list of entries / keys we want the data for
040   * @param currentTime time in millis just before the call to this method
041   * @return
042   * @throws Throwable
043   */
044  public List<T> getValues(
045    List<CacheEntry<K, T>> entries,
046    long currentTime) throws Throwable;
047
048}