IIS - установка модуля ASP.NET, HttpModule

Материал из 1GbWiki.

Перейти к: навигация, поиск

В IIS/ASP.NET можно написать модуль (программный компонент) методы которого будут вызываться при обработке запросов средствами ASP.NET, обычно этот подход применяется для методов ЧПУ (человеко-понятные-урлы).

Содержание

[править] Тестовый модуль для примера

Специально для демонстрации был написан модуль с именем HttpTestModule, его код и бинарное представление (библиотека .dll) можно взять тут - testModule.rar (8kb). Единственное что делает модуль, - добавляет в заголовки HTTP-ответа заголовок с именем X-test и значением генерирующимся в момент исполнения методов модуля, например:

Изображение:Http-response-raw1.gif

[править] Размещение модуля

Допускается два варианта:

  • Сборка с модулем помещается в каталог bin приложения, это наиболее распространённый и удобный клиентам хостинга вариант, не требующий вмешательства службы поддержки. Явных ограничений тут нет.
  • Сборка помещается в GAC сервера, при этом при подключении (примеры ниже) необходимо использовать полное имя сборки, например:
<add name="testModule" type="InSolve.test.HttpTestModule, testModule, Version=1.0.0.0,
Culture=neutral, PublicKeyToken=04872ef5561d2c44" />

[править] Подключение модуля

[править] IIS 6

Добавьте в файл web.config код добавления модуля:

<configuration>
  <system.web>
    <httpModules>
      <add name="testModule" type="InSolve.test.HttpTestModule" />
     </httpModules>
  </system.web>
</configuration>

После этого модуль начнёт обрабатывать запросы к существующим файлам .aspx, например:

обработка всех запросов - в процессе написания

[править] IIS 7 - режим Integrated Pipeline (по умолчанию)

Важно! IIS 7 на хостинге 1Gb.ua размещает сайты в пул приложений для которого установлен интегрированный режим работы очереди. Если вам по каким-то соображениям нужен классический режим - вы можете обратиться в службу поддержки и оставить заявку на изменение режима работы для вашего сайта. Самостоятельно этого вы сделать не сможете.

Вы можете управлять веб-сервером IIS средствами редактирования файла Web.Config в корне приложения (сайта). Для подключения модуля необходимо добавить следующий код:

<configuration>
  <system.webServer>
    <modules>
      <add name="testModule" type="InSolve.test.HttpTestModule" />
    </modules>
  </system.webServer>
</configuration>

После этих изменений все запросы к файлам исполняемым ASP.NET (например, aspx - http://test.iis7.ru/test.aspx) будут приводить к исполнению методов модуля. Важно знать, что это не приведёт к исполнению модуля для запросов адресованных к статическим или любым другим типам ресурсов. Что бы обрабатывать все запросы необходимо задать параметр, указыавющий на необходимость исполнять все запросы средствами ASP.NET. Делается это следующим образом, для XML-элемента <modules> из предыдущего примера необходимо добавить следующий атрибут:

<modules runAllManagedModulesForAllRequests="true">

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

[править] IIS 7 - режим Classic Pipeline

в процессе написания

Этот режим создан для обратной совместимости с приложениями работающими под IIS 6. По возможности лучше пользоваться новым режимом IIS7 - Integrated Pipeline. Суть разницы двух режимов работы пула наглядно показана на видео Усовершенствования IIS 7.0: производительность.

[править] Ссылки по теме

Личные инструменты