ctargett commented on a change in pull request #1773: URL: https://github.com/apache/lucene-solr/pull/1773#discussion_r477558467
########## File path: solr/solr-ref-guide/src/luke-request-handler.adoc ########## @@ -0,0 +1,77 @@ += Luke Request Handler +// Licensed to the Apache Software Foundation (ASF) under one +// or more contributor license agreements. See the NOTICE file +// distributed with this work for additional information +// regarding copyright ownership. The ASF licenses this file +// to you under the Apache License, Version 2.0 (the +// "License"); you may not use this file except in compliance +// with the License. You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +The Luke Request Handler offers programmatic access to the information provided on the <<schema-browser-screen#schema-browser-screen,Schema Browser>> page of the Admin UI. +It is modeled after the Luke, the Lucene Index Browser by Andrzej Bialecki. It is an implicit handler, so you don't need to define it. + +The Luke Request Handler accepts the following parameters: + +`show`:: +The data about the index to include in the response. Options are `schema`, `index`, `doc`, `all`. `index` describes the high level details about the index. `schema` returns details about the `schema` plus the `index` data. `doc` works in conjunction with `docId` or `id` parameters and returns details about a specific document plus the `index` data. + +`id`:: +Get a document using the uniqueKeyField specified in schema.xml. + +`docId`:: +Get a document using a lucene documentID. + +`fl`:: +Which fields you want to list the top terms for. + +`numTerms`:: +How many top terms for each field. The default is 10. + +`includeIndexFieldFlags`:: +Choose whether /luke should return the index-flags for each field. Fetching and returning the index-flags for each field in the index has non-zero cost, and can slow down requests to /luke. + + +== LukeRequestHandler Examples + +The following examples assume you are running Solr's `techproducts` example configuration: + +[source,bash] +---- +bin/solr start -e techproducts +---- + +To return summary information about the index: + +[source,text] +ttp://localhost:8983/solr/techproducts/admin/luke?numTerms=0 + Review comment: Missing starting 'h' for the URL. ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: us...@infra.apache.org --------------------------------------------------------------------- To unsubscribe, e-mail: issues-unsubscr...@lucene.apache.org For additional commands, e-mail: issues-h...@lucene.apache.org
