Django1.7学习（二）

7.玩转API

接下来，我们进入 Python 的交互式 shell 中玩转 Django 提供的 API 。使用以下命令调用Python shell：

python manage.py shell

我们当前使用的环境不同于简单的输入 “python” 进入的 shell 环境， manage.py 文件设置了 DJANGO_SETTINGS_MODULE环境变量，该变量给定了 Django 需要导入的 mysite/settings.py 文件所在路径。

注：如果确实不想使用 manage.py 也可以，只需要设置环境变量DJANGO_SETTINGS_MODULE的值为mysite.settings，启用Python shell 并输入以下命令即可：

import django django.setup()

此处需注意应在与 manage.py 文件所在同一目录下运行 python （ 或确保目录在 Python path 下）

进入shell中后，就可以开始探索 database API了

>>> from polls.models import Question, Choice   # 导入刚创建的模块类



>>> Question.objects.all()

[]



# 创建一个新的Question

# 默认配置文件中时区支持是启用的，因此 Django 希望为 pub_date 获取一个带 tzinfo 的 datetime

# 此处使用 timezone.now() 来替代 datetime.datetime.now() 以获取正确的值

>>> from django.utils import timezone

>>> q = Question(question_text="What's new?",pub_date=timezone.now())



# 将对象保存到数据库中，此处应调用save() 方法

>>> q.save()



# 现在对象有了一个 ID. 此处注意有可能会显示 "1L" 而不是 "1", 这取决于你正使用的数据库

# 这无关紧要，仅仅表明你的数据库后端更偏向于返回 integers 作为 Python 的 long integer 对象

>>> q.id

1



# 通过 Python 属性访问字段值

>>> q.question_text

"What's new?"

>>> q.pub_date

datetime.datetime(2014, 9, 13, 6, 31, 27, 704000, tzinfo=<UTC>)

# 通过改变属性来改变值, 然后调用 save().

>>> q.question_text = "What's up?"

>>> q.save()



# objects.all() 用以打印出所有在数据库中的 question.

>>> Question.objects.all()

[<Question: Question object>]

注意：<Question: Question object> 这样的对象显示方式是毫无意义的。

为了转换成我们看得懂的显示方式，此处可以通过修改 Question 这个model (polls/models.py 文件中)并为 Question 和 Choice 都添加上一个__str__()方法：

from django.db import models



class Question(models.Model):

    # ...

    def __str__(self):              #Python 2.x 用 __unicode__ 

        return self.question_text



class Choice(models.Model):

    # ...

    def __str__(self):              #Python 2.x 用 __unicode__

        return self.choice_text

为 models 添加__str__()方法是很重要的，不只能让自己在处理交互式提示时更加清晰，同时在 Django 自动生成的后台管理界面中也会用到

__str__ 还是 __unicode__?

如果使用的是Python 3.x 版本，很简单，直接使用 __str__()

如果使用的是Python 2.x 版本，则需要定义 __unicode__()方法来返回unicode值。Django 的 models 有一个默认的__str__()方法会调用__unicode__()方法将结果转换成UTF-8编码的字符串，这就意味着 unicode(p)将返回一个Unicode编码的字符串，而str(p)将返回一个UTF-8编码字符串。Python则相反：object 拥有一个__unicode__ 方法调用__str__将结果转变为 ASCII 字符串，这极容易造成混淆。

如果上面的这些让你感觉到混乱，那么推荐使用Python 3.x版本。

 接下来尝试着自定义一个方法

import datetime



from django.db import models

from django.utils import timezone



class Question(models.Model):

    # ...

    def was_published_recently(self):

        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

增加了 import datetime 和 from django.utils import timezone, 分别是为了引用 Python 的标准库的 datetime 模块和 Django 的 django.utils.timezone 中的 time-zone-related 实用工具 。

保存以上更改并且再次运行 python manage.py shell 以开启一个新的 Python shell

>>> from polls.models import Question, Choice

# 确认下添加的 __str__() 正常运行.

>>> Question.objects.all() [<Question: What's up?>]



# Django 提供了一个丰富的完全由关键字驱动的数据库查询 API 

>>> Question.objects.filter(id=1) [<Question: What's up?>]

>>> Question.objects.filter(question_text__startswith='What') [<Question: What's up?>]



# 获取在今年内发布的 Question

>>> from django.utils import timezone >>> current_year = timezone.now().year >>> Question.objects.get(pub_date__year=current_year) <Question: What's up?>



# 请求一个不存在的 ID ,然后将引发异常.

>>> Question.objects.get(id=2) Traceback (most recent call last): ... DoesNotExist: Question matching query does not exist. # 根据主键查询是一种比较常见的方式, 因此 Django 提供了一个精确查找主键的快捷方式 # 以下内容等同于 Question.objects.get(id=1).

>>> Question.objects.get(pk=1) <Question: What's up?>



# 确认下我们自定义的方法正常运行.

>>> q = Question.objects.get(pk=1) >>> q.was_published_recently() True # 给 Question 设置一些 Choice. 创建一个新的 Choice 对象，执行 INSERT 语句后, 
# 添加 choice 到可用的 choices 集合然后返回一个新的 Choice 对象.
# Django 创建了一个可以通过 API 访问的保存外键关联的集合（如 question 的 choice）

>>> q = Question.objects.get(pk=1) # 从关联对象集合中显示所有 choice -- 当前为空.

>>> q.choice_set.all() [] # 创建三个 choice.

>>> q.choice_set.create(choice_text='Not much', votes=0) <Choice: Not much>

>>> q.choice_set.create(choice_text='The sky', votes=0) <Choice: The sky>

>>> c = q.choice_set.create(choice_text='Just hacking again', votes=0) # Choice 对象拥有访问与它们关联的 Question 对象的 API

>>> c.question <Question: What's up?>



# 反之亦然: Question 对象也可以访问 Choice 对象.

>>> q.choice_set.all() [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>] >>> q.choice_set.count() 3



# 只要需要 API 会自动连续关联，可以使用双下划线来隔离关联
# 需要多少层的关联就可以有多少层的关联，没有任何限制 # 找出所有 pub_date 在今年的与 question 有关联的 Choice # （重复使用我们之前创建的的变量 'current_year')

>>> Choice.objects.filter(question__pub_date__year=current_year) [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>] # 用 delete() 来删除 choices 的其中一个.

>>> c = q.choice_set.filter(choice_text__startswith='Just hacking') >>> c.delete()

 参考：https://docs.djangoproject.com/en/1.7/intro/tutorial01/

未完待续。。。