You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@lucene.apache.org by gs...@apache.org on 2022/01/27 17:01:24 UTC
[lucene] branch branch_9x updated: LUCENE-10368: Mark IntTaxonomyFacets as deprecated (#599)
This is an automated email from the ASF dual-hosted git repository.
gsmiller pushed a commit to branch branch_9x
in repository https://gitbox.apache.org/repos/asf/lucene.git
The following commit(s) were added to refs/heads/branch_9x by this push:
new b6fbdcc LUCENE-10368: Mark IntTaxonomyFacets as deprecated (#599)
b6fbdcc is described below
commit b6fbdccc9888491a0b145232beca2ad3c2ee626c
Author: Greg Miller <gs...@gmail.com>
AuthorDate: Thu Jan 27 08:56:28 2022 -0800
LUCENE-10368: Mark IntTaxonomyFacets as deprecated (#599)
---
lucene/CHANGES.txt | 3 +++
.../org/apache/lucene/facet/taxonomy/IntTaxonomyFacets.java | 11 ++++++++++-
2 files changed, 13 insertions(+), 1 deletion(-)
diff --git a/lucene/CHANGES.txt b/lucene/CHANGES.txt
index 3e697af..f933144 100644
--- a/lucene/CHANGES.txt
+++ b/lucene/CHANGES.txt
@@ -34,6 +34,9 @@ API Changes
* LUCENE-10381: Require users to provide FacetsConfig for SSDV faceting. (Greg Miller)
+* LUCENE-10368: IntTaxonomyFacets has been deprecated and is no longer a supported extension point
+ for user-created faceting implementations. (Greg Miller)
+
New Features
---------------------
diff --git a/lucene/facet/src/java/org/apache/lucene/facet/taxonomy/IntTaxonomyFacets.java b/lucene/facet/src/java/org/apache/lucene/facet/taxonomy/IntTaxonomyFacets.java
index cdec3f1..afc5fb1 100644
--- a/lucene/facet/src/java/org/apache/lucene/facet/taxonomy/IntTaxonomyFacets.java
+++ b/lucene/facet/src/java/org/apache/lucene/facet/taxonomy/IntTaxonomyFacets.java
@@ -28,7 +28,16 @@ import org.apache.lucene.facet.FacetsConfig.DimConfig;
import org.apache.lucene.facet.LabelAndValue;
import org.apache.lucene.facet.TopOrdAndIntQueue;
-/** Base class for all taxonomy-based facets that aggregate to a per-ords int[]. */
+/**
+ * Base class for all taxonomy-based facets that aggregate to a per-ords int[].
+ *
+ * @deprecated Visibility of this class will be reduced to pkg-private in a future version. This
+ * class is meant to host common code as an internal implementation detail to {@link
+ * FastTaxonomyFacetCounts} and {@link TaxonomyFacetSumIntAssociations},and is not intended as
+ * an extension point for user-created {@code Facets} implementations. If your code is relying
+ * on this, please migrate necessary functionality down into your own class.
+ */
+@Deprecated
public abstract class IntTaxonomyFacets extends TaxonomyFacets {
/**