Builder设计模式 - 增强版 NavigationBar

1. Builder设计模式的定义？

---

又称建造者模式，将构建过程和表示过程进行分离，让（参数）构建过程变得更加的简单和直观；

2. Builder设计模式实例？

---

有很多框架都用到了Builder设计模式，比如Okhttp、Dialog；

OKHttp：

        // connectTimeout().addNetworkInterceptor().addInterceptor() 其实是要给OKHttp用的
        // 按照一般的套路基本都是 OkHttpClient client = new OkHttpClient();
        //                        client.setTimeOut();
        //                        client.setNetworkInterceptor();
        //                        client.setInterceptor();
        /*OkHttpClient client = new OkHttpClient.Builder().connectTimeout()
                .addNetworkInterceptor().addInterceptor().build();*/

3. 使用场景？

---

对象构建过程相对来说比较复杂的情况下，也就是说参数比较多的情况下回使用Builder设计模式

4. Dialog源码分析？

---

AlertDialog类：最终构建的对象（Dialog）
Builder类：用于构建我们的Dialog
AlertParams类：用于存放参数

如下图所示：

建造者设计模式 - Dialog源码分析.png

5. Builder设计模式和链式调用的区别？

---

这两个完全是两个概念。

Builder设计模式是一种设计模式，链式调用只是一种调用方式，但是一般来讲，Builder设计模式一般都是采用链式调用的这种方式，并不是所有的链式调用都是Builder设计模式。

一般在使用过程是 采用 ... 的方式不一定是Builder设计模式。

链式调用有一个体现，就是在调用方法的时候返回自身对象，Builder一般也有一个体现，就是一般都会出现Builder对象。

6. 增强版的 NavigationBar

---

像我们平时写的顶部标题栏，如下图所示，由于它里边涉及到的对象比较多，所以符合Builder设计模式的使用，那么接下来我们就采用Builder设计模式来写一个 NavigationBar头部标题栏，示例图如下：

Builder设计模式使用 - NavigationBar.png

代码如下所示：
1>：INavigation是一个接口，表示导航栏的规范

/**
 * Email: [email protected]
 * Created by Novate 2018/5/6 18:04
 * Version 1.0
 * Params:
 * Description:    导航栏的规范
*/

public interface INavigation {

    void createNavigationBar();

    /**
     * 绑定参数
     */
    void attachNavigationParams();

    /**
     * 将 NavigationView添加到父布局
     */
    void attachParent(View navigationBar, ViewGroup parent);
}

2>：AbsNavigationBar这个是导航栏的基类

/**
 * Email: [email protected]
 * Created by Novate 2018/5/6 18:04
 * Version 1.0
 * Params:
 * Description:    这个是导航栏的基类
*/

public class AbsNavigationBar implements INavigation {
    private B mBuilder;
    private View mNavigationBar;

    protected AbsNavigationBar(B builder) {
        this.mBuilder = builder;
        createNavigationBar();
    }

    @Override
    public void createNavigationBar() {
        mNavigationBar = LayoutInflater.from(mBuilder.mContext)
                .inflate(mBuilder.mLayoutId, mBuilder.mParent, false);
        // 添加
        attachParent(mNavigationBar, mBuilder.mParent);
        // 绑定参数
        attachNavigationParams();
    }

    /**
     * 绑定参数
     */
    @Override
    public void attachNavigationParams() {
        // 设置文本
        Map textMaps = mBuilder.mTextMaps;
        for (Map.Entry entry : textMaps.entrySet()) {
            TextView textView = findViewById(entry.getKey());
            textView.setText(entry.getValue());
        }
        // 设置点击事件
        Map clickListenerMaps = mBuilder.mCLickListenerMaps;
        for (Map.Entry entry : clickListenerMaps.entrySet()) {
            View view = findViewById(entry.getKey());
            view.setOnClickListener(entry.getValue());
        }
    }

    public  T findViewById(int viewId) {
        return (T) mNavigationBar.findViewById(viewId);
    }

    /**
     * 将 NavigationView添加到父布局
     */
    @Override
    public void attachParent(View navigationBar, ViewGroup parent) {
        parent.addView(navigationBar, 0);
    }

    /**
     * 返回 Builder
     */
    public B getBuilder() {
        return mBuilder;
    }

    /**
     * Builder 构建类
     * 构建 NavigationBar 还有存储参数
     */
    public static abstract class Builder {
        public Context mContext;
        public int mLayoutId;
        public ViewGroup mParent;
        public Map mTextMaps;
        public Map mCLickListenerMaps;

        public Builder(Context context, int layoutId, ViewGroup parent) {
            this.mContext = context;
            this.mLayoutId = layoutId;
            this.mParent = parent;
            mTextMaps = new HashMap<>();
            mCLickListenerMaps = new HashMap<>();
        }

        /**
         * 用来创建 NavigationBar
         */
        public abstract AbsNavigationBar create();

        // 返回的是 AbsNavigationBar 的 Builder ,但是当我们调用 create() 方法的时候会报错

        /**
         * 设置文本
         */
        public B setText(int viewId, String text) {
            mTextMaps.put(viewId, text);
            return (B) this;
        }

        /**
         * 设置点击事件
         */
        public B setOnClickListener(int viewId, View.OnClickListener clickListener) {
            mCLickListenerMaps.put(viewId, clickListener);
            return (B) this;
        }
    }
}

3>：NavigationBar，可以直接拿过来用的 导航栏

/**
 * Email: [email protected]
 * Created by Novate 2018/5/6 18:09
 * Version 1.0
 * Params:
 * Description:    可以拿过来直接使用的 导航栏
*/

public class NavigationBar extends AbsNavigationBar{

    protected NavigationBar(Builder builder) {
        super(builder);
    }

    /**
     * 导航栏的Builder
     */
    public static class Builder extends AbsNavigationBar.Builder{

        public Builder(Context context, int layoutId, ViewGroup parent) {
            super(context, layoutId, parent);
        }

        @Override
        public NavigationBar create() {
            return new NavigationBar(this);
        }
    }
}

4>：DefaultNavigationBar，可以直接拿过来用的 默认样式导航栏

/**
 * Email: [email protected]
 * Created by Novate 2018/5/6 18:09
 * Version 1.0
 * Params:
 * Description:    可以拿过来直接使用的 默认样式导航栏
*/

public class DefaultNavigationBar extends AbsNavigationBar{

    protected DefaultNavigationBar(Builder builder) {
        super(builder);
    }

    @Override
    public void attachNavigationParams() {
        super.attachNavigationParams();
        // 处理特有的
        TextView leftView = findViewById(R.id.back_tv);
        leftView.setVisibility(getBuilder().mLeftVisible);
    }

    /**
     * 导航栏的Builder
     */
    public static class Builder extends AbsNavigationBar.Builder{
        public int mLeftVisible = View.VISIBLE;

        public Builder(Context context, ViewGroup parent) {
            super(context, R.layout.ui_defualt_navigation_bar, parent);
        }

        @Override
        public DefaultNavigationBar create() {
            return new DefaultNavigationBar(this);
        }

        public Builder setLeftText(String text){
            setText(R.id.back_tv,text);
            return this;
        }

        public Builder setLeftClickListener(View.OnClickListener clickListener){
            setOnClickListener(R.id.back_tv,clickListener);
            return this;
        }

        public Builder hideLeftText() {
            mLeftVisible = View.INVISIBLE;
            return this;
        }
    }
}

5>：直接在MainActivity中使用即可：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);


        ViewGroup parent = (ViewGroup) findViewById(R.id.view_root);

        DefaultNavigationBar navigationBar =
                new DefaultNavigationBar.Builder(this,parent)
                        .setLeftText("返回")
                        .hideLeftText()
                        .setLeftClickListener(new View.OnClickListener(){
                            @Override
                            public void onClick(View v) {
                                finish();
                            }
                        })
                        // 还有一些参数
                        .create();
        
        
        
        Dialog dialog = new AlertDialog.Builder(this)
                .setTitle("标题")
                .setIcon(R.mipmap.ic_launcher)

                // 在 create()之前的所有操作都是 去存放我们的参数

                // create()方法主要是用于创建 Dialog对象，然后把参数取出来，设置给 Dialog，
                // 然后返回一个最终的Dialog对象
                .create() ;
    }
}

具体代码已上传至github：
https://github.com/shuai999/Architect_day9.git