RecyclerView显示列表

本次要讲的内容是利用RecyclerView显示Users列表的信息，如下图所示。



首先我们来创建模型User.java

package com.example.mytest.User;
import java.util.UUID;

public class User{
    private UUID mId;
    private String name;

    public User() {
        this(UUID.randomUUID());
    }

    public User(UUID id){
        mId=id;
    }

    public UUID getId() {
        return mId;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    @Override
    public String toString() {
        return "User{" +
                "mId=" + mId +
                ", name='" + name + '\'' +
                '}';
    }
}

创建单例UserLab.java

user数组对象将存储在一个单例里。单例是特殊的Java类，在创建实例时，一个单例类仅允许创建一个实例。

应用能在内存里存活多久，单例就能活多久。

package com.example.mytest.User;
import android.content.Context;
import java.util.ArrayList;
import java.util.List;
import java.util.UUID;

public class UserLab {
    private static UserLab sUserLab;

    private List<User> mUsers;//保存User对象

    //get()方法
    public static UserLab get(Context context){
        //如果实例存在直接返回它，如果不存在，调用构造方法创建它
        if (sUserLab==null){
            sUserLab=new UserLab(context);
        }
        return sUserLab;
    }
    //私有构造方法
    private UserLab(Context context){
        mUsers=new ArrayList<>();
        //先批量存入100个User对象
        for (int i=0;i<100;i++){
            User user=new User();
            user.setName("User #"+i);
            mUsers.add(user);
        }
    }

    public List<User> getUsers(){
        return mUsers;
    }
    public User getUser(UUID id){
        for (User user:mUsers){
            if (user.getId().equals(id)){
                return user;
            }
        }
        return null;
    }
}

创建通用型fragment托管布局activity_fragment.xml

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/fragment_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="com.example.mytest.User.UserActivity">
</FrameLayout>

抽象activity类,创建SingleFragmentActivity.java

因为这段代码很通用，所以抽取出来，便于简化代码。

package com.example.mytest.User;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.support.v4.app.FragmentManager;
import android.support.v7.app.AppCompatActivity;
import com.example.mytest.R;

public abstract class SingleFragmentActivity extends AppCompatActivity {
    protected abstract Fragment createFragment();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_fragment);

        FragmentManager fm=getSupportFragmentManager();
        Fragment fragment=fm.findFragmentById(R.id.fragment_container);

        if (fragment==null){
            fragment=createFragment();
            fm.beginTransaction().add(R.id.fragment_container,fragment).commit();
        }
    }
}

创建UserListActivity.java

继承SingleFragmentActivity类,托管UserListFragment

package com.example.mytest.User;
import android.support.v4.app.Fragment;

public class UserListActivity extends SingleFragmentActivity {
    @Override
    protected Fragment createFragment() {
        return new UserListFragment();
    }
}

创建UserListFragment .java

public class UserListFragment extends Fragment {

}

在配置文件AndroidManifest.xml中声明UserListActivity为launcher acticity

<activity android:name=".User.UserListActivity">
           <!--添加这里开始-->
            <intent-filter>
                <action android:name="android.intent.action.MAIN"/>
                <category android:name="android.intent.category.LAUNCHER"/>
            </intent-filter>
           <!--添加这里结束-->
        </activity>

现在运行应用，会看到UserListActivity的FrameLayout托管了一个无内容的UserListFragment。

我们需要UserListFragment向用户展示user列表，这就要用到RecyclerView类。RecyclerView是ViewGroup的子类，每一个列表项都是作为一个View子对象显示的。

一次为所有列表项创建View很容易搞垮应用，按需创建视图对象才是比较合理的解决方案。RecyclerView顾名思义就是回收再利用，用户滑动屏幕切换视图时，上一个视图会回收利用，当然整个功能的实现还需要ViewHolder子类和Adapter子类的支持。

• RecyclerView的任务仅限于回收和定位屏幕上的View。
• ViewHolder只做一件事：容纳View视图。
• Adapter创建必要的ViewHolder，绑定ViewHolder至模型层数据。
  
  现在我们来正式使用RecyclerView。

1. 添加RecyclerView依赖库

dependencies {
...
       compile 'com.android.support:recyclerview-v7:25.3.1'
}

2.新建fragment_user_list.xml布局文件。

修改根视图为RecyclerView,并为其配置ID

<?xml version="1.0" encoding="utf-8"?>
<android.support.v7.widget.RecyclerView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/user_recycler_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

</android.support.v7.widget.RecyclerView>

3.视图和fragment关联

修改UserListFragment类文件，使用布局并找到布局中的RecyclerView视图。

注意，没有LayoutManager的支持，不仅RecyclerView无法工作，还会导致应用崩溃。所以，RecyclerView视图创建完成后，就立即转交给了Manager对象。LayoutManager负责屏幕上列表项的摆放、定义屏幕滚动行为。

public class UserListFragment extends Fragment {
   private RecyclerView mUserRecyclerView;
   @Override
   public View onCreateView(LayoutInflater inflater,ViewGroup container,Bundle savedInstanceState) {
        View view=inflater.inflate(R.layout.fragment_user_list,container,false);

        mUserRecyclerView=(RecyclerView)view.findViewById(R.id.user_recycler_view);
        mUserRecyclerView.setLayoutManager(new LinearLayoutManager(getActivity()));
        return view;
    }
}

4.实现ViewHolder和Adapter

public class UserListFragment extends Fragment {
   ........
    //定义ViewHolder内部类，它会实例化并使用list_item_user布局
    private class UserHolder extends RecyclerView.ViewHolder{
        private User mUser;
        //构造方法
        public UserHolder(LayoutInflater inflater,ViewGroup parent){
            super(inflater.inflate(R.layout.list_item_user,parent,false));
        }
    }

    //创建Adapter内部类
    private class UserAdapter extends RecyclerView.Adapter<UserHolder>{
        private List<User> mUsers;

        public UserAdapter(List<User> users){
            mUsers=users;
        }

        @Override
        public UserHolder onCreateViewHolder(ViewGroup parent, int viewType) {
            LayoutInflater layoutInflater=LayoutInflater.from(getActivity());

            return new UserHolder(layoutInflater,parent);
        }

        @Override
        public void onBindViewHolder(UserHolder holder, int position) {

        }

        @Override
        public int getItemCount() {
            return mUsers.size();
        }
    }
}

新建updateUI方法。关联Adapter和RecyclerView。

public class UserListFragment extends Fragment {
......
    private UserAdapter mAdapter;
    @Override
    public View onCreateView(LayoutInflater inflater,ViewGroup container,Bundle savedInstanceState) {
        View view=inflater.inflate(R.layout.fragment_user_list,container,false);

        mUserRecyclerView=(RecyclerView)view.findViewById(R.id.user_recycler_view);
        mUserRecyclerView.setLayoutManager(new LinearLayoutManager(getActivity()));

        updateUI();

        return view;
    }
    private void updateUI() {
        UserLab userLab=UserLab.get(getActivity());
        List<User> users=userLab.getUsers();

        mAdapter=new UserAdapter(users);
        mUserRecyclerView.setAdapter(mAdapter);
    }
    ......
}

运行应用，结果如图所示。



现在绑定列表项，使呈现不同的数据。

我们把绑定工作放入UserHolder类里，绑定之前首先要实例化相关组件。由于是一次性任务，因此直接放在构造方法里处理。然后定义bind(User)方法，每次有新的User要在UserHolder中显示时，都要调用它一次。

为了锦上添花，这里还设置了列表项点击后弹出小的提示框。通过实现View.OnClickListener接口来实现这个功能。

//定义ViewHolder内部类，它会实例化并使用list_item_user布局
    private class UserHolder extends RecyclerView.ViewHolder implements View.OnClickListener{
        private TextView mNameTextView;
        private User mUser;

        //构造方法
        public UserHolder(LayoutInflater inflater,ViewGroup parent){
            super(inflater.inflate(R.layout.list_item_user,parent,false));
            //检测用户点击事件
            itemView.setOnClickListener(this);//点击了则调用onClick()方法
            //实例化视图组件
            mNameTextView=(TextView) itemView.findViewById(R.id.user_name);
        }
        //每次有新的User要在UserHolder中显示时，都要调用它一次
        public void bind(User user){
            mUser=user;
            mNameTextView.setText(mUser.getName());
        }

        @Override
        public void onClick(View v) {
            Toast.makeText(getActivity(),mUser.getName()+" clicked!",Toast.LENGTH_SHORT).show();
        }
    }

//创建Adapter内部类
    private class UserAdapter extends RecyclerView.Adapter<UserHolder>{
   .........
        @Override
        public void onBindViewHolder(UserHolder holder, int position) {
            User user=mUsers.get(position);
            holder.bind(user);
        }
    ........
 }

这里为了方便大家的阅读，再次提供UserListFragment.java的全部代码。

package com.example.mytest.User;

import android.os.Bundle;
import android.support.v4.app.Fragment;
import android.support.v7.widget.LinearLayoutManager;
import android.support.v7.widget.RecyclerView;
import android.view.LayoutInflater;
import android.view.View;
import android.view.ViewGroup;
import android.widget.TextView;
import android.widget.Toast;

import com.example.mytest.R;

import java.util.List;

public class UserListFragment extends Fragment {
    private RecyclerView mUserRecyclerView;
    private UserAdapter mAdapter;

    @Override
    public View onCreateView(LayoutInflater inflater,ViewGroup container,Bundle savedInstanceState) {
        View view=inflater.inflate(R.layout.fragment_user_list,container,false);

        mUserRecyclerView=(RecyclerView)view.findViewById(R.id.user_recycler_view);
        mUserRecyclerView.setLayoutManager(new LinearLayoutManager(getActivity()));

        updateUI();

        return view;
    }

    private void updateUI() {
        UserLab userLab=UserLab.get(getActivity());
        List<User> users=userLab.getUsers();

        mAdapter=new UserAdapter(users);
        mUserRecyclerView.setAdapter(mAdapter);
    }

    //定义ViewHolder内部类，它会实例化并使用list_item_user布局
    private class UserHolder extends RecyclerView.ViewHolder implements View.OnClickListener{
        private TextView mNameTextView;
        private User mUser;

        //构造方法
        public UserHolder(LayoutInflater inflater,ViewGroup parent){
            super(inflater.inflate(R.layout.list_item_user,parent,false));
            //检测用户点击事件
            itemView.setOnClickListener(this);//点击了则调用onClick()方法
            //实例化视图组件
            mNameTextView=(TextView) itemView.findViewById(R.id.user_name);
        }
        //每次有新的User要在UserHolder中显示时，都要调用它一次
        public void bind(User user){
           /* mUser=user;
            mNameTextView.setText(mUser.getName());*/
        }

        @Override
        public void onClick(View v) {
            Toast.makeText(getActivity(),mUser.getName()+" clicked!",Toast.LENGTH_SHORT).show();
        }
    }

    //创建Adapter内部类
    private class UserAdapter extends RecyclerView.Adapter<UserHolder>{
        private List<User> mUsers;

        public UserAdapter(List<User> users){
            mUsers=users;
        }

        @Override
        public UserHolder onCreateViewHolder(ViewGroup parent, int viewType) {
            LayoutInflater layoutInflater=LayoutInflater.from(getActivity());

            return new UserHolder(layoutInflater,parent);
        }

        @Override
        public void onBindViewHolder(UserHolder holder, int position) {
            User user=mUsers.get(position);
            holder.bind(user);
        }

        @Override
        public int getItemCount() {
            return mUsers.size();
        }
    }
}

现在再次运行程序，效果如下图。