Class UTF8TaxonomyWriterCache

java.lang.Object
org.apache.lucene.facet.taxonomy.writercache.UTF8TaxonomyWriterCache
All Implemented Interfaces:
TaxonomyWriterCache, Accountable

@Deprecated public final class UTF8TaxonomyWriterCache extends Object implements TaxonomyWriterCache, Accountable
Deprecated.
A "cache" that never frees memory, and stores labels in a BytesRefHash (utf-8 encoding).
  • Field Details

    • bytes

      private final ThreadLocal<BytesRefBuilder> bytes
      Deprecated.
    • bytesUsed

      private final Counter bytesUsed
      Deprecated.
    • map

      private final BytesRefHash map
      Deprecated.
    • PAGE_BITS

      private static final int PAGE_BITS
      Deprecated.
      See Also:
    • PAGE_SIZE

      private static final int PAGE_SIZE
      Deprecated.
      See Also:
    • PAGE_MASK

      private static final int PAGE_MASK
      Deprecated.
      See Also:
    • ordinals

      private volatile int[][] ordinals
      Deprecated.
    • count

      private int count
      Deprecated.
    • pageCount

      private int pageCount
      Deprecated.
    • DELIM_CHAR

      private static final byte DELIM_CHAR
      Deprecated.
      See Also:
  • Constructor Details

    • UTF8TaxonomyWriterCache

      public UTF8TaxonomyWriterCache()
      Deprecated.
      Sole constructor.
  • Method Details

    • get

      public int get(FacetLabel label)
      Deprecated.
      Description copied from interface: TaxonomyWriterCache
      Lookup a category in the cache, returning its ordinal, or a negative number if the category is not in the cache.

      It is up to the caller to remember what a negative response means: If the caller knows the cache is complete (it was initially fed with all the categories, and since then put() never returned true) it means the category does not exist. Otherwise, the category might still exist, but just be missing from the cache.

      Specified by:
      get in interface TaxonomyWriterCache
    • assertSameOrdinal

      private boolean assertSameOrdinal(FacetLabel label, int id, int ord)
      Deprecated.
    • put

      public boolean put(FacetLabel label, int ord)
      Deprecated.
      Description copied from interface: TaxonomyWriterCache
      Add a category to the cache, with the given ordinal as the value.

      If the implementation keeps only a partial cache (e.g., an LRU cache) and finds that its cache is full, it should clear up part of the cache and return true. Otherwise, it should return false.

      The reason why the caller needs to know if part of the cache was cleared is that in that case it will have to commit its on-disk index (so that all the latest category additions can be searched on disk, if we can't rely on the cache to contain them).

      Ordinals should be non-negative. Currently there is no defined way to specify that a cache should remember a category does NOT exist. It doesn't really matter, because normally the next thing we do after finding that a category does not exist is to add it.

      Specified by:
      put in interface TaxonomyWriterCache
    • isFull

      public boolean isFull()
      Deprecated.
      Description copied from interface: TaxonomyWriterCache
      Returns true if the cache is full, such that the next TaxonomyWriterCache.put(org.apache.lucene.facet.taxonomy.FacetLabel, int) will evict entries from it, false otherwise.
      Specified by:
      isFull in interface TaxonomyWriterCache
    • clear

      public void clear()
      Deprecated.
      Description copied from interface: TaxonomyWriterCache
      Clears the content of the cache. Unlike TaxonomyWriterCache.close(), the caller can assume that the cache is still operable after this method returns.
      Specified by:
      clear in interface TaxonomyWriterCache
    • size

      public int size()
      Deprecated.
      How many labels are currently stored in the cache.
      Specified by:
      size in interface TaxonomyWriterCache
    • ramBytesUsed

      public long ramBytesUsed()
      Deprecated.
      Description copied from interface: Accountable
      Return the memory usage of this object in bytes. Negative values are illegal.
      Specified by:
      ramBytesUsed in interface Accountable
    • close

      public void close()
      Deprecated.
      Description copied from interface: TaxonomyWriterCache
      Let go of whatever resources the cache is holding. After a close(), this object can no longer be used.
      Specified by:
      close in interface TaxonomyWriterCache
    • toBytes

      private BytesRef toBytes(FacetLabel label)
      Deprecated.