关于本指南

本指南介绍了 Apache Solr 的所有重要特性和功能。

Solr 可从 https://solr.net.cn/ 免费下载。

本指南旨在提供高级文档,意在成为一部百科全书,而不是一本食谱。它的结构旨在满足广泛的需求,从刚入门的新开发人员到扩展其应用程序或进行故障排除的经验丰富的开发人员。无论何时需要有关 Solr 的权威信息,它都将在应用程序生命周期的任何时候派上用场。

所提供的材料假设您熟悉一些基本的搜索概念,并且可以阅读 XML。它不假设您是 Java 程序员,尽管在直接使用 Lucene 或为 Solr 安装开发自定义扩展时,了解 Java 会有所帮助。

主机和端口示例

运行 Solr 时的默认端口为 8983。本指南中的示例、URL 和屏幕截图可能显示不同的端口,因为 Solr 使用的端口号是可配置的。

如果您尚未自定义 Solr 安装,请务必在遵循示例时使用端口 8983,或将您自己的安装配置为使用示例中显示的端口号。

同样,URL 示例始终使用 localhost;如果您要从远程位置访问 Solr,请将 localhost 替换为 Solr 正在运行的适当域或 IP。

例如,我们可能会提供类似以下内容的示例查询

http://localhost:8983/solr/gettingstarted/select?q=brown+cow

此 URL 中有几项您可能需要在本地更改。首先,如果您的服务器在“www.example.com”上运行,您将用适当的域替换“localhost”。如果您未使用端口 8983,您也将替换它。最后,您将需要用您在实现中使用的适当名称替换“gettingstarted”(集合或核心名称)。然后,URL 将变为

http://www.example.com/solr/mycollection/select?q=brown+cow

目录路径

路径信息相对于 solr.home 给出,这是 Solr 主安装下 Solr 的集合及其 confdata 目录存储的位置。

在很多情况下,它位于安装的 server/solr 目录中。但是,也可能出现例外情况,尤其是如果安装已对此进行自定义。

在本指南的几个案例中,我们的示例基于“techproducts”示例构建(即,您已使用命令 bin/solr -e techproducts 启动 Solr)。在这种情况下,solr.home 将是自动为您创建的 example/ 目录的子目录。

另请参阅部分 Solr Home,以进一步了解此目录中包含的内容。

API 示例

Solr 具有两种目前共存的 API 样式。随着时间的推移,Solr 逐渐发展,第一种样式也随之有机地发展,而第二种样式称为“V2 API”,它使用现代化且自文档化的 API 界面重新设计了许多原始 API。

在很多情况下(但并非全部),两种样式之间的 API 调用参数和输出是相同的。在所有情况下,所使用的路径和端点都不同。

在本指南中,我们添加了两种样式的示例,并将其分为“V1 API”和“V2 API”部分。截至本指南的 7.2 版本,这些示例尚未完成 - 随着未来版本指南的发布,将添加更多内容。

部分 v2 API 提供了有关如何使用新 API 结构的更多信息,包括如何选择禁用它。

所有 API 都会返回一个响应头,其中包括请求的状态和处理时间。一些 API 还会包括用于请求的参数。本指南中的许多示例都省略了此头信息,您可以通过向任何请求添加参数 omitHeader=true 在本地执行此操作。

特殊内联注释

这些页面中包含特殊注释。有几种类型的注释

信息块提供对您有用的其他信息。
重要块提供我们希望您了解的信息。
提示块提供有用的提示。
注意块提供了有关应小心的场景或配置的详细信息。
警告块用于警告您可能危险的更改或操作。