Repository模式探索

移动端开发中,经常遇到通用的数据加载:例如IM中个人头像加载。

在应用开发初期,由于缺乏把所有加载逻辑整合到一起的思维,导致后期头像逻辑变化时,只能用搜索找出相关的代码并修改。即使代码分散的地方比较少,也经常出现遗漏修改,亲历。

头像加载这种统一的加载逻辑,必须整合到一个类中,并做好抽象,以便应对将来的需求变更。拓展开来,用户名获取、应用配置读取、读取Session都能受益。

下面基于IM头像加载的实战,总结出相关经验。

一、设计思想

总结实战后接口设计的三个基本目的:

  1. 通过接口定义来指明实现的具体方向,声明接口的功能范围;
  2. 对调用屏蔽实现:调用方只需了解接口方法的功能,而不需要了解具体实现;
  3. 抽象需要预留一定的拓展性:如个人头像接口设计时,考虑群头像和个人头像交互;

二、接口功能

产品开发过程要满足以下产品需求:

  1. userId即可把用户头像加载到ImageView中;
  2. 能指定加载来源的filePath,而不是仅根据userId;
  3. userId对应的url根据一定的逻辑拼接出来;
  4. 群头像有最多四个用户的个人头像,所以个人头像需要为群头像逻辑提供用户的Bitmap.

根据上述的需求,可以整理出以下的抽象接口。这些接口虽然已经投入到生产环境中,但是不一定设计得非常科学,还在进一步演进,请酌情参考。

方法具体能力在注释中已经写得很明确,不再复述。

/**
 * Global avatar loading repository interface.
 */
public interface IUserAvatarLoader {

    /**
     * Load avatar into ImageView if exists, else load the default drawable.
     */
    void loadByUserId(Context context, String userId, ImageView view);

    /**
     * Load avatar into ImageView by local file path.
     */
    void loadByFilePath(Context context, String filePath, ImageView view);

    /**
     * Return a {@link Bitmap} instance according to specific image url and size.
     */
    Bitmap getBitmap(Context context, String imageUrl, int ImageSize) throws ExecutionException, InterruptedException;

    /**
     * Return the url requests of avatar.
     */
    String getUrl(String userId);
}

三、具体实现

定义抽象接口后,下一步是选择具体的图片加载框架。

常用的图片加载框架有PicassoGlide等。由于头像已经抽象为接口,使用前者或后者对用户都是无感且透明的。

如果将来决定迁移到其他图片加载框架,那只需要在UserAvatarLoader这一实现层来修改,所有调用点不需要任何修改。

若更换实现时要修改抽象接口,想必在接口设计就存在设计遗漏甚至设计错误。因此,前期接口往往决定了后期实现难度和可用性。

下面为项目中的实现:我们用的是Glide,其提供了合理的三级缓存功能,再配合OkHttp网络框架,能节省大量开发时间。

public class UserAvatarLoader implements IUserAvatarLoader {

    private static final String API = "https://api.phantomvk.com";

    @Override
    public void loadByUserId(Context context, String userId, ImageView view) {
        Glide.with(context)
                .load(getUrl(userId))
                .apply(ImageOptions.userAvatarOptions)
                .into(view);
    }

    @Override
    public void loadByFilePath(Context context, String filePath, ImageView view) {
        Glide.with(context)
                .load(filePath)
                .apply(ImageOptions.userAvatarOptions)
                .into(view);
    }

    @Override
    public Bitmap getBitmap(Context context, String imageUrl, int imageSize)
            throws ExecutionException, InterruptedException {
            
        return Glide.with(context)
                .asBitmap()
                .load(imageUrl)
                .submit(imageSize, imageSize)
                .get();
    }

    @Override
    public String getUrl(String userId) {
        return API + "/api/v1/rcs/profile/" + userId + "/avatar";
    }
}

上面还用到了GlideRequestOption,所以把所有RequestOption整理到一个类中。

其中

  1. R.drawable.def_avatar是默认头像资源;
  2. android.R.color.darker_gray是消息图片加载过程的背景色.
public final class ImageOptions {

    public static RequestOptions userAvatarOptions = new RequestOptions()
            .placeholder(R.drawable.def_avatar)
            .error(R.drawable.def_avatar)
            .autoClone();

    public static RequestOptions chatMessageOptions = new RequestOptions()
            .placeholder(android.R.color.darker_gray)
            .centerCrop()
            .autoClone();
}

四、构建工厂

虽然实现已经完成,但是还差一步:就是调用点的整合。

如果不通过一个工厂来提供调用点,那么使用时还是得各自构建对象。这样不仅消耗堆内存空间,也增加了GC的压力。以后更换具体的实现类还得一个一个手动更换。

所以我们还要增加一层,对调用屏蔽构建方式:

public class ImageLoaders {

    private static IUserAvatarLoader userAvatarLoader = new UserAvatarLoader();
    
    private static IChatMessageLoader chatMessageLoader = new ChatMessageLoader();

    public static IUserAvatarLoader userAvatarLoader() {
        return userAvatarLoader;
    }

    public static IChatMessageLoader chatMessageLoader() {
        return chatMessageLoader;
    }
}

考虑到应用初次启动动就需要调用头像加载逻辑,都在主线程完成初始化,无谓懒加载什么了,静态变量初始化就够了。

五、用法

使用只要像下面调用,以后任何修改这行代码都不需要改变。

userId加载头像

ImageLoaders.userAvatarLoader().loadByUserId(context, userID, avatarView);

由文件加载头像

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 172,079评论 25 707
  • 一、简介 在泰国举行的谷歌开发者论坛上,谷歌为我们介绍了一个名叫Glide的图片加载库,作者是bumptech。这...
    天天大保建阅读 7,472评论 2 28
  • 坏了又迟到了,可是天怎么黑了,心里越来越着急。上学路有陡坡,所以走稳步也是不容易的,走了好久才走到宽敞的大路上,心...
    4e57b8f24a48阅读 253评论 3 2
  • 当桃花遇到油菜花 春天,田边小路上的桃花对田里的油菜花说:“我们比比谁的本领大?”油菜花不服气的说:“比就比...
    花絮絮语阅读 553评论 0 2
  • div { background-color:red\0; /* ie 8/9*/ background-colo...
    99538阅读 252评论 0 2