[记]SAF 中抽象工厂的实现

SAF 中抽象工厂的实现

引言

本文是《Developing Application Frameworks in .NET》的读书笔记。SAF 是书中的一个范例框架，意为 Simple Application Framework(简单应用程序框架)。这篇文章主要向大家说明了SAF中抽象工厂模式的实现方式。

设计思想概述

抽象工厂是很常用的一种创建型模式，它的主要作用在于向程序员屏蔽了创建对象的复杂细节，在获取对象时，只需要在工厂类上调用 GetXXX()，或者 CreateXXX()，便可以得到一个类型实例，而不是通常所使用的new XXX()这种方式。关于抽象工厂更详细的内容可以参考 奇幻RPG(人物构建与Abstract Factory模式) 这篇文章。SAF 的抽象工厂也是基于GOF的这个基本模型，但是做了下面两个改进：

利用反射，根据字符串动态创建工厂

我们获得工厂类时，通常还是通过AbstractFactory factory = new ConcreteFactory()这种方式获得。这样如果我们想更换一个工厂实体类时，比如说，将上面的ConcreteFactory换成 AnotherFactory，我们需要修改代码为 AbstractFactory factory = new AnotherFactory()，这样免不了需要再次重新进行编译。

在SAF中，使用了自定义Config配置节点，将 工厂名称 和 它的类型信息(所在的程序集、命名空间、类型名称)全部保存在了App.Config文件中，并创建相应的ClassFactoryConfiguration 类型用于获取App.Config中的节点信息。然后创建ClassFactory类型，并在其中添加静态方法GetFactory(string name)，其中name代表了工厂名称(必须与App.Config中保存的名称匹配)。然后，在客户端调用这个方法来创建工厂。通过这种方式，我们只需要在Config中保存所有的工厂类信息，然后就可以为GetFactory()通过传入不同的参数，创建不同的工厂类。

实际的流程如下：

  1. 客户端程序调用  ClassFactory.GetFactory(string factoryName) 方法，传入工厂名称。
  2. 在GetFactory() 方法中一个ClassFactoryConfiguration对象，这个对象封装了获取app.Config中信息的方法。
  3. ClassFactoryConfiguration 根据 factoryName参数在app.Config中寻找与工厂名称匹配的节点，找到后，返回该工厂的类型信息。
  4. GetFactory()方法根据类型信息，使用反射创建类型实例，然后返回该实例。

使用Remoting创建远程工厂

SAF中的另一个改进是引入了Remoting，关于Remoting的详细内容，可以参考 .Net中的Remoting 这篇文章。有的时候，我们需要使用Remoting获取位于远程服务器中的对象，这时往往需要写一些注册Channel、转换对象类型的代码。SAF的抽象工厂将这些细节也屏蔽了起来，只要将获取远程对象的地址写在配置文件中，比如http://localhost:8989/ClassFactory，剩下的步骤与使用本地对象别无二致，极大的简化了操作。

接下来我们看一下代码实现。

代码实现

抽象工厂类的实现

首先是创建抽象工厂类的体系，新建一个解决方案ClassFactory，再其下建立一个类库项目 Factory，它包含了下面一些类，以构成一个基本的抽象工厂模式，作为范例：

namespace Factory {
    /* 工厂基类
     * **************************************************/
    public abstract class ProductFactory : MarshalByRefObject{
        public abstract Product GetCheapProduct();
        public abstract Product GetExpensiveProduct();
    }

    // 工厂实体类 (一般产品)
    public class ConcreteProductFactory : ProductFactory {
        public override Product GetCheapProduct() {
            return new CheapProduct();
        }
        public override Product GetExpensiveProduct() {
            return new ExpensiveProduct();
        }
    }

    // 工厂实体类 (新产品)
    public class ConcreteNewProductFactory : ProductFactory {
        public override Product GetCheapProduct() {
            return new NewCheapProduct();
        }
        public override Product GetExpensiveProduct() {
            return new NewExpensiveProduct();
        }
    }

    // 工厂实体类 (远程产品) 使用Remoting
    public class ConcreteRemoteProductFactory : ProductFactory {
        public override Product GetCheapProduct() {
            return new RemoteCheapProduct();
        }
        public override Product GetExpensiveProduct() {
            return new RemoteExpensiveProduct();
        }
    }

    /* 产品基类 MashalByRefObject
     * **************************************************/
    public abstract class Product : MarshalByRefObject {
        public abstract string Name { get; }
        public abstract int GetPrice();
        public abstract string GetColor();
    }

    // 一般产品实体类 ( 由 ConcreteProductFactory 创建 )
    public class CheapProduct : Product {
        private const int cost = 10;
        private const string color = "red";
        private const string name = "Cheap Product";

        public override int GetPrice() {
            return cost * 2;
        }
        public override string GetColor() {
            return color;
        }
        public override string Name {
            get {
                return name;
            }
        }
 }

    // 一般产品实体类 ( 由 ConcreteProductFactor 创建 )
    public class ExpensiveProduct : Product { /* 实现略 */ }

    // 新产品实体类 ( 由 ConcreteNewProductFactory 创建 )
    public class NewCheapProduct : Product { /* 实现略 */ }

    // 新产品实体类 ( 由 ConcreteNewProductFactory 创建 )
    public class NewExpensiveProduct : Product { /* 实现略 */ }
   
    // 远程产品实体类 ( 由 ConcreteRemoteProductFactory 创建 )
    public class RemoteCheapProduct : Product { /* 实现略 */ }

    // 远程产品实体类 ( 由 ConcreteRemoteProductFactory 创建 )
    public class RemoteExpensiveProduct : Product { /* 实现略 */ }
}

这里需要注意的是 ProductFactory和 Product 抽象类均继承自 MarshalByRefObject 基类，这是因为这两个类的子类实现有一部分位于客户端、还有一部分位于服务器端，为了能从服务器端向客户端进行封送(Marshal)，它们必须声明为继承自MarshalByRefObject。

我们注意到上面这段程序的两个 远程产品实体类(RemoteCheapProduct和RemoteExpensiveProduct) 应该是仅存在于服务器端的，等下我们会细说这里。现在我们编译上面的代码，会在Bin目录下生成Factory.dll文件。

服务器端的实现

服务器端的实现很简单，仅仅是开启Remoting服务，供客户端进行调用就可以了。在上面已经说明，服务器端仅需要提供两个远程产品实体类(RemoteCheapProduct 和 RemoteExpensiveProduct)，所以只需要提供一个 ConcreteRemoteProductFactory 工厂类型就可以了。现在我们再创建一个解决方案，名为FactoryServer，在其下添加一个Console控制台项目RemoteServer，接下来，我们 把上一步生成的Factory.dll 文件复制到Bin目录下，然后引用它(不要引用项目)。

这里需要注意：因为Factory包含了远程所要提供的对象，所以我们需要引用它；而它也包含了客户端可以直接创建的对象，所以客户端也需要引用Factory.dll，但是我们不能将Factory服务器端所提供的内容交给客户端(如果可以的话，我们根本用不着Remoting)，所以我们在客户端引用Factory之前要屏蔽掉服务器端实现的内容。如果直接引用项目(服务器端、客户端同时引用了Factory项目)，一是没有起到服务端、客户端分离的作用，二是一旦我们屏蔽掉Factory项目中的内容，那么重新生成之后，服务器端也丧失了这些内容(所以我们在屏蔽部分内容之前将生成好的dll复制到FactoryServer的Bin目录下，然后引用之)。

服务器端通过配置的方式开启Remoting服务，app.Config中的配置如下：

<system.runtime.remoting>
    <application>
        <service>
            <wellknown
                mode="Singleton"
                  type="Factory.ConcreteRemoteProductFactory, Factory"
                  objectUri="ClassFactory" />
        </service>
        <channels>
            <channel ref="http" port="8989"/>
        </channels>
    </application>
</system.runtime.remoting>

接着，编写Program代码，仅仅是根据配置开启服务而已：

public class Program {
    static void Main(string[] args) {
        // 根据 App.config.exe 中的配置开启远程服务
        RemotingConfiguration.Configure("RemoteServer.exe.config", false);

        Console.WriteLine("远程服务成功开启！");
        Console.ReadLine();
    }
}

客户端的实现

我们在上面 抽象工厂类 的实现中，已经创建了一个解决方案ClassFactory，以及其下的Factory项目。我们将ClassFactory解决方案整体视为客户端，此时，客户端不应包含服务端的代码实现(RemoteCheapProduct类 和 RemoteExpensiveProduct类)，所以我们将它删除或者注释掉。另外，由于Config中保存的类型信息是工厂类型的信息，比如ConcreteRemoteProductFactory类型的信息，所以当我们通过反射创建远程工厂类型的实例时，客户端依然需要ConcreteRemoteProductFactory的类型信息，所以我们不能屏蔽掉ConcreteRemoteProductFactory，但是我们可以让它什么都不做(Empty Class)，现在修改ConcreteRemoteProductFactory 如下所示：

// 工厂实体类 (远程产品) 使用Remoting
public class ConcreteRemoteProductFactory : ProductFactory {
    public override Product GetCheapProduct() {
        throw new Exception("由服务器端实现");
    }
    public override Product GetExpensiveProduct() {
        throw new Exception("由服务器端实现");
    }
}

这个类仅仅是为了在客户端提供一个类型信息，以便能够通过反射创建类型，实际上只要访问的是服务器端，那么这里永远都不会抛出异常，因为这个类实际是在服务器端创建的。

现在修改app.config文件，记录我们所有的工厂类的 名称 及类型信息。名称可以任意起，在创建类型的时候调用的GetFactory(string name)方法的name参数要与这里匹配；类型信息必须为客户端拥有的工厂类类型，用于通过反射创建对象：

<configSections>
    <section name="classFactory" type="ConfigManager.ClassFactorySectionHandler, ConfigManager" />
</configSections>

<classFactory>
    <factory name="ProductFactory-A" type="Factory.ConcreteProductFactory, Factory" />
    <factory name="ProductFactory-B" type="Factory.ConcreteNewProductFactory, Factory" />
    <factory name="Remote-ProductFactory-C" location="http://localhost:8989/ClassFactory" type="Factory.ConcreteRemoteProductFactory, Factory" />
</classFactory>

注意到name属性为" Remote-ProductFactory-C "的节点，它拥有一个location属性，这个属性保存了获取它的远程地址，用于Remoting访问。

接下来，我们要创建对这个节点的处理程序，ClassFactorySectionHandler。在ClassFactory解决方案下再添加一个类库项目：ConfigManager，然后添加ClassFactorySectionHandler类，它用于处理节点(如不清楚，可以参考 .Net自定义应用程序配置)：

// 结点处理程序，在调用 ConfigurationManager.GetSection("sectionName") 自动调用这里
public class ClassFactorySectionHandler : IConfigurationSectionHandler {
    public object Create(object parent, object configContext, XmlNode section) {
        return new ClassFactoryConfiguration(section);
    }
}

// 结点配置程序
public class ClassFactoryConfiguration {
    private XmlNode node;

    // 这里的 node 为 classFactory 结点
    public ClassFactoryConfiguration(XmlNode section) {
        this.node = section;
    }

    // 获取与name属性匹配的子结点的 type 属性
    public string GetFactoryType(string name) {

        // 获取子结点，使用 XPath 语法查找
        XmlNode childNode = node.SelectSingleNode("factory[@name='" + name + "']");

        if (childNode != null && childNode.Attributes["type"] != null)
            return childNode.Attributes["type"].Value;
        else
            return null;
    }

    // 获取与name属性匹配的子结点的 location 属性
    // location 属性指定远程对象的获取位置
    public string GetFactoryLocation(string name) {
        // 获取子结点，使用 XPath 语法查找
        XmlNode childNode = node.SelectSingleNode("factory[@name='" + name + "']");

        if (childNode != null && childNode.Attributes["location"] != null)
            return childNode.Attributes["location"].Value;
        else
            return null;
    }
}

我们只需要注意两个方法就可以了：GetFacotryType(string name)，获取工厂类的类型，用于通过反射创建类型；GetFactoryLocation(string name)，获取工厂类的地址，用于Remoting。

接下来我们在解决方案下再创建一个控制台项目，Main，它是我们的客户程序。在其下创建ClassFactory类，我们的所有客户端代码实际上通过这个类的静态方法GetFactory(string name)获取工厂类：

public class ClassFactory {
    // 不允许使用 new 创建
    private ClassFactory() {}
   
    // 根据结点的name属性创建Factory对象
    public static object GetFactory(string name) {
        object factory = null;

        // 获取配置对象
        ClassFactoryConfiguration config =
    (ClassFactoryConfiguration)ConfigurationManager.GetSection("classFactory");

        // 获取Factory位置，用于Remoting远程对象
        string location = config.GetFactoryLocation(name);

        // 获取Factory类型
        string type = config.GetFactoryType(name);

        if(type == null) return null;

        Type t = Type.GetType(type);

        try {
            if (location != null) {
                factory = Activator.GetObject(t, location);    // 创建远程对象
            } else {
                factory = Activator.CreateInstance(t);         // 创建本地对象
            }
        }
        catch {
            throw new Exception("使用反射创建对象失败！");
        }

        return factory;
    }
}

代码测试

现在我们对代码进行一下测试：

public class Program {
    static void Main(string[] args) {

        // 创建根据配置创建工厂类
        ProductFactory pfA = (ProductFactory)ClassFactory.GetFactory("ProductFactory-A");
        ProductFactory pfB = (ProductFactory)ClassFactory.GetFactory("ProductFactory-B");
        ProductFactory pfC = (ProductFactory)ClassFactory.GetFactory("Remote-ProductFactory-C");

        // 创建本地产品
        Product p1 = pfA.GetCheapProduct();
        Product p2 = pfA.GetExpensiveProduct();
        Product p3 = pfB.GetCheapProduct();
        Product p4 = pfB.GetExpensiveProduct();

        // 创建远程产品
        Product p5 = pfC.GetCheapProduct();
        Product p6 = pfC.GetExpensiveProduct();

        // 打印产品
        PrintDescription(p1);
        PrintDescription(p2);
        PrintDescription(p3);
        PrintDescription(p4);

        // 打印远程产品
        PrintDescription(p5);
        PrintDescription(p6);

        Console.WriteLine("Press enter to finish");
        Console.ReadLine();
    }

    private static void PrintDescription(Product p) {
        Console.WriteLine("{0}", p.Name);
        Console.WriteLine("---------------------------");
        Console.WriteLine("Color: {0}", p.GetColor());
        Console.WriteLine("Price: {0} \n", p.GetPrice());
    }
}

在运行之前，先运行服务端，然后再运行客户端，可以得到下面的输出结果：

Cheap Product
---------------------------
Color: red
Price: 20

Expensive Product
---------------------------
Color: red
Price: 100
// 略 ...
Press enter to finish

感谢阅读，希望这篇文章可以为你带来帮助！

posted @ 2008-07-26 18:41  Jimmy Zhang  阅读(2436)  评论(4)  编辑  收藏  举报