Silk
一個(gè)基于java bean的響應(yīng)式框架
Why we need this?
假設(shè)我們有這么一個(gè)需求：
我們登陸成功之后通過(guò)服務(wù)器拿到一個(gè)useraccount對(duì)象,useraccount對(duì)象長(zhǎng)這個(gè)樣子
public class UserAccount{
private String userName;//姓名
private int age;//年齡
private String userImage;//頭像
public void setUserName(String userName){
this.userName = userName;
}
public String getUserName(){
return userName;
}
//后略......
}
我們會(huì)在界面上展示登陸用戶的姓名烦粒，頭像等等:
UserAccount useraccount = getUserAccount();//獲取到了useraccount對(duì)象
TextView tvName = findViewById(R.id.tv_name);
tvName.setText(useraccount.getUserName());
OK，接下來(lái)如果我們需要修改用戶的姓名亿柑，那么以往我們是這樣的：
useraccount.setUserName("mike");
//其他的工作
tvName.setText(useraccount.getUserName());
//其他的展示
這里面帚桩，我們一般是給對(duì)象set了某個(gè)值之后捻悯，再更新UI男旗。
Now,We change
使用silk之后球散，現(xiàn)在我們的useraccount定義是這樣的：(就多了一個(gè)注解而已)
@RxBean
public class UserAccount{
private String userName;//姓名
private int age;//年齡
private String userImage;//頭像
public void setUserName(String userName){
this.userName = userName;
}
public String getUserName(){
return userName;
}
//后略......
}
我們接下來(lái)這樣展示里面的數(shù)據(jù)：
TextView tvName = findViewById(R.id.tv_name);
SilkBrite<UserAccount> brite = SilkBrite.create();//初始化了一個(gè)brite
UserAccount useraccount = brite.asSilkBean(getUserAccount());//獲取useraccount對(duì)象巨缘，其實(shí)這是一個(gè)“換了包”的對(duì)象
brite.asModeObservable()
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Action1<UserAccount>() {
@Override
public void call(UserAccount info) {
tvName.setText(useraccount.getUserName());
}
});
然后我們要修改用戶姓名了添忘！
//你只需要做下面這件事，UI上面就會(huì)同步
useraccount.setUserName("mike");
所以若锁，用了silk搁骑，我們就不需要每次修改了bean之后還要去同步UI。
引用
- gradle又固，在你的app的build.gradle文件中引入依賴
dependencies {
...
compile 'com.github.landscapeside:SilkLib:1.0'
apt 'com.github.landscapeside:SilkComplier:0.1'
...
}
然后在你的app的build.gradle中應(yīng)用apt插件：
apply plugin: 'com.neenbedankt.android-apt'
project的build.gradle中申明：
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
用的是jitpack倉(cāng)庫(kù)仲器，所以需要在project的build.gradle中注明
allprojects {
repositories {
jcenter()
maven { url "https://jitpack.io" }
}
}
用法
- 如上所說(shuō)，在你需要silk功能的java bean類上使用RxBean注解仰冠，然后重新構(gòu)建一下項(xiàng)目
- 然后要新建一個(gè)SilkBrite出來(lái)
SilkBrite<UserAccount> brite = SilkBrite.create();乏冀，注意，目前來(lái)說(shuō)洋只，一個(gè)brite就對(duì)應(yīng)處理一個(gè)bean對(duì)象 - 接下來(lái)需要將原有的bean對(duì)象設(shè)置一個(gè)代理
UserAccount useraccount = brite.asSilkBean(getUserAccount()); - 上一步生成的代理對(duì)象才能真正嵌入到Silk響應(yīng)式框架之中辆沦，通過(guò)bean的setter即可觸發(fā)相應(yīng)
- 我們需要監(jiān)聽(tīng)到事件源發(fā)出的消息并作出反應(yīng)
brite.asModeObservable()
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.subscribe(new Action1<UserAccount>() {
@Override
public void call(UserAccount info) {
tvName.setText(useraccount.getUserName());
}
});
- 當(dāng)然昼捍，還可以嵌套使用，比如一個(gè)Parent對(duì)象有2個(gè)Child肢扯，不管是修改Parent的屬性或者是child屬性妒茬，我們都希望能得到通知，則兩個(gè)類都標(biāo)記上RxBean注解即可
@RxBean
public class Parent{
private String userName;//姓名
private int age;//年齡
private String userImage;//頭像
private Child child1;
private Child child2;
public void setUserName(String userName){
this.userName = userName;
}
public String getUserName(){
return userName;
}
//后略......
}
@RxBean
public class Child{
private String userName;//姓名
private int age;//年齡
//......
}
- 有時(shí)候我們有這樣的需求蔚晨，顯示UserAccount的nick的時(shí)候希望能加上如果為空的默認(rèn)顯示
brite.asNodeObservable("nick")
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.map(o1 -> {
String name = String.valueOf(o1);
if (TextUtils.isEmpty(name)) {
return "unknown user";
}
return name;
})
.subscribe(new Action1<String>() {
@Override
public void call(String name) {
tvName.setText(name);
}
});
- 如果是要加上child的默認(rèn)顯示
brite.asNodeObservable("child1::userName")
.subscribeOn(Schedulers.io())
.observeOn(AndroidSchedulers.mainThread())
.map(o1 -> {
String name = String.valueOf(o1);
if (TextUtils.isEmpty(name)) {
return "unknown user";
}
return name;
})
.subscribe(new Action1<String>() {
@Override
public void call(String name) {
tvName.setText(name);
}
});
限制
- 首先乍钻，一個(gè)brite就是用來(lái)處理一個(gè)bean對(duì)象，所以并不太適合列表類的應(yīng)用铭腕，當(dāng)然后續(xù)會(huì)考慮改進(jìn)
- 而且就如Silk的開(kāi)發(fā)目的一樣银择，它就只是為了解決基于bean的響應(yīng)式編程，如果是基于sqlite的響應(yīng)式需求累舷，請(qǐng)移步sqlbrite
最后
感謝如下項(xiàng)目給我的指導(dǎo)和參考：
