Cache.java

package clashingdeps.jackson.cache;

import java.util.Optional;

/**
 * Cache, for storing data associated with keys.
 */
public interface Cache {

    /**
     * Store a value object in the cache with no specific expiry time. The object may be evicted by the cache any time,
     * if necessary.
     *
     * @param key   key that may be used to retrieve the object in the future
     * @param value the value object to be stored
     */
    void put(String key, Object value);

    /**
     * Retrieve a value object from the cache.
     * @param key               the key that was used to insert the object initially
     * @param expectedClass     for convenience, a class that the object should be cast to before being returned
     * @param <T>               the class of the returned object
     * @return                  the object if it was in the cache, or an empty Optional if not found.
     */
    <T> Optional<T> get(String key, Class<T> expectedClass);
}