Django实践-使用管理站点管理自己的应用

因为Django是在快节奏的新闻编辑室环境中开发的,它旨在使常见的Web开发任务变得快速而容易,我们可以在编写很少代码的情况下完成强大的功能。本文就在这个思想的指导下产生。让我们见证一下寥寥几行代码即可拥有一个管理站点的魔幻魅力。

管理站点基本架构

MVC思想,包括模型层、视图层、模板层

模型层

Django提供了一个抽象层(“模型”),用于构造和操纵Web应用程序的数据。模型是数据的唯一的、权威的信息源。它包含你所储存数据的必要字段和行为。通常,每个模型对应数据库中唯一的一张表。

每个模型都是django.db.models.Model 的一个Python 子类。
模型的每个属性都表示为数据库中的一个字段。
Django 提供一套自动生成的用于数据库访问的API。
一旦你建立好数据模型,Django 会自动为你生成一套数据库抽象的API,可以让你创建、检索、更新和删除对象。

最基本的对模型的应用仅仅只需要定义所需字段即可。
例如:

class Vm(models.Model):
  name = models.CharField('云主机名称', null=False, max_length=20)
  image = models.CharField('云主机镜像', max_length=20) 

视图层

Django 具有“视图”的概念,用于封装负责处理用户请求及返回响应的逻辑。视图是一个可调用对象,可以接收一个请求然后返回一个响应。这个可调用对象不仅仅限于函数,Django 同时提供一些可以用作视图的类。它们允许你结构化你的视图并且利用继承和混合重用代码。Django 提供基本的视图类,它们适用于绝大多数的应用。所有的视图类继承自View 类,它负责将视图连接到URL、HTTP 方法调度和其它简单的功能。
视图反映基本的Web开发中的一个常见情况:根据URL中的参数从数据库中获取数据、载入模板文件然后返回渲染后的模板。 由于这种情况非常普遍,Django提供了一种叫做“generic views”的系统可以方便地进行处理。

Generic views会将常见的模式抽象化,可以使你在编写app时甚至不需要编写Python代码。

模板层

模板层提供了设计友好的语法来展示信息给用户。
作为Web 框架,Django 需要一种很便利的方法以动态地生成HTML。最常见的做法是使用模板。模板包含所需HTML 输出的静态部分,以及一些特殊的语法,描述如何将动态内容插入。

Django 项目可以配置一个或多个模板引擎(甚至是零,如果你不需要使用模板)。Django 的模板系统自带内建的后台 —— 称为Django 模板语言(DTL),以及另外一种流行的Jinja2。其他的模板语言的后端,可查找第三方库。

Django 为加载和渲染模板定义了一套标准的API,与具体的后台无关。加载包括根据给定的标识找到模板然后预处理,通常会将它编译好放在内存中。渲染表示使用Context 数据对模板插值并返回生成的字符串。

Django 模板语言 是Django 原生的模板系统。直到Django 1.8,这是唯一可用的内置选项。尽管,它闭门造车,并且偏重某些方面,但是它仍然是一个优秀的模版库。如果没有特别紧急的理由选择另外一种后台,你应该使用DTL,特别是你编写可插拔的应用并打算发布其模板的时候。Django 中包含模板的标准应用,例如django.contrib.admin,都使用DTL。

又由于历史遗留原因,通用支持的模板引擎和Django实现的模板语言都在django.template 命名空间中。
模板引擎通过TEMPLATES 设置来配置。它是一个设置选项列表,与引擎一一对应。默认的值为空。在settings.py 定义了一些有用的值:

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [],
        'APP_DIRS': True,
        'OPTIONS': {
            # ... some options here ...
        },
    },
]

BACKEND 是一个指向实现了Django模板后端API的模板引擎类的带点的Python路径。内置的后端有 django.template.backends.django.DjangoTemplates 和 django.template.backends.jinja2.Jinja2.

由于绝大多数引擎都是从文件加载模板的,所以每种模板引擎都包含两项通用设置:

  1. DIRS 定义了一个目录列表,模板引擎按列表顺序搜索这些目录以查找模板源文件。
  2. APP_DIRS 告诉模板引擎是否应该进入每个已安装的应用中查找模板。每种模板引擎后端都定义了一个惯用的名称作为应用内部存放模板的子目录名称。

如果你的app只是简单的操作,没有复杂的业务,你不需要编写Python代码。

Admin 界面

Django 最强大的部分之一是自动生成的Admin 界面。它读取模型中的元数据来提供一个强大的、生产环境就绪的界面,使内容提供者能立即用它向站点中添加内容。

  1. 添加 'django.contrib.admin'到INSTALLED_APPS 设置中.
  2. admin有四个依赖 - django.contrib.auth, django.contrib.contenttypes, django.contrib.messages 和django.contrib.sessions. 如果这些应用没有在 INSTALLED_APPS 列表中, 那你要把它们添加到该列表中.
  3. 把django.contrib.messages.context_processors.messages 添加到TEMPLATES 中DjangoTemplates后台的'context_processors'选项中,同样把django.contrib.auth.middleware.AuthenticationMiddleware 和 django.contrib.messages.middleware.MessageMiddleware 添加到 MIDDLEWARE_CLASSES. (这些默认都是激活的,所以如果你手工操作过的话就需要按照以上方法进行设置..)
  4. 确定应用中的哪些模型应该在Admin 界面中可以编辑。
  5. 给每个模型创建一个ModelAdmin 类,封装模型自定义的Admin 功能和选项。
  6. 实例化AdminSite 并且告诉它你的每一个模块和ModelAdmin 类。
  7. 将AdminSite 实例绑定到URLconf。

示例

创建app

在我们前一篇文章中建立的项目中,创建一个cloud应用,在命令行中作如下操作:

E:
cd E:\PROJECTS\TEST\dj_admin      
django-admin.py startapp cloud

当前目录为 结构为:

dj_admin
    |-- cloud
    |   |--migrations
    |   |-- __init__.py
    |   |-- admin.py
    |   |-- apps.py
    |   |-- models.py
    |   |-- tests.py
    |   |-- views.py
    |-- dj_admin       
    |-- manage.py
编辑模型文件

我们修改 cloud/models.py 文件,代码如下:

# encoding=utf-8
from __future__ import unicode_literals
from django.db import models

class Vm(models.Model):
  name = models.CharField('云主机名称', null=False, max_length=20)
  image = models.CharField('云主机镜像', max_length=20) 

以上的类名代表了数据库表名,且继承了models.Model,类里面的字段代表数据表中的字段(name),数据类型则由CharField(相当于varchar)、null表示数据库中该字段是否允许为NULL,max_length 参数限定长度。

注册app

接下来在settings.py中找到INSTALLED_APPS这一项,如下:

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'cloud',               # 添加此项
)
注册模型到管理站点

为了让 admin 界面管理某个数据模型,我们需要先注册该数据模型到 admin。修改 cloud/admin.py:

# encoding=utf-8
from django.contrib import admin
from cloud.models import Vm

# Register your models here.


admin.site.register(Vm)
我们所做的事情

好了,我们仅仅只需要做上面一些编写和设置,即可以实现对Vm这一实体的所有操作,即我们常用的增、删、改、查。我们做了如下动作:

创建app
编辑模型文件
注册app到配置项中
注册模型到管理站点
启动服务查看效果

我们在命令行中通过命令行启动服务

python manage.py makemigrations # 让 Django 知道我们在模型上有一些变更
python manage.py migrate   # 创建表结构
python manage.py runserver 0.0.0.0:8000   # 0.0.0.0 让其它电脑可连接到此服务器,8000 为端口号。如果不说明,那么端口号默认为 8000。
启动服务.png

在浏览器中访问我们的站点http://localhost:8000/admin/,并登录。可以看到管理列表页,多了cloud管理列表:

自定义模型管理.png

添加Vm页面

添加Vm.png

Vm列表

vmList.png

修改Vm和编辑Vm

详情和修改.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,491评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,856评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,745评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,196评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,073评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,112评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,531评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,215评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,485评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,578评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,356评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,215评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,583评论 3 299
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,898评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,174评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,497评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,697评论 2 335

推荐阅读更多精彩内容