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

com.netease.cloud.util.ResponseMetadataCache Maven / Gradle / Ivy

There is a newer version: 1.3.1
Show newest version
package com.netease.cloud.util;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import com.netease.cloud.ResponseMetadata;

/**
 * Cache of response metadata for recently executed requests for diagnostic
 * purposes. This cache has a max size and as entries are added, the oldest
 * entry is aged out once the max size has been reached.
 */
public class ResponseMetadataCache {
    private final int maxEntries;
    private Map map;
    private List objectList;

    /**
     * Creates a new cache that will contain, at most the specified number of
     * entries.
     *
     * @param maxEntries
     *            The maximum size of this cache.
     */
    public ResponseMetadataCache(int maxEntries) {
        this.maxEntries = maxEntries;

        objectList = new ArrayList(maxEntries);
        map = new HashMap();
    }

    /**
     * Adds a new entry to this cache, possibly evicting the oldest entry if the
     * cache is at its size limit.
     *
     * @param obj
     *            The key by which to store the metadata.
     * @param metadata
     *            The metadata for this entry.
     */
    public synchronized void add(Object obj, ResponseMetadata metadata) {
        if (obj == null) return;

        if (map.size() >= maxEntries) evictOldest();
        store(System.identityHashCode(obj), metadata);
    }

    /**
     * Returns the response metadata associated with the specified object, or
     * null if no metadata is associated with that object.
     *
     * @param obj
     *            The key by which the desired metadata is stored.
     *
     * @return The response metadata associated with the given object key,
     *         otherwise null if no metadata is associated with that object.
     */
    public ResponseMetadata get(Object obj) {
        // System.identityHashCode isn't guaranteed to be unique
        // on all platforms, but should be reasonable enough to use
        // for a few requests at a time.  We can always easily move
        // to our own unique IDs if needed.
        return map.get(System.identityHashCode(obj));
    }

    private void evictOldest() {
        map.remove(objectList.remove(0));
    }

    private void store(int id, ResponseMetadata metadata) {
        map.put(id, metadata);
        objectList.add(id);
    }
}