Обзор проекта «Razor Pages (MVC)»
Страницы Razor — это фреймворк, ориентированный на страницы, для создания веб-приложений с серверной прорисовкой на базе ASP.NET Core. Подобно шаблону «Модель-Представление-Контроллер» (MVC), он обеспечивает разделение прикладной логики и представления. Однако в Razor Pages код организован вокруг отдельных страниц, каждая из которых, как правило, состоит из .cshtml файл и связанный с ним файл кода PageModel.
Razor Pages — это практичный выбор, если вам нужен HTML, прорисовываемый на сервере, простая система маршрутизации и интегрированная среда разработки на ASP.NET Core без необходимости создания отдельного одностраничного приложения (SPA).
Обзор
Nano’s RazorApp Проект представляет собой веб-приложение на базе ASP.NET Core, которое использует тот же код домена, приложения и инфраструктуры, что и WebAPI проекта. Обе конфигурации используют одну и ту же основную бизнес-логику и бэкенд-сервисы, но различаются по способу представления пользовательского интерфейса и реализации аутентификации.
Чтобы ознакомиться с общими сведениями об общей архитектуре, начните с Руководство по Web API в ASP.NET Core а также обзор решения .NET.
В данном руководстве основное внимание уделяется различиям между интерфейсом Razor Pages в Nano и его конфигурацией SPA, в которой используется WebAPI в качестве презентационного слоя для отдельного фронтенда на React или Vue.
Этот RazorApp Проект также может отображать в IDE отсутствующие зависимости для разработки интерфейса. Эти зависимости используются для настройки и пересборки ресурсов темы; они могут не требоваться для простого запуска приложения. См. Руководство по теме и стилизации Razor подробнее.
Отличия от WebAPI
Основные различия между конфигурациями SPA и Razor Pages в Nano заключаются в интерфейсе пользователя, построенном на основе страниц, и в механизме аутентификации.
Карта Razor Pages
Маршрутизация Razor Pages регистрируется в конфигурации запуска приложения с помощью MapRazorPages(). ASP.NET Core обнаруживает страницы Razor в папке Страницы каталог и настраивает маршруты в соответствии со структурой файлов и папок на странице, при этом правила формирования маршрутов и атрибуты можно настраивать по своему усмотрению.
Как правило, на каждой странице имеется два файла:
.cshtml— определяет HTML-разметку страницы с использованием синтаксиса Razor..cshtml.cs— содержит соответствующиеPageModelкласс и серверная логика страницы.
Такая структура позволяет объединить разметку и логику, специфичную для конкретной страницы, при этом общие сервисы приложения и бизнес-логика остаются в других проектах.
Аутентификация с использованием файлов cookie
В настройках Razor Pages в Nano используется аутентификация с использованием файлов cookie благодаря интерфейсу пользователя, отображаемому на стороне сервера, вместо использования токенов JWT типа «bearer» в качестве основного механизма аутентификации для клиентской части.
Основные различия заключаются в следующем:
Настройки файлов cookie: В RazorApp проекта Расширения ServiceCollection, настройки аутентификации с помощью файлов cookie заменяют конфигурацию аутентификации JWT, используемую в настройках, ориентированных на SPA.
Текущий арендатор и пользователь: Этот CurrentTenantUserService получает идентификационные данные и претензии текущего пользователя из субъекта аутентифицированного запроса, который определяется посредством аутентификации с использованием файлов cookie. В конфигурации с несколькими арендаторами контекст арендатора также должен определяться в соответствии с логикой определения арендаторов Nano.
Служба входа в систему: В конфигурации RazorApp используется служба авторизации, построенная на основе ASP.NET Core Identity’s SignInManager. Когда пользователь успешно входит в систему, приложение устанавливает сеанс аутентификации с помощью файла cookie. Браузер отправляет этот файл cookie вместе с последующими запросами, что позволяет ASP.NET Core идентифицировать аутентифицированного пользователя.
Это заменяет стандартный процесс входа в систему SPA, при котором интерфейс получает токены и управляет ими через TokenService в Инфраструктура/Аутентификация.
Структура страниц
Пользовательский интерфейс Nano’s Razor Pages организует разметку и логику, относящиеся к конкретной странице, в рамках Страницы каталог. Маршруты, как правило, соответствуют структуре папок и файлов, а общие макеты и частичные представления обеспечивают использование стандартных элементов пользовательского интерфейса.
Макет
Основной Макет Вид определяет общую структуру страницы приложения, включая боковую панель навигации, верхнюю панель навигации, нижний колонтитул, а также ссылки на CSS- и JavaScript-ресурсы.
Для сторонних компонентов пользовательского интерфейса, таких как диаграммы, ползунки диапазона и таблицы данных, могут потребоваться собственные файлы CSS и JavaScript. Nano группирует ресурсы сторонних разработчиков в следующих папках:
wwwroot/assets/vendor
При добавлении нового пакета или компонента интерфейса включите необходимые ресурсы и, в зависимости от ситуации, укажите ссылки на них в макете или на соответствующей странице. Старайтесь не загружать одни и те же ресурсы глобально, если они требуются только на определённых страницах.
Nano также включает в себя Макет для гостей для общедоступных страниц, таких как страница входа в систему и восстановления пароля, которые не используют основной макет приложения с аутентификацией.
Страницы
Страницы приложения сгруппированы в папки по отдельным функциям, в том числе:
АутентификацияПрофильПродукцияПользователиАрендаторы
Каждая страница Razor может иметь файл кода, содержащий её PageModel. Используйте PageModel для подготовки данных, необходимых для первоначального отображения страницы, обработки запросов на страницу и взаимодействия со службами приложения.
DTO и атрибуты валидации можно использовать для определения моделей входных данных и обеспечения валидации. При соответствующей настройке jQuery Unobtrusive Validation может использовать эти правила для обеспечения валидации на стороне клиента наряду с валидацией на стороне сервера.
Хотя Razor Pages выполняет рендеринг HTML на сервере, Nano также использует AJAX-запросы для вызова API-контроллеров при выполнении многих операций CRUD. Это позволяет при выполнении таких действий, как создание, редактирование или удаление записей, обновлять пользовательский интерфейс без необходимости полной перезагрузки страницы.
JavaScript-код для конкретных страниц размещен в следующих папках:
wwwroot/assets/js/pages
Отдельные страницы могут включать необходимые скрипты с помощью Razor Сценарии раздел, который отображается макетом при соответствующей настройке.
Ресурсы шаблонов
Ресурсы шаблонов содержит примеры элементов пользовательского интерфейса, которые можно использовать в качестве отправной точки при разработке приложения. Примеры разделены на две категории:
- Базовый интерфейс пользователя — стандартные компоненты Bootstrap, такие как поля ввода данных, модальные окна и кнопки.
- Расширенный пользовательский интерфейс — компоненты, в которых используются сторонние библиотеки, например диаграммы и ползунки.
В некоторых примерах компоненты содержат код JavaScript непосредственно на странице для демонстрации своей функциональности. При адаптации этих примеров для рабочих функций рекомендуется перенести повторно используемую логику в соответствующие общие или специфичные для страницы файлы JavaScript.
Следующие шаги
Перейти к Руководство по теме и стилю Razor Pages чтобы узнать, как Nano организует свои статические ресурсы, таблицы стилей и тему интерфейса.