示例程序
使用Builder模式編寫“文檔”的程序。這裏編寫出的文檔結構如下:
- 含有一個標題
- 含有幾個字符串
- 含有條目項目
Builder類中定義了決定文檔結構的方法,然後Director類使用該方法編寫一個具體的文檔。
Builder是抽象類,它並沒有進行任何實際的處理,僅聲明瞭抽象方法。Builder類的子類決定了用來編寫文檔的具體出裏。
/*
* Builder聲明瞭編寫文檔方法的抽象類。makeTitle、makeString、makeItems
* 方法分別是編寫標題、字符串、條目方法。close是完成文檔編寫*/
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();
}
/*
* Director類使用Builder類中聲明的方法來編寫文檔。
* Director構造函數傳入的參數是Builder類型,但是參數是Builder的子類
* construct方法是編寫文檔,所調用的方法都是在Builder類中聲明的方法。*/
public class Director {
private Builder builder;
public Director(Builder builder) {
this.builder=builder;
}
public void construct() {
builder.makeTitle("Greeting");
builder.makeString("從早上至下午");
builder.makeItems(new String[] {
"早上好",
"下午好"
});
builder.makeString("晚上");
builder.makeItems(new String[] {
"晚上好",
"晚安。",
"再見。"
});
builder.close();
}
}
import java.io.*;
public class HTMLBuilder extends Builder{
private String filename;
private PrintWriter writer;
@Override
public void makeTitle(String title) {
filename=title+".html";
try {
writer=new PrintWriter(new FileWriter(filename));
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
writer.println("<html><head><title>"+title+"</title></head><body>");
//輸出標題
writer.println("<h1>"+title+"</h1>");
}
@Override
public void makeString(String str) {
writer.println("<p>"+str+"</p>");
}
@Override
public void makeItems(String[] items) {
writer.println("<ul>");
for(int i=0;i<items.length;i++) {
writer.println("<li>"+items[i]+"</li>");
}
writer.println("</ul>");
}
@Override
public void close() {
writer.println("</body></html>");
writer.close();
}
public String getResult() {
return filename;
}
}
/*
* 功能是純文本編寫,並以String方式返回*/
public class TextBuilder extends Builder{
private StringBuilder buffer=new StringBuilder();
@Override
public void makeTitle(String title) {
buffer.append("==================\n");
buffer.append("["+title+"]\n");
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();
}
}
public class Main {
public static void main(String[] args) {
if(args.length!=1) {
usage();
System.exit(0);
}
if(args[0].equals("plain")) {
TextBuilder textBuilder=new TextBuilder();
Director director=new Director(textBuilder);
director.construct();
String result=textBuilder.getResult();
System.out.println(result);
}else if(args[0].equals("html")) {
HTMLBuilder htmlBuilder=new HTMLBuilder();
Director director=new Director(htmlBuilder);
director.construct();
String filename=htmlBuilder.getResult();
System.out.println(filename);
}else {
usage();
System.exit(0);
}
}
private static void usage() {
System.out.println("Usage: java Main plain 純文本編輯");
System.out.println("Usage: java Main html 編寫HTML文檔");
}
}
Builder模式中的登場角色
*Builder(建造者)
Builder角色負責定義用於生成實例的接口。Builder角色中準備了用於生成實例的方法。在示例程序中Builder就是扮演此角色。
ConcreteBuilder(具體創建者)
ConcreteBuilder角色是負責實現Builder角色的接口的類。這裏定義了在生成實例時實際被調用的方法此外ConcreteBuilder角色中還定義了最終生成結果的方法。在示例程序中TextBuilder和HTMLBuilder就是扮演次角色。
Director(監工)
Director角色負責使用Builder的接口來生成實例。它並不依賴與ConcreteBuilder角色。爲了保證不論ConcreteBuilder角色是如何被定義的,Director角色都能正常工作,它只調用在Builder中的定義的方法。在示例程序中Direcctor類扮演此角色。
Client(使用者)
該角色使用了Builder模式。在示例程序中Main扮演此角色。
誰知道??
Main類並不知道(沒有調用)Builder類,它只調用了Director類的construct方法。這樣Director類就會開始工作(Main對此一無所知),並完成文檔的編寫。
另一方面,Director類知道Builder類,它調用了Builder類的方法來編寫文檔,但是它並不知道它“真正”使用的是哪個類。也不需要知道,因爲Director實現了Builder類的方法。而這些方法子類也都已經實現。
Director類不知道自己使用的是Builder的哪個子類,因爲這樣不知道才能替換。無論將Buidler的哪個子類傳遞給它,都可以正常工作。
正因爲不知道所以才能替換,作爲設計人員,我們必須時刻關注這種“可替換性”。