ASP.NET MVC Урок 1. Начало
Цель урока: Изучить Global.asax и поведение запуска веб-приложения, обработки веб-запроса. Изучение Nuget и Подключение протоколирования.
Начало
Создадим приложение ASP.NET MVC 4 Web Application «Lesson1» (рис 1.):
Не будем запускать приложение, а сразу установим (если до этого не сделали) NuGet расширение:
NuGet Package Manager – это расширение для Visual Studio, которое позволяет добавлять в существующие проекты модули, которые значительно упрощают работу. При создании «Basic» asp.net mvc4 приложения в само приложение было добавлено изначально много модулей. Их список мы можем найти, кликнув в Manage NuGet Packages… в контекстном меню проекта:
Для метода (действия) Index добавим View и выберем
Views/Shared/_Layout.cshtml в качестве layout (типа master page):
Собственно, можем запускать.
Всё что мы увидим – это:
Почему контроллер надо было назвать именно Home и как это работает, мы будем изучать более подробно в следующих уроках.
Global.asax
А сейчас обратим внимание на файл Global.asax:
Класс MvcApplication наследует HttpApplication и содержит инструкции для инициализации приложения. Есть еще несколько событий, на которые можно добавить код. Рассмотрим их:
Package Manager Console
В NuGet есть консоль для выполнения команд по установке\удалению\поиску модулей, и других вещей, типа скаффолдинга.
Для вывода всех установленных модулей пишем:
Для получения всех доступных к установке модулей:
Для получения всех доступных модулей с названием NLog
Для установки модуля NLog необходимо вначале выбрать проект (если их в солюшене больше одного) и ввести команду:
Файлы копируются в проект, добавляются ссылки на сборки и web.config может быть обновлен.
Для удаления из проекта модуля необходимо, чтобы он не был связан с другими модулями. Удаляем так:
После установки пользуемся документацией на NLog (https://github.com/nlog/nlog/wiki/Tutorial) и добавляем в Web.config:
Мы ее потом исправим. Добавим в код (Global.asax.cs):
Запустим и завершим приложение (Stop). Откроем файл C://file.txt. Мы увидим, какие события происходили.
WebActivator
WebActivator – это модуль, который позволяет запустить код до самого первого старта App_Start. Это может быть необходимо для того, чтобы, к примеру, создать тестовую БД перед запуском.
Установим:
Добавим класс в App_Start папку:
В файле логов увидим, что строка Application PreStart исполняется раньше Application Start:
Создадим четыре файла отдельно для trace (трассировки), debug (отладки), info (информации), error (ошибки). Определим место записи: /Contents/logs/[текущая дата] Перепишем конфигурацию:
Log2Console
Для NLog есть еще классная программа Log2Console, которая позволяет получать логи прямо в окне программы.
Запускаем программу и настраиваем приемщик:
Обзор ASP.NET
ASP.NET — бесплатная интернет-платформа для создания замечательных веб-сайтов и веб-приложений с помощью HTML, CSS и JavaScript. Также можно создавать веб-API и использовать технологии реального времени, такие как веб-сокеты.
Начало работы
Установите Visual Studio 2019 Community Edition — бесплатную интегрированную среду разработки для ASP.NET в Windows.
Сайты и веб-приложения
ASP.NET предоставляет три платформы для создания веб-приложений: веб-формы, ASP.NET MVC и веб-страницы ASP.NET. Все три платформы стабильны и полноценны: замечательные веб-приложения можно создать с помощью любой из них. Независимо от того, какую платформу выберете, вы везде получите все преимущества и возможности ASP.NET.
Каждая платформа предназначена для определенного стиля разработки. Ваш выбор зависит от сочетания навыков программирования (знаний, опыта разработки), типа создаваемого приложения и удобного вам подхода к разработке.
Ниже приведен обзор каждой из платформ и некоторые идеи о выборе между ними. Если вы предпочитаете введение в видео, см. статью создание веб- сайтов с помощью ASP.NET и что такое Web Tools?
Веб-формы
С веб-формами ASP.NET можно создавать динамические веб-сайты, используя знакомую модель перетаскивания, управляемую событиями. Область конструирования и сотни элементов управления и компонентов позволяют быстро создавать комплексные сайты с эффективным пользовательским интерфейсом и доступом к данным.
ASP.NET MVC предлагает эффективный, основанный на шаблонах способ создания динамических веб-сайтов, который позволяет четко разделять проблемы и дает полный контроль над разметкой для увлекательных и гибких разработок. ASP.NET MVC содержит множество функций, позволяющих вести быструю TDD-совместимую разработку для создания сложных приложений, использующих новейшие веб-стандарты.
Веб-страницы ASP.NET
Веб-страницы ASP.NET и синтаксис Razor обеспечивают быстрый, понятный и простой способ объединения серверного кода с HTML для создания динамического веб-содержимого. Подключайтесь к базам данных, добавляйте видео, ссылки на сайты социальных сетей и множество других дополнительных функций, чтобы создавать прекрасные сайты, которые соответствуют новейшим веб-стандартам.
Примечания о веб-формах, MVC и веб-страницах
Кроме того, эти три платформы не полностью независимы друг от друга и выбор одной из них не препятствует использованию другой. Так как платформы могут сосуществовать в одном и том же веб-приложении, некоторые компоненты приложений, написанные с помощью разных платформ, встречаются нечасто. Например, клиентские части приложения могут быть разработаны в MVC для оптимизации разметки, тогда как доступ к данным и административные части разрабатываются в веб-формах для использования преимуществ элементов управления данными и простого доступа к данным.
Веб-API
Технологии в реальном времени
ASP.NET SignalR — это новая библиотека для разработчиков ASP.NET, которая упрощает разработку веб-функций в режиме реального времени. SignalR обеспечивает двунаправленную связь между сервером и клиентом. Серверы могут мгновенно отправлять содержимое подключенным клиентам по мере доступности. SignalR поддерживает веб-сокеты и обращается к другим совместимым методам для старых браузеров. SignalR включает API для управления подключениями (например, события подключения и отключения), группирования соединений и авторизации.
Мобильные приложения и сайты
ASP.NET может работать с собственными мобильными приложениями с помощью серверной части веб-API, а также мобильных веб-сайтов, использующих такие платформы разработки, как начальная загрузка Twitter. При создании собственного мобильного приложения можно легко создать веб-API на основе JSON для управления доступом к данным, проверкой подлинности и Push-уведомлениями для приложения. Если вы создаете реагирующий мобильный сайт, вы можете использовать любую платформу CSS или открытую систему сетки или выбрать мощную мобильную систему, например jQuery Mobile или Sencha, а также замечательные мобильные приложения с PhoneGap.
Одностраничные приложения
Одностраничные приложения ASP.NET (SPA) позволяют создавать приложения, включающие значительное взаимодействие на стороне клиента, с использованием HTML 5, CSS 3 и JavaScript. Visual Studio включает шаблон для создания одностраничных приложений с помощью knockout.js и веб-API ASP.NET. Помимо встроенного шаблона SPA-шаблоны, созданные сообществом разработчиков, также доступны для загрузки.
Веб-перехватчики
Веб-перехватчик — это упрощенный HTTP-шаблон, обеспечивающий простую модель подписки для связи друг с другом веб-API и SaaS-служб. Когда в службе происходит событие, зарегистрированным подписчикам отправляется уведомление в форме POST HTTP-запроса. Запрос POST содержит сведения о событии, благодаря чему получатель может выполнить соответствующие действия.
Веб-перехватчики используются в большом количестве служб, включая Dropbox, GitHub, Instagram, MailChimp, PayPal, Slack, Trello и многих других. Например, веб-перехватчик может указывать, что файл был изменен в Dropbox, изменение кода зафиксировано в GitHub, платеж был инициализирован в PayPal или была создана карточка в Trello.
чтобы установить клиентскую библиотеку, в окне консоли диспетчер пакетов выполните следующую команду:
Чтобы установить клиентскую библиотеку, выполните в командной оболочке следующую команду:
Подключение в центр
Обработано потерянное подключение
Автоматическое повторное подключение
Без каких бы то ни было параметров, WithAutomaticReconnect() настраивает клиент на ожидание 0, 2, 10 и 30 секунд соответственно, прежде чем пытаться выполнить каждую попытку повторного подключения, останавливая после четырех неудачных попыток.
Перед запуском всех попыток повторного подключения компонент HubConnection переходит в HubConnectionState.Reconnecting состояние и запускает Reconnecting событие. Это дает возможность предупредить пользователей о потере подключения и отключении элементов пользовательского интерфейса. Неинтерактивные приложения могут запускать постановку в очередь или удалять сообщения.
Если клиент успешно повторно подключится в течение первых четырех попыток, компонент HubConnection вернется в Connected состояние и начнет Reconnected событие. Это дает возможность информировать пользователей о том, что подключение было восстановлено, и выводит сообщения из очереди.
Так как соединение выглядит совершенно только для сервера, для ConnectionId Reconnected обработчиков событий будет предоставлен новый.
Reconnected Параметр обработчика событий connectionId будет иметь значение null, если HubConnection был настроен на пропуск согласования.
WithAutomaticReconnect() не настраивается HubConnection для повтора начальных сбоев запуска, поэтому ошибки запуска должны быть обработаны вручную:
Если клиент не будет успешно подключаться в течение первых четырех попыток, компонент HubConnection перейдет в Disconnected состояние и запустит Closed событие. Это дает возможность попытаться вручную перезапустить подключение или сообщить пользователям, что подключение было безвозвратно утрачено.
Чтобы настроить настраиваемое число попыток повторного подключения перед отключением или изменением времени повторного подключения, WithAutomaticReconnect принимает массив чисел, представляющих задержку в миллисекундах, прежде чем начинать каждую попытку повторного подключения.
В предыдущем примере настраивается HubConnection для запуска попытки повторного подключения сразу после потери соединения. Это также справедливо для конфигурации по умолчанию.
Если первая попытка повторного подключения завершается неудачно, вторая попытка повторного подключения также начнется немедленно, а не подождать 2 секунды, как в конфигурации по умолчанию.
Если вторая попытка повторного подключения завершается неудачно, третья попытка повторного подключения начнется через 10 секунд, что опять же, как и конфигурация по умолчанию.
Затем пользовательское поведение снова рассходится от поведения по умолчанию, останавливаясь после третьего сбоя попытки повторного подключения. В конфигурации по умолчанию будет предпринята еще одна повторная попытки подключения через 30 секунд.
NextRetryDelay должен возвращать значение TimeSpan, представляющее время ожидания перед следующей попыткой повторного подключения или null HubConnection отмене повторного подключения.
Кроме того, можно написать код, который будет повторно подключаться к клиенту вручную, как показано в подсоединении вручную.
Повторное подключение вручную
Используйте Closed событие для реагирования на потерянное подключение. Например, может потребоваться автоматизировать повторное подключение.
Основная причина поддержки асинхронности заключается в том, что вы можете перезапустить подключение. Запуск соединения является асинхронным действием.
В Closed обработчике, который перезапускает подключение, рассмотрите возможность ожидания некоторой случайной задержки, чтобы предотвратить перегрузку сервера, как показано в следующем примере:
Методы концентратора вызовов от клиента
Вызов методов клиента из концентратора
Определите методы, которые концентратор вызывает с помощью connection.On после сборки, но перед запуском соединения.
Приведенный выше код connection.On выполняется, когда код на стороне сервера вызывает его с помощью SendAsync метода.
Хотя сторона концентратора подключения поддерживает строго типизированный обмен сообщениями, клиент должен зарегистрировать с помощью универсального метода HubConnection.On с именем метода. Пример см. в разделе ASP.NET Core узла SignalR в фоновых службах.
Обработка ошибок и ведение журнала
Обрабатывайте ошибки с помощью оператора try-catch. Проверьте Exception объект, чтобы определить необходимые действия после возникновения ошибки.
Эта документация не относится к последней версии SignalR. Ознакомьтесь с ASP.NET Core SignalR.
API концентраторов SignalR позволяет выполнять удаленные вызовы процедур (RPC) с сервера на подключенные клиенты и с клиентов на сервер. В серверном коде определяются методы, которые могут вызываться клиентами, и вызываются методы, которые выполняются на клиенте. В клиентском коде определяются методы, которые могут быть вызваны с сервера, а также вызываются методы, которые выполняются на сервере. Этот механизм отвечает за все клиентские коммуникации.
SignalR также предлагает интерфейс API более низкого уровня, называемый постоянными подключениями. Общие сведения о SignalR, концентраторах и постоянных подключениях, а также руководство, в котором показано, как создать полноценное приложение SignalR, см. в разделе SignalR-начало работы.
Версии программного обеспечения, используемые в этом разделе
Предыдущие версии этого раздела
Сведения о более ранних версиях SignalR см. в статье о старых версияхSignalR.
Вопросы и комментарии
Оставьте отзыв о том, как вы понравится вам в этом учебнике, и что можно улучшить в комментариях в нижней части страницы. Если у вас есть вопросы, не связанные непосредственно с этим руководством, их можно опубликовать на форуме ASP.NET SignalR или StackOverflow.com.
Обзор
Этот документ содержит следующие разделы.
Документацию по программированию клиентов сервера или JavaScript см. в следующих ресурсах:
Настройка клиента
Если версия SignalR, установленная на клиенте, отличается от версии на сервере, то SignalR часто может адаптироваться к разнице. Например, сервер, на котором работает SignalR версии 2, будет поддерживать клиенты, на которых установлена версия 1.1. x, а также клиенты с установленной версией 2. Если разница между версией на сервере и версией на клиенте слишком велика или если Клиент новее, чем сервер, SignalR выдает InvalidOperationException исключение, когда клиент пытается установить соединение. Сообщение об ошибке: » You are using a version of the client that isn’t compatible with the server. Client version X.X, server version X.X «.
Как установить соединение
Прежде чем установить соединение, необходимо создать HubConnection объект и создать прокси-сервер. Чтобы установить соединение, вызовите Start метод для HubConnection объекта.
В примере кода для подключения к службе SignalR используется URL-адрес по умолчанию «/SignalR». Сведения о том, как указать другой базовый URL-адрес, см. в разделе ASP.NET SignalR Hub API Guide-Server-URL-адрес/SignalR.
Междоменные соединения от клиентов Silverlight
Сведения о том, как включить междоменные подключения от клиентов Silverlight, см. в разделе обеспечение доступности службы через границы домена.
Настройка подключения
Прежде чем устанавливать соединение, можно указать любой из следующих параметров.
Установка максимального числа одновременных подключений в клиентах WPF
В клиентах WPF может потребоваться увеличить максимальное число одновременных подключений со значением по умолчанию 2. Рекомендуемое значение — 10.
Указание параметров строки запроса
Если требуется отправлять данные на сервер при подключении клиента, можно добавить параметры строки запроса в объект соединения. В следующем примере показано, как задать параметр строки запроса в клиентском коде.
В следующем примере показано, как считать параметр строки запроса в серверном коде.
Как указать метод перевозки
В рамках процесса подключения клиент SignalR обычно согласовывается с сервером для определения наилучшего транспорта, поддерживаемого как сервером, так и клиентом. Если вы уже уверены, какой транспорт вы хотите использовать, можно обойти этот процесс согласования. Чтобы указать транспортный метод, передайте объект транспорта в метод Start. В следующем примере показано, как указать метод перевозки в клиентском коде.
Пространство имен Microsoft. AspNet. SignalR. Client. Transports содержит следующие классы, которые можно использовать для указания транспорта.
Транспорт Фореверфраме не включен в этот список, так как он используется только браузерами.
Сведения о том, как проверить транспортный метод в коде сервера, см. в разделе ASP.NET SignalR Hub API Guide-Server-как получить сведения о клиенте из свойства Context. Дополнительные сведения о транспортировках и резервных запасах см. в статье Введение в SignalR-транспорты и резервные стратегии.
Как указать заголовки HTTP
Чтобы задать заголовки HTTP, используйте Headers свойство объекта соединения. В следующем примере показано, как добавить заголовок HTTP.
Как указать сертификаты клиента
Чтобы добавить сертификаты клиента, используйте AddClientCertificate метод для объекта соединения.
Создание прокси-сервера концентратора
Чтобы определить методы клиента, которые концентратор может вызывать с сервера, и вызывать методы в концентраторе на сервере, создайте прокси-сервер для концентратора, вызвав CreateHubProxy для объекта Connection. Строка, в которую передается значение, CreateHubProxy является именем класса HUB или именем, заданным в HubName атрибуте, если оно было использовано на сервере. Сопоставление имен не зависит от регистра.
Класс Hub на сервере
Создание прокси клиента для класса HUB
Если класс Hub дополнить HubName атрибутом, используйте это имя.
Класс Hub на сервере
Создание прокси клиента для класса HUB
Определение методов на клиенте, который может вызывать сервер
Чтобы определить метод, который может вызывать сервер, используйте метод прокси-сервера On для регистрации обработчика событий.
Методы без параметров
Если обрабатываемый метод не имеет параметров, используйте неуниверсальную перегрузку On метода:
Код сервера, вызывающий клиентский метод без параметров
Клиентский код WinRT для метода, вызываемого с сервера без параметров (см. примеры WPF и Silverlight далее в этом разделе)
Методы с параметрами, указание типов параметров
Если обрабатываемый метод имеет параметры, укажите типы параметров в качестве универсальных типов On метода. Существуют универсальные перегрузки метода, позволяющие On указать до 8 параметров (4 в Windows Phone 7). В следующем примере один параметр отправляется в UpdateStockPrice метод.
Серверный код, вызывающий клиентский метод с параметром
Класс акции, используемый для параметра
Клиентский код WinRT для метода, вызываемого с сервера с параметром (см. примеры WPF и Silverlight далее в этом разделе)
Методы с параметрами, указание динамических объектов для параметров
В качестве альтернативы указанию параметров в качестве универсальных типов On метода можно указать параметры в виде динамических объектов:
Серверный код, вызывающий клиентский метод с параметром
Класс акции, используемый для параметра
Клиентский код WinRT для метода, вызываемого с сервера с параметром, с использованием динамического объекта для параметра (см. примеры WPF и Silverlight далее в этом разделе)
Удаление обработчика
Чтобы удалить обработчик, вызовите его Dispose метод.
Клиентский код для метода, вызываемого с сервера
Код клиента для удаления обработчика
Вызов методов сервера из клиента
Чтобы вызвать метод на сервере, используйте Invoke метод для прокси-сервера концентратора.
Если метод сервера не имеет возвращаемого значения, используйте неуниверсальную перегрузку Invoke метода.
Серверный код для метода, не имеющего возвращаемого значения
Клиентский код, вызывающий метод, не имеющий возвращаемого значения
Если метод сервера имеет возвращаемое значение, укажите тип возвращаемого значения в качестве универсального типа Invoke метода.
Серверный код для метода, который имеет возвращаемое значение и принимает параметр сложного типа
Класс акции, используемый для параметра и возвращаемого значения
Клиентский код, вызывающий метод с возвращаемым значением и принимающий параметр сложного типа в асинхронном методе ASP.NET 4,5
Клиентский код, вызывающий метод с возвращаемым значением и принимающий параметр сложного типа в синхронном методе
Как работать с событиями времени жизни соединения
SignalR предоставляет следующие события времени жизни подключения, которые можно выполнять:
Например, если вы хотите отображать предупреждающие сообщения об ошибках, которые не являются критическими, но вызывают периодически возникающих проблем с подключением, например медленная работа или частым удалением соединения, обработайте ConnectionSlow событие.
Как обрабатывались ошибки
Если на сервере явно не включены подробные сообщения об ошибках, то объект исключения, возвращаемый SignalR после ошибки, содержит минимальные сведения об ошибке. Например, если вызов newContosoChatMessage завершается ошибкой, сообщение об ошибке в объекте Error содержит » There was an error invoking Hub method ‘contosoChatHub.newContosoChatMessage’. » Отправка подробных сообщений об ошибках клиентам в рабочей среде не рекомендуется по соображениям безопасности, но если вы хотите включить подробные сообщения об ошибках для устранения неполадок, используйте следующий код на сервере.
Для обработки ошибок, вызванных SignalR, можно добавить обработчик для Error события в объекте соединения.
Чтобы обрабатывались ошибки вызовов методов, заключите код в блок try-catch.
Как включить ведение журнала на стороне клиента
Чтобы включить ведение журнала на стороне клиента, задайте TraceLevel TraceWriter Свойства и для объекта соединения.
Примеры кода приложений WPF, Silverlight и консольного приложения для клиентских методов, которые может вызывать сервер
Примеры кода, показанные выше, для определения клиентских методов, которые сервер может вызывать для клиентов WinRT. В следующих примерах показан эквивалентный код для клиентов WPF, Silverlight и консольных приложений.
Методы без параметров
Клиентский код WPF для метода, вызываемого с сервера без параметров
Клиентский код Silverlight для метода, вызываемого с сервера без параметров
Код клиента консольного приложения для метода, вызываемого с сервера без параметров
Методы с параметрами, указание типов параметров
Клиентский код WPF для метода, вызываемого с сервера с параметром
Клиентский код Silverlight для метода, вызываемого с сервера с параметром
Код клиента консольного приложения для метода, вызываемого с сервера с параметром
Методы с параметрами, указание динамических объектов для параметров
Клиентский код WPF для метода, вызываемого с сервера с параметром, с использованием динамического объекта для параметра
Клиентский код Silverlight для метода, вызываемого с сервера с параметром, с использованием динамического объекта для параметра
Код клиента консольного приложения для метода, вызываемого с сервера с параметром, с использованием динамического объекта для параметра
