2006-05-02 09:31:56 +08:00
|
|
|
"""
|
2006-06-01 03:10:43 +08:00
|
|
|
3. Giving models custom methods
|
2006-05-02 09:31:56 +08:00
|
|
|
|
|
|
|
Any method you add to a model will be available to instances.
|
|
|
|
"""
|
|
|
|
|
|
|
|
from django.db import models
|
|
|
|
import datetime
|
|
|
|
|
|
|
|
class Article(models.Model):
|
2007-08-05 13:14:46 +08:00
|
|
|
headline = models.CharField(max_length=100)
|
2006-05-02 09:31:56 +08:00
|
|
|
pub_date = models.DateField()
|
|
|
|
|
Merged Unicode branch into trunk (r4952:5608). This should be fully
backwards compatible for all practical purposes.
Fixed #2391, #2489, #2996, #3322, #3344, #3370, #3406, #3432, #3454, #3492, #3582, #3690, #3878, #3891, #3937, #4039, #4141, #4227, #4286, #4291, #4300, #4452, #4702
git-svn-id: http://code.djangoproject.com/svn/django/trunk@5609 bcc190cf-cafb-0310-a4f2-bffc1f526a37
2007-07-04 20:11:04 +08:00
|
|
|
def __unicode__(self):
|
2006-05-02 09:31:56 +08:00
|
|
|
return self.headline
|
|
|
|
|
|
|
|
def was_published_today(self):
|
|
|
|
return self.pub_date == datetime.date.today()
|
|
|
|
|
2006-06-04 08:23:51 +08:00
|
|
|
def articles_from_same_day_1(self):
|
2006-05-02 09:31:56 +08:00
|
|
|
return Article.objects.filter(pub_date=self.pub_date).exclude(id=self.id)
|
|
|
|
|
2006-06-04 08:23:51 +08:00
|
|
|
def articles_from_same_day_2(self):
|
2006-05-02 09:31:56 +08:00
|
|
|
"""
|
|
|
|
Verbose version of get_articles_from_same_day_1, which does a custom
|
|
|
|
database query for the sake of demonstration.
|
|
|
|
"""
|
|
|
|
from django.db import connection
|
|
|
|
cursor = connection.cursor()
|
|
|
|
cursor.execute("""
|
|
|
|
SELECT id, headline, pub_date
|
|
|
|
FROM custom_methods_article
|
|
|
|
WHERE pub_date = %s
|
|
|
|
AND id != %s""", [str(self.pub_date), self.id])
|
|
|
|
# The asterisk in "(*row)" tells Python to expand the list into
|
|
|
|
# positional arguments to Article().
|
|
|
|
return [self.__class__(*row) for row in cursor.fetchall()]
|
|
|
|
|
2006-08-27 21:59:47 +08:00
|
|
|
__test__ = {'API_TESTS':"""
|
2006-05-02 09:31:56 +08:00
|
|
|
# Create a couple of Articles.
|
|
|
|
>>> from datetime import date
|
|
|
|
>>> a = Article(id=None, headline='Area man programs in Python', pub_date=date(2005, 7, 27))
|
|
|
|
>>> a.save()
|
|
|
|
>>> b = Article(id=None, headline='Beatles reunite', pub_date=date(2005, 7, 27))
|
|
|
|
>>> b.save()
|
|
|
|
|
|
|
|
# Test the custom methods.
|
|
|
|
>>> a.was_published_today()
|
|
|
|
False
|
2006-06-04 08:23:51 +08:00
|
|
|
>>> a.articles_from_same_day_1()
|
|
|
|
[<Article: Beatles reunite>]
|
|
|
|
>>> a.articles_from_same_day_2()
|
|
|
|
[<Article: Beatles reunite>]
|
|
|
|
>>> b.articles_from_same_day_1()
|
|
|
|
[<Article: Area man programs in Python>]
|
|
|
|
>>> b.articles_from_same_day_2()
|
|
|
|
[<Article: Area man programs in Python>]
|
2006-08-27 21:59:47 +08:00
|
|
|
"""}
|