一、什么是建造模式
建造者模式:是将一个复杂的对象的构建与它的表示分离,使得同样的构建过程可以创建不同的表示。
举一个栗子,我有A、B、C、D、E、F六块积木。我拿过来一个机器,我只需要向机器中放入积木,机器就可以根据我放入的积木生成不同的模型给我。此中,模型为“复杂的对象”,积木为“表现”,机器的作用是“构建对象”。当我构建某个对象时,我只需要知道它有什么样的表现,而不需要管它是如何构建的。
建造者模式通常包括下面几个角色:
1、Builder:给出一个抽象接口,以规范产品对象的各个组成成分的建造。这个接口规定要实现复杂对象的哪些部分的创建,并不涉及具体的对象部件的创建。
2、ConcreteBuilder:实现Builder接口,针对不同的商业逻辑,具体化复杂对象的各部分的创建。 在建造过程完成后,提供产品的实例。
3、Director:调用具体建造者来创建复杂对象的各个部分,在指导者中不涉及具体产品的信息,只负责保证对象各部分完整创建或按某种顺序创建。
4、Product:要创建的复杂对象。
二、演示实例(Android中使用DialogFragment构建消息提示框)
在Android应用程序中需要给予用户不同的消息提示框。如:仅有一个ok按钮的信息提示框,含有取消和确认的消息选择框,有标题有内容的消息选择框等等。
提示框上所有的元素可以视为它所包含的“表现”,最后展示给用户的提示框为“复杂的对象”。我们需要做的就是封装一个构建最终展示给用户的提示框的类。
代码制造中与定义不符之处
忽略了Director角色类的定义,Director角色的作用是将“复杂对象”的要组合的“表现”设置到ConcreteBuilder角色中。而ConcreteBuilder角色的作用是将接收到的“表现”进行建造组合后,提供产品实例。
二、演示实例
实际代码内容
代码制造内容中使用了DataBing,用DataBing完成Fragment与布局文件间数据的双向绑定。
1、Product:要创建的复杂对象。
代码块
public class PromptDialogFragment extends DialogFragment {
private final static String TAG = "PromptDialogFragment";
private static final String BUNDLE_KEY_INFO = "BUNDLE_KEY_INFO";
private static final String BUNDLE_KEY_CANCEL = "BUNDLE_KEY_CANCEL";
private static final String BUNDLE_KEY_CONFIRM = "BUNDLE_KEY_CONFIRM";
private static final String BUNDLE_KEY_OK = "BUNDLE_KEY_OK";
private static final String BUNDLE_KEY_CALLBACK = "BUNDLE_KEY_CALLBACK";
/**
* Dialog提示框的默认宽度
*/
private final int DEFAULT_WIDTH = 240;
@Inject
DisplayUtil displayUtil;
FragmentPromptDialogBinding binding;
public final ObservableField<String> infoValue = new ObservableField<>();
public final ObservableField<String> cancelValue = new ObservableField<>();
public final ObservableField<String> confirmValue = new ObservableField<>();
public final ObservableField<String> okValue = new ObservableField<>();
private CallBack callBack;
public static PromptDialogFragment newInstance(){
PromptDialogFragment fragment = new PromptDialogFragment();
return fragment;
}
@Override
public void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
AndroidSupportInjection.inject(this);
Bundle bundle = getArguments();
infoValue.set(bundle.getString(BUNDLE_KEY_INFO));
cancelValue.set(bundle.getString(BUNDLE_KEY_CANCEL));
confirmValue.set(bundle.getString(BUNDLE_KEY_CONFIRM));
okValue.set(bundle.getString(BUNDLE_KEY_OK));
callBack= (CallBack) bundle.getSerializable(BUNDLE_KEY_CALLBACK);
}
@Nullable
@Override
public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container, @Nullable Bundle savedInstanceState) {
//设置DialogFragment无标题
getDialog().requestWindowFeature(Window.FEATURE_NO_TITLE);
binding = DataBindingUtil.inflate(inflater, R.layout.fragment_prompt_dialog, container, false);
binding.setViewModel(this);
//设置点击空白区域Dialog框不消失
setCancelable(false);
return binding.getRoot();
}
@Override
public void onStart() {
super.onStart();
initDialogSize();
}
/**
* 初始化Dialog提示框的大小
*/
private void initDialogSize(){
Window window = getDialog().getWindow();
// 一定要设置Background,如果不设置,window属性设置无效
window.setBackgroundDrawable( new ColorDrawable(Color.TRANSPARENT));
DisplayMetrics dm = new DisplayMetrics();
getActivity().getWindowManager().getDefaultDisplay().getMetrics( dm );
WindowManager.LayoutParams params = window.getAttributes();
params.gravity = Gravity.CENTER;
// 使用ViewGroup.LayoutParams,以便Dialog 宽度充满整个屏幕
params.width = displayUtil.dip2px(DEFAULT_WIDTH);
params.height = ViewGroup.LayoutParams.WRAP_CONTENT;
window.setAttributes(params);
}
public void show(FragmentManager manager) {
super.show(manager, TAG);
}
/**
* 消息框取消按钮的点击事件(左边按钮)
* @param view
*/
public void cancelClick(View view){
super.dismiss();
if(callBack!=null){
callBack.onCancel();
}
}
/**
* 消息框确认按钮的点击事件(右边按钮)
* @param view
*/
public void confirmClick(View view){
super.dismiss();
if(callBack!=null){
callBack.onSuccess();
}
}
/**
* 消息框OK按钮的点击事件(仅有一个按钮)
* @param view
*/
public void okClick(View view){
super.dismiss();
if(callBack!=null){
callBack.onSuccess();
}
}
/**
* Dialog提示框按钮点击事件回调接口
*/
public interface CallBack extends Serializable {
void onSuccess();
void onCancel();
}
}
2、Builder:给出一个抽象接口,以规范产品对象的各个组成成分的建造。这个接口规定要实现复杂对象的哪些部分的创建,并不涉及具体的对象部件的创建。
代码块
/**
* 抽象建造,以规范产品对象的各个组成成分的建造
*/
public interface PromptDialogBuilder{
/**
* 设置提示框提示信息
* @param value
* @return
*/
PromptDialogBuilder setInfoValue(String value);
/**
* 设置取消按钮文言(左侧按钮)
* @param value
* @return
*/
PromptDialogBuilder setCancelValue(String value);
/**
* 设置确认按钮文言(右侧按钮)
* @param value
* @return
*/
PromptDialogBuilder setConfirmValue(String value);
/**
* 设置按钮文言(该按钮与“取消、确认按钮在显示上互斥”)
* @param value
* @return
*/
PromptDialogBuilder setOKValue(String value);
/**
* 设置按钮点击事件的回调
* @param callBack
* @return
*/
PromptDialogBuilder setCallBack(CallBack callBack);
/**
* 提供产品实例(返回PromptDialogFragment对象)
* @return
*/
PromptDialogFragment build();
}
3、ConcreteBuilder:实现Builder接口,针对不同的商业逻辑,具体化复杂对象的各部分的创建。 在建造过程完成后,提供产品的实例。
代码块
/**
* 具体的建造,针对不同的商业逻辑,具体化复杂对象的各部分的创建。 在建造过程完成后,提供产品的实例。
*/
public final static class Builder implements PromptDialogBuilder{
private String infoValue;
private String cancelValue = "取消";
private String confirmValue = "确认";
private String okValue;
private CallBack callBack;
private AppCompatActivity activity;
public <T extends AppCompatActivity>Builder(T activity){
this.activity=activity;
}
@Override
public Builder setInfoValue(String value) {
this.infoValue=value;
return this;
}
@Override
public Builder setCancelValue(String value) {
this.cancelValue=value;
return this;
}
@Override
public Builder setConfirmValue(String value) {
this.confirmValue=value;
return this;
}
@Override
public Builder setOKValue(String value) {
this.okValue=value;
return this;
}
@Override
public Builder setCallBack(CallBack callBack) {
this.callBack=callBack;
return this;
}
@Override
public PromptDialogFragment build() {
PromptDialogFragment fragment = PromptDialogFragment.newInstance();
Bundle bundle=new Bundle();
bundle.putString(BUNDLE_KEY_INFO, infoValue);
bundle.putString(BUNDLE_KEY_CANCEL, cancelValue);
bundle.putString(BUNDLE_KEY_CONFIRM, confirmValue);
bundle.putString(BUNDLE_KEY_OK, okValue);
bundle.putSerializable(BUNDLE_KEY_CALLBACK, callBack);
fragment.setArguments(bundle);
fragment.show(activity.getSupportFragmentManager());
return fragment;
}
}
4、Director:调用具体建造者来创建复杂对象的各个部分,在指导者中不涉及具体产品的信息,只负责保证对象各部分完整创建或按某种顺序创建。
代码块
new PromptDialogFragment.Builder(this).setInfoValue("您已登录成功!").setOKValue("OK").build();
代码块
new PromptDialogFragment.Builder(this)
.setInfoValue("你是否执行登录操作!")
.setCancelValue("取消")
.setConfirmValue("确认")
.setCallBack(new PromptDialogFragment.CallBack() {
@Override
public void onSuccess() {
Toast.makeText(activity, "确认操作", Toast.LENGTH_LONG).show();
}
@Override
public void onCancel() {
Toast.makeText(activity, "取消操作", Toast.LENGTH_LONG).show();
}
}).build();
最后附上布局文件的内容
代码块
<layout xmlns:android="http://schemas.android.com/apk/res/android">
<data>
<import type="android.view.View"/>
<variable
name="viewModel"
type="com..fragment.PromptDialogFragment" />
</data>
<RelativeLayout
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:background="@drawable/white_round_bg"
android:paddingTop="20dp">
<TextView
android:id="@+id/prompt_info"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginLeft="15dp"
android:layout_marginRight="15dp"
android:gravity="center_horizontal"
android:text="@{viewModel.infoValue}" />
<View
android:id="@+id/prompt_lines"
android:layout_width="match_parent"
android:layout_height="0.1dp"
android:layout_below="@+id/prompt_info"
android:layout_marginTop="15dp"
android:background="@color/new_title_line_bg" />
<LinearLayout
android:layout_width="match_parent"
android:layout_height="40dp"
android:layout_below="@+id/prompt_lines"
android:visibility="@{viewModel.okValue==null?View.VISIBLE:View.GONE}">
<TextView
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1"
android:gravity="center"
android:text="@{viewModel.cancelValue}"
android:onClick="@{viewModel::cancelClick}"/>
<View
android:layout_width="0.1dp"
android:layout_height="match_parent"
android:layout_below="@+id/prompt_info"
android:layout_marginBottom="3dp"
android:layout_marginTop="3dp"
android:background="@color/new_title_line_bg" />
<TextView
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1"
android:gravity="center"
android:text="@{viewModel.confirmValue}"
android:onClick="@{viewModel::confirmClick}"/>
</LinearLayout>
<LinearLayout
android:layout_width="match_parent"
android:layout_height="40dp"
android:layout_below="@+id/prompt_lines"
android:visibility="@{viewModel.okValue==null?View.GONE:View.VISIBLE}">
<TextView
android:layout_width="0dp"
android:layout_height="match_parent"
android:layout_weight="1"
android:gravity="center"
android:text="@{viewModel.okValue}"
android:onClick="@{viewModel::okClick}"/>
</LinearLayout>
</RelativeLayout>
</layout>