haystack+whoosh

2019-08-27 16:38:39 浏览数 (1)

haystack: 全文检索框架(对检索引擎包装下,抹掉差异 提供统一接口,方便码农)。该框架支持Elasticsearch,Whoosh, XapianSolr搜索引擎。 Elasticsearch:据说是java写的。Elastic(有弹性的,灵活 可伸展的),大概说明其 操作的灵活性。 Xapian: apian蜜蜂,X apian,大概使用蜜蜂的嗅探能力,来说明其搜索范围之广。

whoosh:检索引擎。(单词原意:飞快的移动。大概是说 其检索的速度很快,咻的一下 就找到了)

检索引擎(whoosh)的作用: 对 表中的某些字段 进行 关键词分析,在 关键词 和 表中其它记录s 之间 建立联系(索引表)。


1. 安装django-haystack, whoosh, jieba(切换到项目目录下)
代码语言:javascript复制
$ cd ~/PycharmProjects/dailyfresh
$ pip install whoosh 
$ pip install django-haystack
$ pip install jieba 
2. 在Django项目的settings.py里面的INSTALLED_APPS添加Haystack

add 'haystack' to INSTALLED_APPS

3. 修改settings.py文件, 配置引擎

配置haystack使用什么引擎,以及配置检索文件的存放路径

代码语言:javascript复制
# 配置 全文检索框架(haystack)使用 检索引擎(whoosh)
HAYSTACK_CONNECTIONS = {
    'default': {
        # 使用whoosh引擎
        # haystack 通过 下面路径 中的 WhooshEngine类,来使用whoosh检索引擎
        # WhooshEngine的路径 venv/lib/site-packages/haystack/backends/whoosh_backend.py WhooshEngine类
        'ENGINE': 'haystack.backends.whoosh_backend.WhooshEngine',
        # 索引文件的 存放路径,所有的 索引文件 都存放在 该目录下。生成索引文件时,自动 在目录(BASE_DIR)下 创建目录(whoosh_index)
        'PATH': os.path.join(BASE_DIR, 'whoosh_index'),
    }
}

# 检索引擎(whoosh)的作用: 对 表中的某些字段 进行 关键词分析,在 关键词 和 表中其它记录s 之间 建立联系(索引表)
# 表中 字段内容 发生变化时,索引 也应发生变化 来适应 字段内容的变化。

# 当表中数据 发生变化(添加 删除 修改)时,自动生成 新的索引(替换 旧的索引)
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'
4. 对某个django的app创建索引

goods应用 目录下面建立search_indexes.py文件,文件名不能更改。(goods是你某个app的名称,可替换为 具体的app名称) 在search_indexes.py文件中,只需更改3处地方: 1)导入 需要建立索引的模型类(GoodsSKU) 2)索引类的名称(命名规则:模型类 Index) 3)get_model返回的 模型类(改为 你想建立索引的模型类)

代码语言:javascript复制
# 定义索引类

from haystack import indexes

# 导入模型类
from apps.goods.models import GoodsSKU



# 对某个类的 某些数据 建立索引
# 索引类 类名 的格式:模型类名 Index
class GoodsSKUIndex(indexes.SearchIndex, indexes.Indexable):
    # text: 索引字段。document=True: 指定 该text为 索引字段。
    # use_template=True 指定 对表中的哪些字段进行关键词分析 建立索引文件。对字段的说明,是 放在一个文件中的。
    text = indexes.CharField(document=True, use_template=True)

    def get_model(self):
        # 返回 需要检索的 模型类
        return GoodsSKU

    # 返回 数据。对该数据 建立索引。
    def index_queryset(self, using=None):
        return self.get_model().objects.all()
5. 对哪些字段建立索引

创建目录templates/search/indexes/goods/,在templates/search/indexes/goods/目录下, 新建文件goodssku_text.txt。(goods为 APP名。goodssku为模型名,并且 全部 改为小写。模型名的 后缀_text.txt,不能更改)

代码语言:javascript复制
# object代表 GoodsSKU模型名,
# 因为文件名已经指定了 模型类的路径和名称
# name, desc, goods, detail为字段名
# 根据表中的哪些字段 建立 索引数据

{{ object.name }}   # 根据商品的名称name 建立索引
{{ object.desc }}   #          简介desc 建立索引
{{ object.goods.detail }}   # 根据商品的详情detail 建立索引(详情在spu表中)
6. 命令生成索引文件

在项目目录下,执行命令:

代码语言:javascript复制
$ python manage.py rebuild_index

如果成功生成索引文件,会在项目的根目录下,出现下图中的目录和文件。

成功生成索引文件 图

7. 添加 搜索框的表单,并设置

templates/base.html中 添加搜索框表单。 form表单的method=‘get'不能改变,搜索栏的文本框的name="q"也是固定不变的。 action是 表单的 提交地址,对搜索的处理 交由 搜索引擎 进行处理。对表单action的配置,表单地址的配置 可随意更改,但是需要与项目目录下urls.py中的 全文检索框架的url配置 一致。

代码语言:javascript复制
    <div class="search_con fl">
        {# 下面form表单的method 是'get'不能改变,搜索栏的文本框的name="q" 也是固定不变的 #}
        {# action 表单的 提交地址,对搜索的处理 交由 搜索引擎 进行处理 #}
        <form method="get" action="/search">
            <input type="text" class="input_text fl" name="q" placeholder="搜索商品">
            <input type="submit" class="input_btn fr" name="" value="搜索">
        </form>

    </div>
8. 配置全文检索的url

在项目目录下urls.py中,添加 全文检索框架的url配置(url地址 要和 表单action地址 一致)

代码语言:javascript复制
re_path(r'^search', include('haystack.urls')),  # 全文检索框架
9. 全文检索搜索过程

搜索到结果后,haystack会把搜索出来的结果 传递给 templates/search目录下的search.html, 传递的上下文 有:

haystack会对搜索的结果数据 进行分页,并把 当前页的page对象 传递给search.html

  • query: 搜索关键字.
  • page: 当前页的page对象。遍历page对象,获取到的是SearchResult类的 实例对象,该对象的object属性 才是模型类的对象.page对象object属性包含模型类的对象,这些模型类的对象是 搜索的结果。
  • paginator: 当前分页的pagenitor对象. 通过HAYSTACK_SEARCH_RESULTS_PER_PAGE 可以控制 每页显示搜索结果的数量。
10. 更改whoosh引擎 使用的 关键词分析 类

1)安装jieba 在项目目录下

代码语言:javascript复制
pip install jieba
  1. 更改whoosh默认的 关键词分析类

找到项目虚拟环境下haystack目录(venv/lib/python3.6/site-packages/haystack/backends/)。 在该目录下 新建文件ChineseAnalyzer.py, 写入 如下 内容。

代码语言:javascript复制
import jieba
from whoosh.analysis import Tokenizer, Token

class ChineseTokenizer(Tokenizer):
    def __call__(self, value, positions=False, chars=False,
                 keeporiginal=False, removestops=True,
                 start_pos=0, start_char=0, mode='', **kwargs):
        t = Token(positions, chars, removestops=removestops, mode=mode, **kwargs)
        seglist = jieba.cut(value, cut_all=True)
        for w in seglist:
            t.original = t.text = w
            t.boost = 1.0
            if positions:
                t.pos = start_pos   value.find(w)
            if chars:
                t.startchar = start_char   value.find(w)
                t.endchar = start_char   value.find(w)   len(w)
            yield t

def ChineseAnalyzer():
    return ChineseTokenizer()

更改whoosh_backend.py中的词语分析类:

代码语言:javascript复制
# 复制whoosh_backend.py并改名为whoosh_cn_backend.py
$ cp whoosh_backend.py whoosh_cn_backend.py

$ vi whoosh_cn_backend.py
# 添加from .ChineseAnalyzer import ChineseAnalyzer一行,导入ChineseAnalyzer方法

# 命令行模式搜索StemmingAnalyzer(), 将其修改为ChineseAnalyzer()

# :wq

更改settings.py中的 HAYSTACK_CONNECTIONS配置, 使其使用whoosh_cn_backend

代码语言:javascript复制
# 配置 全文检索框架(haystack)使用 检索引擎(whoosh)
HAYSTACK_CONNECTIONS = {
    'default': {
        # 使用whoosh引擎
        # haystack 通过 下面路径 中的 WhooshEngine类,来使用whoosh检索引擎
        # WhooshEngine的路径 venv/lib/site-packages/haystack/backends/whoosh_backend.py WhooshEngine类
        # 'ENGINE': 'haystack.backends.whoosh_backend.WhooshEngine',
        'ENGINE': 'haystack.backends.whoosh_cn_backend.WhooshEngine',
        # 索引文件的 存放路径,所有的 索引文件 都存放在 该目录下。生成索引文件时,自动 在目录(BASE_DIR)下 创建目录(whoosh_index)
        'PATH': os.path.join(BASE_DIR, 'whoosh_index'),
    }
}

# 检索引擎(whoosh)的作用: 对 表中的某些字段 进行 关键词分析,在 关键词 和 表中其它记录s 之间 建立联系(索引表)
11. 重新生成索引文件

切换到项目目录下

代码语言:javascript复制
$ python manage.py rebuild_index

0 人点赞