美文网首页设计模式Android技术知识Android知识
Android建造者模式初探(Toast工具类的进一步封装)

Android建造者模式初探(Toast工具类的进一步封装)

作者: Silence潇湘夜雨 | 来源:发表于2017-06-17 15:30 被阅读408次

    前提

    在写这篇文章前一直在思考,我对建造者模式有了一个大体的理解。但是,有没有可能会造成过度封装呢,这里还需要各位看官老爷来评判,如果想看之前的对Toast工具了的封装可以移步Android 自定义Toast,并且勘误Android工具类里面的ToastUtils,有不足之处还望指出。

    话不多说先上图

    Toast基本显示.png 带图标和改变字体图标大小的toast.png 改变背景颜色的toast.png 改变字体颜色和位置的toast.png

    1、先讲一下什么是建造者模式

    释义

    建造者模式 (BuilderPattern) 又称为生成器模式,该模式主要用于将一个复杂对象的构建与它的表示分离,向用户屏蔽复杂对象组成部分的创建细节,使得同样的构建过程可以创建不同的表示。建造者模式通常包含如下4个角色。

    UML图:


    建造者模式图

    角色介绍

    1.Builder:抽象建造者角色,主要为创建产品对象的各组成部分指定抽象接口,一般包含两类方法,其中 buildPartX() 用于创建复杂对象的各部分,此种方法的数量取决于复杂对象组成部分的多少;getResult() 用于返回复杂对象。

    2.ConcreteBuilder:具体建造者角色,继承自抽象建造者,实现复杂对象各部件的构造和装配,并返回该对象。

    3.Director:指挥者角色,客户端通常只与该角色交互,通过construct()方法方法得到复杂对象。

    4.Product:产品角色(复杂对象),通常定义为一个 POJO,针对其中的每个成员对象都有一组公有的 get() 和 set() 方法。

    建造者模式的分类

    根据产品创建过程中零件的构造是否具有一致的先后顺序,可以将其分为“有设计者” 和 “无设计者”,两种形式。

    有设计者

    在现实生活中,建造一个房子,但我们不知道怎么造,就要请负责总体设计的设计师和负责具体施工的工人,设计师只设计图纸、命令工人干活,不参与施工。工人负责具体细节(窗户、地板的构建)。最后,我们要从工人手中接过建造好的房子。

    对建造者(工人)的规范:

    package cn.house;
    
    public interface Builder {
    
      /**
       * 建造窗户
       */
      public void mkWindow();
    
      /**
       * 建造房屋
       */
      public void mkFloor();
    
      /**
       * 获取房间
       */
      public Room getRoom();
    }
    

    实现了 Builder 接口的工人:

    package cn.house;
    
     public class RoomBuilder implements Builder{
     private Room room = new Room();
    
      /** 具体创建窗户 */
       public void mkWindow() {
    
      Window window = new Window();
     room.setWindow(window);
       }
    
       /** 具体创建地板 */
       public void mkFloor() {
         Floor floor = new Floor();
        room.setFloor(floor);
    }
    
     /** 交付以创建好的房子 */
     public Room getRoom() {
      return room;
    }
     }
    

    设计师:

    package cn.house;
    
    public class Designer {
    
      /**
       * 命令 Builder
       * 
       * @param builder
       */
     public void command(Builder builder) {
       // 建造房屋
       builder.mkWindow();
    
       // 建造地板
       builder.mkFloor();
     }
    }
    

    测试用例:

     public static void main(String[] args) {
    
    Builder builder = new RoomBuilder();
    Designer design = new Designer();
    design.command(builder);
    
    Room room = builder.getRoom();
    Window window = room.getWindow();
    Floor floor = room.getFloor();
    
    System.out.println(window);
    System.out.println(floor);
      }
    

    无设计者

    Android 中的 AlertDialog 就属于无设计者的形式,下面是 AlertDialog 的简单模拟:

    public class AlertDialog {
      private String title;
      private String message;
      private int buttonCount;
    
     private AlertDialog() {
    // empty
     }
    
    /** 获取标题 */
    public String getTitle() {
    return title;
    }
    
    /** 获取信息 */
    public String getMessage() {
    return message;
    }
    
    /** 获取按钮数 */
    public int getButtonCount() {
    return buttonCount;
    }
    
    /** 显示 */
    public void show() {
    System.out.println("show");
    }
    
    /** 建造者 */
    public static class Builder {
    private AlertDialog entity = new AlertDialog();
    
    public Builder(boolean isContext) {
      if (!isContext) {
        throw new RuntimeException("必须有上下文");
      }
    }
    
    /** 设置标题 */
    public Builder setTitle(String title) {
      entity.title = title;
      return this;
    }
    
    /** 设置内容 */
    public Builder setMessage(String message) {
      entity.message = message;
      return this;
    }
    
    /** 设置按钮数 */
    public Builder setButtonCount(int buttonCount) {
      entity.buttonCount = buttonCount;
      return this;
    }
    
    /** 交付结果 */
    public AlertDialog build() {
      return entity;
    }
    }
    }
    

    可以看出,AlertDialog 直接命令 Builder ,并没有涉及到 Designer,所以它是无序的。

    建造者模式的应用场景

    相同的方法,不同的执行顺序,产生不同的执行效果

    一个对象可以配置多个不同的零件,产生不同的效果

    一个对象,参数方法极多,调用顺序不同则效果不同

    Android 开源项目中的应用

    由于建造者模式本身的优点,极大简化了对象的创建,一般被用于生成某些配置对象。可以看到下面的代码是多么的简洁清晰,一目了然。

    2、讲解一下我们今天关于Toast的进一步封装

    首先,看一下具体使用
    最基本的用例:

    new ToastUtil.Builder(this).setMessage("").build();
    

    设置基本参数的用例:

    new ToastUtil.Builder(this).setMessage("123456")
                    .setTextColor("#F2F2FF").setBackgroudColor(R.color.yellow)
                    .setTextSise(48).setIcon(R.drawable.ic_launcher)
                    .setImageSize(128).setGrivaty(Gravity.CENTER).build();
    

    其次,让我们考虑一下,上面图中Toast显示的内容包括:文字内容、文字大小、文字颜色、图片内容、图片大小、还有背景颜色和显示位置等,那么就要定义这些变量,请各位看官来看代码(代码中比较有详细的解释,各位看官应该都可以看懂)。

    public class ToastUtil {
    // 消息内容
    private String message;
    // 图标
    private int icon;
    // 字体大小
    private int textSize = 0;
    // 字体颜色
    private String textColor;
    // 背景颜色
    private int bgColor = 0;
    // 上下文
    private Context mContext;
    // 是否显示
    private boolean mShow = false;
    // Toast
    private Toast mToast;
    // 布局
    private LinearLayout mLayout;
    // 位置
    private int gravity = 0;
    // ImageView
    private ImageView mImgView;
    // TextView
    private TextView mTxtContent;
    // 显示时长
    private int duration = 0;
    // X轴偏移量
    private int floatX;
    // Y轴偏移量
    private int floatY;
    // 图标大小
    private int mImageSize;
    
    //构造函数设置为私有的,不能直接New
    private ToastUtil() {
    }
    
    /**
     * Builder
     * 
     * @author Silence
     * 
     */
    public static class Builder {
        ToastUtil mToastUtil = new ToastUtil();
    
        public Builder(Context context) {
            mToastUtil.mContext = context;
    
        }
    
        /**
         * 消息内容
         * 
         * @param message
         * @return
         */
        public Builder setMessage(String message) {
            mToastUtil.message = message;
            return this;
        }
    
        /**
         * Toast显示位置
         * 
         * @param gravity
         * @return
         */
        public Builder setGrivaty(int gravity) {
            mToastUtil.gravity = gravity;
            return this;
        }
    
        /**
         * 显示的图标
         * 
         * @param icon
         * @return
         */
        public Builder setIcon(int icon) {
            mToastUtil.icon = icon;
            return this;
        }
    
        /**
         * 现实时长
         * 
         * @param duration
         * @return
         */
        public Builder setDuration(int duration) {
            mToastUtil.duration = duration;
            return this;
        }
    
        /**
         * 显示的字体颜色
         * 
         * @param textColor
         * @return
         */
        public Builder setTextColor(String textColor) {
            mToastUtil.textColor = textColor;
            return this;
        }
    
        /**
         * 显示的字体大小
         * 
         * @param textSize
         * @return
         */
        public Builder setTextSise(int textSize) {
            mToastUtil.textSize = textSize;
            return this;
        }
    
        /**
         * X轴偏移量
         * 
         * @param floatX
         * @return
         */
        public Builder setFloatX(int floatX) {
            mToastUtil.floatX = floatX;
            return this;
        }
    
        /**
         * Y轴偏移量
         * 
         * @param floatY
         * @return
         */
        public Builder setFloatY(int floatY) {
            mToastUtil.floatY = floatY;
            return this;
        }
    
        /**
         * 图标大小
         * 
         * @param imageSize
         * @return
         */
        public Builder setImageSize(int imageSize) {
            mToastUtil.mImageSize = imageSize;
            return this;
        }
    
        /**
         * 显示的背景颜色
         * 
         * @param bgColor
         * @return
         */
        public Builder setBackgroudColor(int bgColor) {
            mToastUtil.bgColor = bgColor;
            return this;
        }
    
        /**
         * 创建
         * 
         * @return
         */
        public ToastUtil build() {
            mToastUtil.setLayoutView();
            return mToastUtil;
        }
    
    }
    
    public void setLayoutView() {
        if (!mShow) {
            mToast = new Toast(mContext);
            // 图标
            mImgView = new ImageView(mContext);
            LinearLayout.LayoutParams lParams = new LinearLayout.LayoutParams(
                    mImageSize, mImageSize);
            mImgView.setImageResource(icon);
            lParams.gravity = Gravity.CENTER_HORIZONTAL
                    | Gravity.CENTER_VERTICAL;
            lParams.setMargins(5, 5, 5, 5);
            mImgView.setLayoutParams(lParams);
    
            // 消息内容
            mTxtContent = new TextView(mContext);
            LinearLayout.LayoutParams lParams1 = new LinearLayout.LayoutParams(
                    LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
            if (!TextUtils.isEmpty(textColor)) {
                mTxtContent.setTextColor(Color.parseColor(textColor));
            }
            if (textSize != 0) {
                mTxtContent.setTextSize(textSize);
            }
            mTxtContent.setLayoutParams(lParams1);
            // 布局
            mLayout = new LinearLayout(mContext);
            LinearLayout.LayoutParams params = new LinearLayout.LayoutParams(
                    LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
            mLayout.setOrientation(LinearLayout.HORIZONTAL);
            mLayout.setLayoutParams(params);
            mLayout.addView(mImgView);
            mLayout.addView(mTxtContent);
            if (bgColor != 0) {
    
                mLayout.setBackgroundResource(bgColor);
            }
            if (gravity != 0) {
                mToast.setGravity(gravity, floatX, floatY);
            }
            mToast.setView(mLayout);
            if (duration != 0) {
                mToast.setDuration(duration);
            }
            if (!TextUtils.isEmpty(message)) {
                mTxtContent.setText(message);
            }
            mToast.show();
        }
    }
    }
    

    最后,再直接创建使用(使用建造者模式是new xx.Builder()使用的,不能用类名.setxx()使用,之前就是用的类名.setxx(),差点被自己蠢死(捂脸))

    感谢

    感谢博主cfanrAndroid 设计模式-建造者模式
    感谢博主博弈史密斯建造者模式(侧重Java、Android)
    最后啰嗦一句:设计模式在编程中很有用,应该认真思考可以写出很优雅的代码,我辈应该奋发图强,像大神们看齐。

    相关文章

      网友评论

      本文标题:Android建造者模式初探(Toast工具类的进一步封装)

      本文链接:https://www.haomeiwen.com/subject/zizvqxtx.html