Azure Services Bus(服务总线)中的工作流(workflow)

     在Azure Services Platform上对于工作流服务的支持，一直是我很感兴趣的内容。当然也是疑问
比较多的领域。鉴于这方面的资料太少，所以今天就从AzureServicesKit中的一个DEMO出发，来大概
了解一下这方面相关内容。

     注：今天的示例位于AzureServicesKit安装目录\Labs\Ex02-RoutingWithXPath\end文件夹。

     该示例场景展示的是一个定单(order)流程，如下图：



     注：图中的两个服务可能布置在1台或N台机器上。

     在上图中，我们看出在当前场景中存在两个服务，即：

    BillService（即定单生成）。
    ShipOrderService(定单处理：包括处理定单相关信息等)

     其中的BillService的代码如下：

[ServiceContract(Name = "Billing", Namespace = "http://Microsoft.ServicePlatformLabs")]
public class BillingService
{
    [OperationContract(Name = "Invoice", IsOneWay = true)]
    public void Invoice(string orderId, string total)
    {
        Console.WriteLine("Invoice for Order {0} ({1}) generated", orderId, total);
    }
}

    注：上面的ServiceContract属性Name="Billing"和OperationContract属性Name = "Invoice"
会以链接方式绑定到工作流CloudServiceBusSend活动(activity)的Action属性上，即：

    http://Microsoft.ServicePlatformLabs/Billing/Invoice

    ShippingService的代码如下：

    [ServiceContract(Name = "Shipping", Namespace = "http://Microsoft.ServicePlatformLabs")]
    public class ShippingService
    {
        [OperationContract(Name = "ProcessOrder", IsOneWay = true)]
        public void ProcessOrder(string orderId)
        {
            Console.WriteLine("Processing Shipping information for Order {0}", orderId);
        }
    }

    
    同理，ShippingService会以链接方式绑定到工作流CloudServiceBusSend活动(activity)的
Action属性上，即：
   

http://Microsoft.ServicePlatformLabs/Shipping/ProcessOrder

    

    而这两个服务都会被暴露到ServiceBus中以便让用户进行访问操作，从而完成一个客户下订单的
完整流程（CreateOrder）.

    而如何对这两个服务进行安排组装，就是通过WorkFlow的进行的。如果有开发过工作流经验的开
发者应该会很容易理解这个概念。不过这里还是要解释一下，就是在云中运行的工作流与我们平时所
了解的工作流（主要是在Activities方面）还是有些差异的，当然这并不意味着云中的工作流要更难
于理解，恰恰相反，就目前而言，还是很容易的，下面是其在VS中的设计器中的截图：
    
   

    有关这几个新添加的工作流activity，可能就要几个篇幅来介绍和说明，因为今天的目的不在于
此，所以就先略过这块内容了。

    另外就是目前在云中只支持CloudSequentialWorkFlow,如下图：

 

    目前还不支持状态机工作流，但并不确保将来就不会出现。当然将来会不会出现workflow4中的
flowchart型工作流就更不好说了。

    假设我们最终要实现的工作流程如下：
    1.接受客户端post过来的请求，并获取其中指定的节点信息，本DEMO中节点路径为：

      <root><order><total>节点值</total></order></root>

    2.通过对该节点值进行比较判断，当值大于1000时则将工作流程转入一个CloudDelay活动中，以
进行延时操作（设置CloudDelay活动的TimeOut属性）。当值小于或等于1000时则顺序执行上面所介
绍的两个服务（BillingService，ShippingService）

    将上面的流程中工作流进行表示（创建）的结果如下图：

   


     好了，现在我们有了工作流和服务，接下来就是通过编码将服务运行起来以及将工作流发布到
Azure上了。下面是服务的创建运行代码：

internal static void Main()
        {
            var billingServiceHost = new ServiceHost(typeof(BillingService));
            Console.WriteLine("BillingService hosted at:");
            Console.WriteLine(""t" + billingServiceHost.Description.Endpoints[0].Address.Uri);
            billingServiceHost.Open();

            var shippingServiceHost = new ServiceHost(typeof(ShippingService));
            Console.WriteLine("ShippingService hosted at:");
            Console.WriteLine(""t" + shippingServiceHost.Description.Endpoints[0].Address.Uri);
            shippingServiceHost.Open();

            Console.WriteLine();
            Console.WriteLine("Press [Enter] to exit");
            Console.ReadLine();

            billingServiceHost.Close();
            shippingServiceHost.Close();
        }

 
    
     上面代码中的Address.Uri属性是在app.config中进行配置的：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <bindings>
      <netEventRelayBinding>
        <binding name="default" />
      </netEventRelayBinding>
    </bindings>

    <services>

      <service name="Services.ShippingService">
        <host>
          <baseAddresses>
            <add baseAddress="sb://servicebus.windows.net/services/[ENTER YOUR SERVICEBUS USERNAME HERE]"/>
          </baseAddresses>
        </host>

        <endpoint address="Shipping"
                  contract="Services.ShippingService"
                  binding="netEventRelayBinding"
                  behaviorConfiguration="transportClientBehavior0"
                  bindingConfiguration="default" />

      </service>

      <service name="Services.BillingService">
        <host>
          <baseAddresses>
            <add baseAddress="sb://servicebus.windows.net/services/[ENTER YOUR SERVICEBUS USERNAME HERE]"/>
          </baseAddresses>
        </host>

        <endpoint address="Billing"
                  contract="Services.BillingService"
                  binding="netEventRelayBinding"
                  behaviorConfiguration="transportClientBehavior0"
                  bindingConfiguration="default" />

      </service>
    </services>

    <behaviors>
      <endpointBehaviors>
        <behavior name="transportClientBehavior0">
          <!--
            Specify
              - CardSpace (default)
              - UserNamePassword
              - X509Certificate
              - AutomaticRenewal (tgt)
              - FederationViaCardSpace
            for credentialType.
          -->
          <transportClientEndpointBehavior credentialType="UserNamePassword">
            <clientCredentials>
              <userNamePassword userName="[ENTER YOUR SERVICEBUS USERNAME HERE]"
                                password="[ENTER YOUR SERVICEBUS PASSWORD HERE]" />
            </clientCredentials>
          </transportClientEndpointBehavior>
        </behavior>
      </endpointBehaviors>
    </behaviors>
  </system.serviceModel>

</configuration>

    注:config文件中的[ENTER YOUR SERVICEBUS USERNAME HERE]内容就是我们在AzureService平台上
创建的solution名称（这部分内容参见这篇文章），这里我们继续使用上一篇文章中创建的那个项目名
称MSF_DataSyncExample,而PASSWORD就是我们在创建MSF_DataSyncExample之后所设置的口令。

    上面仅是完成了服务的本地化配置。而要把工作流（文件内容）发布到AzureService上我们还需要
在工作流文件的可视模式下的空白区域单击鼠标右键，从弹出菜单中选择“Deploy WordFlow”,这里系
统会弹出一个窗口，如下：

 

 

    我们只需要将刚才在config文件中输入的solution名称和口令在这里敲进去并单击Deploy按钮即可。
这样系统就会在AzureService上为我们创建这样一个发布了的工作流（注：您也可以通过下面的地址
http://workflow.ex.azure.microsoft.com/login.aspx?name=[solutionname]来访问AzureService
并在系统向导的提示下完成工作流的发布）。

    工作流发布之后，我们还需要为当前的工作流创建一个实例，以便于让客户端访问该工作流服务时
持有它，进而完成工作流程。而创建工作流实例的工作是在Azure平台上完成的，请在IE地址栏中敲入
地址：https://workflow.ex.azure.microsoft.com/WorkflowManagement.aspx，如下图：


    
    我们在上图中选择了刚才发布(Deploy)的工作流，然后点击“Manage Instances”按钮后，系统显
示如下：



    我们点击：“CreateInstance”按钮后，如下图：



     我们看到，系统以 “name_date/time stamp”方式为我们命名了一个“实例名称”，这主要是为了
避免出现同名的情况，因为实例在系统中必须唯一。

    接着我们点击"next"按钮，系统接下来会提示我们进行身份验证，如下图：

   

    这样系统就会创建该实例并返回到当前工作流的实例管理列表：

   

    
    当我们把工作流实例创建完成后，就把将当前工作流运行（通过选中相应的实例并单击页面下方的
“Start”按钮，另外可以点击Details按钮来获得实例ID，下面会介绍）起来。

    这样在Azure平台上，我们的工作流就算是配置运行起来了，那么接下来，我们来看看到如何让客户
端访问发布的工作流的。

    首先是客户端的配置文件：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>
    <add key="UserName" value="[ENTER YOUR SERVICEBUS USERNAME HERE]"/>
    <add key="Password" value="[ENTER YOUR SERVICEBUS PASSWORD HERE]"/>
    <add key="InstanceId" value="[ENTER THE WORKFLOW INSTANCE ID]"/>
  </appSettings>
</configuration>

     从上面节点信息可以看出，我们要将配置在service端的相应节点信息（包括solution名称和口令
）配置到当前config节点上。当然这里还多了一个节点就是“InstanceId”，该实例ID就是我们刚才在
Azure平台上创建的工作流实例的ID,我们可以通过单击相应的实例来获得该内容，如下：

   

    这样就完成了在client端的config配置，下面就是客户端访问的工作流的代码了。

internal class Program
{
    private const string workflowTypeName = "CloudOrderWorkflow2";
    private const string activityName = "ReceiveOrder";
    
    internal static void Main()
    {
        Console.Title = "Client";

        var userName = ConfigurationManager.AppSettings["UserName"].ToString();
        var password = ConfigurationManager.AppSettings["Password"].ToString();
        var instanceId = ConfigurationManager.AppSettings["InstanceId"].ToString();

        Console.WriteLine("Press [enter] to send the order to the cloud workflow");
        Console.ReadLine();

        var request = CreateMessage();

        try
        {
            CallReceiveActivity(userName, password, workflowTypeName, instanceId, activityName, request);
        }
        catch (WebException ex)
        {
            Console.WriteLine("Error handled:");
            using (var sr = new StreamReader(ex.Response.GetResponseStream()))
            {
                Console.WriteLine(sr.ReadToEnd());
            }
        }

        Console.WriteLine("Press [enter] to exit");
        Console.ReadLine();
    }

    private static string CreateMessage()
    {   //注：为了测试工作流中的IFELSE流程，可在800运行之后修改为1400，这样会运行cloudDelay流程
        return "<root><order><total>800</total></order></root>";
    }

    internal static void CallReceiveActivity(string userName, string password, string workflowName, string instanceId, string activityName, string message)
    {
        var url = String.Format(CultureInfo.InvariantCulture,
                   "http://{0}/workflowsHttp/{1}/workflows/{2}/instances/{3}/{4}",
                   WorkflowClientConfig.WorkflowHostName, userName, workflowName, instanceId, activityName);
        
        var token = GetWorkflowGrantingToken(userName, password);

        using (var httpRequest = new WebClient())
        {
            httpRequest.Headers.Add(HttpRequestHeader.ContentType, "text/xml");
            httpRequest.Headers.Add("X-MS-Identity-Token", token);
            var response = httpRequest.UploadString(url, message);

            Console.WriteLine("Response by the server: {0}", response);
        }
    }

    internal static string GetWorkflowGrantingToken(string userName, string password)
    {
        string tokenUrl = string.Format(CultureInfo.InvariantCulture,
                                        "https://{0}/issuetoken.aspx?u={1}&p={2}",
                                        WorkflowClientConfig.StsHostName,
                                        userName,
                                        password);

        Console.WriteLine("Requesting authentication token");
        HttpWebRequest tokenRequest = (HttpWebRequest)WebRequest.Create(tokenUrl);
        HttpWebResponse tokenResponse = (HttpWebResponse)tokenRequest.GetResponse();

        byte[] tokenBody = new byte[500];
        int tokenBodyLength = tokenResponse.GetResponseStream().Read(tokenBody, 0, 500);

        var authenticationToken = Encoding.UTF8.GetString(tokenBody, 0, tokenBodyLength);
        Console.WriteLine("Authentication Token: {0}", authenticationToken);

        return authenticationToken;
    }
}

     现在我们在本地分别打开两个VS2008,一个将service项目做为启动项目中，一个以Client作为启动
项目，分别在相应的项目上击鼠标右键，在弹出菜单上选“调试”--》“启动新实例”。先运行service端如
下：



    然后是按上面所说方式启动Client端：




    这里，我们在切换回服务端运行界面，如下:




    到这里，我们只是测试了工作流中的ELSE分支（代码中Total为800），还未测试当Total>1000的分支。
下面是修改Total值之后的测试流程：

    1.首先重复上面在AZURE平台上创建工作流实例的步骤，以便生成新的实例ID供客户端config文件更新
节点配置。
    2.将client的运行代码从800改为1400,然后顺序启动上面的service,client应用，这时我们还是会看到
之前运行的service端和client端的运行界面，只是这次服务端在客户端提提交请求之后，并未马上返回打印
结果，而是运行了cloudDelay活动，这时如果我们访问azure平台上的相关工作流页面时，会看到下面的结果
azure_run_flow.gif

    即当前工作流实例正在运行，我们需要等待1分钟之后，再刷新该页面时，会看到当前实例已运行完成：
azure_workflow_complate.gif

    好了，到现在为止，整个开发和运行测试流程就介绍的差不多了。


    因为手头的资料不多，而我还有的一些疑问还是没有最终得到解答。下面我将它们罗列出来，如果大家
感兴趣或有这方面的经验，不妨与我联系或在回复中进行讨论。

    1.例子中的SERVICE端如果能够被布署在多台服务器上，当client端post请求时，当前会通过哪台机器上
的服务来处理？我猜测的一种可能应该是service bus会通过一些网络路由算法（如最短路径算法）来分配相
应的服务机来处理相应请求。但如果是这样，是否还应该包括负载均衡方面的考虑呢？ 必定每台机器的处理
能力有限，任务多了就要排队，如果一味还是”最短路径“的话，会让service bus中的某一个服务结点不堪
负。

    2.目前的测试可以让azure平台上的某一工作流在某一条件下被触发执行（上传中的total<=1000）.但工
作流的持久化就在azure上吗？这样的话，如果azure平台出现问题，正在运行的实例可能会将执行在一半的
工作流“回滚”，以免出现数据被脏读的情况吗？另外如果企业想将被执行失败的工作流按“自己的方式”
进行处理又应该如何去做呢？

   3.在biztalk中其扮演的角色是ESB（企业服务总线），而Azure Service Bus目前而言应该是一个ISB(
Internet 服务总线)。如果与ISG是ESB的一种实现方式的话，那在ESB中的消息类型与ISB中的消息类型又是
否为一脉相承呢，在SDK中我看到了这样一段代码（出现在了AzureServicesKit\Labs\IntroServiceBus\
Ex04-RESTSample中）：

       Message response = StreamMessageHelper.CreateMessage(
           OperationContext.Current.IncomingMessageVersion, "GETRESPONSE", this.WriteImage);
                
     而该Message类型为abstract类型（位置System.ServiceModel.Channels名空间），这个类型又与在
 BIZTALK Server上配置于数据库中的message表中的消息数据是怎样一个关系呢。以前曾在网上看到有篇文
 章说azure会将shartpoint逐步在云中加以实现，如果是这样的话那biztalk是否将来会与AZURE平台产生
 某种更深层次的关联吗？
 

    疑问之后还是疑问，看来在研究Azure平台的过程中还有很长的路要走，走一步

看一步吧!!!   

     好了，今天的内容就先到这里了。

     原文链接:http://www.cnblogs.com/daizhj/archive/2008/12/08/1350013.html

 

     作者: daizhj, 代震军

     Tags: Azure,isb,service bus,esb,workflow,工作流,服务总线

     网址: http://daizhj.cnblogs.com/