Работа с моделями — Python: Разработка на фреймворке Django

Модель в MVC v2 – это слой приложения, который отвечает за связь с предметной областью. В нем находится вся бизнес-логика приложения. Для простоты реализации, сюда часто включают механизмы для работы с базой данных.

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

Это значит, что мы можем работать с моделями через специальный вариант REPL, который работает в контексте фреймворка командой python manage.py shell.

Создадим новую статью, наполним ее данными и сохраним в базе:

python manage.py shell

from hexlet_django_blog.article.models import Article # Импортируем наш класс модели Article
a = Article()
# Когда объект модели создан, его можно наполнять данными через обычные свойства.
a.name = 'my super article'
a.body = 'my content'
a # <Article: Article object (None)>
a.id
a.name # 'my super article'
a.body # 'my content'

Также можно создать объект методом create. Этот метод создает объект и автоматически сохраняет его в базу.

from hexlet_django_blog.article.models import Article

a = Article.objects.create(name='my super article', body='my content')
a # <Article: Article object (1)>
a.id # 1
a.name # 'my super article'
a.body # 'my content'
a.created_at # datetime.datetime(2022, 11, 3, 20, 48, 19, 883732, tzinfo=datetime.timezone.utc)
a.updated_at # datetime.datetime(2022, 11, 3, 20, 48, 19, 883732, tzinfo=datetime.timezone.utc)

Этот метод делает запрос INSERT в базу данных. Затем он обновляет сам объект:

• Внутрь записывается идентификатор статьи, взятый из базы данных
• Заполняются поля created_at и updated_at.

Созданный объект можно тут же поменять:

a.name = 'another title'
a.name # 'another title'

Изменение свойств не затрагивает базу данных. Это происходит только на уровне самого объекта. Если в этот момент закрыть консоль, то все изменения потеряются. Для сохранения нужно снова вызвать save(). Этот метод универсальный, он подходит как для создания новой сущности, так и для ее обновления:

a.save()
a # <Article: Article object (1)>
a.id # 1
a.name # 'another title'
a.body # 'my content'
a.created_at # datetime.datetime(2022, 11, 3, 20, 48, 19, 883732, tzinfo=datetime.timezone.utc)
a.updated_at # datetime.datetime(2022, 11, 3, 20, 48, 19, 883732, tzinfo=datetime.timezone.utc)

Теперь предположим, что у нас нет переменной с текущей статьей. Например, мы перезапустили консоль. Получить нужный объект можно с помощью статических методов, которые появляются у каждой модели. Самый простой способ достать запись, сделать поиск по ее идентификатору:

a = Article.objects.get(id=1)
a # <Article: Article object (1)>
a.id # 1
a.name # 'another title'
a.body # 'my content'
a.created_at # datetime.datetime(2022, 11, 3, 20, 48, 19, 883732, tzinfo=datetime.timezone.utc)
a.updated_at # datetime.datetime(2022, 11, 3, 20, 48, 19, 883732, tzinfo=datetime.timezone.utc)

Article.objects — это представление всех объектов данной модели. get ищет одну запись по заданному условию и возвращает запись. Если запись не найдена, то вызовется исключение:

a = Article.objects.get(id=2)
# Traceback (most recent call last):
#     ...
# DoesNotExist: Question matching query does not exist.

Если нужен поиск по полям, который вернет коллекцию, для этого подходит метод filter:

a = Article.objects.filter(name='another title')
a # <QuerySet [<Article: Article object (1)>]>

Мы можем составить и более сложный запрос. Предположим, что надо вывести body первой записи, у которой это id больше 50 (при условии, что записей в таблице больше 50):

Article.objects.filter(id__gt=50).first().body # 'my content'

Здесь строится целая цепочка вызова методов. И такие цепочки могут быть достаточно длинными. Каждый из шагов уточняет запрос по тому или иному критерию, а в конце всегда стоит вызов какого-то метода. Он определяет, сколько записей мы хотим получить. В данном случае мы хотим получить одну первую попавшуюся. Поэтому запрос заканчивается вызовом метода .first(). А .body мы уже получаем у объекта, который является результатом выполнения запроса.

Во фрагменте указано условие, по которому выбираются объекты в запросе — id__gt=50. Это так называемый lookup. id здесь означает имя поля, а дальше через разделитель "__" (двойное подчеркивание) указывается gt — сокращение от greater than (больше чем) и, наконец, само значение.

Такой синтаксис приходится использовать, так как мы не можем при вызове метода указать аргумент id > 20. Авторы вышли из ситуации и использовали именованные аргументы с такими необычными именами.

Попробуем запросить данные из базы данных и вывести список всех записей модели Article:

a = Article.objects.all()
a # <QuerySet [<Article: Article object (1)>]>

И последнее, что можно сделать с сущностью, это удалить ее:

a = Article.objects.get(id=1)
a.delete() # (1, {'article.Article': 1})
Article.objects.all() # <QuerySet []>

Самостоятельная работа

1. Создайте пять статей через репл. Они понадобятся при построении CRUD

---

Остались вопросы? Задайте их в разделе «Обсуждение»

Вам ответят команда поддержки Хекслета или другие студенты