Создание видов в Django

Python | Amber | Комментировать запись

Если вы следовали мануалам по разработке в Django, вы успешно создали приложение Django, которое позволяет пользователям с правами администратора добавлять комментарии и посты через панель управления. Вы также обеспечили постоянство данных, используя MySQL и модели Django.

В этом мануале вы научитесь создавать виды Django, которые позволят веб-приложению правильно обрабатывать запросы и возвращать требуемые ответы в Интернете. Согласно документам Django, веб-ответ может быть HTML-контентом веб-страницы, перенаправлением или ошибкой HTTP (например, 404). Код для функций видов технически может находиться в любом месте вашего проекта, если он присутствует в пути Python. Однако существуют некоторые соглашения об именовании и размещении файлов, и мы будем следовать этим методам.

В результате ваш блог Django (блог) выведет последний пост по URL-адресу your-IP-or-domain/post.

Требования

Этот мануал является частью серии по разработке Django. Чтобы получить правильную среду в этом руководстве, вы должны были выполнить эти мануалы:

• Установка Django в Ubuntu и Debian (помогает установить Django и настроить среду разработки).
• Создание приложения Django и подключение к базе данных
• Создание моделей в Django
• Подключение интерфейса администратора Django

Однако если у вас есть своя установка Django, вы можете работать с ней, чтобы научиться создавать виды Django.

1: Создание функций видов

Сначала нужно перейти в соответствующий каталог и активировать свою виртуальную среду Python в терминале сервера Ubuntu:

cd ~/my_blog_app
. env/bin/activate

Теперь, когда виртуальная среда включена, перейдите в каталог blogsite, откройте файл Python и создайте первую функцию вида.

Читайте также: Определение функций в Python 3

cd ~/my_blog_app/blog/blogsite

Откройте файл views для редактирования, используя текстовый редактор.

nano views.py

В файле вы должны увидеть код, который выглядит так:

from django.shortcuts import render
# Create your views here.

Оставьте оператор import, который импортирует функцию render() из библиотеки django.shortcuts. Функция render() позволяет комбинировать шаблон и контекст, чтобы вернуть соответствующий объект HttpResponse. Помните об этом, потому что каждый созданный вами вид отвечает за создание, заполнение и возврат HttpResponse.

Читайте также: Импорт модулей в Python 3

Затем добавьте первый вид, который будет приветствовать пользователей на индексной странице. Импортируйте функцию HttpResponse() из библиотеки http. Используя эту функцию, вы сможете передать текст, который будет отображаться при запросе веб-страницы.

from django.shortcuts import render
from django.http import HttpResponse
def index(request):
return HttpResponse('Hello, welcome to the index page.')

После этого нужно добавить еще одну функцию, которая отобразит отдельный пост (его мы создадим позже).

...
def individual_post(request):
return HttpResponse('Hi, this is where an individual post will be.')

В результате файл views.py выглядит так:

from django.http import HttpResponse
from django.shortcuts import render
def index(request):
return HttpResponse('Hello, welcome to the index page.')
def individual_post(request):
return HttpResponse('Hi, this is where an individual post will be.')

Сохраните и закройте файл.

На данный момент функции не указывают на конкретный URL-адрес, поэтому вам нужно добавить его в блок urlpatterns в конфигурационном файле URL. Добавив виды, свяжите их с URL-адресами через этот файл, чтобы пользователи могли просматривать страницы, которые вы создали.

2: Сопоставление URL-ов с видами

Django делает создание собственных URL-адресов относительно простой задачей. Это делается в Python, в файле URLconf.

Чтобы показать веб-страницу, Django сначала должен определить корневой модуль URLconf, затем найти urlpatterns, список, содержащий все шаблоны URL-ов.

Читайте также: Работа со списками в Python 3

Затем Django просматривает каждый шаблон URL, пока не найдет первый, который соответствует. Как только совпадение найдено, Django находит связанный с ним вид, и эта функция вида получит данные, относящиеся к шаблону URL и объекту HttpRequest. Если во время этого процесса в какой-либо точке произошел сбой, вместо него отображается вид обработки ошибок.

В каталоге ~/my_blog_app/blog/blogsite откройте файл urls.py (это и есть URLconf).

nano urls.py

Отредактируйте файл таким образом:

from django.urls import path
from . import views
urlpatterns = [
path('', views.index, name='index'),
path('post/', views.individual_post, name='individual_post')
]

Сохраните и закройте его.

Обновив файл URLconf каталога blogsite, вы должны включить его в URLconf каталога blog, иначе он не будет распознаваться. Мы должны сделать это, потому что он определяется как ROOT_URLCONF. Это означает, что Django просматривает URLconf каталога blog, чтобы найти шаблоны urlpatterns.

Чтобы включить файл URLconf из каталога blogsite в файл URLconf каталога blog, перейдите в этот каталог:

cd ~/my_blog_app/blog/blog

Откройте файл URLconf с помощью nano или другого текстового редактора.

nano urls.py

В файл нужно добавить следующие строки, чтобы включить файл /blogsite/urls.py:

from django.contrib import admin
from django.urls import include, path
urlpatterns = [
path('admin/', admin.site.urls),
path('', include('blogsite.urls'))
]

Сохраните и закройте файл.

Теперь откройте веб-браузер и перейдите по URL-адресам, которые вы создали, чтобы убедиться, что они отображают текст, который вы добавили в виды. Чтобы получить доступ к файлу manage.py, который обслуживает приложение Django, нужно перейти в родительский каталог:

cd ..

Выполните следующую команду, указав свой IP:

python manage.py runserver your-server-ip:8000

Откройте URL в браузере:

your-server-ip:8000

Вы увидите страницу с таким текстом:

Hello, welcome to the index page.

Теперь откройте этот URL:

your-server-ip:8000/post/

Вы увидите:

Hi, this is where an individual post will be.

Вы убедились, что файлы urls.py работают правильно.

3: Создание поста для блога

Теперь, когда вы понимаете основы работы шаблонов URL-ов и видов, добавьте в блог новый пост, который будет отображаться на странице вместо текста, который вы жестко закодировали в файле Python.

Создайте пост через созданную вами ранее страницу администратора. Используйте веб-браузер, чтобы перейти на страницу Blogsite:

your-server-ip:8000/admin/blogsite/

В интерфейсе кликните + Add в строке Posts, чтобы добавить в БД тестовый пост.

После этого вы увидите форму ввода, которая выглядит так:

Add Post
Title:
Slug:
Content:
Author:

Эта страница используется для создания всех постов в блоге. Кроме того, вы можете редактировать сообщения с помощью ссылки Change.

Заполните форму.

Нажмите SAVE. Вы увидите страницу подтверждения.

The post “Post object (1)” was added successfully

Вы создали свой первый пост.

4: Отображение данных БД

Теперь нужно открыть MySQL. Остановите текущий процесс сервера через терминал, набрав CTRL+C, затем откройте свой интерпретатор MySQL:

mysql -u root

В командной строке MySQL перейдите в базу данных blog_data:

use blog_data;

Отобразите содержимое таблицы blogsite_post:

select * from blogsite_post;

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

+----+--------------------+--------------------+---------------+----------------------------+--------+

| id | title              | slug               | content       | created_on                 | author |

+----+--------------------+--------------------+---------------+----------------------------+--------+

|  1 | My First Blog Post | my-first-blog-post | Hello, World! | 2018-04-24 17:10:00.139735 | 8host  |

+----+--------------------+--------------------+---------------+----------------------------+--------+
1 row in set (0.00 sec)

В выводе есть строка с данными для поста, который вы добавили. Теперь нужно сослаться на эти данные в функции вида. Используйте CTRL+D для выхода из интерпретатора MySQL.

Перейдите к каталогу, где хранится файл views.py:

cd ~/my_blog_app/blog/blogsite

Откройте файл:

nano views.py

Отредактируйте его, чтобы он выглядел так:

from django.shortcuts import render
from django.http import HttpResponse
from .models import Post
def index(request):
return HttpResponse('Hello, welcome to the index page.')
def individual_post(request):
recent_post = Post.objects.get(id__exact=1)
return HttpResponse(recent_post.title + ': ' + recent_post.content)

В приведенном выше коде появился дополнительный оператор import для Post. Также вы удалили условную строку из HttpResponse и заменили ее данными из поста в блоге. Чтобы сослаться на данные конкретного объекта, используется идентификатор поста, связанный с объектом, который нужно отобразить. Этот идентификатор хранится в переменной recent_post. Затем можно указать определенные поля этого объекта через двоеточие.

После того, как вы сохранили и закрыли файл, перейдите в папку с файлом manage.py, чтобы запустить приложение Django.

cd ~/my_blog_app/blog
python manage.py runserver your-server-ip:8000/post/

В браузере откройте ссылку:

your-server-ip:8000/post/

На экране вы должны увидеть свой новый пост.

Чтобы остановить процесс, нажмите CTRL+C.

Чтобы отключить среду разработки, введите команду deactivate, а затем выйдите с сервера.

Заключение

В этом мануале вы создали виды, связали шаблоны URL и отобразили на веб-странице текст из базы данных блога.

В следующем мануале вы узнаете, как сделать блог красивее, используя HTML для создания шаблонов Django. Шаблоны – последняя важная часть в разработке приложения Django.