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

前提

在写这篇文章前一直在思考,我对建造者模式有了一个大体的理解。但是,有没有可能会造成过度封装呢,这里还需要各位看官老爷来评判,如果想看之前的对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)
最后啰嗦一句:设计模式在编程中很有用,应该认真思考可以写出很优雅的代码,我辈应该奋发图强,像大神们看齐。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,029评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,395评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,570评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,535评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,650评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,850评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,006评论 3 408
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,747评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,207评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,536评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,683评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,342评论 4 330
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,964评论 3 315
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,772评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,004评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,401评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,566评论 2 349

推荐阅读更多精彩内容