Package org.opends.server.extensions

Class SoftReferenceEntryCache

java.lang.Object
org.opends.server.api.MonitorProvider
org.opends.server.api.EntryCache<SoftReferenceEntryCacheCfg>
org.opends.server.extensions.SoftReferenceEntryCache
All Implemented Interfaces:
Runnable, MeterBinder, ConfigurationChangeListener<SoftReferenceEntryCacheCfg>
public final class SoftReferenceEntryCache extends EntryCache<SoftReferenceEntryCacheCfg> implements ConfigurationChangeListener<SoftReferenceEntryCacheCfg>, Runnable
This class defines a Directory Server entry cache that uses soft references to manage objects in a way that will allow them to be freed if the JVM is running low on memory.

  • Constructor Details

    • SoftReferenceEntryCache

      public SoftReferenceEntryCache()
      Creates a new instance of this soft reference entry cache. All initialization should be performed in the initializeEntryCache method.

  • Method Details

    • initializeEntryCache

      public void initializeEntryCache(ServerContext serverContext, SoftReferenceEntryCacheCfg configuration) throws ConfigException, InitializationException
      Description copied from class: EntryCache
      Initializes this entry cache implementation so that it will be available for storing and retrieving entries.
      Overrides:
      initializeEntryCache in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      serverContext - The server context.
      configuration - The configuration to use to initialize the entry cache.
      Throws:
      ConfigException - If there is a problem with the provided configuration entry that would prevent this entry cache from being used.
      InitializationException - If a problem occurs during the initialization process that is not related to the configuration.

    • finalizeEntryCache

      public void finalizeEntryCache()
      Description copied from class: EntryCache
      Performs any necessary cleanup work (e.g., flushing all cached entries and releasing any other held resources) that should be performed when the server is to be shut down or the entry cache destroyed or replaced.
      Specified by:
      finalizeEntryCache in class EntryCache<SoftReferenceEntryCacheCfg>

    • containsEntry

      public boolean containsEntry(Dn entryDN)
      Description copied from class: EntryCache
      Indicates whether the entry cache currently contains the entry with the specified DN. This method may be called without holding any locks if a point-in-time check is all that is required. Note that this method is called from @see #getEntry(DN entryDN, LockType lockType, List lockList)
      Specified by:
      containsEntry in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      entryDN - The DN for which to make the determination.
      Returns:
      true if the entry cache currently contains the entry with the specified DN, or false if not.

    • getEntry

      public SizedEntry getEntry(Dn entryDN)
      Description copied from class: EntryCache
      Retrieves the entry with its size, with the specified DN from the cache.
      Specified by:
      getEntry in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      entryDN - The DN of the entry to retrieve.
      Returns:
      The requested entry with its size if it is present in the cache, or null if it is not present.

    • getEntry

      public SizedEntry getEntry(String backendID, long entryID)
      Description copied from class: EntryCache
      Retrieves the requested entry with its size, if it is present in the cache.
      Specified by:
      getEntry in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      backendID - ID of the backend associated with the entry to retrieve.
      entryID - The entry ID within the provided backend for the specified entry.
      Returns:
      The requested entry if it is present in the cache, or null if it is not present.

    • putEntry

      public void putEntry(SizedEntry entry, String backendID, long entryID)
      Description copied from class: EntryCache
      Stores the provided entry in the cache. Note that the mechanism that it uses to achieve this is implementation-dependent, and it is acceptable for the entry to not actually be stored in any cache.
      Specified by:
      putEntry in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      entry - The entry to store in the cache.
      backendID - ID of the backend with which the entry is associated.
      entryID - The entry ID within the provided backend that uniquely identifies the specified entry.

    • putEntryIfAbsent

      public void putEntryIfAbsent(SizedEntry entry, String backendID, long entryID)
      Description copied from class: EntryCache
      Stores the provided entry in the cache only if it does not conflict with an entry that already exists. Note that the mechanism that it uses to achieve this is implementation-dependent, and it is acceptable for the entry to not actually be stored in any cache. However, this method must not overwrite an existing version of the entry.
      Specified by:
      putEntryIfAbsent in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      entry - The entry to store in the cache.
      backendID - ID of the backend with which the entry is associated.
      entryID - The entry ID within the provided backend that uniquely identifies the specified entry.

    • removeEntry

      public void removeEntry(Dn entryDN)
      Description copied from class: EntryCache
      Removes the specified entry from the cache.
      Specified by:
      removeEntry in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      entryDN - The DN of the entry to remove from the cache.

    • clear

      public void clear()
      Description copied from class: EntryCache
      Removes all entries from the cache. The cache should still be available for future use.
      Specified by:
      clear in class EntryCache<SoftReferenceEntryCacheCfg>

    • clearBackend

      public void clearBackend(String backendID)
      Description copied from class: EntryCache
      Removes all entries from the cache that are associated with the provided backend.
      Specified by:
      clearBackend in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      backendID - ID of the backend for which to flush the associated entries.

    • isConfigurationAcceptable

      public boolean isConfigurationAcceptable(SoftReferenceEntryCacheCfg configuration, List<LocalizableMessage> unacceptableReasons)
      Description copied from class: EntryCache
      Indicates whether the provided configuration is acceptable for this entry cache. It should be possible to call this method on an uninitialized entry cache instance in order to determine whether the entry cache would be able to use the provided configuration.
      Overrides:
      isConfigurationAcceptable in class EntryCache<SoftReferenceEntryCacheCfg>
      Parameters:
      configuration - The entry cache configuration for which to make the determination.
      unacceptableReasons - A list that may be used to hold the reasons that the provided configuration is not acceptable.
      Returns:
      true if the provided configuration is acceptable for this entry cache, or false if not.

    • isConfigurationChangeAcceptable

      public boolean isConfigurationChangeAcceptable(SoftReferenceEntryCacheCfg configuration, List<LocalizableMessage> unacceptableReasons)
      Description copied from interface: ConfigurationChangeListener
      Indicates whether the proposed change to the configuration is acceptable to this change listener.
      Specified by:
      isConfigurationChangeAcceptable in interface ConfigurationChangeListener<SoftReferenceEntryCacheCfg>
      Parameters:
      configuration - The new configuration containing the changes.
      unacceptableReasons - A list that can be used to hold messages about why the provided configuration is not acceptable.
      Returns:
      Returns true if the proposed change is acceptable, or false if it is not.

    • applyConfigurationChange

      public ConfigChangeResult applyConfigurationChange(SoftReferenceEntryCacheCfg configuration)
      Description copied from interface: ConfigurationChangeListener
      Applies the configuration changes to this change listener.
      Specified by:
      applyConfigurationChange in interface ConfigurationChangeListener<SoftReferenceEntryCacheCfg>
      Parameters:
      configuration - The new configuration containing the changes.
      Returns:
      Returns information about the result of changing the configuration.

    • run

      public void run()
      Operate in a loop, receiving notification of soft references that have been freed and removing the corresponding entries from the cache.
      Specified by:
      run in interface Runnable

    • getEntryCount

      public long getEntryCount()
      Description copied from class: EntryCache
      Retrieves the current number of entries stored within the cache.
      Specified by:
      getEntryCount in class EntryCache<SoftReferenceEntryCacheCfg>
      Returns:
      The current number of entries stored within the cache.

    • getMemoryUsage

      public long getMemoryUsage()
      Description copied from class: EntryCache
      Retrieves the current amount of memory used by this cache in bytes.
      Specified by:
      getMemoryUsage in class EntryCache<SoftReferenceEntryCacheCfg>
      Returns:
      The current amount of memory used by this cache in bytes.

    • toVerboseString

      public String toVerboseString()
      Description copied from class: EntryCache
      Return a verbose string representation of the current cache maps. This is useful primary for debugging and diagnostic purposes such as in the entry cache unit tests.

      This method is invoked by unit tests for debugging.

      Specified by:
      toVerboseString in class EntryCache<SoftReferenceEntryCacheCfg>
      Returns:
      String verbose string representation of the current cache maps in the following format: dn:id:backend one cache entry map representation per line or null if all maps are empty.