大网数据广告活动
.NET 与 C# 开发

使用操作来实现服务器端行为

· 52CE 我爱测

OData 操作提供了用于实现这样一种行为方法,即该行为将作用于从 OData 服务检索的资源。 例如,请考虑将一部数字电影作为资源,你可能需要完成许多事情:签出、评级/注释或签入。 这些是用于管理数字电影的 WCF 数据服务可能实现的所有动作示例。 动作在 OData 响应中描述,而此响应包含对其调用此动作的资源。 当用户请求表示数字电影的资源时,从 WCF 数据服务返回的响应将包含有关可用于该资源的动作的信息。 动作的可用性可能取决于数据服务或资源的状态。 例如,一旦数字电影已被签出,其他用户就无法签出。 客户只需指定 URL 即可调用动作。 例如,http://MyServer/MovieService.svc/Movies(6)将标识特定的数字电影和http://MyServer/…

OData 操作提供了用于实现这样一种行为方法,即该行为将作用于从 OData 服务检索的资源。 例如,请考虑将一部数字电影作为资源,你可能需要完成许多事情:签出、评级/注释或签入。 这些是用于管理数字电影的 WCF 数据服务可能实现的所有动作示例。 动作在 OData 响应中描述,而此响应包含对其调用此动作的资源。 当用户请求表示数字电影的资源时,从 WCF 数据服务返回的响应将包含有关可用于该资源的动作的信息。 动作的可用性可能取决于数据服务或资源的状态。 例如,一旦数字电影已被签出,其他用户就无法签出。 客户只需指定 URL 即可调用动作。 例如,http://MyServer/MovieService.svc/Movies(6)将标识特定的数字电影和http://MyServer/MovieService.svc/Movies(6)/Checkout像调用对这部特定电影的操作。 动作使您能够公开服务模型,但不必公开数据模型。 继续探讨此电影服务示例,您可能希望允许用户对电影评级,但不能直接将评级数据公开为资源。 您可以实现评级动作,以使用户能够对电影评级,但不能直接将评级数据作为资源进行访问。

实现动作

若要实现服务动作,您必须实现xref:System.IServiceProvider, IDataServiceActionProvider,和IDataServiceInvokable接口。 xref:System.IServiceProvider 使 WCF 数据服务获取的实现IDataServiceActionProvider。 IDataServiceActionProvider使 WCF 数据服务能够创建、 查找、 描述和调用服务操作。 IDataServiceInvokable ,可调用实现服务动作行为的代码和获取结果,如果有的话。 请记住,WCF 数据服务是“每次调用”的 WCF 服务,也即,每次调用此服务时,都会创建此服务的一个新实例。 确保创建此服务时不执行多余的任务。

IServiceProvider

xref:System.IServiceProvider 包含一个名为 xref:System.IServiceProvider.GetService* 的方法。 WCF 数据服务调用此方法来检索一些服务提供程序,包括元数据服务提供程序和数据服务动作提供程序。 当要求提供数据服务操作提供程序,请返回您IDataServiceActionProvider实现。

IDataServiceActionProvider

IDataServiceActionProvider包含可用于检索有关可用操作的信息的方法。 当您实现IDataServiceActionProvider在你的服务的服务的实现定义的扩展元数据IDataServiceActionProvider的操作和处理调度的根据这些操作。

AdvertiseServiceAction

AdvertiseServiceAction 方法调用以确定哪些操作可用于指定的资源。 仅针对并非始终可用的动作才调用此方法。 该方法用于根据所请求的资源状态或服务状态,检查动作是否应包含在 OData 响应中。 如何实现这一检查完全由您决定。 如果计算可用性的代价很高,并且当前资源处于源中,则可以跳过此检查并公布动作。 如果要返回的当前资源是源的一部分,则 inFeed 参数设置为 true。

CreateInvokable

CreateInvokable调用来创建IDataServiceInvokable ,其中包含用于封装实现操作的行为的代码的委托。 这将创建IDataServiceInvokable实例,但不会调用该操作。 WCF 数据服务动作具有副作用,需要与更新提供程序结合使用才能将这些更改保存到磁盘。 IDataServiceInvokable.Invoke从更新提供程序的 savechanges () 调用方法中调用方法。

GetServiceActions

此方法返回的集合ServiceAction表示 WCF 数据服务公开的操作的所有实例。 ServiceAction的操作,包括信息,如操作名称、 其参数和它的返回类型的元数据表示形式。

GetServiceActionsByBindingParameterType

此方法返回的所有集合ServiceAction可以绑定到指定的绑定参数类型的实例。 换而言之,所有ServiceActions 可操作的指定的资源类型 (也称为绑定参数类型)。该服务返回资源以便包含可以针对该资源调用的操作的信息时使用。 此方法应只返回可绑定到确切绑定参数类型(无派生类型)的动作。 此方法针对遇到的每个请求和每种类型调用一次,结果由 WCF 数据服务进行缓存。

TryResolveServiceAction

此方法搜索指定ServiceAction ,并返回true如果ServiceAction找到。 如果找到, ServiceAction中返回serviceAction``out参数。

IDataServiceInvokable

此接口提供执行 WCF 数据服务动作的方法。 当实现 IDataServiceInvokable 时,您应负责三件事:

  1. 捕获并可能封送处理参数

  2. 将参数调度到在调用 Invoke() 时实际实现动作的代码

  3. 存储来自 Invoke() 的任何结果,以便可以使用 GetResult() 检索这些结果

参数可作为标记进行传递。 这是因为可以编写与表示资源的标记结合使用的数据服务提供程序,如果是这种情况,则您可能需要将这些标记转换(封送处理)为实际资源,然后才能调度到实际动作。 封送参数后,它必须处于可编辑状态,以便对资源调用操作时出现的任何更改将保存并写入到磁盘。

此接口需要两个方法:调用和 GetResult。 Invoke 调用用于实现动作行为的委托,而 GetResult 返回此动作的结果。

调用 WCF 数据服务动作

可以使用 HTTP POST 请求来调用动作。 URL 指定资源(后跟动作名称)。 参数在请求的正文中传递。 例如,假设有一个名为 MovieService 的服务,该服务公开了一个名为 Rate 的动作。 您可以使用下面的 URL 针对特定电影调用 Rate 动作:

http://MovieServer/MovieService.svc/Movies(1)/Rate

Movies(1) 指定您要评级的电影,而 Rate 指定 Rate(评级)动作。 评级的实际值将位于 HTTP 请求的正文中,如以下示例所示:

POST http://MovieServer/MoviesService.svc/Movies(1)/Rate HTTP/1.1   
Content-Type: application/json   
Content-Length: 20   
Host: localhost:15238  
{   
   "rating": 4   
}  

Warning: 上面的示例代码只能与支持轻型 JSON 的 WCF 数据服务 5.2 和更高版本结合使用。 如果使用 WCF 数据服务的更低版本,您必须指定 json 详细内容类型,如下所示:application/json;odata=verbose。

此外,你也可以使用 WCF 数据服务客户端调用动作,如下面的代码段所示。

MoviesModel context = new MoviesModel (new Uri("http://MyServer/MoviesService.svc/"));  
//...  
context.Execute(new Uri("http://MyServer/MoviesService.svc/Movies(1)/Rate"), "POST", new BodyOperationParameter("rating",4) );

在上面的代码段中,通过使用 Visual Studio 将服务引用添加到 WCF 数据服务,从而生成了 MoviesModel 类。

请参阅

历史资料。此文对应 2019-08-18 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / .NET 中文文档历史快照
适用范围
历史中文快照 2019-08-18;详见原文产品版本;文档日期 03/30/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。