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();
    }
  }
}

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

[Android] RecyclerView显示列表

相关帖子

2345浏览器设置显示侧边栏教程

利用CSS禁止复制网页内容

怎么利用配置文件来管理多个 Node.js 进程

PHP模拟登陆抓取页面内容

uni-app 利用canvas画简单海报并保存图片

Android控件Spinner实现下拉列表及监听功能

Discuz!X3.5支付宝充值积分支付后显示未成功解决方法

解决编辑器图片插入多次但发布后只显示一次问题

利用html+js触发弹窗事件

浅沫记忆 LV3