访问者（Visitor）

1. 意图（Intent）

为一个对象结构（比如组合结构）增加新能力。

2. 类图（Class Diagram）

• Visitor：访问者，为每一个 ConcreteElement 声明一个 visit 操作
• ConcreteVisitor：具体访问者，存储遍历过程中的累计结果
• ObjectStructure：对象结构，可以是组合结构，或者是一个集合。

  3. 实现（Implementation）

元素接口 [ Element ]

public interface Element {
    void accept(Visitor visitor);
}

[ ConcreteElement ]
具体的元素顾客实现类

public class Customer implements Element {
    private String name;
    private List<Order> orders = new ArrayList<>();
    Customer(String name) {
        this.name = name;
    }
    String getName() {
        return name;
    }
    void addOrder(Order order) {
        orders.add(order);
    }
    public void accept(Visitor visitor) {
        visitor.visit(this);
        for (Order order : orders) {
            order.accept(visitor);
        }
    }
}

具体的元素订单实现类

public class Order implements Element {
    private String name;
    private List<Item> items = new ArrayList();
    Order(String name) {
        this.name = name;
    }
    Order(String name, String itemName) {
        this.name = name;
        this.addItem(new Item(itemName));
    }
    String getName() {
        return name;
    }
    void addItem(Item item) {
        items.add(item);
    }
    public void accept(Visitor visitor) {
        visitor.visit(this);
        for (Item item : items) {
            item.accept(visitor);
        }
    }
}

具体的元素Item实现类

public class Item implements Element {
    private String name;
    Item(String name) {
        this.name = name;
    }
    String getName() {
        return name;
    }
    public void accept(Visitor visitor) {
        visitor.visit(this);
    }
}

定义访问方法的访问者接口 [ Visitor ]

public interface Visitor {
    void visit(Customer customer);
    void visit(Order order);
    void visit(Item item);
}

实现访问方法的具体访问者综合报告类 [ ConcreteVisitor ]
记录了所有的访问信息

public class GeneralReport implements Visitor {
    private int customersNo;
    private int ordersNo;
    private int itemsNo;
    public void visit(Customer customer) {
        System.out.println(customer.getName());
        customersNo++;
    }
    public void visit(Order order) {
        System.out.println(order.getName());
        ordersNo++;
    }
    public void visit(Item item) {
        System.out.println(item.getName());
        itemsNo++;
    }
    public void displayResults() {
        System.out.println("Number of customers: " + customersNo);
        System.out.println("Number of orders:    " + ordersNo);
        System.out.println("Number of items:     " + itemsNo);
    }
}

客户群类 [ ObjectStructure ]
该类成员变量记录了所有的顾客信息（聚合关系），可以添加顾客和让所有顾客接受访问者

class CustomerGroup {
    private List<Customer> customers = new ArrayList<>();
    void accept(Visitor visitor) {
        for (Customer customer : customers) {
            customer.accept(visitor);
        }
    }
    void addCustomer(Customer customer) {
        customers.add(customer);
    }
}

客户端演示代码：

public class Client {
    public static void main(String[] args) {
        Customer customer1 = new Customer("customer1");
        customer1.addOrder(new Order("order1", "item1"));
        customer1.addOrder(new Order("order2", "item1"));
        customer1.addOrder(new Order("order3", "item1"));
        Order order = new Order("order_a");
        order.addItem(new Item("item_a1"));
        order.addItem(new Item("item_a2"));
        order.addItem(new Item("item_a3"));
        Customer customer2 = new Customer("customer2");
        customer2.addOrder(order);
        CustomerGroup customers = new CustomerGroup();
        customers.addCustomer(customer1);
        customers.addCustomer(customer2);
        GeneralReport visitor = new GeneralReport();
        customers.accept(visitor);
        visitor.displayResults();
    }
}

输出：

customer1
order1
item1
order2
item1
order3
item1
customer2
order_a
item_a1
item_a2
item_a3
Number of customers: 2
Number of orders:    4
Number of items:     6