第五章：模型 - 添加模块的字符串表现 - 《The Django Book 2.0 中文版》

添加模块的字符串表现

添加模块的字符串表现

当我们打印整个publisher列表时，我们没有得到想要的有用信息，无法把````对象区分开来：

System Message: WARNING/2 (<string>, line 872); backlink

Inline literal start-string without end-string.

System Message: WARNING/2 (<string>, line 872); backlink

Inline literal start-string without end-string.

[<Publisher: Publisher object>, <Publisher: Publisher object>]

我们可以简单解决这个问题，只需要为Publisher 对象添加一个方法 unicode() 。 unicode() 方法告诉Python如何将对象以unicode的方式显示出来。为以上三个模型添加unicode()方法后，就可以看到效果了：

from django.db import models
class Publisher(models.Model):
    name = models.CharField(max_length=30)
    address = models.CharField(max_length=50)
    city = models.CharField(max_length=60)
    state_province = models.CharField(max_length=30)
    country = models.CharField(max_length=50)
    website = models.URLField()
    **def __unicode__(self):**
        **return self.name**
class Author(models.Model):
    first_name = models.CharField(max_length=30)
    last_name = models.CharField(max_length=40)
    email = models.EmailField()
    **def __unicode__(self):**
        **return u'%s %s' % (self.first_name, self.last_name)**
class Book(models.Model):
    title = models.CharField(max_length=100)
    authors = models.ManyToManyField(Author)
    publisher = models.ForeignKey(Publisher)
    publication_date = models.DateField()
    **def __unicode__(self):**
        **return self.title**

就象你看到的一样， unicode() 方法可以进行任何处理来返回对一个对象的字符串表示。 Publisher和Book对象的unicode()方法简单地返回各自的名称和标题，Author对象的unicode()方法则稍微复杂一些，它将first_name和last_name字段值以空格连接后再返回。

对unicode()的唯一要求就是它要返回一个unicode对象如果unicode() 方法未返回一个Unicode对象，而返回比如说一个整型数字，那么Python将抛出一个TypeError 错误，并提示：”coercing to Unicode: need string or buffer, int found” 。

Unicode对象

什么是Unicode对象呢？

你可以认为unicode对象就是一个Python字符串，它可以处理上百万不同类别的字符——从古老版本的Latin字符到非Latin字符，再到曲折的引用和艰涩的符号。

普通的python字符串是经过编码的，意思就是它们使用了某种编码方式（如ASCII，ISO-8859-1或者UTF-8）来编码。如果你把奇特的字符（其它任何超出标准128个如0-9和A-Z之类的ASCII字符）保存在一个普通的Python字符串里，你一定要跟踪你的字符串是用什么编码的，否则这些奇特的字符可能会在显示或者打印的时候出现乱码。当你尝试要将用某种编码保存的数据结合到另外一种编码的数据中，或者你想要把它显示在已经假定了某种编码的程序中的时候，问题就会发生。我们都已经见到过网页和邮件被???弄得乱七八糟。 ?????? 或者其它出现在奇怪位置的字符：这一般来说就是存在编码问题了。

但是Unicode对象并没有编码。它们使用Unicode，一个一致的，通用的字符编码集。当你在Python中处理Unicode对象的时候，你可以直接将它们混合使用和互相匹配而不必去考虑编码细节。

Django 在其内部的各个方面都使用到了 Unicode 对象。模型对象中，检索匹配方面的操作使用的是 Unicode 对象，视图函数之间的交互使用的是 Unicode 对象，模板的渲染也是用的 Unicode 对象。通常，我们不必担心编码是否正确，后台会处理的很好。

注意，我们这里只是对Unicode对象进行非常浅显的概述，若要深入了解你可能需要查阅相关的资料。这是一个很好的起点：http://www.joelonsoftware.com/articles/Unicode.html。

为了让我们的修改生效，先退出Python Shell，然后再次运行 python manage.py shell 进入。（这是保证代码修改生效的最简单方法。）现在Publisher对象列表容易理解多了。

>>> from books.models import Publisher
>>> publisher_list = Publisher.objects.all()
>>> publisher_list
[<Publisher: Apress>, <Publisher: O'Reilly>]

请确保你的每一个模型里都包含 unicode() 方法，这不只是为了交互时方便，也是因为 Django会在其他一些地方用 unicode() 来显示对象。

最后， unicode() 也是一个很好的例子来演示我们怎么添加行为到模型里。 Django的模型不只是为对象定义了数据库表的结构，还定义了对象的行为。 unicode() 就是一个例子来演示模型知道怎么显示它们自己。