Builder 模式：又叫建造者模式，将一个复杂对象的构建和表示分离，通过不同的构建，出现不同的表示；解耦代码，增加扩展性
这里主要通过分析 android 源码中的 AlertDialog 进而理解这个模式；先来看简单使用
new AlertDialog.Builder(this)
.setTitle("测试")
.setMessage("测试对话框")
.show();
通过 new 一个 Builder 对象，给这个对象设置不同参数，从而得到不同样式的 Dialog ；看 AlertDialog.Builder(this) 做了什么
//这里只截取部分代码
public static class Builder {
//定义一个 AlertParams p 用来保存参数
private final AlertParams P;
private final int mTheme;
public Builder(@NonNull Context context) {
this(context, AlertDialog.resolveDialogTheme(context, 0));
}
public Builder(@NonNull Context context, @StyleRes int themeResId) {
//在构造方法中初始化 AlertParams
this.P = new AlertParams(new ContextThemeWrapper(context, AlertDialog.resolveDialogTheme(context, themeResId)));
this.mTheme = themeResId;
}
}
主要就是 new AlertParams 对象，这个对象用来保存 set 进来的参数；如下：
public AlertDialog.Builder setTitle(@Nullable CharSequence title) {
this.P.mTitle = title;
return this;
}
setTitle 就是将 title 设置到 AlertParams 的 mTitle 中，其他 set 方法同理，都是将参数设置到 AlertParams 中，继续往下看 .show(); 方法
public AlertDialog show() {
//调用自身的 create 方法，创建 AlertDialog 对象
AlertDialog dialog = this.create();
//显示对话框
dialog.show();
return dialog;
}
public AlertDialog create() {
//new 一个 AlertDialog 对象
AlertDialog dialog = new AlertDialog(this.P.mContext, this.mTheme);
//......
return dialog;
}
先来看这一部分，show 方法其实就是 new AlertDialog ，得到 AlertDialog 对象，先来看 new AlertDialog 做了什么
public class AlertDialog extends AppCompatDialog implements DialogInterface {
final AlertController mAlert;
static final int LAYOUT_HINT_NONE = 0;
static final int LAYOUT_HINT_SIDE = 1;
//注意看，这几个构造方法最终都会调用第二个构造方法
protected AlertDialog(@NonNull Context context) {
this(context, 0);
}
protected AlertDialog(@NonNull Context context, @StyleRes int themeResId) {
super(context, resolveDialogTheme(context, themeResId));
//创建一个 AlertController 对象，并将 AlertDialog 对象传过去
this.mAlert = new AlertController(this.getContext(), this, this.getWindow());
}
protected AlertDialog(@NonNull Context context, boolean cancelable, @Nullable OnCancelListener cancelListener) {
this(context, 0);
this.setCancelable(cancelable);
this.setOnCancelListener(cancelListener);
}
}
所以，目前为止一共出现了四个类
- AlertDialog
- Builder
- AlertController
- AlertParams
其中 Builder 是 AlertDialog 的内部类，AlertParams 是 AlertController 的内部类；Builder 持有一个 AlertParams 对象，AlertController 持有一个 AlertDialog 对象；继续看 create 方法
public AlertDialog create() {
//创建 AlertDialog 对象和 AlertController 对象
AlertDialog dialog = new AlertDialog(this.P.mContext, this.mTheme);
//调用 AlertParams.apply 方法 并将 AlertController 传过去
this.P.apply(dialog.mAlert);
dialog.setCancelable(this.P.mCancelable);
if (this.P.mCancelable) {
dialog.setCanceledOnTouchOutside(true);
}
dialog.setOnCancelListener(this.P.mOnCancelListener);
dialog.setOnDismissListener(this.P.mOnDismissListener);
if (this.P.mOnKeyListener != null) {
dialog.setOnKeyListener(this.P.mOnKeyListener);
}
return dialog;
}
关键就是 AlertParams.apply 方法：
//这是删减后的代码
public void apply(AlertController dialog) {
//判断是否设置有 mCustomTitleView
if (this.mCustomTitleView != null) {
dialog.setCustomTitle(this.mCustomTitleView);
} else {
//判断 mTitle 是否为null
if (this.mTitle != null) {
//我们前面设置了，所以不为null
//将 mTitle 设置给 dialog
//注意 dialog 对象是一个 AlertController
dialog.setTitle(this.mTitle);
}
}
}
apply 方法主要就是判断我们 set 了那些参数，进行非空判断之后又这是给 AlertController 对象；到目前为止，AlertController 和 AlertParams 中包含了我们 set 的参数，然后就没有了，那么是怎么设置到 AlertDialog 中，让 AlertDialog 根据不同参数显示不同效果呢？下面来看 dialog.show(); 方法
//前面分析的 show ，现在要看的是 dialog.show();
public AlertDialog show() {
AlertDialog dialog = this.create();
//来看这个方法
dialog.show();
return dialog;
}
dialog.show(); 就是将 Dialog 显示到界面上
public void show() {
//.....
//判断是否创建，第一次肯定是false
if (!mCreated) {
dispatchOnCreate(null);
} else {
// Fill the DecorView in on any configuration changes that
// may have occured while it was removed from the WindowManager.
final Configuration config = mContext.getResources().getConfiguration();
mWindow.getDecorView().dispatchConfigurationChanged(config);
}
//.......
}
void dispatchOnCreate(Bundle savedInstanceState) {
if (!mCreated) {
//调用 onCreate
onCreate(savedInstanceState);
mCreated = true;
}
}
//发现是一个空方法，我们回到 AlertDialog 中，看怎么重写
protected void onCreate(Bundle savedInstanceState) {
}
走了一圈，发现是一个空方法，我们回到 AlertDialog 中，看怎么重写
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
//调用 mAlert.installContent
// 就是 AlertController.installContent
this.mAlert.installContent();
}
最后发现调用了 AlertController.installContent 好像这些模块都关联起来了
public void installContent() {
int contentView = this.selectContentView();
this.mDialog.setContentView(contentView);
this.setupView();
}
private void setupView() {
//.........
this.setupTitle(topPanel);
//......
}
private void setupTitle(ViewGroup topPanel) {
View titleTemplate;
//判断 mCustomTitleView 是否为null
if (this.mCustomTitleView != null) {
LayoutParams lp = new LayoutParams(-1, -2);
topPanel.addView(this.mCustomTitleView, 0, lp);
titleTemplate = this.mWindow.findViewById(id.title_template);
titleTemplate.setVisibility(8);
} else {
this.mIconView = (ImageView)this.mWindow.findViewById(16908294);
boolean hasTextTitle = !TextUtils.isEmpty(this.mTitle);
if (hasTextTitle && this.mShowTitle) {
//找到默认 titleView
this.mTitleView = (TextView)this.mWindow.findViewById(id.alertTitle);
//设置标题
this.mTitleView.setText(this.mTitle);
if (this.mIconId != 0) {
this.mIconView.setImageResource(this.mIconId);
} else if (this.mIcon != null) {
this.mIconView.setImageDrawable(this.mIcon);
} else {
this.mTitleView.setPadding(this.mIconView.getPaddingLeft(), this.mIconView.getPaddingTop(), this.mIconView.getPaddingRight(), this.mIconView.getPaddingBottom());
this.mIconView.setVisibility(8);
}
} else {
titleTemplate = this.mWindow.findViewById(id.title_template);
titleTemplate.setVisibility(8);
this.mIconView.setVisibility(8);
topPanel.setVisibility(8);
}
}
}
最后发现，根据不同的set然后给Dialog设置了不同的样子
小总结
当调用 Builder.create() 方法时，就是将各种参数设置进去，就和建房子准备砖头水泥；当调用dialog.show() 就是构建需要的对象，就和建房子开始盖。最后在附上UML图
WechatIMG443.jpeg
