Фреймворк — это готовый каркас, по правилам которого пишут приложение или его часть. Например, веб-фреймворк получает запрос к странице, находит подходящий маршрут и запускает функцию, которую написал разработчик. Функция решает, какие данные вернуть. На одном запросе покажем, где работает каркас, где начинается ваш код и когда хватит обычной библиотеки. А если хотите освежить понятия HTTP, интерфейса и сервера перед разбором, попробуйте тест.
Что готово в каркасе, а что пишете вы?
Английское framework, по Кембриджскому словарю, обозначает опорную структуру или систему правил. В разработке опора обычно состоит из кода и соглашений. Веб-фреймворк может дать готовые механизмы для обработки запросов, шаблонов страниц и чтения данных. Соглашения объясняют, где объявить маршрут и какой объект вернуть, чтобы браузер получил страницу. Состав такого набора зависит от проекта.
Представьте каталог книг. Через месяц появятся страницы авторов и список новинок, а в первый день нужна одна страница со всеми книгами. Веб-фреймворк умеет сопоставлять адрес со страницей. Как именно сортировать книги, показывать ли издания на разных языках и куда вести читателя после выбора, решает команда. Одни и те же правила обработки запроса подходят каталогу книг и, например, расписанию кинотеатра. Содержимое и действия у них будут разными.
Полезно различать соглашение и обязательный интерфейс. Соглашение подсказывает, как организовать проект, чтобы коллеги быстро нашли нужный код. Например, в учебных проектах Django часто используют имя файла urls.py для списка маршрутов. Обязательный интерфейс определяет, что передаётся между каркасом и вашим кодом. В Django функция-представление получает объект запроса и возвращает объект ответа. Переименовать файл можно, если изменить настройку. Возвращать из обработчика произвольный тип вместо ответа уже нельзя без дополнительного слоя преобразования.
| Что называют в разговоре | Что это даёт | Пример роли |
|---|---|---|
| Язык | Синтаксис и правила записи программы | На Python пишут функцию, которая выбирает книги |
| Среда выполнения | Запускает код | Интерпретатор выполняет написанную на Python функцию |
| Фреймворк | Устройство процессов и места подключения кода | Django связывает путь страницы с функцией |
| Библиотека | Готовую возможность для определённой области | Модуль json преобразует список в строку JSON |
| Шаблон проекта | Исходные файлы, с которых удобно начать | Заготовка каталогов, настроек и примеров |
Поэтому выбирать между Python и Django как между двумя способами решить одну задачу неудобно. Python определяет, как записать её решение. Django задаёт связь между решением и запросом сайта. Та же функция Python может работать и в маленькой программе, которую человек запускает из командной строки.
Ещё одно употребление слова встречается в управлении. Согласно руководству Кена Швабера и Джеффа Сазерленда, Scrum задаёт рамки командной работы над сложными задачами. В них входят обязанности участников, события и рабочие артефакты, например список задач продукта. Здесь слово «фреймворк» описывает организацию работы людей. О том, как устроены Scrum и его события, есть отдельная статья.
Кто запускает нужную функцию?
Мартин Фаулер объясняет разницу через инверсию управления. Допустим, ваш код собрал список книг, а дальше вы хотите получить JSON, текстовый формат обмена данными. Вы вызываете функцию json.dumps из стандартной библиотеки Python. Функция возвращает строку. Ваш код решает, что сделать дальше: сохранить её в файл, отправить в ответе или использовать для проверки.
В веб-приложении шагом раньше приходит запрос. Он появляется в тот момент, когда читатель открывает страницу. Разработчик связывает адрес с обработчиком, а фреймворк вызывает этот обработчик при совпадении. Внутри обработчика ничто не мешает воспользоваться библиотекой. Получатся две разные связи вокруг одной и той же работы со списком книг.
За кулисами актёр натянул камзол, а про домашние тапочки вспомнил только после сигнала выйти на сцену. Свою реплику он знает. Время выхода подсказывает помощник режиссёра. Так и у обработчика есть своя работа, а момент запуска определяет событие, которое отслеживает каркас.
Правило описывает границу интересующей нас работы. Библиотека тоже может вызвать переданную ей функцию. Например, согласно документации React, при отрисовке интерфейса React сам решает, когда вызвать компоненты. При этом авторы React называют его библиотекой для интерфейсов. Они описывают конкретную область управления: компоненты и то, как их отрисовать. Приложение может выбрать отдельное решение для навигации, обработки серверных запросов и получения данных.
С этим связан пример Next.js. Согласно его документации, Next.js использует React для интерфейса, а его App Router строит маршруты по структуре папок и специальным файлам. Он предоставляет также средства работы на сервере. Поэтому в одном проекте React может управлять отрисовкой компонента, а Next.js определять, на какой странице и в каком режиме этот компонент используется. Обе технологии нужны на разных уровнях.
Один запрос от браузера до страницы
В каталоге книг пусть будет адрес /books/. Браузер отправляет запрос на сервер, когда читатель его открывает. Согласно документации Django, каркас проверяет маршруты в том порядке, в котором их объявили. Как только находится первый подходящий шаблон, Django вызывает связанное с ним представление. Представлением может быть написанная на Python функция.
Обработчик получает сведения о запросе. По ним он может узнать, какую страницу списка попросил посетитель или какой фильтр выбрал. Затем код каталога получает подходящие книги. Приложение определяет, будут ли они прочитаны из базы данных, из заранее подготовленного списка или из другого источника. Django предоставляет собственные инструменты для работы с базой.
Обработчик возвращает ответ. Для обычной страницы это HTML, который браузер покажет читателю. Для обмена между программами удобен JSON. Допустим, функция получила список названий. Превратить список в JSON можно библиотечной функцией, описанной в документации Python. Django также предлагает свой класс ответа для JSON. Это два примера разделения обязанностей: перевести данные в нужный формат и отправить их с правильным типом ответа.
Проверить связь маршрута и функции помогает один эксперимент без запуска сервера: прочитать объявления сверху вниз. Если двум маршрутам подходит один и тот же путь, сработает первый. Теперь представьте, что путь содержит ещё номер страницы. У маршрута должен быть шаблон, который выделит номер, а у обработчика должен быть подходящий параметр. Так можно понять, куда смотреть, когда навигация приводит к неожиданной странице.
Если совпадения нет, Django переходит к обработке ошибки. При найденном маршруте ошибка тоже возможна. Например, открылась функция отдельной книги, но в каталоге нет карточки с таким номером. Для читателя в обоих случаях может появиться 404. При разборе различайте две причины: запрос не дошёл до нужной функции или функция не нашла запрошенный объект. У этих проблем разные места исправления.
Вы можете обнаружить тот же принцип в настоящем проекте. Mozilla публикует код сервера каталога дополнений Firefox. В репозитории указан Django, а в коде видны отдельные части, отвечающие за расширения и запросы к каталогу. Каркас обрабатывает общую веб-механику, а правила публикации и поиска расширений относятся уже к самому продукту.
Какие задачи решают разные фреймворки?
Выражение «веб-фреймворк» охватывает несколько ролей. Серверная часть принимает запросы и работает с данными. Интерфейсная часть отвечает за отображение и действия пользователя. Некоторые решения охватывают обе части приложения. Полезно проверить, о какой части говорится, если в учебном тексте два инструмента поместили в одну категорию.
| Задача | Пример | Что даёт фреймворк |
|---|---|---|
| Ответы сервера на запросы | Django | Маршруты, вызов обработчика, средства работы с данными и шаблонами |
| Интерфейс и веб-маршруты | Next.js | Соглашения о файлах страниц, работу с React и средства серверной отрисовки |
| Интерфейс приложения на разных устройствах | Flutter | Виджеты и цикл построения интерфейса |
| Выполнение тестов | JUnit Jupiter | Правила описания тестов и движок, который их запускает |
| Настольный интерфейс Windows | Windows Forms | Окна, элементы управления и вызов обработчиков событий |
Архитектурный обзор Flutter описывает интерфейс как дерево виджетов. Фреймворк запускает построение нужной части интерфейса, когда состояние поменялось. Например, после нажатия на кнопку приложение меняет число товаров в корзине. Разработчик описывает, какие элементы должны появиться и какое состояние они используют. В опубликованном командой Flutter разборе Google Pay этот подход применили при создании приложений для Android и iOS.
У JUnit другая граница. Согласно руководству проекта, JUnit Jupiter предоставляет способы описать тест и движок для его выполнения. Разработчик помечает функцию как тест и описывает ожидаемый результат. Например, после добавления одной книги в пустой избранный список тот должен содержать одну книгу. Движок находит тест, вызывает его и сообщает, прошла ли проверка. Порядок запуска серии тестов не приходится описывать вручную в каждой функции.
По документации Microsoft, Windows Forms даёт готовые элементы настольного интерфейса. При проектировании окна можно добавить кнопку и написать код её действия. Когда пользователь нажимает кнопку, Windows Forms направляет событие обработчику. Это тот же способ связи с пользовательским кодом, что и в примере с тестом, хотя фреймворки обслуживают разные события и используются в разных отраслях.
У лёгких веб-фреймворков каркас может ограничиваться запросами, маршрутами и ответами. Систему шаблонов и способ работы с базой команда подключает отдельно. В более широком наборе часть таких решений уже принята авторами. Это влияет на объём первоначальной работы и на то, сколько соглашений придётся изучить новому разработчику.
💡 Интересный факт
В июле 2004 года Дэвид Хейнемайер Ханссон объявил о первом публичном выпуске Rails. В него вошла общая инфраструктура веб-сервиса Basecamp. Команды других проектов могли взять оттуда инструменты работы с шаблонами и базой данных и написать свои правила поверх них.
Источник: Дэвид Хейнемайер Ханссон, объявление «Rails: The infrastructure behind Basecamp» в архиве Signal vs. Noise, 24 июля 2004 года.
Когда достаточно библиотеки или CMS?
В первую очередь назовите работу, которую хотите поручить готовому инструменту. Если приложение уже существует и нужно только выгружать данные в определённом формате, полезна библиотека с такой функцией. Если нужен сайт, где авторы будут регулярно добавлять статьи, уместна система управления контентом. CMS предоставляет редактору интерфейс управления страницами, публикациями и их настройками. Например, WordPress описывает себя как средство публикации с темами и расширениями.
Одна страница с контактами и схемой проезда может работать как обычный HTML-файл со стилями. Если у той же организации появляются бронирования, перенос времени и разные права доступа, становится важен способ описать поведение. Веб-фреймворк поможет связать входящие запросы с действиями приложения. При этом правила вроде «записаться можно только после подтверждения почты» остаются решением команды.
На обсуждении запуска кто-то открывает список из пяти технологий, а коллега попросил всего лишь выгрузку книг в файл. Пока остальные выбирают название для новой папки проекта, первый рабочий скрипт уже закончил выгрузку. Такие расхождения удобно ловить по короткому описанию готового результата. Для одного скрипта важен формат файла. Для каталога с редакторами важна ещё и последовательность действий от добавления карточки до публикации.
Граница может проходить внутри проекта. У каталога есть личные кабинеты и собственный поиск. На том же сайте редакция выпускает новости. Для каталога команда может писать приложение на фреймворке, а для новостей использовать CMS. Оба подхода подходят одному продукту, потому что редактор и пользователь каталога совершают разные действия.
Другой вариант касается внешнего вида. Набор готовых стилей иногда называют CSS-фреймворком. Под этим имеют в виду правила сетки, типографики и оформления элементов. Если на странице есть кнопка, набор может задать форму и цвет. Реакция на нажатие зависит от JavaScript или от стандартного поведения HTML. Поэтому слово «фреймворк» в таком названии описывает прежде всего роль в оформлении.
Что проверить на первом сценарии?
Выбирая каркас для нового приложения, начинайте с короткого сквозного сценария. Для каталога это может быть открытие списка книг и переход к одной карточке. Сначала достаточно нескольких записей и одного способа их показать. Даже маленький фрагмент помогает понять, как будут связаны части, которые придётся поддерживать.
- Запишите действие и результатНапример, читатель открывает карточку книги по её адресу. В ответ видит название, автора и наличие.
- Проследите обычный путьНайдите маршрут, обработчик, источник данных и место, где формируется результат. Отметьте, какие части уже предусмотрены каркасом.
- Проверьте один сбойВозьмите адрес книги, которой нет в каталоге. Должно быть ясно, где задаётся поведение и что увидит читатель.
- Добавьте ещё одно требованиеНапример, показывайте карточку только после её публикации. Посмотрите, где хранится это правило и как можно проверить его тестом.
Если на третьем шаге коллега может объяснить, почему получился этот результат, соглашения работают на команду. Меньше времени уйдёт на угадывание, где объявлена страница, как меняется содержимое и куда идти с ошибкой. Если каждый простой сценарий требует менять разные части каркаса, это может быть сигналом, что его устройство плохо подходит задаче.
Отдельно посмотрите, какие версии поддерживает среда запуска. Локальный учебный пример и рабочий проект могут использовать разные версии. Полезно открыть документацию для той версии, с которой вы будете работать, и повторить два действия из быстрого старта. Уточните также, какие библиотеки вы хотите оставить. Они могут диктовать ограничения на язык, среду выполнения или систему сборки.
До выбора представьте стоимость обычного изменения. Сможет ли новый сотрудник добавить ещё один адрес по существующему примеру? Придётся ли переделывать все страницы, если источник данных сменится? Что потребуется обновить, когда выходят новые версии? Эти вопросы полезнее большого списка возможностей, когда у проекта есть конкретная команда и срок.
Если хочется пройти этот путь с учебным проектом и разобрать связь интерфейса с сервером, для этого есть курсы по веб-разработке.
Где чаще всего ошибаются при выборе
Фреймворк сокращает объём повторной работы, если его возможности подходят сценариям. Иногда решение принимают по одному известному приложению или по длинному списку функций. Сначала попробуйте перевести название технологии в перечень действий, необходимых вашему проекту. Это показывает, какой частью процесса вы фактически пользуетесь.
Ошибка 1: выбирать по числу возможностей
Почему так нельзя: инструмент может иметь собственные механизмы работы с базой и пользователями, хотя проект получает эти данные из существующей системы. Подключение лишних функций добавит настроек и работы при обновлении.
Как не ошибиться: пройдите два основных сценария приложения. У каждой используемой возможности должно быть конкретное место в этом разборе.
Ошибка 2: привязать все правила продукта к запросу
Почему так нельзя: если правила публикации книги целиком записаны внутри обработчика страницы, их трудно использовать в импорте или в другом интерфейсе. Для проверки приходится воспроизводить детали веб-запроса.
Как не ошибиться: выделите решение о публикации в обычную функцию или модуль приложения. Оставьте обработчику чтение запроса и формирование ответа.
Есть и ошибка масштаба. Увидев знакомое название, команда берёт пример из большой системы и переносит структуру в маленький проект целиком. В примере может быть отдельный набор файлов для десятков команд, хотя у вас одна. Рабочая структура проекта может меняться по мере роста. В первый день достаточно уметь проследить основной сценарий и найти место следующего изменения.
Вывод
Фреймворк даёт готовый порядок работы части приложения и места для подключения своего кода. Для каталога это можно увидеть на любом запросе: маршрут приводит к обработчику, а обработчик решает, что вернётся в ответе. При выборе проверьте, какую часть работы вы хотите поручить каркасу. Начните с одного сценария, который нужен пользователю. Если пока путаются запросы, интерфейс и сервер, закрепите различия тестом.