zoukankan      html  css  js  c++  java
  • 第二节:模型(Models)和管理后台(Admin site)

    本节内容我们将配置数据库,创建第一个model并且快速了解Django自动生成的管理后台(admin site)

    目录

    数据库配置

    打开上一节中新建的项目的配置文件,它是一个普通的python模块。

    默认情况下,数据库配置使用SQLite,如果你数据库的新手,或者你仅仅是对Django感兴趣,这是最好的选择。SQLite包含在Python,所以不需要安装任何东西。当你开始你的第一个真正的项目的时候,你可能想

    要使用更强大的数据库如PostgreSQL,去避免切换数据库的痛苦。

    如果你希望使用另外一个数据库,需要安装对应的数据库驱动并且修改键DATABASES'default'项为匹配的数据库连接设置: 

    • ENGINE - 'django.db.backends.sqlite3','django.db.backends.postgresql','django.db.backends.mysql',或者'django.db.backends.oracle', 还有其他的后端引擎
    • NAME - 数据库名称,如果你使用SQLite,设置为你的数据库文件所在的路径;这种情况下NAME是一个完整的绝对路径,包含文件名,默认值为:os.path.join(BASE_DIR, 'db.sqlite3'),这个文件将存放在你项目所在的目录。

    如果你不使用SQLite作为你的数据库,那么需要另外的设置如:USER,PASSWORD,和HOST必须要添加。关于databases的详细配置我们将单独讲解。

    对于SQLite以外的数据库

    如果你使用SQLite以外的数据库,请确保你已经创建了一个数据库,也要确保在mysite/settings.py中提供的用户具有“创建数据库”的权限,允许自动创建一个测试数据库在后面的教程中将会用。如果你使用SQLite不需要做任何事情,数据库文件将会在你需要的时候自动创建。

    另外,注意在mysite/settings.py文件的顶部INSTALLED_APPS设置,里面包含当前项目中所有被激活的Django应用的名称。应用可以在多个项目中使用,你可以打包并分发给其他的项目使用。

    默认情况下,INSTALLED_APPS包含如下应用:

    • django.contrib.admin - 一个管理后台。下面很快将会用到它
    • django.contrib.auth - 一个认证系统。
    • django.contrib.contenttypes - 一个文档内容类型的框架
    • django.contrib.sessions - 一个session框架
    • django.contrib.messages - 一个消息框架

    这些应用至少使用数据库中的一个表,虽然如此,在我们使用它们之前我们需要在一个数据库里面创建表,可以运行下面的命令做到它:

    $ python manage.py migrate

    migrate命令将查找INSTALLED_APPS的设置,并且创建符合你在mysite/settings.py文件中配置的数据库的任何有必要的数据库表并且随应用迁移,如果说INSTALLED_APPS里面的应用不需要的话那么在运行migrate之前把它注释或删除掉即可。 

    创建模型 

    现在我们定义模型,在我们创建的投票应用中,我们创建两个模型:QuestionChoice。Question模型有一个问题内容和一个发布时间。Choice有两个字段:选择文本和投票数。ChoiceQuestion是多对一的关系。 

    这些概念我们用Python类来代表,编辑 polls/models.py 文件: 

    from django.db import models
    
    class Question(models.Model):
        question_text = models.CharField(max_length=200)
        pub_date = models.DateTimeField('date published')
    
    class Choice(models.Model):
        question = models.ForeignKey(Question, on_delete=models.CASCADE)
        choice_text = models.CharField(max_length=200)
        votes = models.IntegerField(default=0)

    代码很简单,每一个模型是一个继承django.db.models.Model的子类,每一个模型具有很多类变量,每一个变量代表一个数据库字段。每一个字段都是有一个Field类的实例来表示,例如,CharField代表字符字段和DateTimeField代表日期字段。这就告诉Django每一个字段是什么数据类型。Field类的实例的名称(如,choice_text),就是数据库表的字段名。

    有些Field类是需要必须参数的,比如CharField,必须要提供max_length的参数。它不仅仅会在数据库架构中用,在验证中也会用到。一个字段可以有多个可选参数,在本例中,我们设置votes的默认值为0;

    最后,注意在本例中使用ForeignKey定义了一个关系,它告诉Django每个Choice对应一个Question。Django支持所有的数据库关系:多对一,多对多,一对一。

    激活模型

    简单的模型定义告诉Django很多信息,有了他,Django可以:

    • 创建一个针对这个应用的数据库架构。
    • 创建一个Python数据库访问API来访问QuestionChoice对象。

    但是首先需要告诉我们的Django项目polls应用已经被安装了。再次编辑mysite/settings.py文件,修改INSTALLED_APPS'polls.apps.PollsConfig'加入列表,如下所示:

    INSTALLED_APPS = [
        'polls.apps.PollsConfig',
        'django.contrib.admin',
        'django.contrib.auth',
        'django.contrib.contenttypes',
        'django.contrib.sessions',
        'django.contrib.messages',
        'django.contrib.staticfiles',
    ]

       注意:INTALLED_APPS列表直接写应用的名称也是可以的(如,'polls'),官方建议是写AppConfig的子类,'polls.apps.PollsConfig'PollsConfig,这个类在创建应用时已经自动创建好了,在polls/apps.py文件里面定义,这个类里面可以定义关于应用的一些元数据如应用名称,描述等信息,Django提供了一些公用API可以读取里面的配置信息,暂时没有发现其他什么特别的用处。

    现在Django已经知道包含了polls应用了,运行另外一个命令:

    $ python manage.py makemigrations polls

    你可以看到如下的内容:

    Migrations for 'polls':
      polls/migrations/0001_initial.py:
        - Create model Choice
        - Create model Question
        - Add field question to choice

     

    通过运行makemigrations,就是告诉Django项目模型已经有了那些修改,并且存储这些修改信息在polls/migrations/0001_initial.py文件中。

    如果你想查看迁移将在数据库中执行哪些操作,可以运行命令:

    $ python manage.py sqlmigrate polls 0001

    你将可以看到迁移所用到的Sql语句。

    注意以下几点:

    • 输出的内容会根据你使用的数据库的不同而不同。
    • 表明是通过合并应用名称和模型名字的小写自动生成的(如,polls_question)(可以重写)。
    • 主键(id)是自动添加的(可以重写)
    • 通常情况下,Django会在模型名字基础上追加“_id”作为外键字段的名字。(可以重写)
    • sqlmigrate命令不在数据库上更改,仅仅是打印迁移的sql语句。

    如果你感兴趣的话可以运行python manage.py check来检查你项目中的任何问题。

    现在运行migrate命令在数据库里创建这些表: 

    $ python manage.py migrate
    Operations to perform:
      Apply all migrations: admin, auth, contenttypes, polls, sessions
    Running migrations:
      Rendering model states... DONE
      Applying polls.0001_initial... OK

    迁移的命令是非常强大的,让你可以随时修改你的模型,而不需要删除你的数据库或表,可以很方便升级你的数据库,不会丢失数据,后面会详细介绍他们,现在你只要记住需要三步来应用模型的变化:

    • 修改模型(在models.py)。
    • 运行python manage.py makemigrations创建这些修改迁移。
    • 运行python manage.py migrate应用这些修改到数据库。 

    使用API

    现在,让我们进入Python shell的交互式环境并且使用Django提供的免费API。使用如下命令进入python shell:

    $ python manage.py shell

     这个命令是进入我们项目的shell交互环境,现在我们可以使用API来操作表:

    # 创建一个问题,Django默认有日期模块,所以这儿使用timezone
    >>> from django.utils import timezone
    >>> q = Question(question_text=”What’s New?”,pub_date=timezone.now())
    # 保存对象到数据库,你必须明确调用save()方法
    >>> q.save()
    # 现在你可以访问model字段的值了
    >>> q.id
    1
    >>> q.question_text
    What’s new?”
    # 修改你要修改的属性,然后调用save()方法
    >>> q.question_text=”What’s up?”
    >>> q.save()
    # 查询所有问题信息
    >>> Question.objects.all()
    <QuerySet [<Question: Question object>]>
    # 查询投票选择
    >>> q.choice_set.all()

    上面的查询信息返回<QuerySet [<Question: Question object>]>我们不知道这个对象都有什么东西,那么怎么解决这个问题呢,接下来分别在QuestionChoice增加__str__方法,编辑文件polls/models.py

    from django.db import models
    from django.utils.encoding import python_2_unicode_compatible
    
    @python_2_unicode_compatible  # 如果需要支持python 2.x的话,加上这个修饰符
    class Question(models.Model):
        # ...
        def __str__(self):     # 在python 2.x中,函数名为__unicode__
            return self.question_text
    
    @python_2_unicode_compatible  # 如果需要支持python 2.x的话,加上这个修饰符
    class Choice(models.Model):
        # ...
        def __str__(self):     # 在python 2.x中,函数名为__unicode__
            return self.choice_text

    再次进入python shell环境,查看所有信息:

    >>> Question.objects.all()
    <Question: What’s up>

    介绍Django管理后台

    这个后台主要是方便客户或员工来管理网站内容的

    创建管理员

    首先我们需要创建一个可以登录到管理站点的用户,运行下面的命令:

    $ python manage.py createsuperuser

    按照提示输入用户名、邮箱地址、密码;现在管理员用户已经创建好了,输入命令python manage.py runserver启动开发服务器,然后在浏览器输入地址 http://127.0.0.1:8000/amdin,就可以用我们刚刚创建的用户登录系统。

    将应用注册到管理系统

    登录后系统我们发现,在管理界面首页并没有我创建的投票应用,那么现在我们来看一下我们的应用如何注册到管理系统,编辑文件polls/admin.py

    from django.contrib import admin
    
    from .models import Question
    
    admin.site.register(Question)

    现在Question已经注册了,打开后台管理的首页就可以看到我们的应用:

     

    现在你可以对Question进行管理了。

    注意一下几点:

    • 表单是根据Question模型,自动生成的。
    • 不同的模型字段类型由相应的HTML输入组件表示。

    注意:在后台管理系统设置好后,如果系统的图片都显示不出来,需要在mysite/settings.py 加入如下设置:

    import mimetypes
    
    mimetypes.add_type("image/svg+xml", ".svg", True)
    mimetypes.add_type("image/svg+xml", ".svgz", True)

    可能是因为系统中没有SVG媒体类型的设置。

     

     

  • 相关阅读:
    14.3.2.1 Transaction Isolation Levels 事务隔离级别
    ReentrantLock可重入锁
    Lock与synchronized 的区别
    synchronized 与 Lock
    This usually indicates a missing no-arg constructor or that the editor's class name was mistyped in
    Oracle dump 分析secondary key
    java.lang.ClassNotFoundException: org.springframework.web.util.IntrospectorCleanupListener
    Oracle 验证IOT表数据存储在主键里
    Cause: java.lang.IllegalArgumentException: Mapped Statements collection does not contain value for U
    Oracle heap 表的主键 dump 分析
  • 原文地址:https://www.cnblogs.com/caoshiqing/p/5836885.html
Copyright © 2011-2022 走看看