Django-2.1基础操作

 创建项目

---

安装django

pip3 install django
#查看django版本
django-admin --version
python -m django --version
2.1.2

1,创建一个项目（project）

django-admin startproject mysite  # 创建project
# cd mysite #创建完成后，生成的project目录
# tree
|-- manage.py
|-- mysite
| |-- __init__.py
| |-- settings.py
| |-- urls.py
| `-- wsgi.py

# wsgi.py （python web server gateway interface python）服务器网关接口，python应用与web服务器之间的接口
# urls.py url配置文件，django项目中的所有地址都需要配置其url
# settings.py 项目总配置文件，包含了数据库，web应用，时间等各种配置

BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))) #django根目录
SECRET_KEY = ')(^))edmyp7-eork0c%+=q(6ll18(7lce$i)ynsoo2h5m+7v27'  #安全码
DEBUG=True  #(默认的,访问url出错会显示调试的页面，生产环境应该改为False)
ALLOWED_HOSTS = []  # 白名单, 如果DEBUG=False，那么一定要设置此项
INSTALLED_APPS = [   
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    "app01",              #把自己创建的应用加入进来才能被django识别
    "app02"
]
ROOT_URLCONF = 'project_test.urls'   #全局url
DATABASES = {         # 数据库配置
    'default': { 
        'ENGINE': 'django.db.backends.sqlite3',          #数据库引擎
        'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),    #数据库名
      #  "ENGINE": 'django.db.backends.mysql',  #使用mysql数据库
      #  'NAME': 'mydb',       #数据库名
      #  'HOST': 'localhost',   #ip
      #  'PORT': '3306',        #端口，注意是字符串
      #  'USER': 'root',      #用户名
      #  'PASSWORD': 'password'   #密码
    }
}
# LANGUAGE_CODE = 'en-us'
LANGUAGE_CODE = 'zh_Hans'  #可以改成中文
TIME_ZONE = 'UTC'  #时区，生产环境改成Asia
STATIC_URL = '/static/'  #static 是静态文件目录，比如 js,css等文件

2，创建应用（app）

# python manage.py startapp app01 创建app01，生成了app01目录
|-- app01
| |-- admin.py   #当前应用的后台管理系统配置
| |-- apps.py   
| |-- __init__.py
| |-- migrations   #数据移植(迁移)模块，下面的文件是django自动生成
| | `-- __init__.py
| |-- models.py   #数据模块，使用orm框架
| |-- tests.py   #自动化测试模块
| `-- views.py   #视图模块，执行响应的代码，处理代码逻辑
|-- manage.py
|-- mysite
| |-- __init__.py
| |-- settings.py
| |-- urls.py
| `-- wsgi.py
# python manage.py startapp app02  可以创建多个应用

3，运行django程序的命令

# cd mysite #进入project 
# python manage.py runserver 127.0.0.1:8000 #运行命令

访问http://127.0.0.1:8000/ 可以看到django已经安装成功，只是此时并未配置任何url

删除一个app

• 首先删除models.py。# python  manage.py migrate app_name zero 删除models.py中的数据模型。
• 删除app目录。在settings.py的INSTALLED_APPS中移除该app。

视图与路由  

---

urls 控制器    根据url匹配相应的视图函数

views 视图    逻辑处理，决定给前端展示什么数据，调用models数据库里的数据，把要展示的数据返回给模板

创建project 和app之后， # vim mysite/mysite/settings.py  

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'app01',   #加入这一行
]

# 将新建的app加入到settings的INSTALLED_APPS中，django 就能自动找到app中的模板文件(app/templates/文件)和静态文件(app/static/文件)

定义视图view   vim app01/views.py

from django.http import HttpResponse

def test(request):
    return HttpResponse("hello django,this is a test message")

定义url   vim mysite/urls.py

from django.contrib import admin
from django.urls import path
from app01 import views   #导入views
urlpatterns = [
    path('admin/', admin.site.urls),
    path('test/', views.test)    # 加入这一行
]

运行python，访问http://127.0.0.1:8000/test/ 可以看到

path方法 （不支持正则，正则请用re_path）

默认情况下，以下路径转换器可用：

• str -  匹配除路径分隔符'/'之外的任何非空字符串。如果转换器未包含在表达式中，则这是默认值。
  
• path - 匹配任何非空字符串，包括路径分隔符 '/'。这使您可以匹配完整的URL路径，而不仅仅是URL路径的一部分str。
• int  - 匹配零或任何正整数。返回一个int。
• slug - 匹配由ASCII字母或数字组成的任何slug字符串，以及连字符和下划线字符。例如，building-your-1st-django-site。
• uuid  - 匹配格式化的UUID。要防止多个URL映射到同一页面，必须包含短划线并且字母必须为小写。例如，075194d3-6885-417e-a8a8-6c931e272f00。

示例：

# urls.py
from app01 import views
urlpatterns = [
    path('admin/', admin.site.urls),
    path('add/<int:num1>/<int:num2>',views.add),
    path('add/<path:str2>/<path:str1>',views.addstr),
]
# views.py
def add(request,num1,num2):
    addnum = num1 + num2
    return HttpResponse(addnum)
def addstr(request,str1,str2):
    strs = str1 + str2
    return HttpResponse(strs)
访问 http://127.0.0.1:8000/add/2/3 
得到 5
访问 http://127.0.0.1:8000/addstr/a/b 
得到 ba

也可以注册自定义路径转换器

1，先定义一个类 。

2，用to_python(self, value) 方法把匹配的字符串转换成要传递到视图函数的类型

3，用to_url(self, value) 方法把python数据类型转换成url要使用的字符串。

# vim converters 
class FourDigitYearConverter:
    regex = '[0-9]{4}'
    def to_python(self, value):
        return int(value)
    def to_url(self, value):
        return '%04d' % value

# vim urls.py
from django.contrib import admin
from django.urls import path,register_converter
from app01 import views
from . import converters
register_converter(converters.FourDigitYearConverter, 'yyyy')   #注册一个yyyy转换器
urlpatterns = [
    path('mydefine/<yyyy:strs>/',views.years)   #使用yyyy转换器匹配
]
# 使用register_converter()命令在URLconf中注册自定义转换器类

# vim views.py
def years(request,strs):
    return HttpResponse(strs)    

访问http://127.0.0.1:8000/mydefine/2018/ 
得到 2018

re_path() 方法

如果path的转换器语法不足以定义url模式，可以使用正则表达式来匹配。

# urls.py
from django.contrib import admin
from app01 import views
from django.urls import re_path   #导入模块
urlpatterns = [
    path('admin/', admin.site.urls),
    re_path(r'^test/',views.test),
    re_path(r'^datetime/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/(?P<day>d+)',views.date)
]                          #指定参数 year month day，views里面的参数也必须是这个名字不然会出错

# views.py
def test(request):
    now = datetime.datetime.now()
    html = "<html><body>now: %s.</body></html>"%now
    return  HttpResponse(html)
def date(request,year,month,day):
    strs = year+month+day
    return HttpResponse(strs)
访问 http://127.0.0.1:8000/test/ 返回now: 2018-12-11 10:50:58.328433.
访问 http://127.0.0.1:8000/datetime/2018/12/11 返回20181211

使用include 解耦

1，一级url 。在项目的根urls.py中引入 path('app/',include('app.urls.py'))  
2，二级url。 在app目录中创建urls.py文件，格式与urls.py相同 

from django.contrib import admin
from django.urls import path
from django.conf.urls import include
urlpatterns = [
    path('admin/', admin.site.urls),
    path('app01/', include('app01.urls')),
]

from django.conf.urls import re_path
from django.urls import path
from . import views

urlpatterns = [
    re_path('^index/$', views.index),
]

from django.shortcuts import render
from django.http import HttpResponse
def index(request):
    return HttpResponse('ok')

这里访问 http://127.0.0.1:8000/app01/index/  返回 ok

Template 模板

---

存放html文件，使用django模板语言(django template language，DTL）

前面都是简单的用 django.http.HttpResponse 来把内容显示到网页上，这里将介绍使用渲染模板来显示内容。

步骤：

　　1, 在app的根目录下创建名为templates的目录
　　2, 在该目录下创建html文件
　　3, 在views.py 中返回render()

简单的栗子：

在app01下面创建一个templates文件夹,在templates中创建index.html文件

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>hello,app01</h1>
</body>
</html>

在app01/views.py中

from django.shortcuts import render
from django.http import HttpResponse
def index(request):
    return  render(request,'index.html')  #把index.html文件显示在页面上

urls.py 配置省略

访问 http://127.0.0.1:8000/app01/index/  返回 hello,app01

注意：创建多个app时，应该在app的templates目录下创建以app名为名称的目录，将html文件放入新创建的目录下

因为Django查找template是按照INSTALLED_APPS中添加顺序查找,不同app下Templates目录中的同名.html文件会造成冲突

render渲染

render()函数中支持dict类型的参数，该字典是后台传递到模板的参数，字典的键即为传入的参数
在模板中使用{{键名}}来直接使用

变量使用 {{ }}   条件判断和循环使用{% %}

命令行模式：  python3 manage.py shell 

示例1：使用变量

vim app01/views.py

from django.shortcuts import renderdef index(request):
    words = "this is app01 test"
    return  render(request,'app01/index.html',{ "strings": words})

vim app01/templates/app01/index.html

{{ strings }}

 访问http://127.0.0.1:8000/app01/index/  返回 this is app01 test

示例二：字典

vim views.py

def index(request):
    dic = {'k1':'v1','k2':'v2'}
    return  render(request,'app01/index.html',{"test_dict":dic})

vim index.html

{{ test_dict.k1 }}   #注意这里字典取值不是用dict[k1] 而是.  列表索引也是一样的 l.0

 访问http://127.0.0.1:8000/app01/index/  返回v1

还可以使用字典操作：

{% for key,value in test_dict.items %}
    {{ key }} : {{ value }}
{% endfor %}

示例二：类的实例也可以被渲染

 vim views.py

def index(request):
    class Myclass(object):
        def __init__(self,name,age):
            self.name = name
            self.age = age
    return render(request,"app01/index.html",{"myclass":Myclass("lily",23)})

vim index.html

name:{{ myclass.name }} age:{{ myclass.age }}

访问http://127.0.0.1:8000/app01/index/    返回 name:lily age:23

示例三：循环 for

views.py

from django.shortcuts import renderdef index(request):
    test_list = ['aaa','bbb','ccc']
    return  render(request,'app01/index.html',{"t_list":test_list})

index.html

{% for item in t_list %}
{{ item }},
{% endfor %}

访问 http://127.0.0.1:8000/app01/index/  返回 aaa, bbb, ccc,

模板中的逻辑操作符：

==, !=, >=, <=, >, < 

and, or, not, in, not in

view.py

def index(request):
    return  render(request,'app01/index.html',{"num":3})

index.html

{% if num > 10 %}
大于10
{% elif num < 10 %}
小于10
{% else %}
等于10
{% endif %}

访问http://127.0.0.1:8000/app01/index/   返回 小于10

include  引用其他文件的内容

urls.py

urlpatterns = [
    re_path('^p1/$', views.page1),
    re_path('^p2/$', views.page2),
]

views.py

def page1(request):
    return render(request,"app01/page1.html")
def page2(request):
    return render(request, "app01/page2.html")

templates/app01/page1.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>p1</title>
</head>
<body>
<h1>Welcome to page1</h1>
</body>
<footer>
    page1 end----
</footer>
</html>

templates/app02/page2.html

{% include 'app01/page1.html' %}   #引入page1.html的内容
<h1>this is page2</h1>

 

extends  继承和扩展

 templates/app01/page1.html

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>p1</title>
</head>
<body>
{% block page1_content %}   #其他子页面如果继承了此页面，那么通过这个block重写这一块内容
<h1>Welcome to page1</h1>
{% endblock %}          #结束位置
</body>
<footer>
    page1 end----
</footer>
</html>

templates/app01/page2.html

{% extends 'app01/page1.html' %}   #继承page1.html
{% block page1_content %}     #要重写的部分
<h1>this is page2</h1>
{% endblock %}

models 模型

---

通常一个model类对应数据库的一张数据表
Django中models以类的形式表现，它包含了一些基本字段以及数据的一些行为

orm框架    orm(obje relation mapping）对象关系映射
实现了对象和数据库之间的映射，隐藏数据访问的细节，不需要编写原生的sql语句

类 <--->数据表
属性 <--->字段
对象 <--->记录

 使用models的一个小栗子：

1，在app根目录models.py中创建一个类，继承models.Models,该类即是一张数据表，在类中创建字段

vim models.py

from django.db import models
class Article(models.Model):
    title = models.CharField(max_length=32,default='title')
    content = models.TextField(null=True)

2，生成数据表

    1.  python manage.py makemigrations [appname]   如果不指定appname则所有都执行

　　　执行之后会自动在app01/migrations下面生成了0001_initial.py

    2.  python manage.py migrate   

　　　执行之后，数据库会生成在项目根目录下db.sqlite3

    3. 可以查看sql语句：  > python manage.py sqlmigrate app01 0001

>  python manage.py sqlmigrate app01 0001
BEGIN;
--
-- Create model Article
--
CREATE TABLE "myblog_article" ("id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, "title" varchar(32) NOT NULL, "content" text NULL)
;
COMMIT;

 数据库生成在项目根目录下的db.sqlite3，可以使用软件打开，会看到article表已经生成

3， 插入几条数据 id:1  title:title  content:test app01

4，后台呈现数据

修改views.py

from django.shortcuts import render
from django.http import HttpResponse
from . import models
def index(request):
    article_obj = models.Article.objects.get(id=1)  #获取Article表中id=1的记录 
    return  render(request,'app01/index.html',{'article':article_obj})

5,  前端展示

<h1>{{ article.title }}</h1>
<h3>{{ article.content }}</h3>

访问http://127.0.0.1:8000/app01/index/  得到：title: title content: test app01 

Admin  后台管理

---

 Admin是django自带的一个功能强大的后台管理系统，被授权的用户可以直接在admin中管理数据库

1, 访问127.0.0.1:8000/admin可以看到django自带的后台界面。需要设置用户名密码登录

  2，创建用户名密码 

>python manage.py createsuperuser    #创建后台用户名密码

   使用用户名密码登录后台，此时只能看到django后台默认的界面。

3，配置admin.py 

from django.contrib import admin
# Register your models here.
from .models import Articles
admin.site.register(Article)

4，再次访问后台，可以看到数据库。通过后台可以直接对数据库数据进行增删改操作

5，添加两条数据可以看到：

 

为了更加直观的看到添加的数据，可以在models.pyl里面的类中加上一个方法：

def __str__(self):
    return self.title
再次查看，可以看到文章标题

6，如果要自定义显示的字段，可以修改admin.py

from django.contrib import admin
from .models import Article
class Article_Moreinfo(admin.ModelAdmin):   #自定义一个类
    list_display = ('title','content')   #list_display配置要显示的字段
admin.site.register(Article,Article_Moreinfo)