This is an automated email from the ASF dual-hosted git repository. dsmiley pushed a commit to branch branch_10x in repository https://gitbox.apache.org/repos/asf/solr.git
commit aa5179dbb9ded8879820bc0ccd799694e6153e3a Author: David Smiley <[email protected]> AuthorDate: Tue Jul 14 09:02:29 2026 -0400 SOLR-17715: un-deprecate CommonParams.QT (#4461) (cherry picked from commit 51557ecf3f97d4ded66146aedc22555c9844ee62) --- changelog/unreleased/SOLR-17715-undeprecate-qt.yml | 8 ++++++++ .../upgrade-notes/pages/major-changes-in-solr-10.adoc | 3 +++ .../java/org/apache/solr/client/solrj/request/SolrQuery.java | 12 +++++++----- .../src/java/org/apache/solr/common/params/CommonParams.java | 9 +++++---- 4 files changed, 23 insertions(+), 9 deletions(-) diff --git a/changelog/unreleased/SOLR-17715-undeprecate-qt.yml b/changelog/unreleased/SOLR-17715-undeprecate-qt.yml new file mode 100644 index 00000000000..80773d6449e --- /dev/null +++ b/changelog/unreleased/SOLR-17715-undeprecate-qt.yml @@ -0,0 +1,8 @@ +title: Un-deprecate 'qt' for certain use-cases where there's no alternative. +type: deprecated +authors: + - name: David Smiley + nick: dsmiley +links: + - name: SOLR-17715 + url: https://issues.apache.org/jira/browse/SOLR-17715 diff --git a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc index 2b57a88b16a..7a499a98175 100644 --- a/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc +++ b/solr/solr-ref-guide/modules/upgrade-notes/pages/major-changes-in-solr-10.adoc @@ -99,6 +99,9 @@ It is intended as a temporary measure while you migrate the affected accounts to HttpSolrClient returns; this time as a base class for HttpJettySolrClient and HttpJdkSolrClient. Its builder will dynamically detect if solr-jetty is available and use that, otherwise it will use the JDK client. +CommonParams.QT has been un-deprecated. +Nonetheless, if your code makes explicit reference to "qt" when constructing a standard request, there is usually a better way. + == Solr 10.0 === Solr Jetty parameters diff --git a/solr/solrj/src/java/org/apache/solr/client/solrj/request/SolrQuery.java b/solr/solrj/src/java/org/apache/solr/client/solrj/request/SolrQuery.java index 23a3c459f76..f07741e996e 100644 --- a/solr/solrj/src/java/org/apache/solr/client/solrj/request/SolrQuery.java +++ b/solr/solrj/src/java/org/apache/solr/client/solrj/request/SolrQuery.java @@ -1134,14 +1134,16 @@ public class SolrQuery extends ModifiableSolrParams { } /** - * The Request Handler to use (see the solrconfig.xml), which is stored in the "qt" parameter. - * Normally it starts with a '/' and if so it will be used by {@link - * org.apache.solr.client.solrj.request.QueryRequest#getPath()} in the URL instead of the "qt" - * parameter. If this is left blank, then the default of "/select" is assumed. + * The Request Handler to use (see the solrconfig.xml), starting with a '/'. This isn't passed to + * Solr as a parameter; instead {@link QueryRequest} uses it for the path. QueryRequest uses + * "/select" if no path or request-handler is provided. Since this isn't <em>really</em> a + * parameter in practice, it's preferrable to set this in the constructor of QueryRequest, or the + * setter instead. * * @param qt The Request Handler name corresponding to one in solrconfig.xml on the server. * @return this - * @deprecated Use {@link SolrRequest#setPath(String)} + * @deprecated use QueryRequest#QueryRequest(String, SolrParams) + * @see SolrRequest#setPath(String) */ @Deprecated public SolrQuery setRequestHandler(String qt) { diff --git a/solr/solrj/src/java/org/apache/solr/common/params/CommonParams.java b/solr/solrj/src/java/org/apache/solr/common/params/CommonParams.java index b26360864c5..e0febfcfc60 100644 --- a/solr/solrj/src/java/org/apache/solr/common/params/CommonParams.java +++ b/solr/solrj/src/java/org/apache/solr/common/params/CommonParams.java @@ -36,12 +36,13 @@ public interface CommonParams { String TZ = "TZ"; /** - * the Request Handler (formerly known as the Query Type) - which Request Handler should handle - * the request. + * the Request Handler (formerly known as the Query Type) to route to as seen in solrconfig.xml. * - * @deprecated route requests by path instead, not using this parameter + * <p>Note: in a standard request, the handler is the last path component of the URL, not this + * parameter. This parameter is used for special cases when there is no path like a warming query + * or streaming expressions or some other places. */ - @Deprecated String QT = "qt"; + String QT = "qt"; /** the response writer type - the format of the response */ String WT = "wt";
