利用Castle IOC实现远程调用的接口统一（上）

摘要：前段时间学习了解了一下Castle,也想着写点东西。只是不知道写些什么东西好，再加上本人的文采实在是不敢恭维，所以就一直没动手写。这两天本着学习的态度写了一个Castle的Facility。不管代码有没有用，希望对您学习Castle能有一定的帮助。

主要内容
            1、功能概述

            2、如何实现服务器端

            3、如何实现客户端

            4、功能组件实现

            5、代码下载

            6、其他说明

一．功能概述

         该Facility主要功能是收集添加到Windsor组件中的本允许远程调用的方法，然后利用反射，在内部实现一个接口，通过该接口来调用这些公开的方法。也就是说对于客户端，只需要这个接口来调用服务器上的其他接口。由于只有一个调用接口,我们就可以很容易的通过简单的配置来选择不同的调用机制,比如通过Remoting,通过命名管道(NamedPipe)。本文章主要介绍如何应用该Facility.

二．如何实现服务器端

          服务器端代码很简单，只需要一行代码。

               IWindsorContainer container  =   new  WindsorContainer( new  XmlInterpreter());

         指示需要通过App.config 或 web.config来读取配置文件。

         服务器端配置是通过App.config 或 web.config来包含Windsor的配置文件， 配置也很简单。配置信息如下：     

<? xml version = " 1.0 "  encoding = " utf-8 "   ?>
     < configuration >
    
         < configSections >
             < section name = " castle "  type = " Castle.Windsor.Configuration.AppDomain.CastleSectionHandler, Castle.Windsor "   />
         </ configSections >
    
         < castle >
             < include uri = " file://Castle.NamedPipe.xml "   />
             <!--< include uri = " file://Castle.Remoting.xml "   />-->
             < include uri = " file://Castle.Components.xml "   />
         </ castle >
    
     </ configuration >

            上面的配置是通过命名管道调用机制来提供接口，如果希望通过Remoting调用机制，只需要简单的修改一下该配置。当然也需要修改客户端的配置文件，下面会提到。 我们再看看Castle.NamedPipe.xml 文件的配置信息。

            

< configuration >
    
             < facilities >
            
                 < facility id = " actionRemoting "  type = " Suren.Module.ActionMarshal.Manager.Facility.RemotingActionFacility,Suren.Module.ActionMarshal.Manager " ></ facility >
                
             </ facilities >
             < components >
        
                 < component id = " service "  
                    service = " Suren.Module.ActionMarshal.Core.IMarshalService, Suren.Module.ActionMarshal.Core "
                    type = " Suren.Module.ActionMarshal.Manager.Service.NamedPipe.NamedPipeService, Suren.Module.ActionMarshal.Manager " >
                     < parameters >
                         < name > MarshalRemotingTest </ name >     
                     </ parameters >
                 </ component >
             </ components >
        
         </ configuration >

            该配置文件配置了一个自定义的Facility。用来收集组件中的接口方法。还配置了一个实现命名管道服务组件。有关该自定义的Facility与服务组件的详细信息，可以看源代码。 如果大家有需要会写写下半部分，介绍一下该Facility 的代码。
               以下是Castle.Remoting.xml 文件的配置信息

< configuration >

         < facilities >
        
             < facility 
                id = " remote.facility "  
                type = " Castle.Facilities.Remoting.RemotingFacility, Castle.MicroKernel "
                isServer = " true "
                registryUri = " kernel.rem "
                remotingConfigurationFile = " RemotingTcpConfig.config " >
             </ facility >     
            
             < facility id = " actionRemoting "  type = " Suren.Module.ActionMarshal.Manager.Facility.RemotingActionFacility,Suren.Module.ActionMarshal.Manager " ></ facility >
            
         </ facilities >
         < components >
            
             < component id = " service "  
                service = " Suren.Module.ActionMarshal.Core.IMarshalService, Suren.Module.ActionMarshal.Core "
                type = " Suren.Module.ActionMarshal.Manager.Service.Remoting.RemotingService, Suren.Module.ActionMarshal.Manager "
                remoteserver = " component "   />
         </ components >
    
     </ configuration >

三．如何实现客户端

          客户端的配置与服务器配置比较相似。也是通过App.config或Web.config来包含其它配置文件。配置如下：

<? xml version = " 1.0 "  encoding = " utf-8 "   ?>
         < configuration >
        
             < configSections >
                 < section name = " castle "  type = " Castle.Windsor.Configuration.AppDomain.CastleSectionHandler, Castle.Windsor "   />
             </ configSections >
        
             < castle >
                  < include uri = " file://client_NamedPipe.xml "   />
                 <!--< include uri = " file://client_Remoting.xml "   />-->
             </ castle >
        
         </ configuration >

         上面是的配置是通过命名管道来调用服务器接口，如果希望通过Remoting调用机制，只需要简单的修改一下该配置。当然也需要修改服务器端的配置文件。 我们再看看Castle.NamedPipe.xml 文件的配置信息。

<? xml version = " 1.0 "  encoding = " utf-8 "   ?>  
         < configuration >
          
           < components >
          
                 < component id = " service "  
                    service = " Suren.Module.ActionMarshal.Core.IMarshalService, Suren.Module.ActionMarshal.Core "
                    type = " Suren.Module.ActionMarshal.Client.NamedPipeClient, Suren.Module.ActionMarshal.Client " >
                     < parameters >
                         < pipeName > MarshalRemotingTest </ pipeName >
                         < server > 192.168 . 0.68 </ server >
                     </ parameters >
                 </ component >
           </ components >
        
         </ configuration >

            该配置文件配置了一个实现了命名管道客户端的组件，在配置文件中注入了两个参数，一个是命名管道名称，一个是命名管道服务器地址。命名管道名称必须与服务器上配置的一样。 以下是Client_Remoting.xml的配置信息:

<? xml version = " 1.0 "  encoding = " utf-8 "   ?>  
     < configuration >
    
       < facilities >
      
         < facility 
            id = " remote.facility "  
            type = " Castle.Facilities.Remoting.RemotingFacility, Castle.MicroKernel "
            remotingConfigurationFile = " RemotingTcpConfigClient.config "
            isClient = " true "
            remoteKernelUri = " tcp://localhost:2133/kernel.rem "
            baseUri = " tcp://localhost:2133 "   />
      
       </ facilities >
      
      
       < components >
      
             < component id = " service "  
                service = " Suren.Module.ActionMarshal.Core.IMarshalService, Suren.Module.ActionMarshal.Core "
                type = " Suren.Module.ActionMarshal.Manager.Service.Remoting.RemotingService, Suren.Module.ActionMarshal.Manager "
                remoteclient = " component "   />
       </ components >
    
     </ configuration >     

           
          客户端的调用代码如下:

IWindsorContainer container  =   new  WindsorContainer( new  XmlInterpreter());
    IMarshalService service  =  container[ " service " ]  as  IMarshalService;
     object  ret  =  service.Execute( " Sum3 " , 100 , 200 , 300 );
    Console.WriteLine(ret);

            第三行代码作用是执行标识为Sum3的函数，该函数有三个参数，传递该函数的参数分别为100,200,300.执行完成后返回调用结果。

四．组件实现 
          我们先看看一个简单的组件实现。

namespace  Test.Components
     {
        using System;
        using Suren.Module.ActionMarshal.Core;
        
        [Marshal]
        public class CalcServiceImpl : MarshalByRefObject, ICalcService
        {
            public CalcServiceImpl()
            {
            }
            public int Sum(params int[] args)
            {
                int sum = 0;
    
                foreach(int arg in args)
                {
                    sum += arg;
                }
                return sum;
            }
            [Marshal("Sub")]
            public int Sum(int arg)
            {
                int sum;
                sum = arg;
                return sum;
            }
    
            [Marshal("Sum3",MarshalName="对三个整数的相加")]
            public int Sum(int i1 ,int i2,int i3)
            {
                int sum ;
                sum = i1 + i2 + i3;
                return sum;
            }
        }
        
    }

            该类上定义了MarshalAttribute属性。表示该类中的所有公共方法都允许远程调用。我们还可以在方法上也定义MarshalAttribute来修改默认的方法信息。
 
           用默认信息标识对外接口，即用方法名称(Sum)作为该对外接口的标识。

public   int  Sum( params   int [] args)
         {
            int sum = 0;
    
            foreach(int arg in args)
            {
                sum += arg;
            }
            return sum;
        }

            用Sub作为该对外接口的标识

[Marshal( " Sub " )]
         public   int  Sum( int  arg)
         {
            int sum;
            sum = arg;
            return sum;
        }

            用Sum3作为该对外接口的标识，并设置该接口的描述说明

[Marshal( " Sum3 " ,MarshalName = " 对三个整数的相加 " )]
         public   int  Sum( int  i1 , int  i2, int  i3)
         {
            int sum ;
            sum = i1 + i2 + i3;
            return sum;
        }
        

         如果我们没有在类上定义[Marshal]，只在某些公共方法上定义Marshal属性。则只公开定义了Marshal属性的这些方法。
通常情况下我们把标识作为功能号。如[Marshal("10000")]  [Marshal("10001")] [Marshal("10002")] 
         调用的时候int ret = (int)service.Execute("10001",100,200,300);
         值得注意的是所有的标识号不能重复.

         在服务器上配置组件 Castle.Components.xml

< configuration >
         < components >
    
             < component id = " calcservice "  
                service = " Test.Components.ICalcService,Test.Components "  
                type = " Test.Components.CalcServiceImpl,Test.Components " >
             </ component >
             < component id = " serviceOne "  
                service = " Test.Components.IServiceOne,Test.Components "  
                type = " Test.Components.ServiceOneImpl,Test.Components " >
             </ component >
         </ components >
        
     </ configuration >

在客户端上不需要作任何配置。也不需要引用这些组件
  
五．代码下载
 
       所有源代码  下载
 
 
六．其他说明

 命名管道实现代码 http://www.codeproject.com/csharp/dotnetnamedpipespart2.asp

 环境：windows 2003 \ Visual Studio 2003 \ framework1.1 编译运行成功
 
 本文原创，不允许转贴。