django的基本用法

1、项目创建

# 新建一个文件夹DjangoProjects
# 切换到需要的文件夹创建虚拟环境
C:\Projects\DjangoProjects>python -m venv test_venv

# 激活虚拟环境
C:\Projects\DjangoProjects>test_venv\Scripts\activate.bat
# 激活后会在前面添加虚拟环境作为前缀，如下所示
(test_venv) C:\Projects\DjangoProjects>

# 安装django，会安装到虚拟环境的site-packages中
(test_venv) C:\Projects\DjangoProjects>pip3 install django

# 新建项目
(test_venv) C:\Projects\DjangoProjects>django-admin.py startproject testsite

# 这时就可以启动开发服务器了，注意先切换到项目文件夹
(test_venv) C:\Projects\DjangoProjects>cd testsite
(test_venv) C:\Projects\DjangoProjects\testsite>python manage.py runserver

# 创建应用
(test_venv) C:\Projects\DjangoProjects\testsite>python manage.py startapp testblog

2、添加常用文件夹

一般名称为static与templates，在新版本中需要手动添加，static用于静态资源，templates用于存放模板文件。以下是创建好之后的目录，注意在新建的项目testsite目录（上面创建时使用的名称）下面，还会有一个testsite文件夹。

3、一个用于说明如何使用django的例子

结合上面创建的目录和应用，这个例子会显示如何从mongodb中提取数据，并在前端怎样使用highcharts将数据呈现出来。

django的用法比较简单，理解关键的文件是重点。

1> settings.py文件

顾名思义，这是django的设置文件，对于这个例子来说，位于testsite目录所包含的testsite文件夹中。

STATIC_URL = '/static/' # 说明使用static文件夹作为静态资源的文件夹
STATICFILES_DIRS = (os.path.join(BASE_DIR, "static"),) # 如何找到static文件夹，这个必须有，要不然Django是找不到文件夹的位置的

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        # 添加，如何找到templates文件夹
        'DIRS': [os.path.join(BASE_DIR, 'templates')],
         # 从略...
    },

from mongoengine import connect
# 第一个参数是数据库
connect('test', host='192.168.1.108', port=27017)
# 如需验证和指定主机名
# connect('blog', host='192.168.125.1', username='root', password='12345')

以上给出了部分代码，注意上面蓝色显示的部分，一方面，表明了上面创建的static与templates文件夹是如何使用的，另一方面表明了连接mongodb的一种方式。
注意使用mongoengine需要先进行安装： pip3 install mongoengine

2> urls.py

路由在这个文件中设置，文件位于testsite目录所包含的testsite文件夹中。

from django.conf.urls import url
from django.contrib import admin
# 注意这两种写法
from testblog import views
from testblog.views import house, chart

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^index/', views.index),
    url(r'^house/', house),
    url(r'^chart/', chart),
]

在上面的url中，前面一个是正则表达式，后面一个是views.py（下面介绍）中的函数。

例如，当我们访问 127.0.0.1:8000/chart/ 这个页面时，django会通过views.py中设置的自定义的chart函数来处理请求。

3> views.py

这个文件用来封装处理请求的各种函数，本项目系统会自动创建在位于testblog文件目录下面，testblog是上面创建的应用名称。

from django.shortcuts import render
from django.core.paginator import Paginator
from testblog.models import SalesInfo
# Create your views here.

# 地区销售总额
# 因为要构建highcharts需要的数据，地区要有固定的顺序，需要排序
# x轴：地区
# y轴：销售额
def area_sales(cate):
    pipeline = [
    {'$match': {'$and': [{'category': {'$in':cate}}, {'province': {'$in': ['山东','浙江','江苏','河北','辽宁']}}]}},
    {'$group': { '_id': '$province',  'sum_sales': {'$sum': {'$multiply': ['$price', '$quantity'] }}}},
    {'$sort': {'_id': 1}}
    ]
    # SalesInfo在models中设置
    for i in SalesInfo._get_collection().aggregate(pipeline):
        print(i)
        data = {
            'name': i['_id'],
            'y': i['sum_sales']
        }
        yield data

# 对于各地区的排序，与种类无关，此处传了参数“粮食”，使用其他种类是一样的
c=[i['name'] for i in area_sales(['粮食'])]
# 也可以使用下面的方式获取排序
cate = ['山东','浙江','江苏','河北','辽宁']
b = sorted(cate)

# 用于y轴的数据
sg_sales = [i for i in area_sales(['水果'])]
ls_sales = [i for i in area_sales(['粮食'])]
sc_sales = [i for i in area_sales(['蔬菜'])]

def chart(request):
    context = {
        'sg_sales': sg_sales,
        'ls_sales': ls_sales,
        'sc_sales': sc_sales,
        'area': c
    }
    return render(request,'charts.html',context)

上面是关键部分的代码，主要是chart函数，这个自定义的函数通过render函数将请求“request”，页面（所谓的模板）“charts.html”，数据“context”连接起来。

毫无疑问，render函数是关键的一环（来源：from django.shortcuts import render）

area_sales这个生成器函数用于产生y轴需要的数据，仅是为了说明如何构造highcharts图表所需要的数据。里面用到的SalesInfo是在models.py文件中设置的。

4> models.py

用于设置一些ORM对象模型，位于testblog文件目录下面

from django.db import models
from mongoengine import *

# Create your models here.
# 数据来源于mongodb，需要继承自Document
class SalesInfo(Document):
    _id = StringField()
    name = StringField()
    category = StringField()
    province = StringField()
    description = StringField()
    price = FloatField()
    quantity = IntField()
    unit = StringField()
    saledate = StringField()
    # 对应数据库中的数据表
    meta = {'collection':'salesnew'}

5> 模板

一系列的html页面，统一放置在templates文件目录下面，页面所需要的js、图片、css样式则存放到static文件夹下面。可以将页面中一些公用的元素拿出来作为主模板，方便重用。

A、主模板base.html

{% load static %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <link rel="stylesheet" href="{% static 'css/semantic.css' %} ">
    <script src="{% static 'js/jquery-3.1.1.js' %}"></script>
    <script src="{% static 'js/semantic.js' %}"></script>
    <!--<script src="{% static 'js/exporting.js' %}"></script>-->
    <script src="{% static 'js/highcharts.js' %}"></script>
    <script src="{% static 'js/highcharts-more.js' %}"></script>
</head>
<body>
<div class="ui thin visible left sidebar inverted vertical menu">
    <div class="header item">
        <img src="../static/themes/default/assets/images/logo2.png">
    </div>

    <div class="item">
        Documents
        <i class="browser icon"></i>
    </div>
    <div class="item">
        Charts
        <i class="bar chart icon"></i>
    </div>
    <div class="item">
        Others
        <i class="idea icon"></i>
    </div>
</div>
<div class="pusher">
    <div class="ui menu">
        <div class="header item" id="menu">
            Menu
            <i class="content icon"></i>
        </div>
        <div class="item">About us</div>
        <div class="item">Location</div>
        <div class="item">Others</div>
    </div>

    {% block area %}{% endblock %}

    </div>
</div>

<script>
    $('#menu').click(function(){
        $('.ui.sidebar').sidebar('toggle');
    })
</script>

{% block script %}{% endblock %}

</body>
</html>

如上，{% load static %} 用来标识会加载static文件目录中的内容

<link rel="stylesheet" href="{% static 'css/semantic.css' %} ">、script src="{% static 'js/highcharts.js' %}"></script> 、<script src="{% static 'js/highcharts-more.js' %}"></script> 表明了django中加载资源的方式 highcharts.js与highcharts-more.js是使用hightcharts图表所需要的，可以到hightcharts官网下载。

{% block area %}{% endblock %}来标识如何使用部件，可以看作是占位符。其中area是自定义的名称。

B、页面 charts.html

{% extends 'base.html' %}
{% block area %}
<div class="ui equal width grid" style="margin:5px 0 5px 0;width:70%">
   <div class="row">
      <div class="column">
        <div class="ui container segment">
          <div class="ui container" id="chart2"></div>
        </div>
      </div>
    </div>
</div>
{% endblock %}

{% block script %}
    <script>
        $(function () {
        // Create the chart
         $('#chart2').highcharts({
                chart: {
                    type: 'column'
                },
                title: {
                    text: '各地区销售情况'
                },
                subtitle: {
                    text: 'Source: WorldSales'
                },
                xAxis: {
                    categories: {{area|safe}},
                    crosshair: true
                },
                yAxis: {
                    min: 0,
                    title: {
                        text: '金额 (元)'
                    }
                },
                tooltip: {
                    headerFormat: '<span style="font-size:10px">{point.key}</span><table>',
                    pointFormat: '<tr><td style="color:{series.color};padding:0">{series.name}: </td>' +
                    '<td style="padding:0"><b>{point.y:.1f} 元</b></td></tr>',
                    footerFormat: '</table>',
                    shared: true,
                    useHTML: true
                },
                plotOptions: {
                    column: {
                        pointPadding: 0.2,
                        borderWidth: 0
                    }
                },
                series: [{
                    name: '水果',
                    data: {{ sg_sales|safe }}
                }, {
                    name: '粮食',
                    data: {{ ls_sales|safe }}
                }, {
                    name: '蔬菜',
                    data: {{ sc_sales|safe }}
                }]
            });
    });
    </script>
{% endblock %}

{% extends 'base.html' %}表明继承自base.html

{% block area %}{% endblock %}包含了页面的主要代码

{% block script %}{% endblock %}包含了highcharts图表用到的代码，这个可以直接从highcharts官方网站复制。https://www.hcharts.cn/demo/highcharts

需要做的只是改变js中的数据源，主要的，如用于x轴的 categories: {{area|safe}},用于y轴的 data: {{ ls_sales|safe }}，注意{{变量名}}是django在模板中加载变量的方式。当然，也可以换种方式，用js来填充数据，这个可以参考highcharts官网的文档。

6> 结果

在控制台中运行

(test_venv) C:\Projects\DjangoProjects\testsite>python manage.py runserver

会开启开发服务器，并得到一个网址127.0.0.1:8000，访问 127.0.0.1:8000/chart/ 会看到下面的结果：

当然，数据的可视化也可使用百度的echarts。参见 http://echarts.baidu.com/

总结

以上简要的介绍了django的使用方法，包括环境的搭建，以及一个具体的例子。