Какая разница между приложением и проектом? Приложение – это Web-приложение, которое предоставляет определенный функционал – например, Web-блог, хранилище каких-то записей или простое приложение для голосования. Проект – это совокупность приложений и конфигураций сайта. Проект может состоять из нескольких приложений. Приложение может использоваться несколькими проектами.
Создавая приложение убедитесь что вы находитесь в том же каталоге, что и файл manage.py, и выполните команду:
python manage.py startapp polls
Эта команда создаст каталог polls:
polls/
__init__.py
models.py
tests.py
views.py
Эти файлы являются частью приложения голосования.
Первый шаг в создании Web-приложения в Django – создать его модели, которые являются, по сути, схемой базы данных с дополнительными метаданными.
Модель - это основной источник данных. Он содержит набор полей и поведение данных, которые вы храните.
В нашем простом приложении голосования, мы создадим две модели: для голосования и вариантов ответа. Модель голосования содержит вопрос и дату публикации. Модель ответа содержит: текст ответа и количество голосов. Каждый вариант ответа связан с голосованием.
Отредактируйте файл polls/models.py, чтобы он выглядел таким образом:
from django.db import models
class Poll(models.Model):
question = models.CharField(max_length=200)
pub_date = models.DateTimeField('date published')
class Choice(models.Model):
poll = models.ForeignKey(Poll)
choice = models.CharField(max_length=200)
votes = models.IntegerField()
Код очень простой. Каждая модель представлена подклассом django.db.models.Model. Каждая модель содержит несколько атрибутов, каждый из которых отображает поле в таблице базы данных.
Каждое поле представлено экземпляром класса Field. Например, CharField для текстовых полей и DateTimeField для полей даты и времени. Это указывает Django какие типы данных хранят эти поля.
Названия каждого экземпляра Field (например, question или pub_date ) это название поля, в "машинном" формате. Вы будете использовать эти названия в коде, а база данных будет использовать их как названия колонок.
Вы можете использовать первый не обязательный аргумент конструктора класса Field, чтобы определить отображаемое, удобное для восприятия, название поля. Оно используется в некоторых компонентах Django, и полезно для документирования. Если это название не указанно, Django будет использовать "машинное" название. В этом примере, мы указали отображаемое название только для поля Poll.pub_date. Для всех других полей будет использоваться "машинное" название.
Некоторые подклассы Field содержат обязательные параметры. CharField, например, требует аргумент max_length. Этот аргумент используется не только при создании таблицы, но и при проверке данных, что мы скоро увидим.
Заметим, что связь между моделями определяется с помощью ForeignKey. Это указывает Django что каждый Choice связан с одним объектом Poll. Django поддерживает все основные типы связей: многие-к-одному, многие-ко-многим и один-к-одному.
Активация моделей
Эта небольшая часть кода моделей предоставляет Django большое количество информации, которая позволяет Django:
Создать структуру базы данных (CREATE TABLE) для приложения.
Создать Python API для доступа к данным объектов Poll и Choice.
Но первым делом мы должны указать нашему проекту, что приложение polls установлено.
Отредактируйте файл settings.py и измените настройку INSTALLED_APPS добавив строку 'polls'. В результате получим:
INSTALLED_APPS = (
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.sites',
'django.contrib.messages',
'django.contrib.staticfiles',
# Uncomment the next line to enable the admin:
# 'django.contrib.admin',
# Uncomment the next line to enable admin documentation:
# 'django.contrib.admindocs',
'polls',
)
Теперь Django знает что необходимо использовать приложение polls. Давайте выполним следующую команду:
python manage.py sql polls
Вы увидите приблизительно такое (SQL запросы CREATE TABLE для приложения голосования):
BEGIN;
CREATE TABLE "polls_poll" (
"id" serial NOT NULL PRIMARY KEY,
"question" varchar(200) NOT NULL,
"pub_date" timestamp with time zone NOT NULL
);
CREATE TABLE "polls_choice" (
"id" serial NOT NULL PRIMARY KEY,
"poll_id" integer NOT NULL REFERENCES "polls_poll" ("id") DEFERRABLE INITIALLY DEFERRED,
"choice" varchar(200) NOT NULL,
"votes" integer NOT NULL
);
COMMIT;
Обратите внимание на следующее:
Полученные запросы зависят от базы данных, которую вы используете.
Названия таблиц созданы автоматически из названия приложения(polls) и названия модели в нижнем регистре – poll и choice. (Вы можете переопределить это.)
Первичные ключи (ID) добавлены автоматически. (Вы можете переопределить и это.)
Django добавляет "_id" к названию внешнего ключа. (Да, вы можете переопределить и это.)
Внешний ключа определяется явно через REFERENCES.
Учитываются особенности базы данных, которую вы используете. Специфические типы данных такие как auto_increment (MySQL), serial (PostgreSQL), или integer primary key (SQLite) будут использоваться автоматически. То же касается и экранирование называний, что позволяет использовать в названии кавычки – например, использование одинарных или двойных кавычек. Автор этого урока использует PostgreSQL, так что примеры используют синтаксис PostgreSQL.
Команда sql не выполняет SQL запросы в базе данных - она просто выводит их на экран, чтобы вы могли увидеть какой SQL создает Django. Если вы хотите, можете скопировать и выполнить этот SQL в консоли вашей базы данных. Однако, Django предоставляет более простой способ выполнять SQL в базе данных.
Если вам интересно, запустите следующие команды:
python manage.py validate – проверяет на ошибки структуру ваших моделей.
python manage.py sqlcustom polls – выводит дополнительные SQL запросы (такие как изменения в таблице или дополнительные правила) определенные для приложения.
python manage.py sqlclear polls – выводит необходимые DROP TABLE запросы для этого приложения, учитывая таблицы, которые уже существуют в базе данных (если такие есть).
python manage.py sqlindexes polls – выводит CREATE INDEX запросы для приложения.
python manage.py sqlall polls – выводит комбинацию SQL запросов команд sql, sqlcustom, из sqlindexes.
Изучение вывода этих команд может помочь вам понять что на самом деле происходит.
Теперь, выполните команду syncdb снова, чтобы создать таблицы для этих моделей в базе данных:
python manage.py syncdb
Команда syncdb выполняет все запросы из команды sqlall в вашей базе данных для всех приложений, которые находятся INSTALLED_APPS. Она создает все таблицы, загружает начальные данные и создает индексы для всех моделей всех приложений. Команда syncdb может выполняться любое количество раз и будут созданы только таблицы, которые еще не существуют.
Создавая приложение убедитесь что вы находитесь в том же каталоге, что и файл manage.py, и выполните команду:
python manage.py startapp polls
Эта команда создаст каталог polls:
polls/
__init__.py
models.py
tests.py
views.py
Эти файлы являются частью приложения голосования.
Первый шаг в создании Web-приложения в Django – создать его модели, которые являются, по сути, схемой базы данных с дополнительными метаданными.
Модель - это основной источник данных. Он содержит набор полей и поведение данных, которые вы храните.
В нашем простом приложении голосования, мы создадим две модели: для голосования и вариантов ответа. Модель голосования содержит вопрос и дату публикации. Модель ответа содержит: текст ответа и количество голосов. Каждый вариант ответа связан с голосованием.
Отредактируйте файл polls/models.py, чтобы он выглядел таким образом:
from django.db import models
class Poll(models.Model):
question = models.CharField(max_length=200)
pub_date = models.DateTimeField('date published')
class Choice(models.Model):
poll = models.ForeignKey(Poll)
choice = models.CharField(max_length=200)
votes = models.IntegerField()
Код очень простой. Каждая модель представлена подклассом django.db.models.Model. Каждая модель содержит несколько атрибутов, каждый из которых отображает поле в таблице базы данных.
Каждое поле представлено экземпляром класса Field. Например, CharField для текстовых полей и DateTimeField для полей даты и времени. Это указывает Django какие типы данных хранят эти поля.
Названия каждого экземпляра Field (например, question или pub_date ) это название поля, в "машинном" формате. Вы будете использовать эти названия в коде, а база данных будет использовать их как названия колонок.
Вы можете использовать первый не обязательный аргумент конструктора класса Field, чтобы определить отображаемое, удобное для восприятия, название поля. Оно используется в некоторых компонентах Django, и полезно для документирования. Если это название не указанно, Django будет использовать "машинное" название. В этом примере, мы указали отображаемое название только для поля Poll.pub_date. Для всех других полей будет использоваться "машинное" название.
Некоторые подклассы Field содержат обязательные параметры. CharField, например, требует аргумент max_length. Этот аргумент используется не только при создании таблицы, но и при проверке данных, что мы скоро увидим.
Заметим, что связь между моделями определяется с помощью ForeignKey. Это указывает Django что каждый Choice связан с одним объектом Poll. Django поддерживает все основные типы связей: многие-к-одному, многие-ко-многим и один-к-одному.
Активация моделей
Эта небольшая часть кода моделей предоставляет Django большое количество информации, которая позволяет Django:
Создать структуру базы данных (CREATE TABLE) для приложения.
Создать Python API для доступа к данным объектов Poll и Choice.
Но первым делом мы должны указать нашему проекту, что приложение polls установлено.
Отредактируйте файл settings.py и измените настройку INSTALLED_APPS добавив строку 'polls'. В результате получим:
INSTALLED_APPS = (
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.sites',
'django.contrib.messages',
'django.contrib.staticfiles',
# Uncomment the next line to enable the admin:
# 'django.contrib.admin',
# Uncomment the next line to enable admin documentation:
# 'django.contrib.admindocs',
'polls',
)
Теперь Django знает что необходимо использовать приложение polls. Давайте выполним следующую команду:
python manage.py sql polls
Вы увидите приблизительно такое (SQL запросы CREATE TABLE для приложения голосования):
BEGIN;
CREATE TABLE "polls_poll" (
"id" serial NOT NULL PRIMARY KEY,
"question" varchar(200) NOT NULL,
"pub_date" timestamp with time zone NOT NULL
);
CREATE TABLE "polls_choice" (
"id" serial NOT NULL PRIMARY KEY,
"poll_id" integer NOT NULL REFERENCES "polls_poll" ("id") DEFERRABLE INITIALLY DEFERRED,
"choice" varchar(200) NOT NULL,
"votes" integer NOT NULL
);
COMMIT;
Обратите внимание на следующее:
Полученные запросы зависят от базы данных, которую вы используете.
Названия таблиц созданы автоматически из названия приложения(polls) и названия модели в нижнем регистре – poll и choice. (Вы можете переопределить это.)
Первичные ключи (ID) добавлены автоматически. (Вы можете переопределить и это.)
Django добавляет "_id" к названию внешнего ключа. (Да, вы можете переопределить и это.)
Внешний ключа определяется явно через REFERENCES.
Учитываются особенности базы данных, которую вы используете. Специфические типы данных такие как auto_increment (MySQL), serial (PostgreSQL), или integer primary key (SQLite) будут использоваться автоматически. То же касается и экранирование называний, что позволяет использовать в названии кавычки – например, использование одинарных или двойных кавычек. Автор этого урока использует PostgreSQL, так что примеры используют синтаксис PostgreSQL.
Команда sql не выполняет SQL запросы в базе данных - она просто выводит их на экран, чтобы вы могли увидеть какой SQL создает Django. Если вы хотите, можете скопировать и выполнить этот SQL в консоли вашей базы данных. Однако, Django предоставляет более простой способ выполнять SQL в базе данных.
Если вам интересно, запустите следующие команды:
python manage.py validate – проверяет на ошибки структуру ваших моделей.
python manage.py sqlcustom polls – выводит дополнительные SQL запросы (такие как изменения в таблице или дополнительные правила) определенные для приложения.
python manage.py sqlclear polls – выводит необходимые DROP TABLE запросы для этого приложения, учитывая таблицы, которые уже существуют в базе данных (если такие есть).
python manage.py sqlindexes polls – выводит CREATE INDEX запросы для приложения.
python manage.py sqlall polls – выводит комбинацию SQL запросов команд sql, sqlcustom, из sqlindexes.
Изучение вывода этих команд может помочь вам понять что на самом деле происходит.
Теперь, выполните команду syncdb снова, чтобы создать таблицы для этих моделей в базе данных:
python manage.py syncdb
Команда syncdb выполняет все запросы из команды sqlall в вашей базе данных для всех приложений, которые находятся INSTALLED_APPS. Она создает все таблицы, загружает начальные данные и создает индексы для всех моделей всех приложений. Команда syncdb может выполняться любое количество раз и будут созданы только таблицы, которые еще не существуют.
Комментариев нет:
Отправить комментарий