zoukankan      html  css  js  c++  java
  • [记]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

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

  • 相关阅读:
    不容易系列之(3)—— LELE的RPG难题(递推)
    亲和数(因子和)
    爬虫正式学习day2
    爬虫小练习:堆糖图片抓取--爬虫正式学习day1
    js笔记--高阶函数array的各种函数
    js笔记--高阶函数sort()
    js笔记--高阶函数filter()
    js笔记--高阶函数map() reduce()
    js笔记--方法
    js笔记--变量部分
  • 原文地址:https://www.cnblogs.com/JimmyZhang/p/1252181.html
Copyright © 2011-2022 走看看