Django 博客实现简单的全文搜索的示例代码


Posted in Python onFebruary 17, 2020

作者:HelloGitHub-追梦人物

文中所涉及的示例代码,已同步更新到 HelloGitHub-Team 仓库

搜索是一个复杂的功能,但对于一些简单的搜索任务,我们可以使用 Django Model 层提供的一些内置方法来完成。现在我们来为我们的博客提供一个简单的搜索功能。

概述

博客文章通常包含标题和正文两个部分。当用户输入某个关键词进行搜索后,我们希望为用户显示标题和正文中含有被搜索关键词的全部文章。整个搜索的过程如下:

  1. 用户在搜素框中输入搜索关键词,假设为 “django”,然后用户点击了搜索按钮提交其输入的结果到服务器。
  2. 服务器接收到用户输入的搜索关键词 “django” 后去数据库查找文章标题和正文中含有该关键词的全部文章。
  3. 服务器将查询结果返回给用户。

整个过程就是这样,下面来看看 Django 如何用实现这些过程。

将关键词提交给服务器

先来回顾一下我们的 Django 博客的 Post(文章)模型:

blog/models.py

class Post(models.Model):
  # 标题
  title = models.CharField("标题", max_length=70)
  # 正文
  body = models.TextField("正文")
  
  # 其他属性...
  
  def __str__(self):
    return self.title

先看到第 1 步,用户在搜索框输入搜索关键词,因此我们要在博客上为用户提供一个搜索表单,HTML 表单代码大概像这样:

templates/base.html

<form role="search" method="get" id="searchform" action="{% url 'blog:search' %}">
 <input type="search" name="q" placeholder="搜索" required>
 <button type="submit"><span class="ion-ios-search-strong"></span></button>
</form>

特别注意这里 <input type="search" name="q" placeholder="搜索" required> 中的 name 属性,当用户在这个 input 中输入搜索内容并提交表单后,键入的数据会以键值对的形式提交服务器,这个键的名字就是通过 name 属性指定的。这样服务器就可以根据 name 的值来取得用户输入的内容。

用户输入了搜索关键词并点击了搜索按钮后,数据就被发送给了 Django 后台服务器。表单的 action 属性的值为 {% url 'blog:search' %}(虽然我们还没有写这个视图函数),表明用户提交的结果将被发送给 blog 应用下 search 视图函数对应的 URL。

查找含有搜索关键词的文章

搜索的功能将由 search 视图函数提供,代码写在 blog/views.py 里:

blog/views.py

from django.contrib import messages

def search(request):
  q = request.GET.get('q')

  if not q:
    error_msg = "请输入搜索关键词"
    messages.add_message(request, messages.ERROR, error_msg, extra_tags='danger')
    return redirect('blog:index')

  post_list = Post.objects.filter(Q(title__icontains=q) | Q(body__icontains=q))
  return render(request, 'blog/index.html', {'post_list': post_list})

首先我们使用 request.GET.get('q') 获取到用户提交的搜索关键词。用户通过表单 get 方法提交的数据 Django 为我们保存在 request.GET 里,这是一个类似于 Python 字典的对象,所以我们使用 get 方法从字典里取出键 q 对应的值,即用户的搜索关键词。这里字典的键之所以叫 q 是因为我们的表单中搜索框 input 的 name 属性的值是 q,如果修改了 name 属性的值,那么这个键的名称也要相应修改。

接下来我们做了一个小小的校验,如果用户没有输入搜索关键词而提交了表单,我们就无需执行查询,我们给给用户发一条错误提醒消息,这里使用了 django messages 应用,这在 交流的桥梁:评论功能 中讲过。然后将用户重定向到首页。这里的 redirect 函数也在那篇教程中讲过。

如果用户输入了搜索关键词,我们就通过 filter 方法从数据库里过滤出符合条件的所有文章。这里的过滤条件是 title__icontains=q,即 title 中包含(contains)关键字 q,前缀 i 表示不区分大小写。这里 icontains 是查询表达式(Field lookups),我们在之前也使用过其他类似的查询表达式,其用法是在模型需要筛选的属性后面跟上两个下划线。Django 内置了很多查询表达式,建议过一遍 Django 官方留个印象,了解每个表达式的作用,以后碰到相关的需求就可以快速定位到文档查询其用途 Field lookups。

此外我们这里从 from django.db.models 中引入了一个新的东西:Q 对象。Q 对象用于包装查询表达式,其作用是为了提供复杂的查询逻辑。例如这里 Q(title__icontains=q) | Q(body__icontains=q) 表示标题(title)含有关键词 q 或者正文(body)含有关键词 q ,或逻辑使用 | 符号。如果不用 Q 对象,就只能写成 title__icontains=q, body__icontains=q,这就变成标题(title)含有关键词 q 且正文(body)含有关键词 q,就达不到我们想要的目的。

绑定 URL

有了视图函数后记得把视图函数映射到相应了 URL,如下。

blog/urls.py

urlpatterns = [
  # 其他 url 配置
  path('search/', views.search, name='search'),
]

大功告成,在导航栏尝试输入一些关键词,看看效果吧!

当然这样的搜索功能是非常简略的,难以满足一些复杂的搜索需求。编写一个搜索引擎是一个大工程,好在 django-haystack 这款第三方 app 为我们完成了全部工作。使用它我们可以实现更加复杂的搜索功能,比如全文检索、按搜索相关度排序、关键字高亮等等类似于百度搜索的功能,功能十分强大。当然其使用也会复杂一些,下一篇教程将向大家介绍 django-haystack 结合 Elasticsearch 搜索引擎的使用方法。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Python 相关文章推荐
跟老齐学Python之有容乃大的list(4)
Sep 28 Python
收集的几个Python小技巧分享
Nov 22 Python
Python实现的彩票机选器实例
Jun 17 Python
举例讲解Python设计模式编程中对抽象工厂模式的运用
Mar 02 Python
python 常用的基础函数
Jul 10 Python
Sanic框架安装与简单入门示例
Jul 16 Python
Python测试模块doctest使用解析
Aug 10 Python
使用python实现unix2dos和dos2unix命令的例子
Aug 13 Python
python tkinter组件摆放方式详解
Sep 16 Python
python文件读写代码实例
Oct 21 Python
Keras:Unet网络实现多类语义分割方式
Jun 11 Python
聊聊python在linux下与windows下导入模块的区别说明
Mar 03 Python
Python使用qrcode二维码库生成二维码方法详解
Feb 17 #Python
django2.2 和 PyMySQL版本兼容问题
Feb 17 #Python
基于python3的socket聊天编程
Feb 17 #Python
python词云库wordCloud使用方法详解(解决中文乱码)
Feb 17 #Python
python词云库wordcloud的使用方法与实例详解
Feb 17 #Python
tensorflow保持每次训练结果一致的简单实现
Feb 17 #Python
Python基于Socket实现简单聊天室
Feb 17 #Python
You might like
php curl登陆qq后获取用户信息时证书错误
2015/02/03 PHP
php遍历CSV类实例
2015/04/14 PHP
基于PHP给大家讲解防刷票的一些技巧
2015/11/18 PHP
PHP实现按之字形顺序打印二叉树的方法
2018/01/16 PHP
Laravel Validator 实现两个或多个字段联合索引唯一
2019/05/08 PHP
PHP session垃圾回收机制实例分析
2019/06/28 PHP
PHP防止sql注入小技巧之sql预处理原理与实现方法分析
2019/12/13 PHP
js滚动条回到顶部的代码
2011/12/06 Javascript
JQuery插件开发示例代码
2013/11/06 Javascript
遍历DOM对象内的元素属性示例代码
2014/02/08 Javascript
JS中判断JSON数据是否存在某字段的方法
2014/03/07 Javascript
JQuery实现table行折叠效果以JSON做数据源
2014/05/26 Javascript
jQuery中通过ajax的get()函数读取页面的方法
2016/02/29 Javascript
js简单时间比较的方法
2016/08/02 Javascript
微信小程序 Audio API详解及实例代码
2016/09/30 Javascript
JS给Array添加是否包含字符串的简单方法
2016/10/29 Javascript
使用Bootstrap美化按钮实例代码(demo)
2017/02/03 Javascript
JavaScript设计模式之策略模式详解
2017/06/09 Javascript
VUE前后端学习tab写法实例
2019/08/06 Javascript
nodejs使用node-xlsx生成excel的方法示例
2019/08/22 NodeJs
Vue使用axios引起的后台session不同操作
2020/08/14 Javascript
Python抓取框架 Scrapy的架构
2016/08/12 Python
python使用多进程的实例详解
2018/09/19 Python
python自动化unittest yaml使用过程解析
2020/02/03 Python
使用Python内置模块与函数进行不同进制的数的转换
2020/04/26 Python
Python pip安装模块提示错误解决方案
2020/05/22 Python
Python3爬虫带上cookie的实例代码
2020/07/28 Python
pytorch __init__、forward与__call__的用法小结
2021/02/27 Python
phpquery中文手册
2021/03/18 PHP
全球速卖通:AliExpress(国际版淘宝)
2017/09/20 全球购物
Vision Direct比利时:在线订购隐形眼镜
2019/08/27 全球购物
区域销售经理岗位职责
2013/12/10 职场文书
新年主持词
2014/03/27 职场文书
2014年残疾人工作总结
2014/12/06 职场文书
干部考核工作总结2015
2015/07/24 职场文书
virtualenv隔离Python环境的问题解析
2022/06/21 Python