python之路--web--2--Django-1--基础

Python的WEB框架有Django、Tornado、Flask 等多种，Django相较与其他WEB框架其优势为：大而全，框架本身集成了ORM、模型绑定、模板引擎、缓存、Session等诸多功能。

一、基本配置

1.1、创建django程序

终端命令：django-admin startproject [mysite]
IDE创建Django程序时，本质上都是自动执行上述命令

其他常用命令：

　　python manage.py runserver 0.0.0.0
　　python manage.py startapp appname
　　python manage.py syncdb
　　python manage.py makemigrations
　　python manage.py migrate

　　python manage.py createsuperuser

1.2、程序目录

1.3、配置文件

1、数据库

DATABASES = {
    'default': {
    'ENGINE': 'django.db.backends.mysql',
    'NAME':'dbname',
    'USER': 'root',
    'PASSWORD': 'xxx',
    'HOST': '',
    'PORT': '',
    }
}

# 由于Django内部连接MySQL时使用的是MySQLdb模块，而python3中还无此模块，所以需要使用pymysql来代替
  
# 如下设置放置的与project同名的配置的 __init__.py文件中
  
import pymysql
pymysql.install_as_MySQLdb()　

2、模版

TEMPLATE_DIRS = (
        os.path.join(BASE_DIR,'templates'),
    )

3、静态文件

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

4、admin后台管理中文显示

'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.locale.LocaleMiddleware', # 设置admin为中文(这个位置是固定的)，不能放在'....SessionMiddleware'之前，也不能放在'...CommonMiddleware'之后
'django.middleware.common.CommonMiddleware',

二、路由系统

2.1、单一路由对应

1	`url(r'^index$', views.index),`

2.2、基于正则的路由

1 2	`url(r'^index/(d)', views.index),` `url(r'^manage/(?P<name>w)/(?P<id>d*)', views.manage),`

** 注意：使用带固定参数的路由时，需要相当于在views函数中固定死了形参名称，形参名称与正则路由中的名称必须一致，否则会提示函数参数出错，如下：

app0目录下的urls.py定义如下正则路由：

url(r'^test-(?P<user>w*)-(?P<pid>d*)$', views.regex_additional_parameter),

app0目录下的views.py定义的函数regex_additional_parameter的参数就必须是user, pid,不能是别的_user, _pid等

def regex_additional_parameter(request, user, pid):
    print(user, pid)
    return render(request, 'app0/regex_additional_parameter.html', {'user': user, 'pid': pid}, )

否则的话：

TypeError at /app0/test-root-123123

regex_additional_parameter() got an unexpected keyword argument 'user'

Request Method:	GET
Request URL:	http://127.0.0.1:8000/app0/test-root-123123
Django Version:	1.11.7
Exception Type:	TypeError
Exception Value:	regex_additional_parameter() got an unexpected keyword argument 'user'
Exception Location:	/Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/django/core/handlers/base.py in _get_response, line 185
Python Executable:	/Library/Frameworks/Python.framework/Versions/3.6/bin/python3.6

2.3、添加额外的参数

1	`url(r'^manage/(?P<name>w*)', views.manage,{'id':333}),`

2.4、为路由映射设置名称

1 2	`url(r'^home', views.home, name='h1'),` `url(r'^index/(d*)', views.index, name='h2'),`

设置名称之后，可以在不同的地方调用，如：

模板中使用生成URL {% url 'h2' 2012 %}
函数中使用生成URL reverse('h2', args=(2012,)) 路径:django.urls.reverse

Model中使用获取URL 自定义get_absolute_url() 方法，kwargs={'nid': self.id}中的nid必须与views.py函数中的参数名称一致。

class NewType(models.Model):
    caption = models.CharField(max_length=16)


    def get_absolute_url(self):
        """
        为每个对象生成一个URL
        应用：在对象列表中生成查看详细的URL，使用此方法即可！！！
        :return:
        """
        # return '/%s/%s' % (self._meta.db_table, self.id)
        # 或
        from django.urls import reverse
        return reverse('h1', kwargs={'nid': self.id})

获取请求匹配成功的URL信息：request.resolver_match

2.5、根据app对路由规则进行分类

1	`url(r'^web/',include('web.urls')),`

2.6、命名空间

在学习django的过程中，最为惊奇的就是url的配置。

django的url配置有效的降低了后台与页面的耦合度。

在配置url是，为了解决url硬编码的问题，常常会使用命名空间来表示一个url。

命名空间（英语：Namespace）是表示标识符的可见范围。一个标识符可在多个命名空间中定义，它在不同命名空间中的含义是互不相干的。这样，在一个新的命名空间中可定义任何标识符，它们不会与任何已有的标识符发生冲突，因为已有的定义都处于其它命名空间中。

例如在django工程中：

这是系统的urls.py

urlpatterns = patterns('',

url(r'^admin/', include(admin.site.urls)),

url(r'^polls/', include('polls.urls', namespace="polls")),

)

这是自己在项目中新建的工程（application）的urls.py

urlpatterns = patterns('',

url(r'^$', views.index, name='index'),

url(r'^(?Pd+)/$', views.detail, name="detail"),

url(r'^(?Pd+)/result/$', views.result, name="result"),

url(r'^(?Pd+)/vote', views.vote, name="vote"),

)

可以简单的理解为：使用“ /polls/”时，可以利用“polls” 代替，这跟C++中的命名空间是一样的道理。

有了命名空间，我们就可以去除下面的硬编码：

href="/polls/{{ poll.id }}/"

可以改之为：

href="{% url ’polls:detail’ poll.id %}"

a. project.urls.py

from django.conf.urls import url,include
 
urlpatterns = [
    url(r'^a/', include('app01.urls', namespace='author-polls')),
    url(r'^b/', include('app01.urls', namespace='publisher-polls')),
]

b. app01.urls.py

from django.conf.urls import url
from app01 import views
 
app_name = 'app01'
urlpatterns = [
    url(r'^(?P<pk>d+)/$', views.detail, name='detail')
]

c. app01.views.py

def detail(request, pk):
    print(request.resolver_match)
    return HttpResponse(pk)

以上定义带命名空间的url之后，使用name生成URL时候，应该如下：

v = reverse('app01:detail', kwargs={'pk':11})
{% url 'app01:detail' pk=12 pp=99 %}

django中的路由系统和其他语言的框架有所不同，在django中每一个请求的url都要有一条路由映射，这样才能将请求交给对应view中的函数去处理。其他大部分的Web框架则是对一类的url请求做一条路由映射，从而是路由系统变得简洁。

通过反射机制，为django开发一套动态的路由系统Demo： 点击下载

2.7、当存在多个app的时候,恰好还有同名模版怎么办

（先给方法,再讲原理）

.步骤

1.确定新增的这个app在settings.py的INSTALLED_APPS里面已经注册好了
2.确定setting.py里面的TEMPLATES中的APP_DIRS设置为True
3.在app下新建文件夹templates,在templates里面建立app同名文件夹,再放入html模版
4.引用模版的时候,采用”appname/index.html” 这种方式即可

.原理

我用的是Django1.8版本
Django模板载入有两种模式:

django.template.loaders.filesystem.Loader 它会遍历所有app中的templates然后找到符合名字的就返回
django.template.loaders.app_directories.Loader 它会从app对应的templates目录中查找要渲染的模板文件,即使找不到也不去其他app里面找

通识:通常在APP各自的templates目录中保存APP特定的模板，并不直接在APP对应templates目录中直接存放模板文件本身，而是在该目录中在创建一层以APP名称命名的目录，比如APP名称为sqlreview则存放该APP模板的目录为…/sqlreview/templates/sqlreview/，在指定要渲染的模板时可以通过模板文件的上一层目录来限定模板文件，以避免混淆，这实际上是提供了一个命名空间。比如return render(request, ‘sqlreview/base.html’,context),可以在/var/www/site/mycitsm/sqlreview/templates目录中找到该模板。这样便不用担心Django载入的模板究竟是不是对的、需要的那个模板。

Django1.8中进行如下设置

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.template.context_processors.media',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
        },
    },
]

APP_DIRS的值设置为TRUE,表示启用django.template.loaders.app_directories.Loader,DIRS为空即可.
如果不设置APP_DIRS或者设置为False,则启用django.template.loaders.filesystem.Loader模式,这个模式需要把DIRS设置好,要不然找不到任何模版

三、模板

3.1、模版的执行

模版的创建过程，对于模版，其实就是读取模版（其中嵌套着模版标签），然后将 Model 中获取的数据插入到模版中，最后将信息返回给用户。

def current_datetime(request):
    now = datetime.datetime.now()
    html = "<html><body>It is now %s.</body></html>" % now
    return HttpResponse(html)

from django import template
t = template.Template('My name is {{ name }}.')
c = template.Context({'name': 'Adrian'})
print t.render(c)

import datetime
from django import template
import DjangoDemo.settings
 
now = datetime.datetime.now()
fp = open(settings.BASE_DIR+'/templates/Home/Index.html')
t = template.Template(fp.read())
fp.close()
html = t.render(template.Context({'current_date': now}))
return HttpResponse(html)

from django.template.loader import get_template
from django.template import Context
from django.http import HttpResponse
import datetime
 
def current_datetime(request):
    now = datetime.datetime.now()
    t = get_template('current_datetime.html')
    html = t.render(Context({'current_date': now}))
    return HttpResponse(html)

return render_to_response('Account/Login.html',data,context_instance=RequestContext(request))

3.2、模版语言

　模板中也有自己的语言，该语言可以实现数据展示

{{ item }}
{% for item in item_list %}

　　 {% endfor %}
　　for loop.counter
　　for loop.first
　　for loop.last

{% if ordered_warranty %}

　　　　　{% else %}

　　 {% endif %}

母板：{% block title %}

　　　　　　{% endblock %}

子板：{% extends "base.html" %}

　　　　　　{% block title %}

　　　　　　　　...

　　　　　　{% endblock %}

帮助方法：
{{ item.event_start|date:"Y-m-d H:i:s"}}
{{ bio|truncatewords:"30" }}
{{ my_list|first|upper }}
{{ name|lower }}

3.3、自定义simple_tag

a、在app中创建templatetags模块

b、创建任意 .py 文件，如：xx.py

#!/usr/bin/env python
#coding:utf-8
from django import template
from django.utils.safestring import mark_safe
   
register = template.Library()
   
@register.simple_tag
def my_simple_time(v1,v2,v3):
    return  v1 + v2 + v3
   
@register.simple_tag
def my_input(id,arg):
    result = "<input type='text' id='%s' class='%s' />" %(id,arg,)
    return mark_safe(result)

c、在使用自定义simple_tag的html文件中导入之前创建的 xx.py 文件名

1	`{%` `load xx` `%}`

d、使用simple_tag

1 2	`{%` `my_simple_time` `1` `2` `3%}` `{%` `my_input` `'id_username'` `'hide'%}`

e、在settings中配置当前app，不然django无法找到自定义的simple_tag　　

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'app01',
)

更多见文档：https://docs.djangoproject.com/en/1.10/ref/templates/language/

四、中间件

django 中的中间件（middleware），在django中，中间件其实就是一个类，在请求到来和结束后，django会根据自己的规则在合适的时机执行中间件中相应的方法。

在django项目的settings模块中，有一个 MIDDLEWARE_CLASSES 变量，其中每一个元素就是一个中间件，如下图。

****中间件路径：与mange.py在同一目录下的文件夹 wupeiqi/middleware下的auth.py文件中的Authentication类

****也可以放在app下面，如：在app0目录下面的文件夹app0mid/middleware下的custom.py文件中的RequestExecute类，对应settings.py中，中间件注册如下：

'app0.app0mid.middleware.custom.RequestExecute',

4.1、中间件中可以定义四个方法，分别是：

process_request(self,request)
process_view(self, request, callback, callback_args, callback_kwargs)
process_template_response(self,request,response)
process_exception(self, request, exception)
process_response(self, request, response)

以上方法的返回值可以是None和HttpResonse对象，如果是None，则继续按照django定义的规则向下执行，如果是HttpResonse对象，则直接将该对象返回给用户。

4.2、自定义中间件

1、创建中间件类

class RequestExeute(object):
      
    def process_request(self,request):
        pass
    def process_view(self, request, callback, callback_args, callback_kwargs):
        i =1
        pass
    def process_exception(self, request, exception):
        pass
      
    def process_response(self, request, response):
        return response

2、注册中间件

MIDDLEWARE_CLASSES = (
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.contrib.auth.middleware.AuthenticationMiddleware',
    'django.contrib.auth.middleware.SessionAuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'wupeiqi.middleware.auth.RequestExeute',
)

五、admin

django amdin是django提供的一个后台管理页面，该管理页面提供完善的html和css，使得你在通过Model创建完数据库表之后，就可以对数据进行增删改查，而使用django admin 则需要以下步骤：

创建后台管理员
配置url
注册和配置django admin后台管理页面

1、创建后台管理员

1	`python manage.py createsuperuser`

2、配置后台管理url

1	`url(r'^admin/', include(admin.site.urls))`

3、注册和配置django admin 后台管理页面

*设置后台为中文：

'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.locale.LocaleMiddleware',    # 一定放在django.contrib.sessions.middleware.SessionMiddleware之后，设置admin管理界面为中文

*设置在页面中显示的字段名称：

 1 class NewType(models.Model):
 2     caption = models.CharField(max_length=16, verbose_name='用户名')
 3     pwd = models.CharField(max_length=64, verbose_name='密码')
 4 
 5     def __str__(self):                                    # 显示每条记录的名称而不是NewType object
 6         return self.caption
 7 
 8     # def __unicode__(self):                         # 在Python3.6.1中不生效   
 9     #     return self.pwd
10     class Meta:
11         verbose_name = '用户信息表'                # 设置数据表的显示名称
12         verbose_name_plural = '用户信息表'

 1 from django.contrib import admin
 2 from .models import NewType
 3 
 4 # Register your models here.
 5 
 6 
 7 class NewTypeAdmin(admin.ModelAdmin):
 8     list_display = ('id', 'caption', 'pwd')        # 查询结果中显示的字段
 9     search_fields = ('caption', )                   # 设置查询字段
10     list_filter = ('caption', 'id', )                   # 设置最右边的过滤器
11 
12 
13 admin.site.register(NewType, NewTypeAdmin)

a、在admin中执行如下配置

from django.contrib import admin
  
from app01 import  models
  
admin.site.register(models.UserType)
admin.site.register(models.UserInfo)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)

b、设置数据表名称

class UserType(models.Model):
    name = models.CharField(max_length=50)
  
    class Meta:
        verbose_name = '用户类型'
        verbose_name_plural = '用户类型'

c、打开表之后，设定默认显示，需要在model中作如下配置

class UserType(models.Model):
    name = models.CharField(max_length=50)
  
    def __unicode__(self):
        return self.name

from django.contrib import admin
  
from app01 import  models
  
class UserInfoAdmin(admin.ModelAdmin):
    list_display = ('username', 'password', 'email')
  
  
admin.site.register(models.UserType)
admin.site.register(models.UserInfo,UserInfoAdmin)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)

d、为数据表添加搜索功能

from django.contrib import admin
  
from app01 import  models
  
class UserInfoAdmin(admin.ModelAdmin):
    list_display = ('username', 'password', 'email')
    search_fields = ('username', 'email')
  
admin.site.register(models.UserType)
admin.site.register(models.UserInfo,UserInfoAdmin)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)

e、添加快速过滤

from django.contrib import admin
  
from app01 import  models
  
class UserInfoAdmin(admin.ModelAdmin):
    list_display = ('username', 'password', 'email')
    search_fields = ('username', 'email')
    list_filter = ('username', 'email')
      
  
  
admin.site.register(models.UserType)
admin.site.register(models.UserInfo,UserInfoAdmin)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)

更多：http://docs.30c.org/djangobook2/chapter06/