Класс System.Net.HttpListener

В этой статье приводятся дополнительные замечания к справочной документации по этому API.

HttpListener С помощью класса можно создать простой прослушиватель протокола HTTP, который отвечает на HTTP-запросы. Прослушиватель активен в течение всего времени существования HttpListener объекта и выполняется в приложении с его разрешениями.

Чтобы использовать HttpListener, создайте новый экземпляр класса с помощью HttpListener конструктора и используйте Prefixes свойство для получения доступа к коллекции, содержащей строки, указывающие, какие префиксы универсального идентификатора ресурса (URI) должны обрабатываться HttpListener .

Строка префикса URI состоит из схемы (http или https), узла, необязательного порта и дополнительного пути. Примером полной строки префикса является http://www.contoso.com:8080/customerData/. Префиксы должны заканчиваться косой чертой ("/"). Объект HttpListener с префиксом, который наиболее тесно соответствует запрошенным URI, отвечает на запрос. Несколько HttpListener объектов не могут добавить один и тот же префикс; Win32Exception исключение создается, если HttpListener добавляется префикс, который уже используется.

При указании порта элемент узла можно заменить на "*", чтобы указать, что HttpListener запросы, отправленные на порт, если запрошенный URI не совпадает с любым другим префиксом. Например, чтобы получать все запросы, отправляемые через порт 8080, если запрошенный URI не обрабатывается, HttpListenerпрефикс http ://*:8080/. Аналогичным образом, чтобы указать, что HttpListener все запросы, отправленные на порт, заменяют элемент узла символом "+". Например, https://+:8080. Символы "*" и "+" могут присутствовать в префиксах, которые включают пути.

Wild карта поддомены поддерживаются в префиксах URI, управляемых HttpListener объектом. Чтобы указать дикий карта поддомен, используйте символ "*" в качестве части имени узла в префиксе URI. Например, http://*.foo.com/. Передайте этот аргумент в качестве аргумента методу Add .

Чтобы начать прослушивание запросов от клиентов, добавьте префиксы URI в коллекцию и вызовите Start метод. HttpListener предлагает синхронные и асинхронные модели для обработки клиентских запросов. К запросам и связанным ответам обращаются с помощью HttpListenerContext объекта, возвращаемого методом GetContext или его асинхронными аналогами, BeginGetContext методами и EndGetContext методами.

Синхронная модель подходит, если приложение должно блокироваться во время ожидания клиентского запроса и если вы хотите обработать только один запрос за раз. С помощью синхронной модели вызовите GetContext метод, который ожидает отправки запроса клиенту. Метод возвращает HttpListenerContext объект для обработки при возникновении.

В более сложной асинхронной модели приложение не блокируется во время ожидания запросов, и каждый запрос обрабатывается в собственном потоке выполнения. BeginGetContext Используйте метод, чтобы указать определяемый приложением метод для каждого входящего запроса. В этом методе EndGetContext вызовите метод, чтобы получить запрос, обработать его и ответить.

В любой модели входящие запросы получают доступ к свойству HttpListenerContext.Request и представлены объектами HttpListenerRequest . Аналогичным образом ответы получают доступ к свойству HttpListenerContext.Response и представляются объектами HttpListenerResponse . Эти объекты совместно используют некоторые функциональные возможности с объектами и HttpWebResponse объектами, но последние объекты нельзя использовать в сочетании с HttpWebRequestHttpListener тем, что они реализуют клиент, а не сервер, поведение.

Может HttpListener потребоваться проверка подлинности клиента. Можно указать определенную схему, используемую для проверки подлинности, или указать делегат, определяющий используемую схему. Для получения сведений об удостоверении клиента требуется определенная форма проверки подлинности. Дополнительные сведения см. в Userразделе о свойствах AuthenticationSchemesи AuthenticationSchemeSelectorDelegate свойствах.

HTTP.sys

Класс HttpListener построен на основе HTTP.sysпрослушивателя режима ядра, который обрабатывает весь HTTP-трафик для Windows. HTTP.sys обеспечивает управление подключениями, регулирование пропускной способности и ведение журнала веб-сервера. Используйте средство HttpCfg.exe для добавления SSL-сертификатов.