通过

SOAP 和 HTTP 终结点

  • 项目

SoapAndHttpEndpoints 示例演示如何使用 WCF Web 编程模型实现基于 RPC 的服务并以 SOAP 格式和“Plain Old XML”(POX) 格式进行公开。 有关服务的 HTTP 绑定的更多详细信息，请参见基本 HTTP 服务示例。 本示例重点介绍有关使用不同绑定通过 SOAP 和 HTTP 公开相同服务的详细信息。

演示

使用 WCF 通过 SOAP 和 HTTP 公开 RPC 服务。

讨论 (Discussion)

本示例由两个组件组成：一个包含 WCF 服务的 Web 应用程序项目（服务），以及一个使用 SOAP 和 HTTP 绑定调用服务操作的控制台应用程序（客户端）。

WCF 服务公开 2 个操作：GetData 和 PutData，后者回显作为输入传递的字符串。 这些服务操作使用 WebGetAttribute 和 WebInvokeAttribute 进行批注。 这些特性控制这些操作的 HTTP 投影。 此外，这些操作使用 OperationContractAttribute 进行批注，从而使其可以通过 SOAP 绑定进行公开。 服务的 PutData 方法引发 WebFaultException，该异常使用 HTTP 状态代码通过 HTTP 发回，通过 SOAP 作为 SOAP 错误发回。

Web.config 文件通过 3 个终结点配置 WCF 服务：

  • ~/service.svc/mex 终结点，公开服务元数据供基于 SOAP 的客户端访问。

  • ~/service.svc/http 终结点，使客户端可以使用 HTTP 绑定访问服务。

  • ~/service.svc/soap 终结点，使客户端可以使用 SOAP over HTTP 绑定访问服务。

HTTP 终结点通过 <webHttp> 标准终结点进行配置，该标准终结点的 helpEnabled 设置为 true。 因此，服务在 ~/service.svc/http/help 上公开基于 XHTML 的页面，基于 HTTP 的客户端可以使用该页面访问服务。

客户端项目演示如何使用 SOAP 代理（通过“添加服务引用”生成）访问服务以及如何使用 WebClient 访问服务。

该示例包含一个 Web 承载的服务和一个控制台应用程序。 在控制台应用程序运行时，客户端会对服务进行请求，并将响应中的相关信息写入控制台窗口。

运行示例

  1. 打开 SOAP 和 HTTP 终结点示例的解决方案。

  2. 按 CtrlShiftB 以生成解决方案。

  3. 如果它尚未打开，请按 Ctrl+W 再按 S 打开“解决方案资源管理器”窗口。

  4. 在“解决方案资源管理器”窗口中，右击“服务”项目，将光标放在“调试”上下文菜单选项上以显示“启动新实例”上下文菜单。 单击“启动新实例”。 这将启动承载服务的 ASP.NET 开发服务器。

  5. 在“解决方案资源管理器”窗口中，右击客户端项目，将光标放在“调试”上下文菜单选项上以显示“启动新实例”上下文菜单。 单击“启动新实例”。

  6. 出现客户端控制台窗口，该窗口提供了正在运行的服务的 URI，以及该服务的 HTML 帮助页的 URI。 可随时通过在浏览器中键入 HTML 帮助页的 URI 来查看该帮助页。

  7. 在示例运行时，客户端将写入当前活动的状态。

  8. 按任意键可终止客户端控制台应用程序。

  9. 按 Shift+F5 可停止调试服务。

  10. 在 Windows 通知区域中，右击 ASP.NET 开发服务器图标，然后从上下文菜单中选择“停止”。