Поделиться через

Конечные точки SOAP и HTTP

  • Статья

Данный образец демонстрирует реализацию службы на основе RPC и предоставление ее в формате протокола SOAP или формате "Plain Old XML" (POX) с помощью модели веб-программирования WCF. Дополнительные сведения о привязке HTTP для этой службы см. в образце Базовая служба HTTP. В данном образце акцент сделан на особенностях предоставления одной и той же службы через протокол SOAP и HTTP с использованием разных привязок.

Демонстрации

Предоставление службы RPC через протокол SOAP и HTTP с использованием WCF.

Обсуждение

Данный образец состоит из двух компонентов: проекта веб-приложения (служба), который содержит службу WCF, и консольного приложения (клиент), которое вызывает операции службы с использованием привязок протокола SOAP и HTTP.

Служба WCF предоставляет 2 операции — GetData и PutData, которые повторяют строку, переданную им на входе. Операции службы помечены атрибутами WebGetAttribute и WebInvokeAttribute. Эти атрибуты управляют HTTP-проекцией операций. Кроме того, они помечены атрибутом OperationContractAttribute, который позволяет предоставлять их через привязки протокола SOAP. Метод службы PutData вызывает исключение WebFaultException, которое отправляется обратно через HTTP с использованием кода состояния HTTP, а через SOAP как ошибка SOAP.

Файл Web.config конфигурирует для службы WCF следующие 3 конечные точки.

  • Конечная точка ~/service.svc/mex предоставляет доступ к метаданным службы клиентам на основе SOAP.

  • Конечная точка ~/service.svc/http позволяет клиентам получать доступ к службе с использованием привязки HTTP.

  • Конечная точка ~/service.svc/soap позволяет клиентам получать доступ к службе с использованием привязки протокола SOAP.

Конечная точка HTTP настроена как стандартная конечная точка <webHttp> с атрибутом helpEnabled, имеющим значение true. В результате этого служба предоставляет справочную страницу на основе XHTML по адресу ~/service.svc/http/help, которую клиенты на основе HTTP могут использовать для доступа к службе.

Клиентский проект демонстрирует доступ к службе с использованием прокси протокола SOAP (сформированного с помощью команды Добавить ссылку на службу) и доступ к службе с использованием клиента WebClient.

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

Выполнение образца

  1. Откройте решение для образца «SOAP and HTTP Endpoints».

  2. Нажмите клавишу F6 для построения решения.

  3. Если окно Обозреватель решений не открыто, нажмите клавиши CTRL+W, S, чтобы открыть его.

  4. В окне Обозреватель решений щелкните правой кнопкой мыши проект Service и поместите курсор над пунктом контекстного меню Отладка, чтобы отобразить контекстное меню Запустить новый экземпляр. Нажмите кнопку Запустить новый экземпляр. Запускается сервер разработки ASP.NET, на котором размещается служба.

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

  6. На клиенте открывается окно консоли с URI запущенной службы и URI HTML-страницы справки для запущенной службы. HTML-страницу справки можно просмотреть в любой момент времени, введя URI этой страницы в веб-обозревателе.

  7. Во время работы образца клиент записывает состояние текущего действия.

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

  9. Чтобы прекратить отладку службы, нажмите клавиши SHIFT+F5.

  10. В области уведомлений Windows щелкните правой кнопкой мыши значок сервера разработчика ASP.NET и выберите в контекстном меню пункт Остановить.

Ee818670.Important(ru-ru,VS.100).gif Примечание
Образцы уже могут быть установлены на компьютере. Перед продолжением проверьте следующий каталог (по умолчанию).

<диск_установки>:\WF_WCF_Samples

Если этот каталог не существует, перейдите на страницу Образцы Windows Communication Foundation (WCF) и Windows Workflow Foundation (WF) для .NET Framework 4, чтобы загрузить все образцы Windows Communication Foundation (WCF) и WF. Этот образец расположен в следующем каталоге.

<диск_установки>:\WF_WCF_Samples\WCF\Basic\Web\SoapAndHttpEndpoints