超理论坛客户端源码食用指南

关于项目

超理论坛制作的Android客户端,是我的个人项目-w-,目前刚刚完成向MVVM架构 + Data Binding 的迁移,项目开源在这里。截图:

首页截图,比较符合MD规范
支持显示LaTeX

这是一篇与它配套的源码食用指南,希望可以与有兴趣的同学一起探讨-w-

架构

使用了Data Binding的MVVM架构

包组织方式

项目中有8个包,分别是view, viewmodel, model, data, binding, network, meta, utils

  • view

即MVVM中的View层,在MVVM中,View层应该负责和UI相关,和业务逻辑无关的操作,要注意的是和UI相关并不仅仅指改变某个控件的颜色这种简单的操作——实际上这些操作也基本被Data Binding接管了——切换到其它Activity、弹出Toast或者Dialog,也应该交给View来做,只是切换到哪个Activity,弹出的Toast内容是什么,就要让Viewmodel来指定。关于View和ViewModel的具体分工,我也疑惑了很久,直到找到这篇文章,我是先看到了它的中文版,疑惑于其中的ViewModel不应该持有任何Context的引用的说法,然后在谷歌上搜索,找到了它的首发地址,期待着会看到一些和中文版不同的更新,果然我在评论区里发现了作者对View和ViewModel职责的划分,这个app也基本是按照它区分View和ViewModel。

  • viewmodel

即MVVM中的ViewModel层,处理和业务逻辑有关的功能,值得注意的是,在这个项目中,ViewModel既没有持有任何Context,也没有以任何形式持有View对象的引用,而是比较纯粹的数据驱动。

  • model

即MVVM中的Model层,主要是一些POJO对象,用于JSON解析,或用于绑定在xml中。对一些情况来说,完全按照网页接口返回的JSON解析出的对象并不适合直接绑定于xml并显示在界面中,可能需要根据app当前的情况添加其它的数据,或对已有的数据进一步处理,因此在model包中一部分类是以Business开头的,表示这些类是由其他model进一步处理得到的,用于与界面中的元素绑定。

  • data

一些有效范围在整个Application的数据,存放在了这个类中,比如自己的账户信息。

  • binding

包含用于Data Binding框架的类,主要是各种BindingAdapter,其中有一个为了给RecyclerView绑定数据而实现的BindingAdapter,GitHub上有不少类似的第三方库,比如binding-collection-adapter,但是不支持Support包中的DiffUtil,因此我自己重新造了一个轮子,代码在binding包下的RecyclerViewBA.java中,支持对不同的数据渲染不同的layout,对实现了DiffItem接口的类,在list更新时会应用DiffUtil实现插入、删除、移动的动画效果,有兴趣的同学可以参考一下,提一些建议:)。

  • network

和网络有关的类,如对Retrofit、OkHttp的封装、Retrofit的service等,Android 5.0以下的系统默认不支持TLS协议,导致网络访问失败,修补的代码也在这个包里。

  • meta

一些零零散散的内容,比如各种custom view,解析LaTeX和表情的代码。

  • utils

各种工具类,主要是各种网络请求,比如发帖、回帖、登录、注销这些。

对MVVM架构的理解

在所有MV*架构中,View都是一个只负责UI的角色,虽然有一些文章提议MVVM中的Model层应该包含业务逻辑,但我的这个项目仍然将model作为存放数据的“哑类”。一篇介绍MVVM架构的文章,大部分篇幅应该都用于阐述View和ViewModel的关系,对它们之间的关系,网上也有各种不同的说法,总结出来,有这么几种:

  1. 让ViewModel直接持有View的引用,需要时调用View暴露的各种方法

  2. 让ViewModel持有View的Context的引用,来处理startActivity之类的需要Context的方法。

  3. View实现特定的接口,将View作为接口的对象传递给ViewModel

  4. 使用事件总线来在ViewModel和View之间传递消息。

第一种方法不符合MVVM中ViewModel应该对View一无所知的要求,也不符合松耦合的原则。第二种方法实用性不高——不是所有需要View层完成的事情都能用Context解决,比如更改menu。第三种方法不能适应复杂的需求——如果总共有三个需要暴露给ViewModel的方法,每个View可能只实现其中的某几个,那可能最多要实现七个不同的接口,或者在ViewModel里持有多个简单接口对象的引用——其实它们都指向同一个View。第四种方法是不错的,不过事件总线用起来有些麻烦。

我自己在项目中使用的办法是一种类似于事件总线的办法,利用Data Binding中的Observable...类,在View中使用它们的addOnPropertyChangedCallback方法为这些ViewModel中的变量添加监听器,在这些变量改变时,就可以执行监听器中的回调函数。这样,就把ViewModel和View解耦了,和事件总线一样都是使用了观察者模式。这样,ViewModel可以实现比较纯粹的数据驱动,对View保持一无所知,并且利于之后的维护。

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

推荐阅读更多精彩内容