Что такое код asp start


Содержание

Файл global.asax

Файл global.asax позволяет записывать обработчики событий, реагирующие на глобальные события. Пользователи не могут запрашивать файл global.asax напрямую. Файл global.asax выполняет свой код автоматически в ответ на некоторые события приложения.

Код в файле global.asax пишется точно так же, как и для веб-формы. Отличие заключается в том, что файл global.asax не содержит дескрипторов HTML или ASP.NET. Вместо этого он содержит методы со специфическими предопределенными именами.

Хотя в показанном коде это не отражено, в каждом файле global.asax определены методы для единственного класса — класса приложения. Класс приложения унаследован от HttpApplication, что позволяет работать в коде со всеми его общедоступными и защищенными членами. В этом примере используется объект Response, который является встроенным свойством класса HttpApplication, точно так же, как и встроенным свойством класса Page.

В предыдущем примере метод Application_OnEndRequest() выводит в нижней части страницы колонтитул с датой и временем ее создания. Поскольку обработчик событий реагирует на событие HttpApplication.EndRequest, метод Application_OnEndRequest() будет выполняться при каждом запросе страницы, сразу же после завершения выполнения всего имеющегося в ней кода обработки событий.

Как и в случае веб-форм, содержимое файла global.asax также можно разнести в два файла: один — с объявлением, а второй — непосредственно с кодом. Однако поскольку поверхности проектирования для файлов global.asax не предусмотрено, в этом нет никакой необходимости, поэтому в Visual Studio и не предлагается опция для создания файла global.asax с классом отделенного кода.

В случае создания веб-приложения как веб-проекта Visual Studio будет применять подход с отделенным кодом и создавать два файла: global.asax (который будет практически пустым) и связанный с ним global.asax.cs (который содержит класс приложения со всеми обработчиками событий). Конечный результат будет точно таким же.

Файл global.asax является необязательным, но каждому веб-приложению разрешено иметь не более одного файла global.asax, который должен находиться в корневом каталоге приложения, а не в каком-то из его подкаталогов. Чтобы добавить файл global.asax в проект, выберите в меню Website (Веб-сайт) (или в меню Project (Проект), если используется модель веб-проекта) пункт Add New Item (Добавить новый элемент) и укажите шаблон Global Application Class (Глобальный класс приложения). (Если в проекте уже присутствует файл global.asax, этот шаблон отображаться не будет.)

При добавлении файла global.asax Visual Studio включает в него пустые обработчики для большинства наиболее распространенных событий приложений, поэтому разработчику остается только поместить свой код в нужные методы.

Стоит отметить, что обработчики событий приложения в файле global.asax присоединяются не так, как обработчики событий обычных элементов управления. Чаще всего для присоединения обработчика событий приложения используется распознаваемое имя метода. Например, если создан защищенный метод по имени Application_OnEndRequest(), то ASP.NET будет автоматически вызывать его при возникновении события HttpApplication.EndRequest. В действительности все зависит от соглашения. Разработчик вполне может решить присоединить обработчик событий к событию HttpApplication.EndRequest, а не предоставлять метод Application_OnEndRequest().

При первой загрузке домена приложения ASP.NET создает пул объектов приложения и использует его для обслуживания каждого запроса. Размер этого пула может варьироваться в зависимости от системы и количества доступных потоков, но обычно включает от 1 до 100 экземпляров. Каждому запросу предоставляется эксклюзивный доступ к одному из этих объектов приложения, а когда обработка запроса завершается, объект становится доступным для повторного использования. По мере прохождения приложением различных стадий обработки ASP.NET вызывает соответствующие методы, которые приводят в действие написанный разработчиком код. Конечно, в случае, если имена методов указаны неправильно, ASP.NET не может вызывать их, и тогда написанный разработчиком код просто игнорируется.

События приложения

В файле global.asax могут обрабатываться события двух следующих типов:

события, которые возникают всегда, для каждого запроса. К числу таких событий относятся события, связанные запросом, и события, связанные с ответом;

события, которые возникают только при определенных условиях.

Обязательные события разворачиваются в описанном ниже порядке:

Application_BeginRequest(). Этот метод вызывается в начале каждого запроса.

Application_AuthenticateRequest(). Этот метод вызывается до того, как будет выполнена аутентификация. Это стартовая точка для создания собственной логики аутентификации.

Application_AuthorizeRequest(). После того как пользователь пройдет процедуру аутентификации (будет идентифицирован), потребуется определить права пользователя. Вы можете использовать этот метод для назначения специальных привилегий.

Application_ResolveRequestCache(). Этот метод обычно используется вместе с кэшированием выходных данных. При кэшировании выходных данных повторно используется сгенерированный HTML-код веб-формы, без выполнения какого-то вашего кода. Однако этот обработчик события по-прежнему продолжает работать.

На этом этапе запрос передается соответствующему обработчику. Например, в случае запроса веб-формы на этом этапе выполняется компиляция страницы (если в этом есть необходимость) и создается ее экземпляр.

Application_AcquireRequestState(). Этот метод вызывается непосредственно перед тем, как касающаяся сеанса информация будет извлечена для клиента и использована для заполнения коллекции Session.

Application_PreRequestHandlerExecute(). Этот метод вызывается перед тем, как соответствующий обработчик HTML выполнит запрос.

В этот момент производится обработка запроса соответствующим обработчиком. Например, если это запрос веб-формы, то выполняется код обработки события для страницы, и для страницы генерируется HTML-код.

Application_PostRequestHandlerExecute(). Этот метод вызывается сразу после того, как будет обработан запрос.

Application_ReleaseRequestState(). Этот метод вызывается тогда, когда информация, специфическая для сеанса, сериализируется из коллекции Session, чтобы стать доступной для следующего запроса.

Application_UpdateRequestCache(). Этот метод вызывается перед добавлением информации в кэш выходных данных. Например, если вы включили кэширование выходных данных для веб-страницы, то ASP.NET в этот момент поместит сгенерированный HTML-код страницы в кэш.

ApplicationEndRequest(). Этот метод вызывается в конце запроса перед тем, как объекты будут освобождены и восстановлены. Это подходящая точка для кода очистки.

На рисунке показан процесс обработки одного запроса:

Некоторые события срабатывают не при каждом запросе:

Application_Start()

Этот метод вызывается, когда впервые запускается приложение и создается домен приложения. В данный обработчик события удобно помещать код инициализации всего приложения. Например, в этот момент можно загрузить и кэшировать данные, которые не будут изменяться в течение времени жизни приложения; к ним можно отнести деревья навигации, статические каталоги товаров и т.п.

Session_Start()

Этот метод вызывается каждый раз, когда начинается новый сеанс. Он часто применяется для инициализации информации, специфичной для пользователя.

Application_Error()

Этот метод вызывается всякий раз, когда в приложении возникает необработанное событие.

Session_End()

Этот метод вызывается всякий раз, когда сеанс пользователя завершается. Сеанс завершается, когда код явно освобождает его или когда истекает срок его действия из-за отсутствия запросов на протяжении указанного периода времени (обычно 20 минут). Как правило, этот метод применяется для очистки любых связанных с сеансом данных. Однако вызывается этот метод только в том случае, если используется внутрипроцессный режим хранения состояния сеансов (режим InProc, а не StateServer или SQLServer).

Application_End()

Этот метод вызывается сразу после завершения работы приложения. Завершение работы приложения может произойти либо по причине перезапуска IIS, либо вследствие перехода приложения в новый домен приложения в ответ на обновление файлов или параметров настроек повторного использования процесса.

Application_Disposed()

Этот метод вызывается спустя какое-то время после завершения работы приложения, когда сборщик мусора .NET готов к восстановлению занимаемой приложением памяти. В этот момент уже поздно выполнять критическую очистку, хотя можно в последний раз узнать, были ли освобождены критические ресурсы.

События приложений обычно используются для выполнения инициализации приложения, очистки, регистрации использования, профилирования и поиска и устранения неисправностей. Однако не следует думать, что приложению обязательно нужны глобальные события приложения. Многие приложения ASP.NET вообще не используют файл global.asax.

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

Демонстрация событий приложения

В следующем веб-приложении используется файл global.asax, который реагирует на событие HttpApplication.Error. Он перехватывает ошибку и отображает некоторую информацию в предопределенном формате:

Чтобы протестировать этот обработчик событий приложения, понадобится создать еще одну веб-страницу, вызывающую ошибку. Ниже показан пример, который генерирует ошибку при попытке выполнить во время загрузки страницы операцию деления на ноль:

Запросив эту страницу, вы увидите следующий результат:

Обычно вы не будете использовать метод ApplicationError(), поскольку он не обладает достаточной гибкостью для работы с различными типами ошибок (если только не предусмотреть большой объем условного кода). Конфигурировать страницы специальных ошибок можно с использованием IIS. Однако метод ApplicationError() может оказаться чрезвычайно полезным, если вы захотите зарегистрировать ошибку, чтобы исследовать ее в будущем или даже отправить администратору системы электронное письмо с уведомлением о ней. В действительности, во многих случаях вам понадобятся именно эти технологии, поскольку объект Response не будет доступен. Двумя такими примерами являются методы Application_Start() и Application_End().

ASP — Управление сеансами

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

В ASP обеспечено уникальное решение вопроса управления данными сеанса. Используя объект ASP Session (сеанс) и особый код пользователя, который автоматически формируется сервером, можно создавать «умные» приложения, которые будут автоматически узнавать каждого посетителя узла и собирать необходимые сведения о его предпочтениях или выбираемых им вариантах.

Важно! Код пользователя назначается в ASP посредством HTTP-модуля настройки, небольшого по объему файла, который сохраняется в обозревателе пользователя. Таким образом, при создании приложений для работы с программами обозревателя, в которых описанные модули настройки не поддерживаются или отключены пользователем, средства управления сеансами ASP задействовать не следует.

Начало и завершение сеансов

Существует четыре варианта начала сеанса.

  • Новый пользователь запрашивает адрес URL, который указывает на файл «.asp» в приложении, а файл Global.asa для данного приложения содержит процедуру Session_OnStart.
  • Пользователь сохраняет значение в объекте Session.
  • Новый сеанс запускается автоматически при получении сервером запроса без требуемого модуля настройки SessionID.
  • Пользователь в приложении запрашивает файл «.asp», а в файле приложения Global.asa при создании экземпляра объекта с областью действия на уровне сеанса используется тег . Дополнительные сведения о создании экземпляра объекта с помощью тега можно найти в разделе Использование компонентов и объектов.

Сеанс автоматически завершается, если пользователь в приложении не запросил или не обновил страницу в течение определенного периода времени. По умолчанию этот период составляет 20 минут. Используемое по умолчанию значение для приложения можно изменить с помощью свойства Session Timeout (время ожидания сеанса) на листе свойств Параметры приложения в оснастке IIS. Это значение должно определяться с учетом потребностей веб-приложения и объема памяти сервера. Так, если ожидается, что посетители будут уделять каждой странице веб-приложения всего несколько минут, установленное по умолчанию время ожидания сеанса можно значительно сократить. Если время ожидания велико, число одновременно открытых сеансов может значительно увеличиться, что отрицательно скажется на свободных ресурсах оперативной памяти сервера.

Уменьшая указанное по умолчанию время ожидания сеанса, можно одновременно задать свойство Timeout (ожидание) для объекта Session (сеанс). Например, в следующем сценарии устанавливается период ожидания продолжительностью в 5 минут.

Кроме того, можно установить период ожидания, который превышает используемое по умолчанию значение, определяемое свойством Session Timeout (время ожидания сеанса).

Примечание. Свойство Timeout (время ожидания) применимо только к сеансам с состояниями. На протяжении сеансов без состояний объект Session (сеанс) не включает в себя статических объектов или содержимого. Подобные сеансы автоматически завершаются после обработки запроса и его последующего возобновления в связи с поступлением нового запроса от того же обозревателя.

Для принудительного завершения сеанса существует метод Abandon (завершение) объекта Session (сеанс). Например, в форму можно поместить кнопку «Выход», а в качестве параметра ACTION указать URL файла «.asp» со следующей командой.

Примечание. Пользовательские запросы, которые были помещены в очередь до запуска команды Session.Abandon, выполняются в контексте завершаемого сеанса. После выполнения команды Session.Abandon вновь поступающие запросы уже не будут связаны с данным сеансом.

О коде сеанса и модулях настройки

При первом поступлении пользовательского запроса на файл «.asp» в данном приложении ASP создает SessionID (код сеанса). Это число рассчитывается по сложному алгоритму и позволяет однозначно определить каждый сеанс пользователя. В начале нового сеанса сервер сохраняет этот код в обозревателе пользователя как файл модуля настройки узла.

Модуль настройки SessionID подобен коду к сейфу: в сеансе взаимодействия пользователя с приложением ASP может сохранять относящиеся к пользователю сведения в специально отведенном месте на сервере. Содержащийся в модуле настройки код сеанса пользователя преобразуется в заголовок HTTP-запроса. Это открывает доступ к сведениям, как открывается сейф после набора правильного шифра замка. Получая запрос на страницу, ASP всегда проверяет код сеанса в заголовке HTTP-запроса.

Сохраненный в обозревателе пользователя код используется ASP на протяжении всего сеанса, даже если пользователь запрашивает другой файл «.asp» или файл «.asp» из другого приложения. Если сеанс принудительно завершается пользователем или оканчивается по истечении периода ожидания, при запросе другого файла «.asp» ASP начинает новый сеанс с тем же кодом. Выделение пользователю нового кода сеанса имеет место только при перезапуске сервера администратором, поскольку это очищает хранящиеся в памяти параметры SessionID, или в результате перезапуска обозревателя на компьютере пользователя.

Использование одного и того же кода сеанса позволяет ASP уменьшить число передаваемых в обозреватель модулей настройки. Кроме того, если было указано, приложению ASP не требуются средства управления сеансом, можно отключить журнал сеанса в ASP и отправку модулей настройки SessionID пользователям.

ASP не отправляет модуль настройки сеанса в следующих случаях.

  • Отключено сохранение сведений о состоянии сеанса в приложении.
  • Страница ASP определена как не сохраняющая сведений о сеансе, то есть содержит тег . Дополнительные сведения см. в разделе Страницы ASP без сеансов.

Следует учитывать, что модули настройки SessionID не предназначены для постоянного наблюдения за работой пользователей на протяжении многократных посещений ими веб-узла. Данные модуля настройки SessionID хранятся в оперативной памяти сервера и легко могут быть потеряны. Чтобы сохранять сведения о посетителях веб-приложения за более продолжительный срок, следует сохранить на компьютере пользователя особый модуль настройки и занести в базу данных сведения, которые дают возможность опознать пользователя впоследствии. Дополнительные сведения см. в разделе Использование модулей настройки «cookie».

Сохранение и удаление данных из объекта Session

Объект Session обеспечивает доступ к динамическому массиву с ассоциативными связями, предназначенному для хранения соответствующих данных. В объекте Session могут храниться как скалярные, так и объектные переменные.

Для сохранения переменной в объекте Session следует присвоить значение поименованной записи объекта Session. Ниже приводится пример команды сохранения двух новых переменных в объекте Session.

Извлечение данных объекта Session осуществляется посредством обращения к соответствующей поименованной записи. Например, для просмотра текущего значения переменной Session(«FirstName») служит следующая команда.

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

В объекте Session можно также сохранить экземпляр объекта, хотя это может сказаться на быстродействии сервера. Для получения дополнительных сведений см. раздел Задание области определения объекта.

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

Семейство Contents объекта Session содержит все хранящиеся переменные сеанса (речь идет о переменных, для сохранения которых не используется тег языка HTML). С помощью метода Remove семейства Contents можно выборочно удалить ссылки на переменные, которые добавлялись при соответствующем состоянии сеанса. Следующий сценарий иллюстрирует применение метода Remove для очистки элемента (в данном случае это сведения о предоставляемых пользователю скидках), из объекта Session.

При необходимости полностью удалить все сохраняемые переменные сеанса можно с помощью метода RemoveAll семейства Contents.

Для метода Remove имеется возможность выбрать удаление элементов по именам или по индексу. В следующем сценарии показан пример циклического перебора значений объекта Session и их удаление по индексу при выполнении заданного условия.

Модуль настройки (файл «cookie») представляет собой опознавательную метку, которая внедряется веб-сервером в обозреватель пользователя. При очередном запросе веб-страницы обозреватель отправляет на сервер полученный ранее модуль настройки. Эта схема позволяет связать сведения о пользователе с конкретным посетителем. Сценарии ASP позволяют получать и устанавливать значения «cookie». Этой цели служат семейства Cookies объектов Response и Request.

Установка значения «cookie» выполняется командой Response.Cookies. Если это значение ранее отсутствовало, команда Response.Cookies создаст новое значение. Так, для отправки обозревателю модуля настройки с именем («VisitorID») и значением («49») можно воспользоваться следующей командой, которая на веб-странице должна располагаться до тега .

Если продолжительность действия модуля настройки должна ограничиваться только текущим сеансом, отправки этого модуля в обозреватель вполне достаточно. Но если стоит задача опознания посетителя даже после перезапуска обозревателя, модуль настройки «cookie» должен быть сохранен обозревателем в виде файла на жестком диске компьютера пользователя. Для сохранения модуля настройки используйте в Response.Cookies атрибут Expires с будущей датой.

Модуль настройки может принимать сразу несколько значений, например индексированный модуль настройки. Индексированному модулю настройки назначается ключ, которому может быть присвоено определенное значение. Пример.

Если существующий модуль настройки уже имеет значения ключа, однако имя ключа в Response.Cookies не определено, значения ключа удаляются. Если же существующий модуль настройки не имеет значений ключа, а Response.Cookies определяет имена и значения ключа, существующее значение «cookie» удаляется. При этом создаются новые пары «ключ-значение».

Для получения значения «cookie» служит семейство Request.Cookies. Например, если HTTP-запрос пользователя задает Visitor >, значение 49 может быть извлечено следующей инструкцией.

Точно так же значение ключа из индексированного модуля настройки может быть получено по имени ключа. Например, обозреватель пользователя отправляет в заголовке HTTP-запроса следующие данные:

Показанная ниже инструкция возвратит значение Travel .

Определение путей в модуле настройки

Все модули настройки, которые сохраняются ASP в обозревателе пользователя, содержат сведения о пути. Запрашивая файл, путь которого указан в модуле настройки, обозреватель автоматически направляет этот модуль на сервер. По умолчанию сохраненные в модуле настройки пути соответствуют имени приложения с файлом «.asp», с помощью которых был создан данный модуль настройки. Так, после создания модуля настройки с помощью файла «.asp», который относится к приложению с именем UserApplication, каждое последующее обращение веб-обозревателя пользователя к любому файлу данного приложения будет сопровождаться отправкой соответствующего модуля настройки. Будут отправляться также все остальные модули настройки, содержащие путь /UserApplication.

Чтобы задать в модуле настройки путь, отличный от используемого по умолчанию пути приложения, можно воспользоваться атрибутом Path семейства ASP Response.Cookies. Например, в следующем сценарии путь SalesApp/Customer/Profiles/ назначается модулю настройки Purchases .

Каждый раз, запрашивая файл из /SalesApp/Customer/Profiles/ (или из находящихся по этому пути каталогов), веб-обозреватель, в котором содержится модуль настройки Purchases , отправляет этот модуль настройки на сервер.

При сохранении пути модуля настройки многие обозреватели, в числе которых Microsoft Internet Explorer (версия 4.0 и более поздние), а также обозреватели Netscape, различают регистр букв. Это означает, что если регистр букв пути, который указывается в запросе, и пути, который был сохранен в модуле настройки, отличается, обозреватель не выполняет отправку модуля настройки на сервер. Например, для ASP, виртуальные каталоги /TRAVEL и /travel одинаковы, однако с точки зрения обозревателя, который различает регистр букв в адресе URL, /TRAVEL и /travel указывают на разные приложения. Поэтому необходимо следить за тем, чтобы все адреса URL для файлов «.asp» задавались в одном регистре. Это гарантирует отправку обозревателем сохраненных модулей настройки на сервер.

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

Однако следует помнить, что независящая от приложения отправка модуля настройки на сервер может привести к снижению уровня безопасности, если модуль настройки содержит данные, доступ к которым должен быть разрешен только в пределах конкретного приложения.

Сохранение сведений о состоянии без помощи модулей настройки

Работу с модулями настройки поддерживают не все обозреватели. Если эта поддержка имеется, она также может быть отключена пользователем. Если требуется обеспечить совместимость приложения с обозревателями, не поддерживающими модули настройки, возможности управления сеансами ASP задействовать не следует.

В этом случае необходимо разработать собственную схему передачи сведений между страницами приложения. Это может быть сделано двумя основными способами.

  • Добавление параметров в строку запроса URL. Пример.

Однако в некоторых обозревателях при передаче формы с использованием метода GET параметры, которые явно передаются в строке запроса могут не обрабатываться.

Добавление в форму скрытых значений. Пусть в следующей HTML-форме присутствует скрытый элемент управления, который не выводится на экран. Эта форма передает значение кода пользователя, а также указанные им сведения с помощью метода HTTP POST.

. Часть 1

Интерфейс к базе данных с помощью ASP

Постановка задачи

Предположим, перед нами стоит задача создания газетного сайта, причем некоторые из его читателей должны иметь право пополнять его новыми статьями, снабжаемыми фотографиями непосредственно с самого сайта и без программирования. Предположим также, что такой сайт должен иметь возможности удаления статей, их поиска, а также сортировки. С первого взгляда может показаться, что решение такой задачи не под силу начинающему программисту ASP, однако, как вы скоро увидите, это далеко не так.

Для начала давайте все-таки разберемся, что же от нас требуется. По сути, необходимо создать базу данных всех статей, подготовить несколько HTML-форм для загрузки статей на сервер, их поиска, сортировки, удаления и, наконец, отображения результата.

Я почти уверен, что подобная задача актуальна применительно практически к любому сайту, тем более что подобным образом (разве что без возможностей поиска, сортировки и удаления) работает большинство гостевых книг (guestbook).

Что нам понадобится

Для реализации вышеизложенной задачи нам потребуется персональный компьютер с Microsoft Windows NT или Windows 2000 (можно и Workstation, и Server), установленный IIS (Internet Information Server), какой-нибудь HTML-редактор (советую использовать Macromedia Dreamweaver), Microsoft Access (версии 95, 97 или 2000) и самый обычный текстовый редактор.

Создание и подготовка базы данных

Прежде всего создадим базу данных статей, для чего:

  • запустим приложение Microsoft Access;
  • любым из известных способов создадим новую базу данных. Назовем ее «Articles»;
  • в созданной базе данных создадим таблицу с именем, например «Articles»;
  • пользуясь инструментом «Конструктор», определим поля нашей таблицы и типы принимаемых ими значений (рис. 1);
  • заполним таблицу несколькими статьями в соответствии с созданными полями (рис. 2);
  • сохраним базу данных в файле «ArticlesDB.mdb».

Далее необходимо прописать нашу базу данных в соответствующем разделе источников данных системы, для этого:

  • запустим программу-конфигуратор источников данных (Data Sources ODBC) — Start->Settings->Control Panel->Administrative Tools->Data Sources ODBC;
  • перейдем во вкладку «System DSN» и создадим новый источник данных, нажав на «Add…»;
  • в появившемся списке драйверов выберем драйвер баз данных Microsoft Access — «Microsoft Access Driver (*.mdb)» и нажмем на «Finish»;
  • в строке «Data Source Name» зададим имя нашей базы данных, например «Articles» (это то имя, по которому мы в дальнейшем будем обращаться к ней);
  • нажмем на «Select…», выберем подготовленный нами файл «ArticlesDB.mdb» и нажмем «OK».

В результате в списке источников данных в вашей системе появится строка, представленная на рис. 3.

Оформляем главную страницу (index.asp)

С ASP работать очень просто. Для этого надо всего лишь вставить текст скрипта ASP в пару тэгов . В остальном ASP-файл ничем не отличается от HTML-файла (за исключением, пожалуй, расширения). Комментарии в HTML, как известно, вставляются в пару тэгов , в ASP же закомментировать строку можно при помощи символа ‘ (апостроф) в ее начале.

Теперь давайте разберемся. Во-первых, как вы наверняка заметили, ASP-код легко сочетается с HTML-тэгами; в этом его достоинство. Так, к примеру, строка Response.Write Link & «
» отображает на экране браузера клиента подготовленное сервером значение переменной Link и HTML-тэг
, то есть перевод строки. Особый интерес вызывает переменная rs. Для искушенных программистов сразу скажу — это указатель. Однако в ASP с целью облегчения работы начинающих указатели маскируются. Здесь не встретишь громоздких С’шных конструкций, типа «я знаю, что ты знаешь, что я знаю», или, выражаясь программистским языком, указатель на указатель… Однако сделано это так искусно, что гибкость программирования при этом не теряется, нет лишь прямой работы с указателями, а только работа с помощью специальных функций, скрывающих от программиста рутину и защищающих указатели от некорректных действий. Таким образом, выражение rs.Fields («Article»).value означает значение поля «Article» текущего значения указателя на элемент базы данных (в нашем случае статей) и содержит текст статьи, которая соответствует текущей позиции указателя на все статьи. Переход к следующему элементу базы (смещение указателя) выполняется с помощью инструкции Rs.MoveNext. В приведенном выше примере это не делается, а попросту формируется ссылка на текст статьи в виде ее названия и отображается комментарий самой первой статьи, соответствующей результату запроса. Давайте попробуем отобразить все статьи нашей базы данных на главной странице в виде HTML. И еще, обратите особое внимание на директиву:

Илон Маск рекомендует:  Что такое код mcal_snooze

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

Первая строчка скрипта шаблона HTML присваивает переменной TheID значение, переданное ссылкой с использованием метода Request.QueryString. Далее открывается база данных, из которой читается статья (запись), соответствующая идентификатору, переданному из главного скрипта (index.asp).

Создаем главную страницу

Таким образом в таблицу в цикле будут добавляться ряды со ссылками на статьи и с аннотациями, пока не будут отображены все статьи из базы данных. Следует обратить внимание на переменную Cnt. По окончании цикла она будет содержать число обработанных статей (рядов таблицы).

Язык структурированных запросов — SQL

Настала пора разобраться с тем, что таится за строчками:

По сути, именно за этими двумя строчками кроется работа с нашей базой данных: первая представляет собой текстовую строку с запросом к базе данных (текстовые строки в ASP записываются в двойных кавычках); вторая — содержит директиву выполнения этого запроса с одновременным присвоением результата переменной (указателю на записи в базе данных). В рамках настоящей статьи мы не будем рассматривать SQL (Structured Query Language) во всех деталях, а остановимся лишь на тех его операторах, без понимания которых дальнейшая работа будет невозможна. Для тех, кому этого покажется недостаточным, советую посетить отобранные мною сайты с детальной документацией по SQL.

Для полноценной работы нам необходимо познакомиться с четырьмя операторами этого мощного языка, предназначенного специально для работы с базами данных.

DELETE удаляет те ряды из «Имя Таблицы», которые удовлетворяют условию, определенному в «Определении», и возвращает число удаленных рядов. Если выполнить команду DELETE без условия WHERE, то все ряды указанной таблицы будут удалены. В этом случае DELETE возвратит 0. Ключевое слово LOW_PRIORITY откладывает выполнение операции DELETE до завершения работы чтения из таблицы других клиентов.

SELECT используется для извлечения рядов (записей) из одной или более таблиц. Выражение_Select определяет столбцы таблицы, значения которых необходимо извлечь. Все ключевые поля должны быть заданы в строгой последовательности. К примеру, выражение HAVING должно следовать за любым выражением GROUP BY и до любого выражения ORDER BY.

Выражение_Select можно заменить псевдонимом (alias) с помощью ключевого слова AS. Псевдоним используется в качестве идентификатора имени столбца и может быть использован наряду с ключевыми словами ORDER BY или HAVING.

Выражение HAVING может относиться к любому столбцу или псевдониму в Выражении_Select. Оно применяется к запросу в последнюю очередь, непосредственно перед посылкой данных клиенту. SELECT . INTO OUTFILE ‘имя_файла’ заносит отобранные записи в файл. Файл создается непосредственно на сервере и не может «уже существовать» (одна из основных причин такого механизма заключается в предотвращении случайного «затирания» различных важных файлов).

INSERT используется для добавления новых записей в существующую таблицу. Допустимо две формы использования INSERT.

Первая форма — INSERT . VALUES — вставляет ряды на основании заданных значений. Вторая форма — INSERT . SELECT — вставляет ряды, выбранные из другой таблицы.

Ключевое слово LOW_PRIORITY откладывает выполнение операции до завершения работы чтения из таблицы других клиентов. Ключевое слово IGNORE в команде INSERT позволяет избегать вставки повторяющихся строк (используется в сочетании с ключевыми словами PRIMARY или UNIQUE). Для второй формы INSERT INTO . SELECT операция не может содержать выражения ORDER BY. Таблица, в которую производится добавление записей, не может присутствовать в выражении FROM части SELECT запроса потому, что запрещено производить выделение из той же самой таблицы, в которую производится вставка.

REPLACE служит для редактирования содержимого таблицы и работает в точности как INSERT, за исключением того, что если старая запись в таблице имеет то же значение, что и записываемая, то старая запись удаляется прежде, чем добавляется новая.

UPDATE обновляет поля существующей таблицы новыми значениями. Выражение SET показывает, какие поля (столбцы) должны быть изменены, и значения, которые должны быть им присвоены. Выражение WHERE, если оно есть, указывает, какие ряды должны быть обновлены. В противном случае операция применяется ко всем рядам таблицы. Ключевое слово LOW_PRIORITY откладывает выполнение операции до завершения работы чтения из таблицы других клиентов. Выражения UPDATE выполняются слева направо.

Обновляет значение поля Password в таблице WAPassword, записывая в поле, чей идентификатор ID равен 1 значение ‘passw’.

Увеличивает значение поля counter таблицы Счетчик на 1.

Удваивает поле age, а затем прибавляет 1 к его значению в таблице persondata.

Что такое Global.asa

Global.asa позволяет выполнять определенные скрипты в начале работы клиентской сессии или при инициализации IIS. Примером тому может служить простейший счетчик числа посещений сайта. Более того, допустимо использовать множественные файлы Global.asa. Однако следует помнить, что ASP-скрипт ищет самый близкий (расположенный в том же каталоге) файл Global.asa и использует именно его.

По сути, этот файл может содержать четыре скрипта: первый будет выполняться при инициализации службы IIS/PWS (Application_OnStart), второй — при остановке службы IIS/PWS (Application_OnEnd) (обычно эти первые два скрипта отрабатывают в процессе перезагрузки компьютера), и еще два скрипта выполняются дополнительно при инициализации сессии пользователя (Session_OnStart) и по ее окончании (Session_OnEnd). Данная схема очень сильно напоминает пары «конструктор-деструктор». Неспроста всякая переменная, которая должна быть использована (например, в текущей сессии), может быть инициализирована в Session_OnStart с тем, чтобы быть использованной в процессе работы сессии, она же уничтожается (обнуляется) в Session_OnEnd.

Global.asa не может содержать тэгов HTML. Недопустимо использование JavaScript. Не рекомендуется писать файл Global.asa с помощью каких-либо HTML-редакторов, для этого гораздо лучше использовать NotePad. И еще один совет: прежде чем вставлять скрипт в файл Global.asa, попробуйте его в работе в обычном ASP-файле.

Пример файла Global.asa

Добавляем новую статью (UploadForm.asp и Upload2DBS.asp)

Теперь, когда мы разобрались с SQL, можно приступать к добавлению новой статьи, причем делать мы это будем прямо с сайта, а если быть точнее — непосредственно с HTML-формы. Для этого сначала создадим файл с самой формой и определим скрипт-реакцию на подтверждение (кнопку «Publish the article!»). (Предполагается, что читатель знаком с азами построения HTML-форм, поэтому мы рассмотрим этот процесс, не вдаваясь в детали построения форм.)

Прежде всего следует уточнить задачу на этом этапе. Итак, очевидно следующее:

  • на загрузку статьи с сайта должен иметь право не каждый (следовательно, желательно предусмотреть пароль для доступа к этой функции);
  • у каждой статьи есть определенная тема (рубрика), причем она не может быть произвольной, а должна выбираться из списка;
  • список можно хранить непосредственно в HTML-файле и, каждый раз изменяя его, изменять сам файл. Это самый простой и быстрый способ;
  • однако для того, чтобы позволить динамически изменять и пополнять этот список, рекомендуется держать его в базе данных. Это позволит пользователям произвольным образом изменять его содержимое и не потребует переделки формы. Для простоты сначала рассмотрим вариант со встроенным («жестко прошитым») рубрикатором.

Как видим, передача управления осуществляется благодаря директиве ACTION=»http://localhost/Upload2DBS.asp»> в тэге формы. Тем самым указывается скрипт-ответ на реакцию пользователя после нажатия на кнопку «Publish the article!». Теперь остановимся на селекторе рубрик. Как уже отмечалось, желательно перевести его содержимое в базу данных. Для этого в нашей базе данных (файл ArticlesDB.mdb) создадим новую таблицу с именем, к примеру «Topics», в которой с помощью конструктора определим всего одно поле — «Topic» типа «текст». Далее заполним эту таблицу произвольными значениями нашего рубрикатора и отсортируем полученный список в алфавитном порядке. После чего следует заменить тэг

Теперь давайте разберемся с самой сутью дальнейшей работы. Что же должен делать наш скрипт-реакция?

Во-первых, следует позаботиться о том, чтобы все обязательные поля (а они отмечены звездочкой) были введены. Наиболее правильным способом проверки этого является скрипт, написанный на любом языке описания скриптов (например, JavaScript), который будет проверять, введены ли значения обязательных полей. Для этого достаточно добавить в определение тэга формы параметр onsubmit=»preprocess();», где preprocess() — имя функции-скрипта, который и будет осуществлять проверку. Здесь как нельзя кстати видно преимущество языков описания сценариев (JavaScript, Jscript, VBScript) перед ASP. ASP выполняется на стороне сервера, а перегружать связь «клиент-сервер» простой проверкой типа «введены ли значения», согласитесь, неправильно. Однако специально в целях обучения мы будем делать это с помощью ASP.

И еще. Прежде чем приступить к выполнению нашей задачи, следует сказать еще об одной небольшой проблеме: когда мы будем вставлять в ячейку базы данных текст, его форматирование (даже самое простое) не сохранится, и в дальнейшем его невозможно будет корректно отобразить на HTML-странице, поскольку поле Memo хранит неформатированную строку текста. Чтобы избежать этого, следует написать функцию, которая позволит производить примитивное HTML-форматирование введенного текста статьи, перед тем как записать его в базу данных. Другими словами, в самом примитивном случае (хотя бы для того, чтобы сохранить исходную разбивку на строки) функция должна вставлять символы конца строки там, где во входном потоке имеются символы переноса строк.

Удаляем статью (RemoveForm.asp и Rem.asp)

Было бы неплохо предусмотреть возможность удаления статьи с нашего сайта: во-первых, она может устареть, а во-вторых, в процессе ее подготовки не исключены ошибки или опечатки. Останавливаться на форме удаления статьи не будем, скажем лишь, что она содержит единственные элементы с запросом пароля и кнопкой удаления (см. файл RemoveForm.asp), и сразу перейдем к рассмотрению непосредственно процесса удаления:

Особое внимание следует уделить первым двум строкам. Они получают значение глобальной переменной текущего сеанса (сессии) работы со значением идентификатора текущей статьи (в нашем случае удаляемой), которая была инициализирована (файл ArtTmp.htm) следующей строкой:

Таким образом, в текущий скрипт передается в качестве параметра сеансовая переменная с идентификатором текущей статьи, которую необходимо удалить. Имеется в виду, что ссылка на удаление присутствует в странице с шаблоном (файл ArtTmp.htm) и удаляемая статья является текущей.

Организуем поиск (SearchForm.asp и SearchDBS.asp)

Как известно, без поиска навигация в сколь-нибудь солидной базе данных невозможна в принципе. Попробуем организовать поиск статьи по ее реквизитам, причем постараемся организовать булев (логический) поиск, соединяя отдельные значения критериев поиска с помощью логики «И/ИЛИ».

Опять же не заостряя внимание на поисковой форме (файл SearchForm.asp), перейдем непосредственно к самому процессу поиска:

Самое интересное происходит при формировании запроса к базе из составляющих:

В зависимости от введенной пользователем комбинации исходных полей из этих компонентов формируется окончательный запрос, в частности для полей «Author» и «Title». Возможны четыре случая: оба поля пусты, пусто первое поле, пусто второе поле и оба поля не пусты. Соответствующая строка SQL-запроса в каждом из этих случаев формируется по-своему. То же самое относится к состоянию селекторов рубрик статей и порядку их сортировки. При добавлении той или иной подстроки учитывается состояние «радиокнопок» И/ИЛИ и соответствующая подстрока добавляется в SQL-запрос, предваряясь логическим элементом «and» или «or» соответственно. После того как окончательный запрос сформирован, он выполняется, а результирующая страница формируется исходя из списка статей, удовлетворяющих критериям.

Полный код приведенных в статье примеров, включая файл базы данных, находится на нашем CD-ROM.

И в заключение

Напоследок хотелось бы сориентировать разработчиков ASP-страниц в мире документации и инструментальных средств. Дело в том, что автор настоящей статьи провел не один день сидя в Интернете в поисках всевозможных исходных текстов, документации, инструментальных средств и теоретических основ этого мощного средства.

Среди множества инструментальных средств, служащих для облегчения создания ASP-приложений, выделяются два: Easy ASP © Eric Banker, 2000 и Microsoft InterDev из комплекта Microsoft Visual Studio 6.0. Первый — очень удобное, несложное и небольшое средство для быстрого создания ASP-приложений. Второй представляет собой мощный, тяжеловесный интегрированный пакет в духе Microsoft для разработки всевозможных Web-приложений.

Временная версия EasyASP 4.0 находится на нашем CD-ROM.

Среди огромного числа сайтов мною были отобраны те, посещение которых было для меня особенно полезным и с которыми хотелось ознакомить читателей, а именно:

http://www.15seconds.com/issue/000210.htm — создание динамичных JavaScript-скриптов с помощью ASP и интерфейсов к базам данных

http://www.alphasierrapapa.com/iisdev/ — сайт, посвященный разработке серверов IIS с помощью ASP

http://www.websiteresources.com/ — огромная база исходных текстов всевозможных Web-программ

Примеры ASP-кода для профессионалов

http://www.asptoday.com/search.asp?category=ASP Tricks — масса полезных советов для начинающих программировать на ASP

http://www.oreilly.com/catalog/aspnut/ — замечательная книга популярнейшей серии «In a Nutshell» всемирно известного издательства O’REILLY «ASP in a Nutshell A Desktop Quick Reference». На сайте бесплатно размещена одна из глав книги

http://www.chilisoft.net/ — версии ASP для различных платформ можно скачать с этого сайта

http://www.willcam.com/sql/ — введение в структурированный язык запросов SQL

SQL Reference and Example Site — хорошо структурированный материал по SQL

Ваше первое ASP.NET 5 веб приложение, созданное при помощи Visual Studio¶

В этом руководстве вы увидите, как создать простое веб приложение при помощи ASP.NET 5. В этом приложении данные будут связаны с базой данных SQL при помощи Entity Framework (EF), а ASP.NET MVC будет поддерживать операции CRUD.

Начальные реквизиты¶

Прежде чем начать, убедитесь, что вы сделали вот это: Установка ASP.NET 5 для Windows. Мы предполагаем, что у вас установлена Visual Studio 2015 и последняя версия среды и инструментария ASP.NET 5.

Дополнительную информацию по установке ASP.NET 5 на других платформах вы можете получить тут: Начинаем.

Создание нового ASP.NET 5 проекта¶

Запустите Visual Studio 2015. Из меню File выберите New > Project.

Выберите шаблон ASP.NET Web Application. Он находится в Installed > Templates > Visual C# > Web. Назовите проект ContosoBooks и нажмите OK.

В диалоговом окне New ASP.NET Project выберите Web Application под ASP.NET 5 Preview Templates. Кроме того, убедитесь, что галочка не стоит на Host in the cloud, и нажмите OK.

Не меняйте метод аутентификации. Оставьте по умолчанию Individual User Accounts.

Запуск приложения по умолчанию¶

После того как Visual Studio закончит создание приложения, запустите его, нажав Debug -> Start Debugging. Как вариант, вы можете нажать F5.

Для инициализации Visual Studio и нового приложения может потребоваться время. После завершения браузер покажет запущенное приложение.

После запуска приложения закройте браузер и нажмите на иконку “Stop Debugging” в Visual Studio, чтобы остановить приложение.

Просмотр проекта¶

В Visual Studio окно Solution Explorer позволяет вам управлять файлами проекта. Шаблон веб приложения, который вы использовали для создания этого приложения, добавляет следующую базовую структуру папок:

Visual Studio создает некоторые начальные файлы и папки для проекта. Вот первичные файлы, с которыми вам стоит ознакомиться:

Имя файла Цель
project.json Присутствие файла project.json определяет проект .NET Execution Environment (DNX). В файле project.json содержится вся информация, которая нужна DNX, чтобы запустить и упаковать ваш проект. Дополнительную информацию, включая файловую схему project.json, вы можете найти тут: see Работа с DNX проектами.
global.json Visual Studio использует этот файл для конфигурации проекта.
appsettings.json Этот файл позволяет вам включать дополнительную информацию о проекте. Дополнительную информацию вы можете получить тут: Конфигурация.
Startup.cs Класс Startup является начальной точкой приложения. В классе Startup должен быть определен метод Configure , кроме того, здесь может быть определен метод ConfigureServices , и он может быть вызван при запуске приложения. Дополнительную информацию вы можете получить тут: Запуск приложения.
Index.cshtml Здесь view содержит HTML для основной страницы.
_Layout.cshtml Здесь view содержит общий HTML для разных страниц веб приложения.
HomeController.cs Этот controller содержит классы, которые обрабатывают входящие запросы браузера, получают модельные данные, а затем определяют шаблоны представлений, которые возвращают ответ браузеру.

Понимание MVC¶

В этом проекте используется MVC. MVC обозначает Model-View-Controller (модель-представление-контроллер). MVC — это паттерн для разработки приложений, и эти приложения хорошо структурированы, их можно протестировать и легко поддерживать. MVC приложения содержат:

  • Models: Классы, которые представляют данные этого приложения, а затем используют логику валидации для связывания бизнес-правил и данных.
  • Views: Шаблонные файлы, которые использует приложение для динамичных HTML ответов.
  • Controllers: Классы, которые обрабатывают входящие браузерные запросы, получают модельные данные, а затем определяют представления, которые возвращают ответ браузеру.

Понимание .NET Core¶

.NET Core 5 — это модальная реализация среды разработки и библиотек, которая включает в себя некоторые аспекты .NET Framework. .NET Core 5 разрабатывается для Windows, Linux и OS X. .NET Core 5 состоит из набора библиотек “CoreFX” и маленькой среды разработки “CoreCLR”. .NET Core имеет открытый исходный код, так что вы можете отслеживать развитие проекта на GitHub. Больше информации вы можете получить тут: Выбор правильного .NET сервера.

Entity Framework¶

Entity Framework (EF) — это ORM (object-relational mapping) фреймворк. Он позволяет работать с реляционными данными как с объектами, и при этом вам нужно писать намного меньше кода для доступа к данным, чем обычно. Используя EF, вы можете работать с запросами при помощи LINQ, затем получать и обрабатывать данные как строго типизированные объекты. LINQ предлагает паттерны для запроса и обновления данных. Использование EF позволяет сфокусироваться на остальной части проекта, а не на основах доступа к данным.

Откройте файл project.json. В разделе dependencies вы увидите следующие строки, связанные с EF:

Здесь показано, что вы можете использовать команды EF из командного окна, а также что пакет EF NuGet включен в ваш проект.

Создание модели данных и скаффолдинг¶

Entity Framework поддерживает парадигму разработки Code First. Code First позволяет определять модели данных при помощи классов. Класс — это конструкция, которая позволяет создавать собственные пользовательские типы, группируя переменные разных типов, методы и события. Классы могут работать с существующей базой данных или генерируют базу данных. В данном руководстве вы начнете с создания entity-классов, которые определяют модели данных для веб приложения. Затем вы создадите контекстные классы, которые управляют entity-классами и дают данным доступ к базе данных. Далее вы настроите EF и заполните базу данных.

Создание entity-классов¶

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

В веб приложении будет две сущности:

Вы определите класс для каждой из них в папке Models в Solution Explorer.

Модельный класс вы можете поместить в любое место вашего проекта. Папка Models — это просто соглашение.

Кликните правой кнопкой мышки по папке Models и выберите Add > New Item. В диалоговом окне Add New Item выберите шаблон Class. В поле Name напишите “Author.cs” и нажмите OK.

Замените код по умолчанию следующим кодом:

Повторите эти шаги для создания другого класса Book со следующим кодом:

Чтобы не уложнять приложение, пусть у каждой книги будет один автор. Свойство Author определяет способ управления отношениями между автором и книгой. В EF этот тип свойства называется navigation property. Когда EF создает схему базы данных, EF автоматически вставляет AuthorID , и это будет вторичным ключом для таблицы Authors.

Скаффолдинг¶

Скаффолдинг сохраняет ваше время и усилия, автоматически генерируя начальную точку для операций CRUD вашего приложения. Начав с простого модельного класса и не написав ни единой строки кода, вы создаете два контроллера, которые содержат CRUD-операции, связанные с авторами и книгами, а также необходимые представления.

Чтобы добавить скаффолдинг кликните правой клавишей мышки по папке Controllers в Solution Explorer. Выберите Add –> New Scaffolded Item.

Если вы не видите опцию New Scaffolded Item, убедитесь, что при создании проекта вы использовали Individual User Accounts.

Из диалогового окна Add Scaffold выберите MVC 6 Controller with views, using Entity Framework, а затем нажмите на кнопку Add.

Далее, в диалоговом окне Add Controller в списке с модельными классами выберите Book (ContosoBooks.Models). Также установите контекстный класс на ApplicationDbContext (ContosoBooks.Models). Флажок на Generate views должен быть установлен. Нажмите на кнопку Add.

Как вы видите, диалоговое окно Add Controller дает вам возможность выбирать опции для создания контроллеров и представлений.

Этот скаффолд создает код, который предоставляет контроллер и набор представлений. В представлениях есть UI и код для создания, чтения, обновления, удаления и перечисления данных из базы данных.

Повторите вышеперечисленные шаги по скаффолдингу, чтобы создать контроллер Author и связанные с ним представления. Используйте модельный класс Author (ContosoBooks.Models) и контекстный класс ApplicationDbContext (ContosoBooks.Models), как показано на следующем рисунке.

В Solution Explorer вы увидите, что новые контроллеры добавлены в папку Controller, а новые представления в папку Views.

Настройка приложения перед добавлением данных¶

Далее, к приложению нужно добавить пакет Microsoft.Extensions.DependencyInjection . В Solution Explorer найдите и откройте project.json. В разделе dependencies в конце раздела пропишите эту строку.

IntelliSense помогает вам, когда вы набираете. Когда вы сохраните project.json, Visual Studio автоматически даст ссылку на новый пакет.

После добавления этой строки раздел dependencies в файле project.json будет выглядеть вот так:

Добавление данных¶

Мы не будем вручную набирать данные — мы используем код, который заполнит базу данных. Добавьте класс SampleData в папке Models со следующим кодом:

Вы не будете вставлять этот класс данных в производственный код, но для нашего сценария он годится.

Далее, в Solution Explorer, откройте файл Startup.cs. Добавьте следующую строку кода в методе Configure:

После этого полный файл Startup.cs будет выглядеть вот так:

Обратите внимание, что в ConfigureServices приложение вызывает Configuration[«Data:DefaultConnection:ConnectionString»] , чтобы получить строку соединения с базой данных. Во время разработки эта настройка идет из файла appsettings.json. Когда вы разворачиваете приложение в производственной среде, вы устанавливаете строку соединения в переменную среды на хосте. Если Configuration API находит переменную среды с тем же ключом, то возвращает переменную среды, вместо того значения, что находится в appsettings.json.

Создание веб приложения¶

Чтобы убедиться, что все классы и изменения работают, вы должны создать приложение.

Из меню Build выберите Build Solution.

Отображается окно Output, и если все прошло успешно, вы увидите соответствующее сообщение.

Если же произошла ошибка, то просмотрите предыдущие шаги. Информация в окне Output покажет, в каком файле возникла проблема и где требуется изменение. Эта информация поможет вам определить, какие предыдущие шаги вам стоит повторить, чтобы устранить проблему.

Прежде чем запустить приложение, вы должны создать БД, используя миграцию данных.

Использование миграции данных для создания базы данных¶

Миграция данных в EF используется для обновления моделей во всем приложении. Изначально используя миграцию данных для создания базы данных, вы можете легко изменить базу, после того как была изменена модель. Это позволит вам более эффективно создавать и поддерживать приложение. Альтернативой миграции данных, когда требуются изменения в модели или схеме после изменения базы данных, является пересоздание всей базы данных.

Откройте Command Prompt в директории проекта (ContosoBooks/src/ContosoBooks).

Чтобы открыть Command Prompt, кликните правой кнопкой мышки по кнопке start в Windows и выберите из меню Command Prompt.

Чтобы найти директорию проекта, кликните правой кнопкой мышки в Visual Studio по имени проекта (ContosoBooks) в Solution Explorer и выберите Open Folder in File Explorer. Скопируйте путь к проекту из File Explorer в Command Prompt. Например, введите следующее из Command Prompt, чтобы сменить директорию:

Убедитесь, что вы перешли к папке ContosoBooks, что в папке src.

Из Command Prompt запустите следующие команды:

Если dnu restore не распознается, вам нужно полностью повторить шаг с начальными реквизитами (или частично). Но сперва вам надо проверить Active версию .NET Version Manager (dnvm). Чтобы сделать это, введите dnvm list в командной строке. Если рядом с какой-либо версией нет *, установите активную версию, то есть, введите dnvm use 1.0.0-rc1-update1 -p , так что нужная версия будет выбрана.

.NET Version Manager (dnvm) — это набор утилит командной строки, которые используются для обновления и конфигурации .NET Runtime.

DNX обозначает .NET Execution Environment. Команда ef указана в файле project.json проекта. Больше информации по dnvm , dnu , and dnx , вы можете получить тут: DNX Overview.

Команда “ add Initial ” создает миграцию “Initial”, которая добавляет в проект код, позволяя EF обновлять схему базы данных. Команда update создает актуальную базу данных. После запуска этой команды папка Migrations будет обновлена:

Если вы хотите получить помощь по EF командам, введите следующее в командной строке: dnx ef -? . Для помощи с командой add введите следующее: dnx ef migrations add -? . А для помощи с командой update — следующее: dnx ef database update -? .

Кроме того, вы сможете увидеть новую базу данных в SQL Server Object Explorer.

Добавление навигации¶

Обновите навигацию для веб приложения. Из Solution Explorer откройте файл Views/Shared/_Layout.cshtml. Найдите следующий код:

Замените выше представленный код вот этим:

Данные изменения добавят ссылку к представлению Books и ссылку к представлению Authors. Вы создали эти представления, когда добавили в проект скаффолдинг.

Создание веб приложения¶

Чтобы убедиться, что все работает, вам снова нужно собрать приложение.

Из меню Build выберите Build Solution.

Локальный запуск веб приложения¶

Запустите приложение, чтобы увидеть, как выглядит вся продукция или категория продуктов.

В Solution Explorer кликните правой клавишей мышки по названию проекта и выберите View -> View in Browser. Либо же просто нажмите F5.

Откроется браузер и покажет приложение. Нажмите на ссылку Books вверху страницы.

Закройте браузер и нажмите на иконку “Stop Debugging” в Visual Studio.

Публикация приложения на Azure¶

В Solution Explorer в Visual Studio кликните правой кнопкой мышки по проекту и выберите Publish.

В окне Publish Web нажмите на Microsoft Azure Web Apps и залогиньтесь на Azure.

После этого нажмите New, чтобы создать на Azure новое приложение.

Назовите сайт, выберите сервисный план, ресурсную группу и регион. Также выберите сервер базы данных, а также имя пользователя и пароль к нему. Если вы уже создавали сервер базы данных, используйте его. После этого нажмите Create.

В Connection в окне Publish Web нажмите Publish.

Прогресс публикации вы можете просмотреть в окне Output или в окне Azure App Service Activity в Visual Studio.

После публикации на Azure ваше приложение, запущенное на Azure, будет отображено в браузере.

Дополнительная информация доступна вот тут: Publishing and Deployment.

ASP.NET Core — Написание ясного кода в ASP.NET Core с использованием встраивания зависимостей

Эта статья основана на ASP.NET Core 1.0 предварительной версии RC1. Некоторая информация может быть изменена при выпуске версии RC2.

Продукты и технологии:

ASP.NET Core 1.0

В статье рассматриваются:

  • примеры жесткого связывания;
  • написание «честных» классов;
  • встраивание зависимостей в ASP.NET Core;
  • код с возможностью модульного тестирования;
  • тестирование обязанностей контроллера.

ASP.NET Core 1.0 является полностью переписанной ASP.NET, и одной из основных целей в этой новой инфраструктуре является более модульная архитектура. То есть приложения должны иметь возможность использовать только те части инфраструктуры, которые им нужны, причем инфраструктура предоставляет зависимости по мере того, как они запрашиваются. Более того, разработчики, создающие приложения на основе ASP.NET Core, должны иметь возможность использовать ту же функциональность, чтобы поддерживать свои приложения свободно связанными и модульными. С появлением ASP.NET MVC группа ASP.NET значительно улучшила поддержку со стороны инфраструктуры в написании свободно связанного кода, но все равно было очень легко попасть в ловушку жесткого связывания, особенно в классах контроллеров.

Жесткое связывание

Жесткое связывание (tight coupling) хорошо подходит для демонстрационного программного обеспечения. Если вы посмотрите на типичное приложение-пример, показывающее, как создавать сайты на основе ASP.NET MVC (версий 3–5), то скорее всего найдете код, подобный следующему (взят из класса DinnersController приложения-примера NerdDinner, использующего MVC 4):

Глядя на код, чтобы оценить степень его связывания, помните фразу «new является связующим».

Этот тип кода очень сложен в модульном тестировании, потому что NerdDinnerContext создается в процессе конструирования класса и требует подключения к базе данных. Неудивительно, что такие демонстрационные приложения нечасто включают какие-либо модульные тесты. Однако ваше приложение может выиграть от нескольких модульных тестов, даже если вы не занимаетесь разработкой на основе тестов, так что было бы лучше писать код, который можно было бы протестировать. Более того, этот код нарушает принцип Don’t Repeat Yourself (DRY) (принцип «не повторяйся»), поскольку каждый класс контроллера, так или иначе обращающийся к данным, содержит один и тот же код для создания EF-контекста базы данных (Entity Framework). Это делает внесение будущих изменений более дорогостоящим и подверженным ошибкам, особенно по мере развития приложения в течение длительного времени.

Глядя на код, чтобы оценить степень его связывания, помните фразу «new является связующим». То есть везде, где экземпляр класса создается с помощью ключевого слова new, ваша реализация связывается конкретно с этим кодом реализации. Dependency Inversion Principle (принцип инверсии зависимостей) (bit.ly/DI-Principle) утверждает: «Абстракции не должны зависеть от деталей — детали должны зависеть от абстракций». В этом примере детали того, как контроллер извлекает данные для передачи представлению, зависят от деталей того, как эти данные извлекаются, а именно от EF.

Вдобавок к ключевому слову new «статическое сцепление» является еще одним источником жесткого связывания, которое затрудняет тестирование и сопровождение приложений. В предыдущем примере имеется зависимость от системных часов компьютера в виде вызова DateTime.Now. Это связывание усложнило бы создание набора тестовых Dinners для использования в некоторых модульных тестах, так как их свойства EventDate пришлось бы устанавливать относительно текущему показанию часов. Это связывание можно было бы удалить из данного метода несколькими способами, самый простой из которых — переложить заботу об этом на какую-то новую абстракцию, возвращающую Dinners, чтобы это больше не было частью метода. В качестве альтернативы я мог бы сделать значение параметром, чтобы метод возвращал все Dinners после предоставленного параметра DateTime вместо использования только DateTime.Now. Наконец, можно было бы создать абстракцию для текущего времени и ссылаться на текущее время через эту абстракцию. Это может оказаться хорошим подходом, если приложение часто ссылается на DateTime.Now. (Кроме того, заметьте, что, поскольку эти обеды [dinners] предположительно происходят в разных часовых поясах, тип DateTimeOffset может быть более эффективным выбором в реальном приложении.)

Будьте честны

Другая проблема с сопровождением кода вроде этого — он нечестен со взаимодействующими с ним объектами. Вы должны избегать написания классов, экземпляры которых можно создавать в недопустимых состояниях, так как это является частым источником ошибок. Таким образом, все, что необходимо вашему классу для выполнения своих задач, должно предоставляться через его конструктор. Как утверждает Explicit Dependencies Principle (принцип явных зависимостей) (bit.ly/ED-Principle), «методы и классы должны явным образом требовать любые взаимодействующие объекты (collaborating objects), нужные им для корректной работы». Класс DinnersController имеет лишь конструктор по умолчанию, а это подразумевает, что ему не надо взаимодействовать с какими-либо объектами для корректной работы. Но что будет, если вы подвергнете его тесту? Что сделает этот код, если вы запустите его из нового консольного приложения, которое ссылается на MVC-проект?

Первое, что не удастся в этом случае, — попытка создать экземпляр EF-контекста. Код сгенерирует исключение InvalidOperationException: «No connection string named ‘NerdDinnerContext’ could be found in the application config file.» (в конфигурационном файле приложения не найдена строка подключения с именем ‘NerdDinnerContext’). Меня обманули! Для работы этому классу нужно больше, чем заявляет его конструктор! Если классу необходим какой-то способ доступа к наборам экземпляров Dinner, он должен запрашивать их через свой конструктор (или как параметры в своих методах).

Встраивание зависимостей

Встраивание зависимостей (dependency injection, DI) относится к передаче зависимостей класса или метода в виде параметров вместо «зашивания» в код этих связей через new или статические вызовы. Это набирающий популярность метод в .NET-разработке из-за обеспечения им разъединения приложений, в которых он применяется. В ранних версиях ASP.NET преимущества DI не использовались, и, хотя в ASP.NET MVC и Web API наблюдается прогресс в отношении его поддержки, ни одна из инфраструктур до сих пор не предоставляет полной поддержки, в том числе контейнер для управления зависимостями и жизненными циклами их объектов. В ASP.NET Core 1.0 DI не просто полностью поддерживается — оно повсеместно применяется в самом продукте.

В ASP.NET Core 1.0 DI не просто полностью поддерживается — оно повсеместно применяется в самом продукте.

ASP.NET Core не только поддерживает DI, но и включает DI-контейнер, также называемый контейнером Inversion of Control (IoC) или контейнером сервисов. Каждое приложение ASP.NET Core конфигурирует свои зависимости, используя этот контейнер, в методе ConfigureServices класса Startup. Данный контейнер обеспечивает необходимую базовую поддержку, но может быть заменен пользовательской реализацией, если в этом есть потребность. Более того, EF Core также имеет встроенную поддержку DI, поэтому ее конфигурирование в приложении ASP.NET Core сводится к простому вызову метода расширения. Для этой статьи я создал ответвление NerdDinner с именем GeekDinner. EF Core конфигурируется, как показано ниже:

После этого довольно легко запросить через DI экземпляр GeekDinnerDbContext от класса контроллера вроде DinnersController:

Заметьте, что нет ни одного экземпляра ключевого слова new; все зависимости, нужные контроллеру, передаются через его контроллер, и заботится об этом за меня DI-контейнер ASP.NET. В процессе написания приложения мне незачем беспокоиться об инфраструктуре, участвующей в разрешении зависимостей, запрашиваемых моими классами через свои конструкторы. Конечно, при желании можно изменить это поведение, даже заменить контейнер по умолчанию другой реализацией. Поскольку теперь мой класс контроллера следует принципу явных зависимостей, я знаю, что для его работы нужно предоставить экземпляр GeekDinnerDbContext. Выполнив небольшую подготовку для DbContext, я могу создать экземпляр контроллера сам по себе, как демонстрирует это консольное приложение:

При конструировании DbContext в EF Core требуется несколько больше работы, чем в EF6, где просто принималась строка подключения. Дело в том, что, как и ASP.NET Core, EF Core спроектирован в расчете на большую модульность. Обычно вам не понадобится иметь дело напрямую с DbContextOptionsBuilder, так как он используется «за кулисами», когда вы конфигурируете EF через методы расширения вроде AddEntityFramework и AddSqlServer.

А можно ли это протестировать?

Тестирование приложения вручную является важным — вам нужна возможность запустить его и убедиться, что оно действительно запускается и дает ожидаемый вывод. Но поступать так всякий раз, когда вносится какое-то изменение, — пустая трата времени. Одно из значимых преимуществ свободно связанных приложений в том, что они, как правило, лучше поддаются модульному тестированию, чем жестко связанные. Еще важнее, что ASP.NET Core и EF Core гораздо проще в тестировании, чем их предшественники. Для начала я напишу простой тест, который напрямую передает в контроллер какой-то DbContext, который был сконфигурирован на использование хранилища в памяти. Я настрою GeekDinnerDbContext, используя параметр DbContextOptions, который предоставляется этим контекстом через конструктор:

Сконфигурировав это в тестовом классе, легко написать тест, показывающий, что Model в ViewResult возвращает корректные данные:

Конечно, здесь пока что мало логики для тестирования, поэтому данный тест ничего особенного и не проверяет. Критики возразили бы, что этот тест малозначим, и я согласился бы с ними. Однако это отправная точка для будущего теста, когда появится больше логики, что и будет сделано в самом ближайшем будущем. Но сначала, хоть EF Core и поддерживает модульное тестирование в памяти, я все же позабочусь о предотвращении прямого связывания с EF в своем контроллере. Нет никаких причин для связывания обязанностей UI с обязанностями инфраструктуры доступа к данным — по сути, это нарушило бы другой принцип, Separation of Concerns (принцип разделения обязанностей).

Избегайте зависимости от того, что не используется

Принцип отделения интерфейса (Interface Segregation Principle) (bit.ly/LS-Principle) утверждает, что классы должны зависеть только от той функциональности, которую они действительно используют. В случае нового DinnersController с поддержкой DI тот по-прежнему зависит от всего DbContext. Вместо склеивания реализации контроллера с EF можно было бы задействовать некую абстракцию, которая предоставляла бы необходимую функциональность.

Что на самом деле нужно этому методу действия (action method) для должного функционирования? Определенно не весь DbContext. Ему даже не требуется доступ к полному свойству Dinners контекста. Ему достаточно возможности отображать экземпляры Dinner соответствующей страницы. Простейшая .NET-абстракция, представляющая это, — IEnumerable . Поэтому я определю интерфейс, который просто возвращает IEnumerable , и это удовлетворит (большую часть) требований метода Index:

Я называю это репозитарием, поскольку он следует такому шаблону: он абстрагирует доступ к данным интерфейсом, подобным набору. Если по какой-то причине вам не нравится шаблон репозитария или имя, вы можете назвать его IGetDinners, IDinnerService или как угодно иначе (мой рецензент предложил ICanHasDinner). Независимо от того, как вы назовете этот тип, он будет служить той же цели.

Одно из значимых преимуществ свободно связанных приложений в том, что они, как правило, лучше поддаются модульному тестированию, чем жестко связанные.

Покончив с этим, теперь подстроим DinnersController для приема IDinnerRepository в качестве параметра конструктора вместо GeekDinnerDbContext и вызова метода List вместо прямого обращения к Dinners DbSet:

К этому моменту можно скомпилировать и запустить ваше веб-приложение, но вы столкнетесь с исключением, если перейдете к /Dinners: InvalidOperationException («Unable to resolve service for type ‘GeekDinner.Core.Interfaces.IdinnerRepository’ while attempting to activate GeekDinner.Controllers.DinnersController.») («Не удалось разрешить сервис для типа ‘GeekDinner.Core.Interfaces.IdinnerRepository’ при попытке активировать GeekDinner.Controllers.DinnersController.»). Я пока что не реализовал интерфейс, и, как только это будет сделано, мне также понадобится сконфигурировать свою реализацию для использования, когда DI будет выполнять запросы к IDinnerRepository. Реализация этого интерфейса тривиальна:

Заметьте, что прямое связывание реализации репозитария с EF совершенно нормально. Если мне понадобится заменить EF, я просто создам новую реализацию интерфейса. Этот класс реализации является частью инфраструктуры моего приложения, которая представляет собой одно из мест в приложении, где мои классы зависят от конкретных реализаций.

Чтобы сконфигурировать ASP.NET Core на встраивание правильной реализации, когда классы запрашивают IDinnerRepository, нужно добавить следующую строку кода в конец ранее показанного метода ConfigureServices:

Это выражение инструктирует DI-контейнер ASP.NET Core использовать экземпляр DinnerRepository всякий раз, когда требуется разрешить тип, зависимый от экземпляра IDinnerRepository. Scoped означает, что для каждого веб-запроса, обрабатываемого ASP.NET, будет использоваться один экземпляр. Также можно добавлять сервисы, указывая жизненные циклы Transient или Singleton. В данном случае подходит Scoped, поскольку мой DinnerRepository зависит от DbContext, который тоже использует жизненный цикл Scoped. Вот краткое описание доступных сроков жизни объектов.

  • Transient Используется новый экземпляр типа всякий раз, когда запрашивается этот тип.
  • Scoped При первом запросе в рамках данного HTTP-запроса создается новый экземпляр типа, а затем он повторно используется для всех последующих типов, разрешаемых при этом HTTP-запросе.
  • Singleton Единственный экземпляр типа создается один раз и используется всеми последующими запросами для этого типа.

Встроенный контейнер поддерживает несколько способов конструирования типов, которые он будет предоставлять. Самый типичный случай — простая передача типа контейнеру, после чего тот попытается создать экземпляр этого типа, предоставляя ему любые зависимости, которые тип запрашивает по мере выполнения. Вы также можете указать лямбда-выражение для конструирования типа или — в случае жизненного цикла Singleton — передать полностью сконструированный экземпляр в ConfigureServices при его регистрации.

После подключения DI приложение выполняется, как и раньше. Теперь, как показано на рис. 1, я могу тестировать его с применением новой абстракции, используя имитацию или заглушку реализации интерфейса IDinnerRepository вместо того, чтобы напрямую полагаться на EF в коде теста.

Рис. 1. Тестирование DinnersController, используя имитирующий объект

Этот тест работает независимо от того, откуда берется список экземпляров Dinner. Вы могли бы переписать код для доступа к данным, чтобы использовать другую базу данных, Azure Table Storage или XML-файлы, а контроллер все равно работал бы точно так же. Конечно, в данном случае он не делает ничего особенного, поэтому вам, возможно, интересно…

А как насчет реальной логики?

До сих пор я не реализовал никакой реальной бизнес-логики — у меня были лишь простые методы, возвращающие несложные наборы данных. Истинная ценность тестирования проявляется только при наличии логики и особых случаев, в которых вы должны убедиться, что приложение будет вести себя ожидаемым образом. Чтобы продемонстрировать это, я добавлю некоторые требования к своему сайту GeekDinner. Сайт будет предоставлять API, который позволит кому угодно отвечать на приглашение на обед. Однако для числа приглашаемых будет дополнительно задан максимум, и количество ответов на приглашение (RSVP) не должно превышать этот максимум. Пользователи, запрашивающие RSVP, когда максимум уже достигнут, должны добавляться в список ожидания. Наконец, желающие пообедать могут указывать крайний срок относительно их начального времени, по истечении которого они не станут принимать приглашения.

Я мог бы закодировать всю эту логику в метод действия (action), но считаю, что тогда на один метод было бы возложено слишком много обязанностей, особенно на UI-метод, который должен концентрироваться на задачах, связанных с UI, а не на бизнес-логике. Контроллер должен проверять, что ему передаются допустимые входные аргументы, и гарантировать возврат ответов, подходящих для клиента. Решения, выходящие за рамки этих обязанностей, и особенно бизнес-логика не относятся к компетенции контроллеров.

Лучшее место для размещения бизнес-логики — модель предметной области приложения, которая не должна зависеть от обязанностей инфраструктуры (вроде работы с базами данных или UI). Класс Dinner подходит для управления RSVP, описанными в требованиях, поскольку он будет хранить максимальное количество участников мероприятия и знать, сколько RSVP было выдано на данный момент. Однако часть логики также зависит от того, когда появляется RSVP (до или после крайнего срока), поэтому методу понадобится доступ к текущему времени.

Я мог бы просто использовать DateTime.Now, но это затруднило бы тестирование моей логики и связало бы модель предметной области с системными часами. Другой вариант — задействовать абстракцию IDateTime и встроить ее в сущность Dinner. Однако, как показывает мой опыт, лучше всего сохранять сущности вроде Dinner свободными от зависимостей, особенно если вы планируете применять какое-то O/RM-средство наподобие EF для извлечения этих сущностей с уровня хранения. В связи с этим я не хочу заполнять сущности зависимостями, да и EF определенно не смогла бы иметь с этим дело без дополнительного кода с моей стороны. Распространенный подход — изъятие логики из сущности Dinner и перенос ее в какой-либо сервис (вроде DinnerService или RsvpService), в который можно легко встраивать зависимости. Однако это обычно приводит к антишаблону анемичной модели предметной области (anemic domain model antipattern) (bit.ly/anemic-model), в которой сущности имеют очень мало логики (или вообще не имеют ее) и являются просто контейнерами состояния. Нет, в данном случае решение прямолинейное: метод может просто принимать текущее время как параметр и позволять вызывающему коду передавать его.

При таком подходе логика добавления RSVP проста (рис. 2). Для этого метода есть ряд тестов, которые демонстрируют, что он ведет себя, как ожидалось; тесты доступны в проекте-примере, сопутствующем этой статье.

Рис. 2. Бизнес-логика в модели предметной области

Переместив эту логику в модель предметной области, я добился того, что API-метод моего контроллера останется компактным и сконцентрированным на собственных обязанностях. В итоге можно легко протестировать, что контроллер делает то, что ему положено, поскольку через этот метод проходит сравнительно немного путей выполнения.

Обязанности контроллера

Часть обязанностей контроллера — проверка ModelState и обеспечение его допустимости. Для ясности я делаю это в методе действия, но в более крупном приложении я исключил бы этот повторяющийся код в каждом методе действия, используя Action Filter:

Предполагая, что ModelState допустим, метод действия должен извлечь соответствующий экземпляр Dinner по идентификатору, переданному в запросе. Если метод не может найти экземпляр Dinner с совпадающим идентификатором, он должен вернуть результат Not Found:

По завершении этих проверок метод действия может делегировать бизнес-операцию, представленную запросом, модели предметной области, вызвав метод AddRsvp класса Dinner, который вы видели ранее, и сохранив обновленное состояние модели предметной области (в данном случае экземпляр dinner и его набор RSVP); после этого он возвращает ответ OK:

Вспомните: я решил, что у класса Dinner не должно быть зависимости от системных часов, и предпочел передавать текущее время в его метод. В контроллере я передаю _systemClock.Now как параметр currentDateTime. Это локальное поле, заполняемое через DI, что избавляет и контроллер от жесткого связывания с системными часами. Использовать DI в контроллере вполне разумно в противоположность сущности предметной области, так как контроллеры всегда создаются контейнерами сервисов ASP.NET; это подключает любые зависимости, объявленные контроллером в его конструкторе. Поле _systemClock имеет тип IDateTime, что определяется и реализуется всего несколькими строками кода:

Конечно, мне также нужно сконфигурировать контейнер ASP.NET так, чтобы он использовал MachineClockDateTime всякий раз, когда классу требуется экземпляр IDateTime. Это делается в ConfigureServices класса Startup, и, хотя подойдет любой жизненный цикл объекта, в данном случае я предпочел использовать Singleton, так как один экземпляр MachineClockDateTime будет обслуживать все приложение:

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

Следующие шаги

Скачайте сопутствующий этой статье проект-пример и посмотрите модульные тесты для Dinner и DinnersController. Помните, что свободно связанный код, как правило, гораздо проще в модульном тестировании, чем жестко связанный код, напичканный ключевыми словами new или вызовами статических методов, зависящих от обязанностей инфраструктуры. «New является связующим», так что ключевое слово new следует использовать в приложении осознанно, а не по воле случая. Узнать больше о ASP.NET Core и ее поддержке встраивания зависимостей можно на docs.asp.net.

Стив Смит (Steve Smith) — независимый тренер, преподаватель и консультант, а также обладатель звания ASP.NET MVP. Написал десятки статей для официальной документации ASP.NET Core (docs.asp.net) и работает с группами, осваивающими эту технологию. С ним можно связаться через сайт ardalis.com, также следите за его заметками в Twitter (@ardalis).

Выражаю благодарность за рецензирование статьи эксперту Microsoft Дугу Бантингу (Doug Bunting).

Создание страницы start.asp

1. В Visual InterDev щелкните правой кнопкой мыши на localhost/JoCoffee и укажите Add Active Server Page. По запросу введите имя start.asp и щелкните на Open.

2. Как и в site. asp, выделите и удалите весь код, добавленный по умолчанию средой Visual InterDev.

3. Добавьте в start.asp код:

Заметьте, что мы не начинаем start, asp тегом или , поскольку уже имеем эти теги на странице default.asp, куда будет помещена наша новая страница.

При разбиении страницы в Paint Shop Pro мы рыбрали для таблицы ширину 600 пикселей, чтобы уместиться на экране с разрешением 640 х. 480:

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

Атрибуты фона поддерживает только Internet Explorer (он выведет рисунок GIF с узким зеленым фоном и тонкой черной линией). Для межбраузериой совместимости мы дополнительно указываем атрибут bgcolor со значением #ccf f 99 (бледно-зеленый цвет), поддерживаемый браузером Netscape.

Для содержимого предназначена вторая таблица:

Первая ячейка новой таблицы остается пустой. Это позволяет отделить содержимое от панели навигации и избежать «сжатия» внешнего вида страницы:

Вторая ячейка отводится под содержимое. За последним тегом мы останавливаем start.asp, поскольку хотим получить некоторую точку, где страница, построенная на данном шаблоне, сможет полностью выписать свое содержимое и удостовериться в том, что ее компоновка соответствует общему формату. Фактически код уровня представления записывается в подстранице, которую генерируют start.asp и end.asp.

Достоинством такого подхода к построению сайта является то, что при пересмотре внешнего вида сайта (например, при перемещении панели навигации, добавлении новых кнопок и т. д.) нужно будет изменить только start .asp, end.asp и список стилей. Для обновления внешнего вида не придется перерабатывать остальные страницы.

1. Щелкните правой кнопкой мыши на localhost/JoCoffee и выполните Add Active Server Page. Введите имя end.asp и щелкните на Open.

2. Выделите и удалите весь код, который автоматически добавлен в файл средой Visual InterDev.

3. Добавьте в end.asp:

Код end. asp начинается с закрытия ячейки и строки, хранящих основное содержимое:

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

Если этого не сделать, а подстраница будет содержать всего лишь несколько слов, то браузер IE слишком сильно растянет левую навигационную панель.

Затем добавляется строка, отделяющая конец секции содержимого страницы от нижнего колонтитула:

Между тегами

и

не должно быть символа возврата каретки, иначе браузер интерпретирует его как пробел и сделает строку выше, чем запланированная для нее толщина в три пикселя. Обратите внимание, как используется bd.gif в теге img. Изображение bd.gif — весьма полезное средство web-дизайнера. Это файл GIF размером I х 1 пиксель, содержащий одну черную точку. Поместив эту точку на web-страницу, можно применить атрибуты width и height тега img для расширения до нужного размера. В нашем случае мы формируем изображение размером в три пикселя. Атрибут bgcolor тега td гарантирует, что изображение шириной в 1 пиксель закрасит черным цветом строку по всей длине.

Между концом таблицы содержимого и колонтитулом страницы добавляется пустое место, чтобы наша страница не сжималась:

Вспомните упражнение с добавлением свойства Version в объект Visit. Для того чтобы каждая страница сайта показывала номер версии объекта visit при каждом его запуске, в end.asp вводится код:

Powered by WroxCommerce

Если функция Visit обнаружит, что значение invisit еще не установлено, то функция его создаст, но в любом случая всегда возвращается объект visit. Имея объект, можно запросить номер его версии через свойство Version.

В конце функция end.asp закрывает ресурсы, которые могли использоваться во время исполнения объекта Visit:

В результате получим:

Web-страница выглядит так, как было запланировано! Еще не закодированы левая навигационная панель и кнопки управления,, но это не мешает понять взаимодействие между сайтом и объектной моделью WroxCommerce, поскольку в нижнем колонтитуле страницы указывается’ номер версии компонента.

Пока мы не рассматриваем верхнюю панель, поскольку еще не готовы сценарии для соответствующих секций сайта. Однако нужно обсудить вопросы домашней навигации.

Домашняя навигация (Home Navigation) определяет щелчок мыши, возвращающий посетителя на домашнюю страницу сайта.

Стандартным является размещение названия или логотипа сайта в верхнем левом углу страницы. Домашняя страница аналогична команде «сброс», поскольку заблудившийся на сайте посетитель обычно пытается вернуться к отправной точке. Как правило, посетители возвращаются на домашнюю страницу сайта.

Какой код whould быть помещен в Application_Start и session_start событий в global.asax?

Можете ли вы привести пример того, что может быть лучше всего подходит для размещения в подпрограммах Application_Start и session_start? Я знаю, когда каждая функция вызывается. Application_Start, когда первый пользователь первым получает доступ к веб-приложению. Session_start, когда пользователь открывает сеанс с приложением. Но какой код принадлежит в каждом из этих подпрограмм. Что код в каждой подпрограмме должны делать?

Будьте осторожны с обработкой исключений в Application_Start. В IIS7 интегрированном режиме вы не будете иметь объект ответа или HttpContext. Смотрите эту тему: Запрос не доступен в этом контексте

Всего какие-либо примеры? Ну, в MVC сайта маршруты регистрируются в Application_Start. Это также хорошее место, чтобы инициализировать контейнер IoC, такие как StructureMap. Может быть, инициализация некоторых одиночек у вас есть в вашем приложении, если вы хотите, чтобы они были легко доступны, а не поздний переплетом, когда пользователь получает доступ к их (например, если они имеют высокую стоимость инициализации и вы хотели бы сделать один медленный начальный удар на сайте самостоятельно чем беспокоить клиента или два с ним).

Session_start обычно используется реже, но может быть хорошим местом для каждого пользователя (или за сессии, реально) отслеживание какой-то.

Что такое код asp start

Этот текст предназначен для тех, кто никогда не имел дела с ASP и вообще смутно себе представляет возможности программирования на стороне сервера. Я ставил себе задачу создать у читателя общее представление о предмете. Отдельные неточности при этом менее важны — пожалуйста, громко не ругайтесь.

Общие сведения

ASP (Active Server Pages) – это мощная технология от Microsoft, позволяющая легко разрабатывать приложения для WWW. ASP работает на платформе Windows NT и IIS (Internet Information Server), начиная с версии 3, хотя вроде есть реализации на других платформах. ASP – это не язык программирования, это внутренняя технология, позволяющая подключать программы к Web-страницам. Основа успеха ASP – простой скриптовый язык (Visual Basic Script или Java Script) и возможность использования внешних COM-компонент.

Как это все происходит?

Вы пишете программу и складываете в файл на сервере. Браузер клиента запрашивает файл. Файл сначала интерпретируется сервером, на выходе производится HTML-код. Этот HTML посылается клиенту. Файлы с программами имеют расширение .asp. Файлы asp – это обычные текстовые файлы, содержащие исходные тексты программ. Файлы делаются с помощью любого текстового редактора. Каталог, в котором размещены файлы asp должен иметь права на выполнение, так как сервер исполняет эти файлы, когда браузер их запрашивает. Собственно программы пишутся на любом скриптовом языке, который установлен в системе. По умолчанию поддерживаются VBScript и JavaScript. Можно доустановить другие (например, Perl). Если ничего специально не указывать используется VBScript. В дальнейшем будем ссылаться только на него. Программные фрагменты заключаются в скобки . Можно ставить открывающую скобку в начале файла, закрывающую – в конце, все что между ними – программа на Visual Basic’е.

Какие средства есть для программирования?

Web – нормальная среда программирования, если правильно понять, что есть что. В VBScript есть все нормальные конструкции структурного программирования (if, while, case, etc). Есть переменные (описывать не обязательно, тип явно не задается). Поддерживаются объекты. Работа с ними обычная – Object.Property, Object.Method. Есть ряд встроенных объектов (Request, Response, Session, Server, Connection, Recordset). Можно доустанавливать другие компоненты (скачивать, покупать, программировать), например для работы с электронной почтой.

Вывод

Понятия «экран», куда можно выводить данные нет. Все, что надо показать пользователю, выбрасывается в выходной поток на языке HTML. Браузер пользователя интерпретирует этот HTML. Для упрощения вывода существует объект Response . Вывод осуществляется с помощью метода Write .

Так производится запись во внутренний буфер объекта Response. Когда скрипт заканчивает работу, весь буфер выдается клиенту. Надо заметить, что клиент получает «чистый» HTML, таким образом программы на ASP не зависят от клиентского ПО, что очень важно. Если внутри выводимой строки нужно использовать кавычку, кавычка удваивается. Другие методы и свойства Response позволяют управлять выводом. Так Response.Buffer регулирует, получает ли клиент данные по мере из записи в Response, или все сразу по завершении исполнения страницы. Метод Response.Redirect перенаправляет браузер на другую страницу. Чтобы им пользоваться, нельзя до него на странице использовать Response.Write.

Программа на ASP не может явно спросить пользователя о чем-то. Она получает данные из других страниц, либо через URL. Передаваемые параметры помещаются во входной поток и доступны через объект Request . Чтобы передать переменную var в программу test.asp , надо написать:

Чтобы из программы получить значение этой переменной, надо написать:

Несколько переменных разделяется знаком &:

Кроме того, чтобы задавать параметры в URL, можно воспользоваться формами HTML. В вызывающей странице пишем так:

Так это выглядит:

При этом пользователь увидит форму из одного поля ввода (var1), в нем будет значение по умолчанию «default». Второе поле (var2) будет невидимо и будет передавать всегда фиксированное значение «var2value». Кнопка «Submit Form» завершает заполнение формы и передает все переменные на test.asp (action). Если method=»get», переменные передаются через URL (test.asp?var1=default&var2=var2value). Если method=»post», передаются вместе с запросом так, что внешне передача переменных не заметна. В вызываемой программе безразлично, какой метод изпользовался (почти). Если у вас нет специальных аргументов за метод GET, используйте метод POST.

Формы

Формы HTML используются для организации диалога с пользователем. Поддерживаются стандартные элементы управления. Все многообразие задается немногими тэгами:

  • INPUT (с параметром TYPE=)
  • SELECT
  • TEXTAREA

Описание – в документации по HTML.

Взаимосвязь между отдельными страницами

Обычно сервер WWW не хранит состояние приложения, т.е. все запросы взаимонезависимы, и нет стандартного способа понять, что несколько запросов пришли от одного и того же пользователя. Но это очень нужно для разработки полноценных приложений и является одной из главных проблем разработки Web-приложений.

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

ASP, используя cookies, предоставляет программисту более простое средство — объект Session (сессия). Сессия стартует, когда новый пользователь обращается к любому asp-файлу приложения. Сессия заканчивается при отсутствии активности пользователя в течение 20 минут, либо по явной команде. Специальный объект Session хранит состояние сессии. Туда можно записывать переменные, которые доступны из любой страницы в этой сессии. Записать данные в этот объект можно просто:

Считать потом еще проще:

Сессия, таким образом, – это еще один метод передачи данных между страницами. Одна страница пишет данные в сессию, другая – берет потом оттуда.

Наряду с объектом Session существует объект Application . Если сессия создается для каждого нового пользователя, до Application существует в единственном экземпляре, и может использоваться всеми страницами приложения.

Управление приложением

Программисту предоставляется возможность реагировать на 4 события: старт/стоп приложения и старт/стоп каждой сессии. Для реализации этих событий предназначен файл global.asa , который должен располагаться в корневом каталоге приложения. Вот его примерный скелет:

Нужно «просто» вписать Ваш код на соответствующее место. Нужно заметить, что отлаживать код для global.asa довольно непросто, так как он выполняется при очень специфических обстоятельствах (к примеру при старте или остановке сервера).

Использование внешних компонент

Если на сервере установлены дополнительные компоненты, их можно использовать из ASP. Стандартные объекты (например из библиотек ADO (Connection и Recordset) и Scripting (Dictionary, FileSystemObject)) доступны всегда. Установка новой компоненты обычно состоит в копировании dll-файла в каталог на сервере и ее регистрации с помощью программы regsvr32.exe. [В COM+ используется своя процедура инсталляции объектов, это однако не влияет на использования объектов.]

Создать экземпляр объекта можно так:

Class.Object указываются в документации на компоненту. В переменной var запоминается ссылка на созданный экземпляр объекта. Когда объект не нужен, ссылку нужно обнулить с помощью команды:

Пожалуйста всегда обнуляйте все ссылки на объекты, когда они больше не нужны. Теоретически это должно происходить автоматически при завершении процедуры/страницы, однако в стандартной сборке мусора есть определенные «проблемы».

В остальном использование компоненты зависит от самой этой компоненты.

Работа с базами данных

Из ASP можно легко и просто работать с любыми базами данных. Это делается через две промежуточные технологии: ODBC и ADO.

ODBC позволяет организовать доступ к любым базам данных через унифицированный интерфейс с помощью языка SQL. Специфика конкретных СУБД учитывается при помощи специальных драйверов БД. Такие драйверы существуют для всевозможных СУБД (в частности SQL Server, Oracle, Access, FoxPro). Поддержка ODBC обеспечивается на уровне операционной системы Windows (NT). Настройка – через Control Panel/ODBC. Базовым понятием является источник данных или data source. Источник данных – это совокупность сведений о базе данных, включая ее драйвер, имя компьютера и файла, параметры. Чтобы пользоваться базой надо создать источник данных для нее. Важно, чтобы источник данных был «системным», в отличии от «пользовательского». После этого надо лишь знать имя источника данных. [В настоящее время ODBC отступает перед натиском технологии OLE DB. На практике это однако практически ничего не изменяет. Вместо имени источника данных нужно использовать Connection String, в которой указывается имя ODBC-драйвера и все его параметры.]

ADO – это совокупность объектов, доступных из ASP, позволяющих обращаться к источнику данных ODBC [или OLE DB]. Фактически нужны лишь 2 объекта – Connection , представляющий соединение с базой данных и Recordset , представляющий набор записей, полученный от источника. Сначала необходимо открыть соединение, потом к нему привязать Recordset, потом, пользуясь методами Recordset’а, обрабатывать данные. Вот пример:

Если команда SQL не возвращает данных, recordset не нужен, надо пользоваться методом Conn. Execute (SQL_COMMAND).

Если Вы хотите вызывать хранимые процедуры сервера БД с параметрами, нужно воспользоваться объектом Command , который в свою очеред содержит объекты Parameter .

Методики программирования, советы


Описание переменных

VBScript — очень нетребовательный к программисту язык. Так он не требует описывать переменные и не содержит явных типов данных. Все переменные принадлежат одному типу Variant . Из-за отсутствия описаний могут произойти очень трудно обнаруживаемые ошибки. Одна опечатка может стоить полдня поисков.

Однако, есть возможность явно потребовать описания переменных. Для этого первой строкой в ASP-файле нужно написать Option Explicit . После этого обращение к переменной, которая не была объявлена с помощью Dim , вызывает ошибку с указанием номера строки.

Кстати, где расположены описания Dim в процедуре — совершенно не важно. Они могут стоять как до использования переменной, так и после, и даже в цикле. Видимо они отрабатываются препроцессором. Явно задать тип переменной с помощью Dim Var as Typ , как в Visual Basic, все равно нельзя.

Чередование ASP/HTML

Если нужно выдать большой кусок HTML, можно не пользоваться Response.Write. Если в asp-файле встречается кусок текста вне скобок , он трактуется просто как HTML, который надо вывести. Пример:

Обработка ошибок

Для отслеживания ошибок используется специальный объект Err . Он устанавливается в ненулевое значение, если предыдущая команда породила ошибку. Ее можно проверять с помощью If, и таким образом реагировать на ошибки. Чтобы из-за ошибки не прерывалось выполнение программы, в начале нужно включить команду

Включение других файлов

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

Важно: все includes в тексте отрабатываются до исполнения файла. Т.е. даже если include стоит внутри if, то сначала будут включены все includes во всех ветках, и только потом, во время исполнения, будет принятно решение, какую ветку выполнять. Т.е. следующий код не дает условного включения файлов:

Обработка форм

Если надо что-то спросить у пользователя и на основании этого что-то сделать, в простейшем случае создается два файла: один с формой, второй – с ее обработчиком. Обработчик выполняет все действия. Пример:

Рекурсивная обработка форм

Удобный метод состоит в том, чтобы сбор данных и обработку осуществлял один и тот же файл. Для этого пишется asp, в котором есть разные разделы. Специальная переменная отвечает за выбор раздела при запуске. Пример:

Переменные HTTP

Запрос от браузера, кроме запрашиваемой страницы несет еще некоторые данные. Эти данные, например, IP-адрес клиента, доступны через специальные переменные объекта Request. IP-адрес – Request(«REMOTE_ADDR»). Другие — см.документацию (ASPSamp\Samples\srvvar.asp).

Переадресация

Очень легко написать на ASP скрипт, который будет производить некоторые расчеты, и в зависимости от результатов переадресовывать браузер на разные URL (например, подставлять нужный баннер). Делается это так:

Только надо следить, чтобы до выполнения команды redirect ничего не было записано в Response (даже коментарии HTML).

Электронная почта

Одна из часто встречающихся задач – отправить электронную почту с Web-страницы. На первый взгляд, можно просто написать

Но это приводит к тому, что при отправке формы делается попытка на клиентской машине запустить почтовую программу и создать новое сообщение с данными формы. Если это не получается (почтовая программа не настроена, пользователь не отправил почту, и т.д.) — письмо и не будет отправлено. Гораздо надежнее работает серверное решение.

Для этого существуют внешние компоненты, есть и бесплатные. Например, компонента Jmail от Dimac. Все, что для нее нужно – это адрес SMTP-сервера. Вот пример ее использования:

Ваше первое ASP.NET 5 веб приложение, созданное при помощи Visual Studio¶

В этом руководстве вы увидите, как создать простое веб приложение при помощи ASP.NET 5. В этом приложении данные будут связаны с базой данных SQL при помощи Entity Framework (EF), а ASP.NET MVC будет поддерживать операции CRUD.

Начальные реквизиты¶

Прежде чем начать, убедитесь, что вы сделали вот это: Установка ASP.NET 5 для Windows. Мы предполагаем, что у вас установлена Visual Studio 2015 и последняя версия среды и инструментария ASP.NET 5.

Дополнительную информацию по установке ASP.NET 5 на других платформах вы можете получить тут: Начинаем.

Создание нового ASP.NET 5 проекта¶

Запустите Visual Studio 2015. Из меню File выберите New > Project.

Выберите шаблон ASP.NET Web Application. Он находится в Installed > Templates > Visual C# > Web. Назовите проект ContosoBooks и нажмите OK.

В диалоговом окне New ASP.NET Project выберите Web Application под ASP.NET 5 Preview Templates. Кроме того, убедитесь, что галочка не стоит на Host in the cloud, и нажмите OK.

Не меняйте метод аутентификации. Оставьте по умолчанию Individual User Accounts.

Запуск приложения по умолчанию¶

После того как Visual Studio закончит создание приложения, запустите его, нажав Debug -> Start Debugging. Как вариант, вы можете нажать F5.

Для инициализации Visual Studio и нового приложения может потребоваться время. После завершения браузер покажет запущенное приложение.

После запуска приложения закройте браузер и нажмите на иконку “Stop Debugging” в Visual Studio, чтобы остановить приложение.

Просмотр проекта¶

В Visual Studio окно Solution Explorer позволяет вам управлять файлами проекта. Шаблон веб приложения, который вы использовали для создания этого приложения, добавляет следующую базовую структуру папок:

Visual Studio создает некоторые начальные файлы и папки для проекта. Вот первичные файлы, с которыми вам стоит ознакомиться:

Имя файла Цель
project.json Присутствие файла project.json определяет проект .NET Execution Environment (DNX). В файле project.json содержится вся информация, которая нужна DNX, чтобы запустить и упаковать ваш проект. Дополнительную информацию, включая файловую схему project.json, вы можете найти тут: see Работа с DNX проектами.
global.json Visual Studio использует этот файл для конфигурации проекта.
appsettings.json Этот файл позволяет вам включать дополнительную информацию о проекте. Дополнительную информацию вы можете получить тут: Конфигурация.
Startup.cs Класс Startup является начальной точкой приложения. В классе Startup должен быть определен метод Configure , кроме того, здесь может быть определен метод ConfigureServices , и он может быть вызван при запуске приложения. Дополнительную информацию вы можете получить тут: Запуск приложения.
Index.cshtml Здесь view содержит HTML для основной страницы.
_Layout.cshtml Здесь view содержит общий HTML для разных страниц веб приложения.
HomeController.cs Этот controller содержит классы, которые обрабатывают входящие запросы браузера, получают модельные данные, а затем определяют шаблоны представлений, которые возвращают ответ браузеру.

Понимание MVC¶

В этом проекте используется MVC. MVC обозначает Model-View-Controller (модель-представление-контроллер). MVC — это паттерн для разработки приложений, и эти приложения хорошо структурированы, их можно протестировать и легко поддерживать. MVC приложения содержат:

  • Models: Классы, которые представляют данные этого приложения, а затем используют логику валидации для связывания бизнес-правил и данных.
  • Views: Шаблонные файлы, которые использует приложение для динамичных HTML ответов.
  • Controllers: Классы, которые обрабатывают входящие браузерные запросы, получают модельные данные, а затем определяют представления, которые возвращают ответ браузеру.

Понимание .NET Core¶

.NET Core 5 — это модальная реализация среды разработки и библиотек, которая включает в себя некоторые аспекты .NET Framework. .NET Core 5 разрабатывается для Windows, Linux и OS X. .NET Core 5 состоит из набора библиотек “CoreFX” и маленькой среды разработки “CoreCLR”. .NET Core имеет открытый исходный код, так что вы можете отслеживать развитие проекта на GitHub. Больше информации вы можете получить тут: Выбор правильного .NET сервера.

Entity Framework¶

Entity Framework (EF) — это ORM (object-relational mapping) фреймворк. Он позволяет работать с реляционными данными как с объектами, и при этом вам нужно писать намного меньше кода для доступа к данным, чем обычно. Используя EF, вы можете работать с запросами при помощи LINQ, затем получать и обрабатывать данные как строго типизированные объекты. LINQ предлагает паттерны для запроса и обновления данных. Использование EF позволяет сфокусироваться на остальной части проекта, а не на основах доступа к данным.

Откройте файл project.json. В разделе dependencies вы увидите следующие строки, связанные с EF:

Здесь показано, что вы можете использовать команды EF из командного окна, а также что пакет EF NuGet включен в ваш проект.

Создание модели данных и скаффолдинг¶

Entity Framework поддерживает парадигму разработки Code First. Code First позволяет определять модели данных при помощи классов. Класс — это конструкция, которая позволяет создавать собственные пользовательские типы, группируя переменные разных типов, методы и события. Классы могут работать с существующей базой данных или генерируют базу данных. В данном руководстве вы начнете с создания entity-классов, которые определяют модели данных для веб приложения. Затем вы создадите контекстные классы, которые управляют entity-классами и дают данным доступ к базе данных. Далее вы настроите EF и заполните базу данных.

Создание entity-классов¶

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

В веб приложении будет две сущности:

Вы определите класс для каждой из них в папке Models в Solution Explorer.

Модельный класс вы можете поместить в любое место вашего проекта. Папка Models — это просто соглашение.

Кликните правой кнопкой мышки по папке Models и выберите Add > New Item. В диалоговом окне Add New Item выберите шаблон Class. В поле Name напишите “Author.cs” и нажмите OK.

Замените код по умолчанию следующим кодом:

Повторите эти шаги для создания другого класса Book со следующим кодом:

Чтобы не уложнять приложение, пусть у каждой книги будет один автор. Свойство Author определяет способ управления отношениями между автором и книгой. В EF этот тип свойства называется navigation property. Когда EF создает схему базы данных, EF автоматически вставляет AuthorID , и это будет вторичным ключом для таблицы Authors.

Скаффолдинг¶

Скаффолдинг сохраняет ваше время и усилия, автоматически генерируя начальную точку для операций CRUD вашего приложения. Начав с простого модельного класса и не написав ни единой строки кода, вы создаете два контроллера, которые содержат CRUD-операции, связанные с авторами и книгами, а также необходимые представления.

Чтобы добавить скаффолдинг кликните правой клавишей мышки по папке Controllers в Solution Explorer. Выберите Add –> New Scaffolded Item.

Если вы не видите опцию New Scaffolded Item, убедитесь, что при создании проекта вы использовали Individual User Accounts.

Из диалогового окна Add Scaffold выберите MVC 6 Controller with views, using Entity Framework, а затем нажмите на кнопку Add.

Далее, в диалоговом окне Add Controller в списке с модельными классами выберите Book (ContosoBooks.Models). Также установите контекстный класс на ApplicationDbContext (ContosoBooks.Models). Флажок на Generate views должен быть установлен. Нажмите на кнопку Add.

Как вы видите, диалоговое окно Add Controller дает вам возможность выбирать опции для создания контроллеров и представлений.

Этот скаффолд создает код, который предоставляет контроллер и набор представлений. В представлениях есть UI и код для создания, чтения, обновления, удаления и перечисления данных из базы данных.

Повторите вышеперечисленные шаги по скаффолдингу, чтобы создать контроллер Author и связанные с ним представления. Используйте модельный класс Author (ContosoBooks.Models) и контекстный класс ApplicationDbContext (ContosoBooks.Models), как показано на следующем рисунке.

В Solution Explorer вы увидите, что новые контроллеры добавлены в папку Controller, а новые представления в папку Views.

Настройка приложения перед добавлением данных¶

Далее, к приложению нужно добавить пакет Microsoft.Extensions.DependencyInjection . В Solution Explorer найдите и откройте project.json. В разделе dependencies в конце раздела пропишите эту строку.

IntelliSense помогает вам, когда вы набираете. Когда вы сохраните project.json, Visual Studio автоматически даст ссылку на новый пакет.

После добавления этой строки раздел dependencies в файле project.json будет выглядеть вот так:

Добавление данных¶

Мы не будем вручную набирать данные — мы используем код, который заполнит базу данных. Добавьте класс SampleData в папке Models со следующим кодом:

Вы не будете вставлять этот класс данных в производственный код, но для нашего сценария он годится.

Далее, в Solution Explorer, откройте файл Startup.cs. Добавьте следующую строку кода в методе Configure:

После этого полный файл Startup.cs будет выглядеть вот так:

Обратите внимание, что в ConfigureServices приложение вызывает Configuration[«Data:DefaultConnection:ConnectionString»] , чтобы получить строку соединения с базой данных. Во время разработки эта настройка идет из файла appsettings.json. Когда вы разворачиваете приложение в производственной среде, вы устанавливаете строку соединения в переменную среды на хосте. Если Configuration API находит переменную среды с тем же ключом, то возвращает переменную среды, вместо того значения, что находится в appsettings.json.

Создание веб приложения¶

Чтобы убедиться, что все классы и изменения работают, вы должны создать приложение.

Из меню Build выберите Build Solution.

Отображается окно Output, и если все прошло успешно, вы увидите соответствующее сообщение.

Если же произошла ошибка, то просмотрите предыдущие шаги. Информация в окне Output покажет, в каком файле возникла проблема и где требуется изменение. Эта информация поможет вам определить, какие предыдущие шаги вам стоит повторить, чтобы устранить проблему.

Прежде чем запустить приложение, вы должны создать БД, используя миграцию данных.

Использование миграции данных для создания базы данных¶

Миграция данных в EF используется для обновления моделей во всем приложении. Изначально используя миграцию данных для создания базы данных, вы можете легко изменить базу, после того как была изменена модель. Это позволит вам более эффективно создавать и поддерживать приложение. Альтернативой миграции данных, когда требуются изменения в модели или схеме после изменения базы данных, является пересоздание всей базы данных.

Откройте Command Prompt в директории проекта (ContosoBooks/src/ContosoBooks).

Чтобы открыть Command Prompt, кликните правой кнопкой мышки по кнопке start в Windows и выберите из меню Command Prompt.

Чтобы найти директорию проекта, кликните правой кнопкой мышки в Visual Studio по имени проекта (ContosoBooks) в Solution Explorer и выберите Open Folder in File Explorer. Скопируйте путь к проекту из File Explorer в Command Prompt. Например, введите следующее из Command Prompt, чтобы сменить директорию:

Убедитесь, что вы перешли к папке ContosoBooks, что в папке src.

Из Command Prompt запустите следующие команды:

Если dnu restore не распознается, вам нужно полностью повторить шаг с начальными реквизитами (или частично). Но сперва вам надо проверить Active версию .NET Version Manager (dnvm). Чтобы сделать это, введите dnvm list в командной строке. Если рядом с какой-либо версией нет *, установите активную версию, то есть, введите dnvm use 1.0.0-rc1-update1 -p , так что нужная версия будет выбрана.

.NET Version Manager (dnvm) — это набор утилит командной строки, которые используются для обновления и конфигурации .NET Runtime.

DNX обозначает .NET Execution Environment. Команда ef указана в файле project.json проекта. Больше информации по dnvm , dnu , and dnx , вы можете получить тут: DNX Overview.

Команда “ add Initial ” создает миграцию “Initial”, которая добавляет в проект код, позволяя EF обновлять схему базы данных. Команда update создает актуальную базу данных. После запуска этой команды папка Migrations будет обновлена:

Если вы хотите получить помощь по EF командам, введите следующее в командной строке: dnx ef -? . Для помощи с командой add введите следующее: dnx ef migrations add -? . А для помощи с командой update — следующее: dnx ef database update -? .

Кроме того, вы сможете увидеть новую базу данных в SQL Server Object Explorer.

Добавление навигации¶

Обновите навигацию для веб приложения. Из Solution Explorer откройте файл Views/Shared/_Layout.cshtml. Найдите следующий код:

Замените выше представленный код вот этим:

Данные изменения добавят ссылку к представлению Books и ссылку к представлению Authors. Вы создали эти представления, когда добавили в проект скаффолдинг.

Создание веб приложения¶

Чтобы убедиться, что все работает, вам снова нужно собрать приложение.

Из меню Build выберите Build Solution.

Локальный запуск веб приложения¶

Запустите приложение, чтобы увидеть, как выглядит вся продукция или категория продуктов.

В Solution Explorer кликните правой клавишей мышки по названию проекта и выберите View -> View in Browser. Либо же просто нажмите F5.

Откроется браузер и покажет приложение. Нажмите на ссылку Books вверху страницы.

Закройте браузер и нажмите на иконку “Stop Debugging” в Visual Studio.

Публикация приложения на Azure¶

В Solution Explorer в Visual Studio кликните правой кнопкой мышки по проекту и выберите Publish.

В окне Publish Web нажмите на Microsoft Azure Web Apps и залогиньтесь на Azure.

После этого нажмите New, чтобы создать на Azure новое приложение.

Назовите сайт, выберите сервисный план, ресурсную группу и регион. Также выберите сервер базы данных, а также имя пользователя и пароль к нему. Если вы уже создавали сервер базы данных, используйте его. После этого нажмите Create.

В Connection в окне Publish Web нажмите Publish.

Прогресс публикации вы можете просмотреть в окне Output или в окне Azure App Service Activity в Visual Studio.

После публикации на Azure ваше приложение, запущенное на Azure, будет отображено в браузере.

Дополнительная информация доступна вот тут: Publishing and Deployment.

Классический ASP: запустить код в начале каждого запроса перед обработкой фактического файла .asp

December 2020

519 раз

Это классический ASP, работает на IIS 8.5.

Мне нужно, чтобы запустить некоторые VBScript, которые должны быть общими для всех моих * .asp страниц в начале каждого запроса Http тех * .asp файлы.

В настоящее время я использую #include тег в верхней части каждого , и каждый * .asp файл. Я ссылку на файл , который содержит код , который я хочу бежать.

Это делает трюк, но это некрасиво и опасно: если один из * .asp файлов происходит пропустить #include тег, код не будет работать.

Есть ли способ, чтобы сделать некоторые код запуска для каждого запроса * .asp, без необходимости писать код внутри каждого * .asp файла?

В ASP.NET у нас есть HttpApplication.BeginRequest событие. То , что я ищу что — то , что эквивалентно, но в классическом ASP. Мне нужно , чтобы запустить некоторые VBScript , который способен получить доступ к объектам Классический ASP в начале каждого запроса * .asp.

Изменить: согласно запросу @ Кул-ТИГИН, это причина того, что я хочу сделать это: Мои файлы * .asp кодируются в ANSI. Но запросы URL приходит закодированы в UTF-8, которые порождают проблемы.

Если я ничего не делаю, двигатель ASP декодирует URL (и строку запроса) , как если бы они были в ANSI. Например: строка запроса ?value=ç будет отправлена в браузере как ?value=%C3%A7 . C3A7 являются байты для «C» в кодировке UTF-8. Но двигатель ASP считывает 2 байта , как 2 отдельных символов ANSI. Так что , если я ничего не делать, то Request.QueryString(«value») будет строка с длиной 2, с содержанием «Â§».

Чтобы исправить это, я создал следующий обходной путь, который работает:

Я не забочусь о «Foo» строки запроса, он может даже не существовать. Я просто делаю , что «потрогать» десериализации двигателя ASP Строка запроса. Aparently она декодирует все значения строки запроса в первый раз он используется во время обработки запроса. Таким образом, даже после установки CodePage обратно в 1252, в моем предыдущем примере, если я прочитал конкретную строку запроса , Request.QueryString(«value») это будет длиной 1 строка , содержащая «ç», а intented.

Я поставил код обходного пути в workaround.inc файл, и включил его в начале большинства моих * .asp файлов, которые решили эту проблему сейчас. Но есть более тысячи * .asp файлы и многое другое еще предстоит разработать. Это невозможно сделать , что все из них в том числе workaround.inc , поэтому я хотел , чтобы запустить код для всех * запросов .asp , независимо от включаемого тега.

Я ценю вашу заботу о моей проблеме. Если вы можете представить лучшее решение, которое я бы очень счастлив. Спасибо!

Илон Маск рекомендует:  Что такое код excludecliprect
Понравилась статья? Поделиться с друзьями:
Кодинг, CSS и SQL