详说Azure的服务运行时API

一、服务运行时API简介

微软的Windows Azure服务总线提供了一整套REST风格的API,其中包括服务运行时API(Service Runtime API)和服务管理API(Service Management API),分别用于运行时操作和管理操作。

那么,什么是REST呢?REST(Representational State Transfer表述性状态转移)是一种针对网络应用的设计和开发方式,它可以降低开发的复杂性,提高系统的可伸缩性。使用REST API,意味着我们可以使用任意的编程语言来开发应用程序,它只有一个前提,我们使用的编程语言必须要能够支持HTTP协议。使用REST API,我们就不再需要客户端的SDK。

二、服务运行时API和服务管理API的区别

服务运行时API和服务管理API有什么区别呢?

首先,要从两者运行的“位置”进行比较。服务运行时API运行于Windows Azure云的内部,API代码与云交互环境相勾连;而服务管理API运行于Windows Azure云的外部,可以通过调用服务管理API来操纵正在运行的服务。

其次,两者的功能也大不相同。服务运行时API主要用于动态查看服务信息;而服务管理API则用于Azure授权用户能够以编程的方式管理其部署、托管的服务以及存储账户。授权用户可以管理存储服务的生命周期,包括新建存储服务、更新存储服务、删除存储服务等。

服务运行时API有时也被认为是服务托管API。

三、服务运行时API的作用

服务运行时API有哪些作用呢?

1、WindowsAzure云上的Adapter服务可以通过调用服务运行时API来动态查询服务信息。比如可以访问应用的服务信息和用户的角色信息。还可以用于访问服务的拓扑信息,比如正在运行哪些角色、每个角色包含了多少个实例等等。

2、可以从配置文件中读取最新的设置。比如访问服务定义和服务配置文件中各项设置的最新的值,即使是服务配置正在更新,服务运行时API也能确保取得的值为最新状态。要注意,对于工作者角色,它与角色的生命周期是紧密绑定在一起的。

3、可以在配置文件更新后获取通知。 

四、服务运行时API的访问方式

服务运行时API有两种访问方式:

1、对于托管代码,SDK封装了整个Microsoft.WindowsAzure.ServiceRuntime.dll库。只要用Visual Studio创建了一个新

2、对于本地代码,头文件和库文件都被封装在SDK中,可以使用C语言调用服务运行时API。

要说明一点,本地库和托管库两者的功能是完全相同的,你可以选择任意一种访问方式,而且两者间的代码转换也是很容易的。

五、服务运行时API的命名空间

Microsoft.WindowsAzure.ServiceRuntime的命名空间详见下表所述。

描述

LocalResource

表示本地存储资源,托管服务所保留。

Role

表示定义的角色,作为托管服务的一部分。

RoleEntryPoint

在角色实例进行初始化、运行、停止时,提供运行代码的方法。

RoleEnvironment

提供运行角色实例的配置、端点和状态的信息。

RoleEnvironmentCharge

表示托管服务的配置发生了变化。

RoleEnvironmentChangedEventArgs

表示已更改事件的参数,当配置修改被应用到角色实例后使用。

RoleEnvironmentChangingEventArgs

表示待更改事件的参数,当配置修改被应用到角色实例前使用。

RoleEnvironmentConfigurationSettingChange

表示一个角色配置的修改。

RoleEnvironmentException

在访问RoleEnvironment类的属性和方法发生错误时所抛出的异常。

RoleEnvironmentStoppingEventArgs

表示停止事件的参数,当一个角色实例被停止时使用。

RoleEnvironmentTopologyChange

表示某个角色的拓扑结构发生变化。

RoleInstance

表示一个角色实例。

RoleInstanceEndpoint

表示一个角色实例相关联的端点。

RoleInstanceStatusCheckEventArgs

表示StatusCheck事件的参数,用于在内部定期时间间隔来指示一个角色实例的状态。

相关推荐