vLayout学习笔记

vlayout（VirtualLayout）是阿里开源的一个针对 RecyclerView 的 LayoutManager 扩展，主要提供一整套布局方案和布局间的组件复用。

下面主要简述一下个人读官方文档和实践demo的心得，demo的GitHub地址放在文末，欢迎各位大佬指教~

1.初始化RecycleView，
基于上下文，初始化一个VirtualLayoutManager；

recyclerView.setLayoutManager(layoutManager);

将这个VirtualLayoutManager设置进去recyclerView；

2.利用第一步的VirtualLayoutManager创建一个DelegateAdapter ；

DelegateAdapter delegateAdapter = new DelegateAdapter(layoutManager, hasConsistItemType);

3.1.
准备一个Adapter列表：

List adapterList = new ArrayList<>();

添加（add）各种Adapter，
add的参数即自定义adapter，
这里的自定义adapter是SubAdapter；（代码来自官网demo）

        adapterList.add(new SubAdapter(new LinearLayoutHelper(20), 20));
        adapterList.add(new SubAdapter(new StickyLayoutHelper(true), 1));
        adapterList.add(new SubAdapter(new LinearLayoutHelper(20), 20));
        adapterList.add(new SubAdapter(new GridLayoutHelper(4), 80));
        // adapterList.add(new SubAdapter(new FixLayoutHelper(0, 0), 1));
        adapterList.add(new SubAdapter(new FixLayoutHelper(TOP_RIGHT, 0, 0), 1));

3.2.
自定义adapter的设计：
注意，
自定义adapter继承自DelegateAdapter.Adapeter，
泛型可以是自定义的ViewHolder；
构造函数一般接收两个参数，
即LayoutHelper以及一个数据参数（用于adapter的数据支持）；

    private static class SubAdapter extends DelegateAdapter.Adapter {

        private LayoutHelper mLayoutHelper;
        private int mItemCount;

        private SubAdapter(LayoutHelper layoutHelper, int itemCount) {
            mLayoutHelper = layoutHelper;
            mItemCount = itemCount;
        }

        @Override
        public LayoutHelper onCreateLayoutHelper() {
            return mLayoutHelper;
        }

        @Override
        public SubViewHolder onCreateViewHolder(ViewGroup parent, int viewType) {
            LayoutInflater inflater = LayoutInflater.from(parent.getContext());
            return new SubViewHolder(inflater.inflate(R.layout.item, parent, false));
        }

        @Override
        public void onBindViewHolder(SubViewHolder holder, int position) {
            // do nothing
        }

        @Override
        protected void onBindViewHolderWithOffset(SubViewHolder holder, int position, int offsetTotal) {
            super.onBindViewHolderWithOffset(holder, position, offsetTotal);
            holder.setText(String.valueOf(offsetTotal));
            holder.itemView.setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.WRAP_CONTENT));
        }

        @Override
        public int getItemCount() {
            return mItemCount;
        }

    }

对应的ViewHolder设计：

    private static class SubViewHolder extends RecyclerView.ViewHolder {

        public static volatile int existing = 0;
        public static int createdTimes = 0;

        public SubViewHolder(View itemView) {
            super(itemView);
            createdTimes++;
            existing++;
        }

        public void setText(String title) {
            ((TextView) itemView.findViewById(R.id.title)).setText(title);
        }

        @Override
        protected void finalize() throws Throwable {
            existing--;
            super.finalize();
        }
    }

以上，通过给，
继承自DelegateAdapter.Adapter的自定义Adapter，
设置不同的LayoutHelper，实现了各种各样的布局adapter，
然后我们把这些各种各样的布局adapter，
加入到一个List adapterList中去，
接下来我们把这个adapterList，
设置到delegateAdapter中去：
delegateAdapter.addAdapters(adapterList);// 不加会 android.content.res.Resources$NotFoundException: Resource ID！！！！

        delegateAdapter.addAdapters(adapterList);

这里便是VLayout的美妙之处，
我们可以通过继承DelegateAdapter.Adapter，
创建一个自定义的Adapter，顺带配备对应的ViewHolder即业务容器；
给这个自定义Adapter的onCreateLayoutHelper()传入
各种各样的不同类型的不同构造形参的LayoutHelper，
配合传给自定义Adapter的数据支持参数位，
又可以实现各种各样的布局效果；
而这些个各种各样的不同的布局（adapterList），
又可以加到同一个delegateAdapter中，
借助delegateAdapter、VirtualLayoutManager，
将各种各样的这些个布局，
整到同一个RecycleView中！

4.最后画龙点睛：

recycler.setAdapter(delegateAdapter);

---

• adapter的设计跟RecycleView的adapter设计差不多，
  都是onCreateViewHolder/ViewHolder/onBindViewHolder/getItemCount四部曲罢了：

  
  
  DelegateAdapter.Adapter无非就是多了个决定布局类型的onCreateLayoutHelper()方法罢了；

• 注意getItemCount可以用来控制显示的数量，
  可以是数据List的Size，
  也可以通过设定Adapter构造方法，在被调用时通过new过程获取；
  其他的就在自定义的Adapter中、在自定义ViewHolder中添加业务逻辑/业务方法函数即可；
  比如可以在onBindViewHolder()的return之前加套if逻辑组，
  通过给不同的LayoutHelper设定不同的item颜色等等；

• LayoutHelper实例可以通过Java代码在LayoutHelper层进行UI设计约束；
  item层可以通过在adapter.java中用java代码或者在xml中进行UI设计约束；
  其中xml记得巧用drawable文件设计：

  
  

实战demo的GitHub地址