Внутри каталога mysite, который был создан с помощью команды django-admin.py startproject в предыдущей главе, создайте пустой файл с именем views.py. Этот файл будет содержать представления, описываемые в данной главе. Следует отметить, что нет ничего особенного в выбранном нами имени файла. Django нет никакой разницы как он называется и вы убедитесь в этом сами. Но, назвать так файл — это хорошая идея, другим разработчикам будет проще ориентироваться в вашем коде.

Наше представление простое, оно состоит из кода функции и оператора импорта. Вот содержимое файла views.py:

# -*- coding: utf-8 -*-
from django.http import HttpResponse

def hello(request):
    return HttpResponse("Здравствуй, Мир")

Пройдёмся по коду строка за строкой:

Основная идея в том, что представление является функцией языка Python, которая принимает HttpRequest в качестве первого параметра и возвращает экземпляр HttpResponse. Для того, чтобы функция языка Python стала функцией представления Django, он должен соответствовать этим двум правилам. Есть исключения из этих правил, но мы рассмотрим их позже.

Если в этот момент вы бы запустили снова команду python manage.py runserver, то вы бы увидели сообщение «Welcome to Django» без единого следа нашего представления. Так происходит потому, что наш проект mysite ещё не знает о представлении hello. Нам потребуется явно указать Django, что мы активируем данное представление для конкретного URL. (Продолжая нашу аналогию с публикацией статичных HTML файлов, как будто бы мы создали HTML файл, но ещё не закачали его в каталог на сервере.) Для привязки функции представления к конкретному URL в Django используются файлы привязки URL.

Файл привязки URL можно рассматривать как таблицу с содержанием вашего сайта. Проще говоря, этот файл определяет соответствие между URL и функциями представления, которые должны быть вызваны для этих URL. Именно так вы указываете Django: «Для данного URL, вызывай этот код, а для этого URL вызывай вот этот код.» Например, «Если кто-нибудь посетит URL /foo/, вызывай функцию представления foo_view(), которая расположена в модуле views.py.»

Когда вы запустили django-admin.py startproject в предыдущей главе, скрипт автоматически создал для вас файл привязки: urls.py. По-умолчанию, он выглядит примерно так:

from django.conf.urls.defaults import *

# Uncomment the next two lines to enable the admin:
# from django.contrib import admin
# admin.autodiscover()

urlpatterns = patterns('',
    # Example:
    # (r'^mysite/', include('mysite.foo.urls')),

    # Uncomment the admin/doc line below and add 'django.contrib.admindocs'
    # to INSTALLED_APPS to enable admin documentation:
    # (r'^admin/doc/', include('django.contrib.admindocs.urls')),

    # Uncomment the next line to enable the admin:
    # (r'^admin/', include(admin.site.urls)),
)

Этот стандартный файл привязки включает несколько закомментированных блоков, просто раскомментируйте их, если вам нужен соответствующий функционал. Если проигнорировать закомментированные строки, то останется только это:

from django.conf.urls.defaults import *

urlpatterns = patterns('',
)

Давайте пройдём по каждой строчке этого кода:

Основным элементом данного кода является переменная urlpatterns, которую Django ожидает найти в вашем файле привязки. Эта переменная определяет соответствие между списком URL и кодом, который обрабатывает данные URL. По-умолчанию, как вы можете видеть, файл привязки пуст — ваше Django приложение ещё не настроено. (Именно так Django определяет, что следует показывать страницу «Welcome to Django». Если ваш файл привязки пуст, Django предполагает, что вы только что начали новый проект и, следовательно, отображает данное сообщение.)

Для того, чтобы добавить URL и представление в файл привязки, просто добавьте кортеж, объединяющий URL и функцию представления. Ниже показана привязка для нашего представления hello:

from django.conf.urls.defaults import *
from mysite.views import hello

urlpatterns = patterns('',
    ('^hello/$', hello),
)

(Следует отметить, что мы убрали закомментированные строчки для ясности. Вы можете оставить эти строки, если вам захочется.)

Мы сделали следующие изменения:

В двух словах, мы просто указали Django, что любой запрос к URL /hello/ должен быть обработан с помощью функции представления hello.

['', '/usr/lib/python2.4/site-packages', '/home/username/djcode/']

from foo import bar

>>> import sys
>>> print sys.path

Стоит обсудить синтаксис данного шаблона URL, так как он может быть не совсем очевиден. Несмотря на то, что шаблон должен совпадать с /hello/, он выглядит немного не так. Объясним почему:

Следует отметить ещё один важный момент. В шаблоне URL мы передаём функцию представления hello в виде объекта, без его вызова. Это возможно благодаря ключевой особенности языка Python (и любого другого динамического языка): функции являются объектами первого рода, это означает, что вы можете передавать их в другие объекты аналогично переменным. Прикольно, не так ли?

Для того, чтобы протестировать наши изменения внесённые в файл привязок, запустите тестовый сервер, как это было показано в главе «Начинаем», выполнив команду python manage.py runserver. (Если вы не останавливали его работу, это тоже неплохо. Тестовый сервер автоматически обнаруживает изменения в вашем коде и выполняет его перезагрузку по необходимости, таким образом, вам не надо делать это вручную.) Сервер привязывается к адресу http://127.0.0.1:8000/, так что откройте браузер и пройдите по ссылке http://127.0.0.1:8000/hello/. Вы должны увидеть текст «Здравствуй, Мир» — результат работы вашего представления.

Ура! Вы создали вашу первую страницу с помощью Django.

В текущий момент наш файл привязок определяет единственный шаблон: тот, который обрабатывает запросы по URL URL. Что произойдёт при запросе другого URL?

Чтобы узнать это запустите тестовый сервер и посетите страницу такую как http://127.0.0.1:8000/goodbye/ или http://127.0.0.1:8000/hello/subdirectory/, или даже такую http://127.0.0.1:8000/ (корень сайта). Вы должны увидеть сообщение «Страница не найдена» (см. картинку FIXME). Django отображает это сообщение, потому что вы запросили URL, который не был определён в файле привязок.

Назначение данной страницы идёт значительно дальше простого отображения сообщения об ошибке 404. Она также точно вам указывает какой файл привязки использовало Django и показывает каждый шаблон из этого файла. Из этой информации вы получаете возможность понять, почему была вызвана ошибка 404.

Обычно, эта информация предназначена только для вас, для разработчика. В случае боевого сайта, выставленного в Интернет, врядли вы пожелаете показывать такую информацию неизвестным людям. По этой причине страница с подробностями об ошибке 404 отображается только в том случае, когда ваш проект находится в режиме отладки. Мы расскажем как деактивировать режим отладки позже. Сейчас просто запомните, что новый проект Django всегда создаётся со включенным режимом отладки, и что когда проект не находится в этом режиме, Django показывает совсем другое сообщение об ошибке 404.

Как было описано в последнем разделе, вы увидите сообщение об ошибке 404 в случае, если вы перейдёте в корень сайта — по URL http://127.0.0.1:8000/. Django ничего не добавляет к корню сайта. Данный URL никоим образом не является чем-то особенным. Назначить корню сайта соответствующий шаблон — это целиком ваша задача, как и всё остальное в вашем файле привязки.

Шаблон для корня сайта не совсем очевиден, наверное стоит это отметить. Когда вы будете готовы реализовать представление для корня сайта, используйте шаблон '^$', который соответствует пустой строке. Например:

from mysite.views import hello, my_homepage_view

urlpatterns = patterns('',
    ('^$', my_homepage_view),
    # ...
)