zhihu / sugaradapter

Make RecyclerView.Adapter Great Again!

SugarAdapter

Make RecyclerView.Adapter Great Again!

Support API v14+

中文介绍

Introduction

When we use RecyclerView, we need to extends Adapter and override some methods, which are so boring:

• getItemCount()
• getItemViewType()
• onCreateViewHolder()
• onBindViewHolder()
• onViewAttachedToWindow()
• onViewDetachedFromWindow()
• onViewRecycled()
• onAttachedToRecyclerView()
• onDetachedFromRecyclerView()
• onFailedToRecycleView()

More over, we usually need View's lifecycle callback,

such as onViewAttachedToWindow() and onViewDetachedFromWindow().

Now, we use annotationProcessor to reduce your boring Adapter code, add some features with your ViewHolder.

An usage sample see this link.

SugarAdapter

You don't need to extends and override any code of Adapter, just write few lines of builder code:

mAdapter = SugarAdapter.Builder.with(mList) // eg. List<Object>
        .add(FooHolder.class) // extends SugarHolder<Foo>
        .add(BarHolder.class, new SugarHolder.OnCreatedCallback<BarHolder>() { // extends SugarHolder<Bar>
            @Override
            public void onCreated(@NonNull BarHolder holder) {
                // holder.SETTER etc.
            }
        })
        .preInflate(true) // preInflate ViewHolders' XML for smooth scrolling
        .build();
mRecyclerView.setAdapter(mAdapter);

// mAdapter.notifyItem* or mAdapter.notifyDataSetChanged()
// mAdapter.setExtraDelegate() with onAttachedToRecyclerView()/onDetachedFromRecyclerView()

That's all!

SugarHolder

Layout - ViewType - Data, trinity, so we must extends SugarHolder as below:

// FooHolder is public and final by default;
// if you want to extends FooHolder, see demo
@Layout(R.layout.foo) 
public final class FooHolder extends SugarHolder<Foo> {
    // If you don't want to write findViewById(), 
    // just annotate view with @Id(), and make it **public**
    @Id(R.id.text)
    public TextView mTextView;

    public FooHolder(@NonNull View view) {
        super(view);
    }

    @Override
    pubilc void onBindData(@NonNull Foo foo) {
        mTextView.setText(foo.getText());
    }
}

SugarHolder also has some methods which you may want to use or override:

• getAdapter() // get adapter instance directly in holder, perhaps it's not a good design for your code
• getData() // get data instance directly in holder, so you don't to hold data by yourself
• getLifecycle() // support lifecycle-aware components
• getContext() // get context instance directly in holder, cool
• getColor()
• getDrawable()
• getString()
• getRootView()
• findViewById()
• dp2px()
• sp2px()
• onViewAttachedToWindow()
• onViewDetachedFromWindow()
• onViewRecycled()
• onFailedToRecycleView()

Now you can use ViewHolder easily.

Gradle

dependencies {
    // migrate to AndroidX, use 1.8.16
    implementation 'com.zhihu.android:sugaradapter:1.7.16'
    annotationProcessor 'com.zhihu.android:sugaradapter-processor:1.7.16'
}

For Android Library

First, add the ButterKnife's plugin to your project.

Second, in your module's build.gradle:

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [moduleNameOfSugarAdapter: 'YOUR_MODULE_NAME']
            }
        }
    }
}

dependencies {
    // migrate to AndroidX, use 1.8.16
    implementation 'com.zhihu.android:sugaradapter:1.7.16'
    annotationProcessor 'com.zhihu.android:sugaradapter-processor:1.7.16'
}

Third, in your main project's build.config:

android {
    defaultConfig {
        javaCompileOptions {
            annotationProcessorOptions {
                arguments = [subModulesOfSugarAdapter: 'YOUR_MODULE_NAME_1, YOUR_MODULE_NAME_...']
            }
        }
    }
}

dependencies {
    // migrate to AndroidX, use 1.8.16
    implementation 'com.zhihu.android:sugaradapter:1.7.16'
    annotationProcessor 'com.zhihu.android:sugaradapter-processor:1.7.16'
}

The main project must have at least one subclass of SugarHolder with @Layout to toggle AnnotationProcessor.

Finally, use R2.layout.* and R2.id.* to replace R.layout.* and R.id.*, for example, @Layout(R2.layout.foo)

Note: we don't depend the ButterKnife in our library, we just need it's gradle plugin to generate R2.java

Thanks

• JakeWharton/butterknife
• HendraAnggrian/r-parser

License

Copyright 2018 Zhihu Inc.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

sugaradapter's Issues

Java compiler error

为了支持androidx，引入库
implementation 'com.zhihu.android:sugaradapter:1.8.16'
annotationProcessor 'com.zhihu.android:sugaradapter-processor:1.8.16'
编译出错
Error: Default interface methods are only supported starting with Android N (--min-api 24): java.util.Map com.zhihu.android.sugaradapter.ContainerDelegate.getDataClassMap()

求支持增量编译： Incremental annotation processing

参见：https://docs.gradle.org/4.7/userguide/java_plugin.html#sec:incremental_annotation_processing

但是 com.hendraanggrian:r-parser:0.2 使用了 com.sun.source.util.Trees 导致无法增量编译 ……

ClassNotFoundException: ContainerDelegateImpl

异常信息如下：

java.lang.RuntimeException: java.lang.ClassNotFoundException: com.zhihu.android.sugaradapter.ContainerDelegateImpl
    at com.zhihu.android.sugaradapter.Sugar.getContainerDelegate(Sugar.java:38)
    at com.zhihu.android.sugaradapter.SugarAdapter$Builder.add(SugarAdapter.java:63)
    at com.zhihu.android.sugaradapter.SugarAdapter$Builder.add(SugarAdapter.java:57)
    ...

请问如何解决？

不错的库，用 javapoet 生成代码感觉更好

对 Java 代码直接硬编写维护性是否欠佳？

| http://www.zend.com/license/2_00.txt. |

[feature request]: support for other bind data method from original RecyclerView.ViewHolder

problem description

• SugarAdapter make a custom wrapper for RecyclerView.ViewHolder and only expose onBindData() method, which make it impossible to call other bind data method from the original RecyclerView.ViewHolder, such as:

public void onBindViewHolder(VH holder, int position, List<Object> payloads) {
            onBindViewHolder(holder, position);
}

plz consider to add this method to SugarViewHolder as well.