设计模式 生成器模式（builder Pattern）

　　生成器模式又称建造者模式，定义一个抽象的建造者的角色（Builder），规定所有具体的建造者都应该具有的功能——这些功能就是如何创建复杂对象的某个特定部分（子对象），而具体如何创建子对象有具体的创建者实现。再定义一个指导者的角色，它把创建者作为工具，知道如何使用这个工具来创建复杂对象。这样，客户在需要创建这个复杂对象的时候，只需要给指导者一个具体的创建者就可以了。至于具体创建者如何创建子对象的细节以及这些子对象之间的差异，不是指导者，也不是客户关心的。
　　下面我们用一个例子来说明一下生成器模式，假设我们不但需要一个计算的算法，还需要一个由于显示数据根据数据不同而完全不同的用户界面。我们考虑一个简单的例子，在这个例子中，用一个类构造一个用户界面。假设我们要编写一个程序跟踪投资效益。我们有股票、基金、债券等N个投资项目，对每个投资项目都要显示持有量列表，无论对于大数量的投资（股票）还是小数目的投资（基金），都有一种易于使用的显示方式。每种情况我们都想多选显示。如果投资项目的数量大，可以使用多选列表框，如果等于或小于三个项目，则使用复选框代替。让Builder类根据需要显示项目生成的界面，同时还要有相同的方法来返回。
　　我们的程序运行结构图如下，左边是少量数据，右边是大量数据。

　　接下来我们考虑如何构建界面，来完成不同的显示。首先创建MultiChoice接口，里边定义了需要实现的方法。

using System;
using System.Collections ;
using System.Windows.Forms;


    /// <summary>
/// Summary description for MultiChoice.
/// </summary>
    public interface MultiChoice
    {
        ArrayList getSelected();
        void clear();
        Panel getWindow();
    }

　　getWindow方法返回一个包含多选显示的面板（panel），这里使用两个显示面板实现该界面一个是复选框面板，一个是列表面板。

    public class CheckChoice:MultiChoice     {

　　或

    public class ListChoice:MultiChoice {

　　接下来创建一个抽象类Equities，并有它派生出Stocks（股票），Bonds（债券），Mutuals（基金）类。

using System;
using System.Collections ;


    /// <summary>
/// Summary description for Equities.
/// </summary>
    public abstract class Equities     {
        protected ArrayList array;
        public abstract string ToString();
    //----------    
        public ArrayList getNames() {
            return array;
        }
    //----------    
        public int count() {
            return array.Count ;
        }
    }

　　Stocks

using System;
using System.Collections ;



    /// <summary>
/// Summary description for Stocks.
/// </summary>
    public class Stocks:Equities     {
        public Stocks()         {
            array = new ArrayList();
            array.Add ("Cisco");
            array.Add ("Coca Cola");
            array.Add ("GE");
            array.Add ("Harley Davidson");
            array.Add ("IBM");
            array.Add ("Microsoft");
        }
        public override string ToString() {
            return "Stocks";
        }
    }

Bonds（债券），Mutuals（基金）类代码基本类似....

　　我们还需要一个简单的类来决定，要返回的是一个复选框面板还是一个列表框面板。我们把这个类称为StockFactory。由于我们只需要该类的一个实例，因而创建该类时让其中的一个方法为静态的。我们也可以把这个类称为简单工厂。

using System;


    /// <summary>
/// Summary description for StockFactory.
/// </summary>
    public class StockFactory
    {
        public static MultiChoice getBuilder(Equities stocks)
        {
            if (stocks.count ()<=3) {
                return new CheckChoice (stocks);
            }
            else {
                return new ListChoice(stocks);
            }
        }
    }

　　CheckChoice类，这里生成0-3个复选框的面板，并且将面板返回。

using System;
using System.Collections ;
using System.Windows.Forms ;
using System.Drawing ;


//returns a panel of 0 to 3 check boxes
    public class CheckChoice:MultiChoice     {
        private ArrayList stocks;
        private Panel panel;
        private ArrayList boxes;
    //------
        public CheckChoice(Equities stks)         {
        stocks = stks.getNames ();
            panel = new Panel ();
            boxes = new ArrayList ();
            //add the check boxes to the panel
            for (int i=0; i< stocks.Count; i++) {
                CheckBox ck = new CheckBox ();
                //position them
                ck.Location = new Point (8, 16 + i * 32);
                string stk = (string)stocks[i];
                ck.Text =stk;
                ck.Size = new Size (112, 24);
                ck.TabIndex =0;
                ck.TextAlign = ContentAlignment.MiddleLeft ;
                boxes.Add (ck);
                panel.Controls.Add (ck);
            }
        }
        //------
//uncheck all check boxes
        public  void clear() {
            for(int i=0; i< boxes.Count; i++) {
              CheckBox ck = (CheckBox)boxes[i];
                ck.Checked =false;
            }
        }
        //------
//return list of checked items
        public ArrayList getSelected() {
            ArrayList sels = new ArrayList ();
            for(int i=0; i< boxes.Count ; i++) {
                CheckBox ck = (CheckBox)boxes[i];
                if (ck.Checked ) {
                    sels.Add (ck.Text );
                }
            }
            return sels;
        }
        //------
//return panel of checkboxes
        public Panel getWindow() {
            return panel;
        }
    }

　　ListBoxChoice类，该类创建一个多选框列表，并且将其插入到一个面板中，然后显示名称。

using System;
using System.Collections ;
using System.Windows.Forms ;
using System.Drawing ;

    /// <summary>
/// Summary description for ListChoice.
/// </summary>
/// creates a Panel containing a list box
    public class ListChoice:MultiChoice {
        private ArrayList stocks;
        private Panel panel;
        private ListBox list;
    //------
//constructor creates and loads the list box
        public ListChoice(Equities stks) {
            stocks = stks.getNames ();
            panel = new Panel ();
            list = new ListBox ();
            list.Location = new Point (16, 0);
            list.Size = new Size (120, 160);
            list.SelectionMode =SelectionMode.MultiExtended ;
            list.TabIndex =0;
            panel.Controls.Add (list);
            for(int i=0; i< stocks.Count ; i++) {
                list.Items.Add (stocks[i]);
            }
        }
        //returns the Panel
//------
        public  Panel getWindow() {
            return panel;
        }
        //returns an array of selected elements
//------
        public ArrayList getSelected() {
            ArrayList sels = new ArrayList ();
            ListBox.SelectedObjectCollection  coll = list.SelectedItems  ;
            for(int i=0; i< coll.Count; i++) {
                string item = (string)coll[i];
                    sels.Add (item );
                }
        return sels;    
        }
        //------    
//clear selected elements
        public void clear() { 
            list.Items.Clear();
        }
    }

　　在使用列表框的时，列表框中值不仅限于字符串，在添加的数据中，可以使具有ToString方法的任何类型的对象。

    private ListBox lsEquities;
        /// <summary>
/// Required designer variable.
/// </summary>
        private Container components = null;
        private Button btPlot;
        private Panel pnl;
        private MultiChoice mchoice;
        private void init() {
            lsEquities.Items.Add (new Stocks());
            lsEquities.Items.Add (new Bonds());
            lsEquities.Items.Add (new Mutuals());
        }
        public WealthBuilder()
        {
            InitializeComponent();
            init();
        }

　　在单击列表框中第一行数据时，单击方法会获得相应的Equities类的实例，将该实例传给MultiChoice工厂，接下来在相应的类中生成一个包含项目的面板，然后删除旧的面板，添加新的面板。

private void lsEquities_SelectedIndexChanged(object sender, System.EventArgs e) {
            int i = lsEquities.SelectedIndex ;
            Equities eq = (Equities)lsEquities.Items[i];
            mchoice= StockFactory.getBuilder (eq);
            this.Controls.Remove (pnl);
            pnl = mchoice.getWindow ();
            setPanel();
  }
    
private void setPanel() {
             pnl.Location = new Point(152, 24);
            pnl.Size = new Size(128, 168);
            pnl.TabIndex = 1;
            Controls.Add(pnl);
  }

在本里中，我们并没有实现真正的标注，只是弹出选中的值。

        private void btPlot_Click(object sender, System.EventArgs e) {
            //display the selected items in a message box
            if(mchoice != null) {
                ArrayList ar  = mchoice.getSelected ();
                string ans = "";
                for(int i=0; i< ar.Count ; i++) {
                    ans += (string)ar[i] +" ";
                }
                MessageBox.Show (null, ans, "Selected equities", MessageBoxButtons.OK  );
            }
        }

生成器模式效果
1.生成器允许读者改变产品的内部表示，同时也隐藏了产品的组装细节。
2.每个特定的生成器都独立于其他的生成器，同时也独立于程序的其他部分，这一点提高了对象模块性，并使用添加其他的生成器变得简单。
3.由于每个生成器是根据数据移步一步构建最终结果，所以能精确的控制生成器构建的每个结果。
生成器模式有点类似于抽象工厂，两者都是返回由许多方法和对象组成的类，他们之间的主要差别是，抽象工厂返回的是一系列相关的类，而生成器是根据提供的数据一步一步的构建一个复杂的对象。