Windows Communication Foundation (WCF) 可以创建公开支持 ASP.NET AJAX 的终结点在客户端网站上可从 JavaScript 中调用的服务。 中介绍了用于构建此类服务的基本过程如何:使用配置来添加 ASP.NET AJAX 终结点和如何:添加 ASP.NET AJAX 终结点而不使用配置。
ASP.NET AJAX 支持使用 HTTP POST 和 HTTP GET 谓词(HTTP POST 为默认谓词)的操作。 创建没有任何副作用并返回很少或从不进行更改的数据的操作时,应改用 HTTP GET。 GET 操作的结果可以缓存,这意味着对相同操作的多次调用可能导致只请求一次服务。 缓存不是由 WCF,但可以发生在任何级别 (用户的浏览器中,代理服务器和其他级别上。)如果要提高服务性能,则使用缓存会比较有利,但在数据频繁更改或操作执行某些动作时可能不可行。
例如,如果设计服务来管理用户的音乐库,则基于唱片集的标题查找艺术家的操作可以从使用 GET 中获益,但是将唱片集添加到用户的个人收藏集的操作必须使用 POST。
若要控制缓存的生存期,请使用 xref:System.ServiceModel.Web.OutgoingWebResponseContext 类型。 例如,在设计返回每小时更新的天气预报时会使用 GET,但应将缓存持续时间限制在一小时以内,以防止服务的用户访问过时的数据。
在使用来自使用脚本管理器控件的 ASP.NET AJAX 页上的服务时,操作是使用 GET 还是 POST 并没有区别,脚本管理器机制会确保发出正确的请求类型。
HTTP GET 操作使用由 POST 操作支持的任何输入参数,其中包括复杂的数据协定类型。 但是,大多数情况下建议避免在 GET 操作中使用太多的参数或太复杂的参数,原因是这样会降低缓存的效率。
本主题演示了如何通过在服务协定中将 xref:System.ServiceModel.Web.WebGetAttribute 或 xref:System.ServiceModel.Web.WebInvokeAttribute 属性添加到相关的操作以在 GET 和 POST 之间选择。 类似于所使用的 WCF 中的任何 ASP.NET AJAX 服务的其他步骤 (实现、 配置和承载服务) 所需运行此服务。
以 xref:System.ServiceModel.Web.WebGetAttribute 标记的操作始终使用 GET 请求。 以 xref:System.ServiceModel.Web.WebInvokeAttribute 标记或未以这两个属性中的任何一个进行标记的操作将使用 POST 请求。 通过 xref:System.ServiceModel.Web.WebInvokeAttribute 属性,xref:System.ServiceModel.Web.WebInvokeAttribute.Method* 允许使用 GET 和 POST 之外的其他 HTTP 谓词(如 PUT 和 DELETE 等)。 但是,ASP.NET AJAX 不支持这些谓词。 如果打算使用脚本管理器控件来使用来自 ASP.NET 页上的服务,请不要使用 xref:System.ServiceModel.Web.WebInvokeAttribute.Method* 属性。
切换到 GET 的工作示例,请参阅基本 AJAX 服务示例。
使用 POST 的示例,请参阅使用 HTTP POST 的 AJAX 服务示例。
创建响应 HTTP GET 或 HTTP POST 请求的 WCF 服务
-
使用标记的接口定义基本的 WCF 服务约定xref:System.ServiceModel.ServiceContractAttribute属性。 用 xref:System.ServiceModel.OperationContractAttribute 标记每个操作。 添加 xref:System.ServiceModel.Web.WebGetAttribute 属性以规定操作应响应 HTTP GET 请求。 也可以添加 xref:System.ServiceModel.Web.WebInvokeAttribute 属性来显式指定 HTTP POST,或不指定属性(默认设置为 HTTP POST)。
[ServiceContract] public interface IMusicService { //This operation uses a GET method. [OperationContract] [WebGet] string LookUpArtist(string album); //This operation will use a POST method. [OperationContract] [WebInvoke] void AddAlbum(string user, string album); //This operation will use POST method by default //since nothing else is explicitly specified. [OperationContract] string[] GetAlbums(string user); //Other operations omitted… } -
使用
IMusicService实现MusicService服务协定。public class MusicService : IMusicService { public void AddAlbum(string user, string album) { //Add implementation here. } //Other operations omitted… } -
在应用程序中创建一个名为 service 的新文件(扩展名为 .svc)。 编辑此文件添加适当的 @ServiceHost服务指令信息。 指定的xref:System.ServiceModel.Activation.WebScriptServiceHostFactory是要在中使用 @ServiceHost指令以自动配置 ASP.NET AJAX 终结点。
<%@ServiceHost language=c# Debug="true" Service="Microsoft.Ajax.Samples.MusicService" Factory=System.ServiceModel.Activation.WebScriptServiceHostFactory %>
调用服务
-
可以通过使用浏览器来测试服务的 GET 操作,而无需使用任何客户端代码。 例如,如果你的服务配置在
http://example.com/service.svc地址,然后键入http://example.com/service.svc/LookUpArtist?album=SomeAlbum到浏览器地址栏调用该服务,并使响应可以下载或显示。 -
可以像使用任何其他 ASP.NET AJAX 服务一样将服务与 GET 操作一起使用,即,在 ASP.NET AJAX 脚本管理器控件的“脚本”集合中输入相应的服务 URL。 有关示例,请参阅基本 AJAX 服务。
请参阅
历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
