富文本编辑器、全文检索和django发送邮件

时间 2019-11-13

原文原文链接

1.富文本编辑器

1.1快速了解

借助富文本编辑器，网站的编辑人员可以像使用offfice同样编写出漂亮的、所见即所得的页面。此处以tinymce为例，其它富文本编辑器的使用也是相似的。

在虚拟环境中安装包。

pip install django-tinymce==2.6.0
安装完成后，可使用在Admin管理中，也能够自定义表单使用。

示例
1）在test6/settings.py中为INSTALLED_APPS添加编辑器应用。

INSTALLED_APPS = (
    ...
    'tinymce',
)
2）在test6/settings.py中添加编辑器配置。

TINYMCE_DEFAULT_CONFIG = {
    'theme': 'advanced',
    'width': 600,
    'height': 400,
}
3）在test6/urls.py中配置编辑器url。

urlpatterns = [
    ...
    url(r'^tinymce/', include('tinymce.urls')),
]
接下来介绍在Admin页面、自定义表单页面的使用方式。

1.2在Admin中使用

1）在booktest/models.py中，定义模型的属性为HTMLField()类型。

from django.db import models
from tinymce.models import HTMLField

class GoodsInfo(models.Model):
    gcontent=HTMLField()

2）生成迁移文件。

python manage.py makemigrations

3）执行迁移。javascript

python manage.py migrate

4）在本示例中没有定义其它的模型类，可是数据库中有这些表，提示是否删除，输入no后回车，表示不删除，由于其它的示例中须要使用这些表。html

5）迁移完成，新开终端，链接mysql，使用test2数据库，查看表以下：java

6）发现并无表GoodsInfo，解决办法是删除迁移表中关于booktest应用的数据。python

delete from django_migrations where app='booktest';

7）再次执行迁移。mysql

python manage.py migrate

成功完成迁移，记得不删除no。redis

8）在booktest/admin.py中注册模型类GoodsInfosql

from django.contrib import admin
from booktest.models import *
class GoodsInfoAdmin(admin.ModelAdmin):
    list_display = ['id']

admin.site.register(GoodsInfo,GoodsInfoAdmin)

9）运行服务器，进入admin后台管理，点击GoodsInfo的添加，效果以下图数据库

在编辑器中编辑内容后保存。django

1.3自定义使用

1）在booktest/views.py中定义视图editor，用于显示编辑器。

def editor(request):
    return render(request, 'booktest/editor.html')

2）在booktest/urls.py中配置url。api

url(r'^editor/',views.editor),

4）打开py_django虚拟环境的目录，找到tinymce的目录。

/home/python/.virtualenvs/py_django/lib/python3.5/site-packages/tinymce/static/tiny_mce

5）拷贝tiny_mce_src.js文件、langs文件夹以及themes文件夹拷贝到项目目录下的static/js/目录下。

6）在test6/settings.py中配置静态文件查找路径。

STATICFILES_DIRS=[
    os.path.join(BASE_DIR,'static'),
]

7）在templates/booktest/目录下建立editor.html模板。

<html>
<head>
    <title>自定义使用tinymce</title>
    <script type="text/javascript" src='/static/js/tiny_mce.js'></script>
    <script type="text/javascript">
        tinyMCE.init({
            'mode':'textareas',
            'theme':'advanced',
            'width':400,
            'height':100
        });
    </script>
</head>
<body>
<form method="post" action="#">
    <textarea name='gcontent'>哈哈，这是啥呀</textarea>
</form>
</body>
</html>

8）运行服务器，在浏览器中输入以下网址：

http://127.0.0.1:8000/editor/

浏览效果以下图：

1.4显示

经过富文本编辑器产生的字符串是包含html的。在数据库中查询以下图：

在模板中显示字符串时，默认会进行html转义，若是想正常显示须要关闭转义。

问：在模板中怎么关闭转义

方式一：过滤器safe
方式二：标签autoescape off

1）在booktest/views.py中定义视图show，用于显示富文本编辑器的内容。

from booktest.models import *
...
def show(request):
    goods=GoodsInfo.objects.get(pk=1)
    context={'g':goods}
    return render(request,'booktest/show.html',context)

2）在booktest/urls.py中配置url。

url(r'^show/', views.show),

3）在templates/booktest/目录下建立show.html模板。

<html>
<head>
    <title>展现富文本编辑器内容</title>
</head>
<body>
id:{{g.id}}
<hr>
{%autoescape off%}
{{g.gcontent}}
{%endautoescape%}
<hr>
{{g.gcontent|safe}}
</body>
</html>

4）运行服务器，在浏览器中输入以下网址：

http://127.0.0.1:8000/show/

浏览效果以下图：

2.全文检索

2.1快速了解

全文检索不一样于特定字段的模糊查询，使用全文检索的效率更高，而且可以对于中文进行分词处理。

haystack：全文检索的框架，支持whoosh、solr、Xapian、Elasticsearc四种全文检索引擎，点击查看官方网站。
whoosh：纯Python编写的全文搜索引擎，虽然性能比不上sphinx、xapian、Elasticsearc等，可是无二进制包，程序不会莫名其妙的崩溃，对于小型的站点，whoosh已经足够使用，点击查看whoosh文档。
jieba：一款免费的中文分词包，若是以为很差用可使用一些收费产品。

1）在虚拟环境中依次安装须要的包。

pip install django-haystack
pip install whoosh
pip install jieba

2）修改test6/settings.py文件，安装应用haystack。

INSTALLED_APPS = (
    ...
    'haystack',
)

3）在test6/settings.py文件中配置搜索引擎。

...
HAYSTACK_CONNECTIONS = {
    'default': {
        #使用whoosh引擎
        'ENGINE': 'haystack.backends.whoosh_cn_backend.WhooshEngine',
        #索引文件路径
        'PATH': os.path.join(BASE_DIR, 'whoosh_index'),
    }
}

#当添加、修改、删除数据时，自动生成索引
HAYSTACK_SIGNAL_PROCESSOR = 'haystack.signals.RealtimeSignalProcessor'

4）在test6/urls.py中添加搜索的配置。

url(r'^search/', include('haystack.urls')),

2.2建立引擎及索引

1）在booktest目录下建立search_indexes.py文件。

from haystack import indexes
from booktest.models import GoodsInfo
#指定对于某个类的某些数据创建索引
class GoodsInfoIndex(indexes.SearchIndex, indexes.Indexable):
    text = indexes.CharField(document=True, use_template=True)

    def get_model(self):
        return GoodsInfo

    def index_queryset(self, using=None):
        return self.get_model().objects.all()

2）在templates目录下建立"search/indexes/booktest/"目录。

3）在上面的目录中建立"goodsinfo_text.txt"文件。

#指定索引的属性
{{object.gcontent}}

4）找到虚拟环境py_django下的haystack目录。

/home/python/.virtualenvs/py_django/lib/python3.5/site-packages/haystack/backends/

5）在上面的目录中建立ChineseAnalyzer.py文件。

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()

6）复制whoosh_backend.py文件，改成以下名称：

注意：复制出来的文件名，末尾会有一个空格，记得要删除这个空格。

whoosh_cn_backend.py

7）打开复制出来的新文件，引入中文分析类，内部采用jieba分词。

from .ChineseAnalyzer import ChineseAnalyzer

8）更改词语分析类。

查找
analyzer=StemmingAnalyzer()
改成
analyzer=ChineseAnalyzer()

9）初始化索引数据。

python manage.py rebuild_index

10）按提示输入y后回车，生成索引。

11）索引生成后目录结构以下图：

2.3使用

按照配置，在admin管理中添加数据后，会自动为数据建立索引，能够直接进行搜索，能够先建立一些测试数据。

1）在booktest/views.py中定义视图query。

def query(request):
    return render(request,'booktest/query.html')

2）在booktest/urls.py中配置。

url(r'^query/', views.query),

3）在templates/booktest/目录中建立模板query.html。

参数q表示搜索内容，传递到模板中的数据为query。

<html>
<head>
    <title>全文检索</title>
</head>
<body>
<form method='get' action="/search/" target="_blank">
    <input type="text" name="q">
    <br>
    <input type="submit" value="查询">
</form>
</body>
</html>

4）自定义搜索结果模板：在templates/search/目录下建立search.html。

搜索结果进行分页，视图向模板中传递的上下文以下：

query：搜索关键字
page：当前页的page对象
paginator：分页paginator对象

视图接收的参数以下：

参数q表示搜索内容，传递到模板中的数据为query
参数page表示当前页码

<html>
<head>
    <title>全文检索--结果页</title>
</head>
<body>
<h1>搜索&nbsp;<b>{{query}}</b>&nbsp;结果以下：</h1>
<ul>
{%for item in page%}
    <li>{{item.object.id}}--{{item.object.gcontent|safe}}</li>
{%empty%}
    <li>啥也没找到</li>
{%endfor%}
</ul>
<hr>
{%for pindex in page.paginator.page_range%}
    {%if pindex == page.number%}
        {{pindex}}&nbsp;&nbsp;
    {%else%}
        <a href="?q={{query}}&amp;page={{pindex}}">{{pindex}}</a>&nbsp;&nbsp;
    {%endif%}
{%endfor%}
</body>
</html>

5）运行服务器，在浏览器中输入以下地址：

http://127.0.0.1:8000/query/

在文本框中填写要搜索的信息，点击”搜索“按钮。

搜索结果以下：

3.发送邮件

3.1使用django发送

Django中内置了邮件发送功能，被定义在django.core.mail模块中。发送邮件须要使用SMTP服务器，经常使用的免费服务器有：163、126、QQ，下面以163邮件为例。

1）注册163邮箱itcast88，登陆后设置。

2）在新页面中点击“客户端受权密码”，勾选“开启”，弹出新窗口填写手机验证码。

3）填写受权码。

4）提示开启成功。

5）打开test6/settings.py文件，点击下图配置。

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST = 'smtp.163.com'
EMAIL_PORT = 25
#发送邮件的邮箱
EMAIL_HOST_USER = 'itcast88@163.com'
#在邮箱中设置的客户端受权密码
EMAIL_HOST_PASSWORD = 'python808'
#收件人看到的发件人
EMAIL_FROM = 'python<itcast88@163.com>'

6）在booktest/views.py文件中新建视图send。

from django.conf import settings
from django.core.mail import send_mail
from django.http import HttpResponse
...
def send(request):
    msg='<a href="http://www.itcast.cn/subject/pythonzly/index.shtml" target="_blank">点击激活</a>'
    send_mail('注册激活','',settings.EMAIL_FROM,
              ['itcast88@163.com'],
              html_message=msg)
    return HttpResponse('ok')

7）在booktest/urls.py文件中配置。

url(r'^send/$',views.send),

8）启动服务器，在浏览器中输入以下网址：

http://127.0.0.1:8000/send/

邮件发送成功后，在邮箱中查看邮件以下图：

3.2使用celery异步任务队列发送邮件

情景：用户发起request，并等待response返回。在本些views中，可能须要执行一段耗时的程序，那么用户就会等待很长时间，形成很差的用户体验，好比发送邮件、手机验证码等。

使用celery后，状况就不同了。解决：将耗时的程序放到celery中执行。

点击查看celery官方网站
点击查看celery中文文档

celery名词：

任务task：就是一个Python函数。
队列queue：将须要执行的任务加入到队列中。
工人worker：在一个新进程中，负责执行队列中的任务。
代理人broker：负责调度，在布置环境中使用redis。

安装包：

celery==3.1.25
django-celery==3.1.17

1）在booktest/views.py文件中建立视图sayhello。

import time
...
def sayhello(request):
    print('hello ...')
    time.sleep(2)
    print('world ...')
    return HttpResponse("hello world")

2）在booktest/urls.py中配置。

url(r'^sayhello$',views.sayhello),

3）启动服务器，在浏览器中输入以下网址：

http://127.0.0.1:8000/sayhello/

4）在终端中效果以下图，两次输出之间等待一段时间才会返回结果。

5）在test6/settings.py中安装。

INSTALLED_APPS = (
  ...
  'djcelery',
}

6）在test6/settings.py文件中配置代理和任务模块。

import djcelery
djcelery.setup_loader()
BROKER_URL = 'redis://127.0.0.1:6379/2'

7）在booktest/目录下建立tasks.py文件。

import time
from celery import task

@task
def sayhello():
    print('hello ...')
    time.sleep(2)
    print('world ...')

8）打开booktest/views.py文件，修改sayhello视图以下：

from booktest import tasks
...
def sayhello(request):
    # print('hello ...')
    # time.sleep(2)
    # print('world ...')
    tasks.sayhello.delay()
    return HttpResponse("hello world")

9）执行迁移生成celery须要的数据表。

python manage.py migrate

生成表以下：

10）启动Redis，若是已经启动则不须要启动。

sudo service redis start

11）启动worker。

python manage.py celery worker --loglevel=info

启动成功后提示以下图：

11）打开新终端，进入虚拟环境，启动服务器，刷新浏览器。在旧终端中两个输出间仍有时间间隔。

运行完成后以下图，注意两个终端中的时间，服务器的响应是当即返回的。

12）打开booktest/task.py文件，修改成发送邮件的代码，就能够实现无阻塞发送邮件。

from django.conf import settings
from django.core.mail import send_mail
from celery import task

@task
def sayhello():
    msg='<a href="http://www.itcast.cn/subject/pythonzly/index.shtml" target="_blank">点击激活</a>'
    send_mail('注册激活','',settings.EMAIL_FROM,
              ['itcast88@163.com'],
              html_message=msg)