Android | Tangram动态页面之路（六）数据分离

发表于

经过前五篇系列文章，对Tangram和vlayout也有了初步认识，这篇文章开始将结合业务场景使用，探索框架能力能对业务带来的支持，因为调研本身是一个需要不断踩坑的过程，所以大纲也做了微调，后续会根据实际使用过程发现的问题和解决方案进行更新。

  1. 需求背景
  2. Tangram和vlayout介绍
  3. Tangram的使用
  4. vlayout原理
  5. Tangram原理
  6. json模板和数据分离
  7. 待定

本文将对Tangram的json模板和数据进行分离。

笔者Demo代码，内容见demo2包。

数据分离

前面的文章提到过，在实际业务中不太可能把数据绑定在模板里，这样模板会很臃肿，我们要做的是，用模板描述页面结构和数据源，而非数据本身，因此需要将数据剥离出来。

运行效果：

数据mock自玩安卓（看着有点乱，后续有时间搭个小服务，向业务贴近），

重点看页面结构即可，远程模板调整了Card顺序、4列布局改成5列、改了文本颜色和瀑布流item背景色。

然后来看该页面实现ShoppingHomeAct，

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
public class ShoppingHomeAct extends TangramActivity {
    ActivityShoppingHomeBinding mBinding;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        mBinding = DataBindingUtil.setContentView(this, R.layout.activity_shopping_home);
        super.onCreate(savedInstanceState);
    }

    @Override
    protected String createBizDomain() {
        return "shopping_home";//返回业务域：商城首页
    }

    @Override
    protected RecyclerView createRecyclerView() {
        return mBinding.rvList;//返回RecyclerView
    }

    @Override
    protected boolean needRefreshAndLoadMore() {
        return true;//开启下拉刷新和加载更多
    }
}

代码很少，只需继承具备Tangram能力的TangramActivity，返回其需要的对象即可。

动态合并数据

参考官方Demo，首先想到的方法是，动态来合并数据，也就是按如下思路，

进行数据准备，

  1. 模板地址：net_shopping_home.json
  2. 聚合数据接口：tangram/shopping/home
  3. 瀑布流数据接口：玩安卓 - article/list/0/json

模板如下（有删减），描述了页面结构和数据源，

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
{
    //聚合数据接口，当然实际业务中不需要写完整路径，如tangram/shopping/home
    "requestMakeup":"http://rest.apizza.net/mock/3f233eed2d9be716a5f48fccb9c719f2/tangram/shopping/home",
    //瀑布流数据接口
    "requestList":"https://www.wanandroid.com/article/list/%s/json",
    //模板名字
    "templateName":"net_shopping_home",
    //页面结构template
    "template":[
        {
            "type":"container-fiveColumn",  //五列布局
            "load":"makeup:category",  //数据源是聚合接口的category字段
            "itemType":"ImageTextView",  //具体视图cell是上图下文ImageTextView
            "style":{
                "textColor":"#6699ff",  //扩展字段，文本颜色
                "padding":[
                    9,
                    9,
                    0,
                    9
                ]
            }
        },
        {
            "type":"container-waterfall",  //瀑布流布局
            "itemType":"GoodsItemView",  //具体视图cell是商品样式GoodsItemView
            "load":"xxx",  //不用写，只要配置了requestList，默认最后一个Crad取瀑布流数据
            "style":{
                "column":2,  //展示两列
                "hGap":"4",  //间隙
                "vGap":"4",
                "margin":[
                    9,
                    9,
                    0,
                    9
                ],
                "itemBgColor":"#1F1F1F",  //扩展字段，item背景颜色
                "textColor":"#ffffff"  //扩展字段，文本颜色
            }
        }
    ]
}

聚合数据如下（有删减），

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
{
    "errorCode":0,
    "errorMsg":"",
    "data":{
        "banner":[  //轮播图数据
            {
                "imgUrl":"https://wanandroid.com/blogimgs/942a5c62-ca87-4e7c-a93d-41ff59a15ba4.png",
                "link":"https://www.wanandroid.com/navi"
            },
            {
                "imgUrl":"https://www.wanandroid.com/blogimgs/62c1bd68-b5f3-4a3c-a649-7ca8c7dfabe6.png",
                "link":"https://www.wanandroid.com/blog/show/2"
            },
            {
                "imgUrl":"https://www.wanandroid.com/blogimgs/50c115c2-cf6c-4802-aa7b-a4334de444cd.png",
                "link":"https://flutter.cn/"
            }
        ],
        "bottomTitle":[  //瀑布流标题数据
            {
                "title":"猜你喜欢"
            }
        ]
    }
}

一切准备就绪，开始实现TangramActivity，关注主要实现即可。

把聚合数据合并进模板对象的template字段，

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
//TangramActivity.java
void mergeMakeupDataToTemplate(JSONObject data, JSONArray template) throws JSONException {
    //遍历每一个卡片（布局），把数据填充进字段items
    for (int i = 0; i < template.length(); i++) {
        JSONObject card = template.getJSONObject(i);
        //如果card有load字段，并且字段值是makeup:开头，表示card的数据源为聚合数据
        if (card.has("load") && card.getString("load").startsWith("makeup:")) {
            String load = card.getString("load");
            JSONArray cells = data.getJSONArray(load.substring(load.indexOf(":") + 1));
            //把模板配置的itemType即具体视图cell写进数据源
            for (int cellIdx = 0; cellIdx < cells.length(); cellIdx++) {
                cells.getJSONObject(cellIdx).put("type", card.getString("itemType"));
            }
            card.put("items", cells);
        }
    }
}

解析瀑布流数据，

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
//TangramActivity.java
void parseListData(List<ArticleBean.DataBean.Article> list, @NonNull Card card) {
    JSONArray cells = new JSONArray();
    try {
        for (int i = 0; i < list.size(); i++) {
            JSONObject obj = new JSONObject(MyApp.gson.toJson(list.get(i)));
            obj.put("type", card.optStringParam("itemType"));
            //由于使用了玩安卓的数据结构，这里手动添加一些参数用于演示
            obj.put("imgUrl", DataUtil.getImgByIdx(i + mListDataPage * list.size()));
            cells.put(obj);
        }
    } catch (JSONException e) {
        e.printStackTrace();
    }
    List<BaseCell> cs = mEngine.parseComponent(cells);
    card.addCells(cs);
    card.notifyDataChange();
    finishLoad();
}

完整代码可见TangramActivity.java。

待解决问题

  • 局部刷新问题，暂时无解。之前有小伙伴提到过tangram不支持局部刷新，然后实践了一下，处理起来确实挺棘手，如加载瀑布流数据后，card.notifyDataChange的本质还是notifyDataSetChanged。
  • 优化成非继承TangramActivity实现。让业务Activity继承实现始终不够灵活，尝试包装一下核心引擎TangramEngine。