Шаблон Nano ASP.NET для SaaS
Учетные данные администратора (для всех арендаторов): admin@email.com / Password123!
Пример данных обнуляется каждый час
Контакты
Шаблон Nano ASP.NET для SaaS
Общие сведения
.Решение на платформе .NET
Vue UI
Пользовательский интерфейс React
Страницы Razor
Страницы Razor

Обзор проекта «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 подробнее.

Основные различия между конфигурациями SPA и Razor Pages в Nano заключаются в интерфейсе пользователя, построенном на основе страниц, и в механизме аутентификации.

Маршрутизация Razor Pages регистрируется в конфигурации запуска приложения с помощью MapRazorPages(). ASP.NET Core обнаруживает страницы Razor в папке Страницы каталог и настраивает маршруты в соответствии со структурой файлов и папок на странице, при этом правила формирования маршрутов и атрибуты можно настраивать по своему усмотрению.

Как правило, на каждой странице имеется два файла:

  • .cshtml — определяет HTML-разметку страницы с использованием синтаксиса Razor.
  • .cshtml.cs — содержит соответствующие PageModel класс и серверная логика страницы.

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

В настройках 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 организует свои статические ресурсы, таблицы стилей и тему интерфейса.