【FastDev4Android框架开发】RecyclerView完全解析之结合AA(Android Annotations)注入框架实例(三十)

(一).前言:   

         话说RecyclerView已经面市很久，也在很多应用中得到广泛的使用，在整个开发者圈子里面也拥有很不错的口碑，那说明RecyclerView拥有比ListView,GridView之类控件有很多的优点，例如:数据绑定，Item View创建,View的回收以及重用等机制。本系列文章会包括到以下三个部分:

1. RecyclerView控件的基本使用,包括基础,进阶,高级部分,动画之类(点击进入)
2. RecyclerView控件的实战实例(点击进入)
3. RecyclerView控件集合AA(Android Annotations)注入框架实例

         今天使我们本系列文章的第三讲主要使用RecyclerView结合AA(Android Annotations)注入框架实例。本次讲解所有用的Demo例子已经全部更新到下面的项目中了，欢迎大家star和fork。

         [注]关于AA(Android Annotations)注入框架的使用方法，我在CSDN上面已经更新一个专题(点击进入)，大家有兴趣可以去了解学习一下。

         FastDev4Android框架项目地址:https://github.com/jiangqqlmj/FastDev4Android

(二).基本实现

       这边演示的也是比较简单的效果，就是使用RecyclerView实现垂直滑动列表的效果。那么 对于每一项Item的布局如下:

       1.Item布局文件:item_user_item.xml

<?xmlversion="1.0" encoding="utf-8"?>
<RelativeLayoutxmlns:android="http://schemas.android.com/apk/res/android"
   android:layout_width="match_parent"
    android:layout_height="49dp">
    <TextView
        android:id="@+id/tv_first"
        android:text="fist name"
        android:textSize="16sp"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_centerVertical="true"
       android:layout_marginLeft="8dp"/>
    <TextView
        android:id="@+id/tv_last"
        android:text="last name"
        android:textSize="16sp"
       android:layout_width="wrap_content"
       android:layout_height="wrap_content"
       android:layout_centerVertical="true"
       android:layout_alignParentRight="true"
       android:layout_marginRight="8dp"/>
</RelativeLayout>

     该上面布局上面有两个文本框，然后创建一个实体类，里边两个属性:

     2.TestUserBean.java

public class TestUserBean {
    private String firstName;
    private String LastName;
    public TestUserBean() {
    }
    public String getFirstName() {
        return firstName;
    }
    public void setFirstName(String firstName){
        this.firstName = firstName;
    }
    public String getLastName() {
        return LastName;
    }
    public void setLastName(String lastName) {
        LastName = lastName;
    }
    @Override
    public String toString() {
        return "UserModel{" +
                "firstName='" +firstName + '\'' +
                ", LastName='" +LastName + '\'' +
                '}';
    }
}

      3.然后创建一个继承LinearLayout的控件来注入布局，同时加入绑定数据的方法,AAUserItemView.java,该类需要通过@EViewGroup来进行注入：

@EViewGroup(R.layout.item_user_item)
public class AAUserItemView extends LinearLayout {
    @ViewById
    TextView tv_first;
    @ViewById
    TextView tv_last;
    public AAUserItemView(Context context) {
        super(context);
    }
    public void bind(TestUserBean userBean) {
       tv_first.setText(userBean.getFirstName());
       tv_last.setText(userBean.getLastName());
    }
}

     4.因为这边是使用的RecyclerView而不是简单的ListView，那么这边需要特殊进行处理。RecyclerView.Adapter创建的是ViewHolder而不是View，所以这边就不能简单的注入ViewHolder类了。我们这边创建一个泛型类把所有的View包装成ViewHolder。

/**
 * 当前类注释:创建一个泛型类来把所有类型的View包装成ViewHonlder
 * 项目名：FastDev4Android
 * 包名：com.chinaztt.fda.test.RecyclerViewAA
 * 作者：江清清 on 15/11/21 09:24
 * 邮箱：jiangqqlmj@163.com
 * QQ： 781931404
 * 公司：江苏中天科技软件技术有限公司
 */
public class ViewWrapper<V extends View> extends RecyclerView.ViewHolder {
    public V view;
    public ViewWrapper(V itemView) {
        super(itemView);
        view = itemView;
    }
    public V getView() {
        return view;
    }
}

     5.紧接着我们为所有的RecyclerView适配器创建一个基类(抽象类)，继承RecyclerView.Adapter<ViewWrapper<V>>。同时里边提供一个onCreateItemView(ViewGroup parent,intviewType)的抽象类，让调用者自己实现来创建View。然后里边提供一个数据集合，来存储绑定的数据。

import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.view.ViewGroup;
 
import java.util.ArrayList;
import java.util.List;
 
public abstract class  RecyclerViewAdapterBase<T,Vextends View>extends RecyclerView.Adapter<ViewWrapper<V>>{
    /**
     * 存储需要绑定的数据
     */
    protected List<T> items = newArrayList<T>();
    public List<T> getItems() {
        return items;
    }
    public void setItems(List<T> items) {
        this.items = items;
    }
 
    @Override
    public int getItemCount() {
        return items.size();
    }
 
    /**
     * 进行创建视图承载类
     * @param parent
     * @param viewType
     * @return
     */
    @Override
    public final ViewWrapper<V>onCreateViewHolder(ViewGroup parent, int viewType) {
        return new ViewWrapper<V>(onCreateItemView(parent, viewType));
    }
    /**
     * 创建视图Item，交给具体实现类完成
     * @param parent
     * @param viewType
     * @return
     */
    protected abstract VonCreateItemView(ViewGroup parent, int viewType);
 
}

    6.下面我们来实现具体的Adapter，创建AAUserAdapter，并且这个类使用@EBean进行注解,继承刚刚的Adapter基类，RecyclerViewAdapterBase<TestUserBean,AAUserItemView>。主要实现以下两个方法:

• protected AAUserItemView onCreateItemView(ViewGroup parent,int viewType)
• Public void onBindViewHolder(ViewWrapper<AAUserItemView> holder,int position)

分别进行创建View，最后调用onBindViewHolder()方法来进行绑定数据。

package com.chinaztt.fda.test.RecyclerViewAA;
import android.content.Context;
import android.view.ViewGroup;
import org.androidannotations.annotations.EBean;
import org.androidannotations.annotations.RootContext;
 
/**
 * 当前类注释:
 * 项目名：FastDev4Android
 * 包名：com.chinaztt.fda.test.RecyclerViewAA
 * 作者：江清清 on 15/11/21 09:35
 * 邮箱：jiangqqlmj@163.com
 * QQ： 781931404
 * 公司：江苏中天科技软件技术有限公司
 */
@EBean
public class AAUserAdapter extends RecyclerViewAdapterBase<TestUserBean,AAUserItemView> {
    @RootContext
    Context context;
    /**
     * 创建Item视图View
     * @param parent
     * @param viewType
     * @return
     */
    @Override
    protected AAUserItemView onCreateItemView(ViewGroup parent, int viewType) {
        return AAUserItemView_.build(context);
    }
    /**
     * 进行绑定数据View
     * @param holder
     * @param position
     */
    @Override
    public void onBindViewHolder(ViewWrapper<AAUserItemView> holder, int position) {
        AAUserItemView view =holder.getView();
        TestUserBean userBean =items.get(position);
        view.bind(userBean);
    }
}

  7.接下来需要进行使用RecyclerView和Adapter了，不过在使用之前首先需要准备数据，这边我们准备了一个接口类AAUserFinder.java

public interface AAUserFinder {
    List<TestUserBean> findAll();
}

      然后就是AAUserFinder的实现类ImMemoryUserFinder.这边实现接口中的findAll()方法，并且该类使用@EBean标签注解。

packag ecom.chinaztt.fda.test.RecyclerViewAA;
 
import org.androidannotations.annotations.EBean;
 
import java.util.ArrayList;
import java.util.List;
 
/**
 * 当前类注释:
 * 项目名：FastDev4Android
 * 包名：com.chinaztt.fda.test.RecyclerViewAA
 * 作者：江清清 on 15/11/21 09:36
 * 邮箱：jiangqqlmj@163.com
 * QQ： 781931404
 * 公司：江苏中天科技软件技术有限公司
 */
@EBean
public class ImMemoryUserFinder implements AAUserFinder{
    @Override
    public List<TestUserBean> findAll() {
        List<TestUserBean> userModels=new ArrayList<TestUserBean>();
        for(int i=1;i<=45;i++){
            TestUserBean model=new TestUserBean();
           model.setFirstName("First 张三:"+i);
           model.setLastName("Last 李四:" + i);
            userModels.add(model);
        }
        return userModels;
    }
}

      8.最后就是实例化RecyclerView以及使用AAUserAdapter了，该Activity采用@EActivity进行注解，通过@ViewById来注入初始化控件，通过@Bean来注入初始化AAUserAdapter以及AAUserFinder实例化(不过根据多态性，这边实例化的对象为ImMemoryUserFinder)。然后通过@AfterViews注解的方法发生调用，来创建布局管理器以及给Adapter提供数据，绑定数据即可。所有代码如下:

package com.chinaztt.fda.test;
 
import android.os.Bundle;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.OrientationHelper;
import android.support.v7.widget.RecyclerView;
import android.view.View;
import android.widget.LinearLayout;
import android.widget.TextView;
 
import com.chinaztt.fda.test.RecyclerViewAA.AAUserAdapter;
import com.chinaztt.fda.test.RecyclerViewAA.AAUserFinder;
import com.chinaztt.fda.test.RecyclerViewAA.ImMemoryUserFinder;
import com.chinaztt.fda.ui.R;
import com.chinaztt.fda.ui.base.BaseActivity;
 
import org.androidannotations.annotations.AfterInject;
import org.androidannotations.annotations.AfterViews;
import org.androidannotations.annotations.Bean;
import org.androidannotations.annotations.Click;
import org.androidannotations.annotations.EActivity;
import org.androidannotations.annotations.ViewById;
 
/**
 * 当前类注释:RecyclerView集合AA(Android Annotations)注入框架实现实例
 * 项目名：FastDev4Android
 * 包名：com.chinaztt.fda.test
 * 作者：江清清 on 15/11/20 14:41
 * 邮箱：jiangqqlmj@163.com
 * QQ： 781931404
 * 公司：江苏中天科技软件技术有限公司
 */
@EActivity(R.layout.recycler_aa_layout)
public class RecyclerViewAAActivity  extends BaseActivity{
    @ViewById
    LinearLayout top_bar_linear_back;
    @ViewById
    TextView top_bar_title;
    @ViewById
    RecyclerView aa_recyclerview;
    @Bean
    AAUserAdapter adapter;
    @Bean(ImMemoryUserFinder.class)
    AAUserFinder userFinder;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
    }
    @AfterViews
    public void initViews(){
       top_bar_title.setText("RecyclerView集合AA注入框架实例");
        //进行设置RecyerView ,并且绑定数据
        LinearLayoutManager linearLayoutManager=new LinearLayoutManager(this);
       linearLayoutManager.setOrientation(OrientationHelper.VERTICAL);
       aa_recyclerview.setLayoutManager(linearLayoutManager);
        adapter.setItems(userFinder.findAll());
        aa_recyclerview.setAdapter(adapter);
    }
    @Click(R.id.top_bar_linear_back)
    public void clickButton(View view){
        this.finish();
    }
 
}

       9.运行效果如下:

          10.上面的类有很多AA(Android Annotations)注入框架标签的使用，如果各位童鞋对于AA框架不是太了解的话的，看上面的代码内容，会有点晕的~不过我已经对于AA注入学习的专题已经更新了[AA(AndroidAnnotations)注入框架详解专题,点击进入...]

(三).最后总结

           今天我们通过实例来演示了RecyclerView和AA注入框架的结合使用方法。

           本次具体实例注释过的全部代码已经上传到FastDev4Android项目中了。同时欢迎大家去Github站点进行clone或者下载浏览:

https://github.com/jiangqqlmj/FastDev4Android 同时欢迎大家star和fork整个开源快速开发框架项目~后面应大家的要求，会更新RecyclerView下拉刷新和上拉更多效果以及RecyclerView打造的Gallery 3D版本的功能文章,敬请期待~