》》组员向仲裁者报告，仲裁者向组员下达指示。组员之间不再相互
询问和相互指示。
》》在该模式中：一方面，当发生麻烦事情的时候，通知仲裁者；当
发生涉及全体组员的事情时，也通知仲裁者。当仲裁者下达指示时，
组员会立即执行。团队组员之间不再互相沟通并私自做出决定，而
是发生任何事情都向仲裁者报告。另一方面，仲裁者站在整个团队
的角度对组员上报的事情做出决定。
------------------下面的示例程序是一个GUI 应用程序，它展示了一个登
陆对话框，用户在其中输入正确的用户名和密码后可以登陆。
》》要调整多个对象之间的关系时，就需要用到 Mediator 模式了。
即不让各个对象之间互相通信，而是增加一个仲裁者角色，让
他们各自与仲裁者通信。然后，将控制显式的逻辑处理交给仲
裁者负责。
》》登陆对话框：
对话框的使用方法如下：
*** 可以选择作为游客访问（Guest） 或是作为用户登陆（Login）
*** 作为用户登陆时，需要输入正确的用户名（Username）和密码（Password）
*** 点击OK按钮可以登陆，点击 Cancel 按钮可以取消登陆
（在示例程序中我们不会真正登陆，而是在按下按钮后就退出程序）
具体的要求：
*** 如果选择作为游客访问，那么禁用用户名输入框和密码输入框，使用户无法输入
*** 如果选择作为用户登陆，那么启用用户名输入和密码输入框，使用户可以输入
*** 如果在用户名输入框中一个字符都没有输入，那么禁用密码输入框，使用户无法
输入密码
*** 如果用户名输入框中输入至少一个字符，那么启用密码输入框，使用户可以输入
密码（当然，如果选择作为游客访问，那么密码框依然是禁用状态）
*** 只有当用户名输入框和密码输入框中都至少输入一个字符后，OK 按钮才处于启
用状态，可以被按下。用户名输入框或密码输入框中一个字符都没有被输入的时
候，禁用 OK 按钮，使其不可被按下（当然，如果选择作为游客访问，那么OK
按钮总是处于启用状态）
*** Cancel 按钮总是处于启用状态，任何时候都可以按下该按钮。
-----------------------------------------
《示例程序的类图》
》》Mediator 接口：
package mediator;
/*
* 该接口是表示仲裁者的接口
*/
public interface Mediator {
/*
* 生成 Mediator 要管理的组员，在示例程序中，createColleagues()
* 会生成对话框中的按钮和文本输入框等控件
*/
public abstract void createColleagues();
/*
* colleagueChanged()该方法会被各个 Colleague 组员调用。
* 它的作用是让组员可以向仲裁者进行报告。在本例 中，当单选按钮和文本
* 输入框的状态发生变化时，该方法会被调用。
*/
public abstract void colleagueChanged();
}
》》Colleague 接口：
package mediator;
/*
* 该接口表示的是向仲裁者进行报告的组员的接口
*/
public interface Colleague {
/*
* 该方法的作用是告知组员“我是仲裁者，有事请报告我”。向该方法中传递的参数是
* 仲裁者的实例，之后在需要向仲裁者报告时（即调用colleagueChanged() ）
* 会用到该实例
*/
public abstract void setMediator(Mediator mediator);
/*
* 该方法的作用是告知组员仲裁者所下达的指示。参数 enabled 如果为 true ，
* 就表示自己需要变为“启动状态”；如果是 false ，则表示自己需要变为
* “禁止状态”。这个方法表明，究竟是变为“启动状态”还是变为“禁止状态”，
* 并非由组员自己决定，而是由仲裁者来决定。
*/
public abstract void setColleagueEnabled(boolean enabled);
}
》》ColleagueButton 类：
package mediator;
import java.awt.Button;
/*
* 按钮
*/
public class ColleagueButton extends Button implements Colleague {
private Mediator mediator;
//给该按钮指定标签
public ColleagueButton(String string){
super(string);
}
//保存该按钮的仲裁者
public void setMediator(Mediator mediator) {
this.mediator = mediator;
}
//Mediator 下达启用/禁止的指示
public void setColleagueEnabled(boolean enabled) {
setEnabled(enabled);
}
}
》》ColleagueTextField 类：
package mediator;
import java.awt.Color;
import java.awt.TextField;
import java.awt.event.TextEvent;
import java.awt.event.TextListener;
public class ColleagueTextField extends TextField implements Colleague,TextListener {
private Mediator mediator;
//单行文本初始化（使用构造函数 ）
public ColleagueTextField(String string , int columns){
super(string , columns);
}
//保存该单行文本的仲裁者
public void setMediator(Mediator mediator) {
this.mediator = mediator;
}
//Mediator 下达启用/禁用的指示
public void setColleagueEnabled(boolean enabled) {
setEnabled(enabled);
//当启用时，文本框的背景是白色；当禁用时，文本框的背景是灰色
setBackground(enabled? Color.white:Color.lightGray);
}
/*
* java.awt.event.TextListener 接口里面的方法
* 当文字发生变化时 通知 仲裁者 Mediator
*
* 当文本内容发生变化时，AWT 框架会调用该方法
*/
public void textValueChanged(TextEvent e){
mediator.colleagueChanged();
}
}
》》ColleagueCheckbox 类：
package mediator;
import java.awt.Checkbox;
import java.awt.CheckboxGroup;
import java.awt.event.ItemEvent;
import java.awt.event.ItemListener;
public class ColleagueCheckbox extends Checkbox implements ItemListener,Colleague {
private Mediator mediator;
//复选按钮的构造函数，CheckboxGroup 类用于集合 Checkbox 按钮集。
public ColleagueCheckbox(String caption , CheckboxGroup group , boolean state){
super(caption , group , state);
}
//设置该复选框的仲裁者
public void setMediator(Mediator mediator){
this.mediator = mediator;
}
//Meidator 下达启用/禁用指示
public void setColleagueEnabled(boolean enabled){
setEnabled(enabled);
}
/*
* java.awt.event.ItemListener 接口中的方法
* 在用户已选定或取消选定某项时调用。
*/
public void itemStateChanged(ItemEvent e) {
mediator.colleagueChanged();
}
}
》》 LoginFrame 类：
package mediator;
import java.awt.CheckboxGroup;
import java.awt.Color;
import java.awt.Frame;
import java.awt.GridLayout;
import java.awt.Label;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import java.awt.event.WindowAdapter;
import java.awt.event.WindowEvent;
import java.awt.event.WindowListener;
public class LoginFrame extends Frame implements ActionListener, Mediator,
WindowListener{
private ColleagueCheckbox checkGuest;
private ColleagueCheckbox checkLogin;
private ColleagueTextField textUser;
private ColleagueTextField textPass;
private ColleagueButton buttonOk;
private ColleagueButton buttonCancel;
//构造函数
//生成并配置各个 Colleague 后，显示对话框
public LoginFrame(String title){
super(title);
setBackground(Color.LIGHT_GRAY);
//使用布局管理器生成 4*2 窗格
setLayout(new GridLayout(4,2));
//给该窗口增加一个窗口监听器
this.addWindowListener(this);
//生成各个 Colleague
createColleagues();
//配置
add(checkGuest);
add(checkLogin);
add(new Label("Username:"));
add(textUser);
add(new Label("Password"));
add(textPass);
add(buttonOk);
add(buttonCancel);
//设置初始的启用、禁用状态
colleagueChanged();
//显示
pack();
setVisible(true);
}
//生成各个 Colleague
public void createColleagues() {
//生成
CheckboxGroup g = new CheckboxGroup();
checkGuest = new ColleagueCheckbox("Guest",g , true);
checkLogin = new ColleagueCheckbox("Login" , g , false);
textUser = new ColleagueTextField("" , 10);
textPass = new ColleagueTextField("" , 10);
//设置文本回显字符
textPass.setEchoChar('*');
buttonOk = new ColleagueButton("OK");
buttonCancel = new ColleagueButton("Cancel");
//设置 Mediator
checkGuest.setMediator(this);
checkLogin.setMediator(this);
textUser.setMediator(this);
textPass.setMediator(this);
buttonOk.setMediator(this);
buttonCancel.setMediator(this);
//设置 Listener
checkGuest.addItemListener(checkGuest);
checkLogin.addItemListener(checkLogin);
textUser.addTextListener(textUser);
textPass.addTextListener(textPass);
buttonOk.addActionListener(this);
buttonCancel.addActionListener(this);
}
//接收来自于 Colleague 的通知然后判断各 Colleague 的启用/禁用状态
public void colleagueChanged() {
/*
*当 Guest 按钮是开着的，那用户名和密码框就是关闭的，而ok 按钮是开着的
*/
//Guest 模式
if(checkGuest.getState()){
textUser.setColleagueEnabled(false);
textPass.setColleagueEnabled(false);
buttonOk.setColleagueEnabled(true);
}else{
//Login 模式
textUser.setColleagueEnabled(true);
userpassChanged();
}
}
/*
* 当 textUser 或 textPass 文本输入框中的文字发生变化时，
* 判断各 Colleague 的启用 / 禁用状态
*/
private void userpassChanged(){
if(textUser.getText().length() > 0){
textPass.setColleagueEnabled(true);
if(textPass.getText().length() > 0){
buttonOk.setColleagueEnabled(true);
}else{
buttonOk.setColleagueEnabled(false);
}
}else{
textPass.setColleagueEnabled(false);
buttonOk.setColleagueEnabled(false);
}
}
/*
* java.awt.event.ActionListener 接口
* 里面的方法
*/
public void actionPerformed(ActionEvent e) {
System.out.println(e.toString());
System.exit(0);
}
//java.awt.event.WindowListener 接口中的方法
@Override
public void windowOpened(WindowEvent e) {
// TODO Auto-generated method stub
}
@Override
public void windowClosing(WindowEvent e) {
System.exit(0);
}
@Override
public void windowClosed(WindowEvent e) {
// TODO Auto-generated method stub
}
@Override
public void windowIconified(WindowEvent e) {
// TODO Auto-generated method stub
}
@Override
public void windowDeiconified(WindowEvent e) {
// TODO Auto-generated method stub
}
@Override
public void windowActivated(WindowEvent e) {
// TODO Auto-generated method stub
}
@Override
public void windowDeactivated(WindowEvent e) {
// TODO Auto-generated method stub
}
}
》》Main 类-----》测试程序
package mediator;
public class Main {
public static void main(String[] args){
new LoginFrame("Mediator Sample");
}
}
-----------------------------------------------
《Mediator 模式中的登场角色》
**** Mediator （仲裁者、中介者）
Mediator 角色负责定义与 Colleague 角色进行通信和做出决定的接口。
在示例程序中，由 Mediator 接口扮演此角色。
**** ConcreteMediator （具体的仲裁者、中介者）
ConcreteMediator 角色负责实现 Mediator 角色的接口，负责实际做出
决定。在示例程序中，由 LoginFrame 类扮演此角色。
**** Colleague （同事）
Colleague 角色负责定义与 Mediator 角色进行通信的接口。在示例程序
中，由 Colleague 接口扮演此角色。
**** ConcreteColleague （具体的同事）
ConcreteColleague 角色负责定义实现 Colleague 角色的接口。在示例
程序中，由 ColleagueButton 类、ColleagueTextField 类 和
ColleagueCheckbox 类扮演此角色。
-----------------------------------------------
《扩展思路要点》
1.当发生分散灾难时
2.通信线路的增加
3.哪些角色可以复用
上面的示例程序中的 ConcreteColleague 角色可以复用，但是
ConcreteMediator 角色很难复用。
------------------------------------------------
《相关的设计模式》
**** Facade 模式
**** Observer 模式