设计模式（七）Builder模式

　　Builder模式，从这个名字我们可以看出来，这种设计模式就是用于组装具有复杂结构的实例的。

　　下面还是以一个实例程序来解释这种设计模式，先看实例程序的类图。

　　这里为了调试方便，只实现其中一个功能TextBuilder，剩下的HTMLBuilder可自行编写。

　　然后是实例程序代码。

package BigJunOba.bjtu.Builder;

public abstract class Builder {
    
    public abstract void makeTitle(String title);   //编写标题
    public abstract void makeString(String str);     //编写字符串
    public abstract void makeItems(String[] items); //编写含有条目
    public abstract void close();                     //完成文档
    
}

　　Builder类是一个抽象类，它并没有进行任何实际的处理，仅仅声明了编写文档所要用到的抽象方法。

package BigJunOba.bjtu.Builder;
/**
 * @author BigJunOba
 * Director类使用Builder类中声明的方法来编写文档
 */
public class Director {

    private Builder builder;

    public Director(Builder builder) {
        this.builder = builder;
    }
    
    public void construct() {
        builder.makeTitle("我是一个标题");
        builder.makeString("一.下面我要讲第一个问题");
        builder.makeItems(new String[] {
                "1.廉",
                "2.宝",
                "3.宝",
        });
        builder.makeString("二.下面我还要讲第二个问题");
        builder.makeItems(new String[] {
                "4.大",
                "5.帅",
                "6.逼",
        });
        builder.close(); 
    }
    
}

　　Director类。这里需要注意的是，Director构造器的参数是Builder类型的，但我们知道，Builder类是抽象类，是无法实例化的，所以在这里实际上传递给Director类的是Builder类的子类。然后construct方法就是编写文档的方法，调用这个方法后就会编写文档。

package BigJunOba.bjtu.Builder;

public class TextBuilder extends Builder {
    
    //用来将文档内容保存在buffer字段中
    private StringBuffer buffer = new StringBuffer();

    @Override
    public void makeTitle(String title) {
        buffer.append("======================\n");
        buffer.append("\n");
        buffer.append("[" + title + "]");
        buffer.append("\n");
    }

    @Override
    public void makeString(String str) {
        buffer.append('*' + str + "\n");
        buffer.append("\n");
    }

    @Override
    public void makeItems(String[] items) {
        for (int i = 0; i < items.length; i++) {
            buffer.append("  ." + items[i] + "\n");
        }
        buffer.append("\n");
    }

    @Override
    public void close() {
        buffer.append("======================\n");
    }
    
    public String getResult() {
        return buffer.toString();  //将StringBuffer变换为String
    }
}

　　TextBuilder类是Builder类的子类，实现了使用纯文本编写文档并以string返回结果。

package BigJunOba.bjtu.Builder;

public class Main {

    public static void main(String[] args) {
        
            TextBuilder textBuilder = new TextBuilder();
            Director director = new Director(textBuilder);
            director.construct();
            String result = textBuilder.getResult();
            System.out.println(result);
    
        }
}

　　Main类作为测试类，首先创建了一个TextBuilder的对象，然后把Builder类的子类，即TextBuilder的对象的实例传递给Director类，然后打印输出结果。

======================

[我是一个标题]
*一.下面我要讲第一个问题

  .1.廉
  .2.宝
  .3.宝

*二.下面我还要讲第二个问题

  .4.大
  .5.帅
  .6.逼

======================

 　　这是输出。

　　Builder模式的类图和时序图如下。

　　解释每一个部分：

　　Builder：定义用于生成实例的接口。

　　Director：使用Builder中定义的接口，

　　ConcreteBuilder：用来具体实现Builder接口，在生成实例时实际被调用。这里要注意的是，可以有多个ConcreteBuilder来实现不同的功能。如示例中没有实现的HTMLBuilder类。

　　Client：使用了Builder模式，不属于模式的一部分，示例中的Main类就是使用Builder模式从而得出结果。