Android 列表(ListView、RecyclerView)不斷刷新最佳實踐

本文微信公眾號「AndroidTraveler」首發。

背景

在 Android 列表開發過程中，有時候我們的 Item 會有一些組件，比如倒計時。這類組件要求不斷刷新，這個時候由於列表復用的機制，因此會有一些坑。那么我們本篇文章就給大家講兩個主題。

第一個是列表復用是否一定有問題。
第二個是出現問題有哪些解決方案可供我們選擇。

小 Demo

由於我們的主題重點是為了解決不斷刷新問題，因此關於 RecyclerView 的基本使用就不再贅述，不清楚的小伙伴可以看下我之前的文章：
RecyclerView基本使用

首先我們看下效果圖：

很簡單，就是一個 RecyclerView 列表，列表項有兩個組件。分別代表第幾項和剩余秒數。

這里就是通過倒計時來演示刷新可能存在的問題。

重點代碼是 Adapter 里面的顯示邏輯，初始為：

@Override
public void onBindViewHolder(RecyclerViewViewHolder holder, int position) {
    holder.mTvNum.setText(String.valueOf(position + 1));
    updateTime(holder, itemList.get(position));
}

private void updateTime(final RecyclerViewViewHolder holder, final long time) {
    String content;
    long remainTime = time - System.currentTimeMillis();
    remainTime /= 1000;
    if (remainTime <= 0) {
        content = "Time up";
        holder.mTxtTitle.setText(content);
        return;
    }

    content = "剩下"+remainTime+"秒";
    holder.mTxtTitle.setText(content);
}

全部代碼見：https://github.com/nesger/RecyclerView/tree/feature/refresh

接下來我們增加刷新方法，有很多種，我們一一說明。

1. 使用 handler 來實現倒計時刷新

修改顯示代碼，如下：

@Override
public void onBindViewHolder(RecyclerViewViewHolder holder, int position) {
    holder.mTvNum.setText(String.valueOf(position + 1));
    updateTime(holder, itemList.get(position));
}

private void updateTime(final RecyclerViewViewHolder holder, final long time) {
    String content;
    long remainTime = time - System.currentTimeMillis();
    remainTime /= 1000;
    if (remainTime <= 0) {
        content = "Time up";
        holder.mTxtTitle.setText(content);
        return;
    }

    content = "剩下"+remainTime+"秒";
    holder.mTxtTitle.setText(content);
    holder.mTxtTitle.postDelayed(new Runnable() {
        @Override
        public void run() {
            updateTime(holder, time);
        }
    }, 1000);
}

可以看到通過 handler 延時一秒，然后每次更新時間也是減少一秒。

我們看下效果圖：

可以看到沒滾動之前還好，滾動之后會發現，倒計時都亂了。

當然有時候可能不會暴露出來，比如滾動數目少，或者只有部分組件有倒計時，不像我們這個例子，所有項目都有倒計時，但是這也間接留下了可能的坑。

出現這個問題的原因在於組件的復用，如果你用 ListView 演示，並且不用復用，那么是不會錯亂的。

當然列表不復用這個肯定是不推薦的。

因此，該方式不推薦。

全部代碼見：https://github.com/nesger/RecyclerView/tree/feature/refresh_1

2. 使用 Timer 來實現倒計時刷新

@Override
public void onBindViewHolder(RecyclerViewViewHolder holder, int position) {
    holder.mTvNum.setText(String.valueOf(position + 1));
    updateTime(holder, itemList.get(position));
}

private void updateTime(final RecyclerViewViewHolder holder, final long time) {
    String content;
    long remainTime = time - System.currentTimeMillis();
    remainTime /= 1000;
    if (remainTime <= 0) {
        content = "Time up";
        holder.mTxtTitle.setText(content);
        return;
    }

    content = "剩下"+remainTime+"秒";
    holder.mTxtTitle.setText(content);
}

一樣不行，不推薦。

全部代碼見：https://github.com/nesger/RecyclerView/tree/feature/refresh_2

3. 使用 Timer + View 集合

其實我們簡單分析一下就知道，出現上面錯亂情況的原因大致是兩個：一個是復用，一個是代碼多次調用。
所以如果能夠解決這兩個問題，那么這個問題就解決了。

因為我們這里的業務是倒計時監聽，所有 View 都是一樣的，就是一秒更新一次。

所以我們的定時器不需要 N 個，只需要一個，在構造函數初始化即可。

另外為了避免復用和代碼多次調用問題，我們將 View 通過一個集合保存起來。

最后修改的代碼如下：

private Timer mTimer;
private Set<RecyclerViewViewHolder> mHolders;

public RecyclerViewAdapter(Activity activity, List<Long> itemList) {
    if (activity == null || itemList == null) {
        throw new IllegalArgumentException("params can't be null");
    }
    this.activity = activity;
    this.itemList = itemList;
    mHolders = new HashSet<>();
    mTimer = new Timer();
    mTimer.scheduleAtFixedRate(new TimerTask() {
        @Override
        public void run() {
            for (RecyclerViewViewHolder holder : mHolders) {
                updateTime(holder, holder.getTime());
            }
        }
    }, 0, 1000);
}

@Override
public void onBindViewHolder(RecyclerViewViewHolder holder, int position) {
    holder.setTime(itemList.get(position));
    mHolders.add(holder);
    holder.mTvNum.setText(String.valueOf(position + 1));
    updateTime(holder, itemList.get(position));
}

效果圖如下：

可以看到沒問題了。

當然這里有些優化還沒處理，因為本篇主要是思路分析，這里就不添加了。

待優化點：定時器的啟動和關閉跟生命周期關聯，無數據源不啟用定時器等。

全部代碼見：https://github.com/nesger/RecyclerView/tree/feature/refresh_3

該方法來自與一名朋友的分享。

4. 使用 ScheduledExecutorService + View 集合

這邊 AndroidStudio 有安裝阿里巴巴提供的一個代碼檢測插件，鏈接為：https://plugins.jetbrains.com/plugin/10046-alibaba-java-coding-guidelines

在 AndroidStudio 輸入插件名字 Alibaba Java Coding Guidelines 查找安裝即可。

在方法 3 使用 Timer 時提示下面信息：

Run multiple TimeTask by using ScheduledExecutorService rather than Timer because Timer will kill all running threads in case of failing to catch exceptions. 
            
//org.apache.commons.lang3.concurrent.BasicThreadFactory
ScheduledExecutorService executorService = new ScheduledThreadPoolExecutor(1,
    new BasicThreadFactory.Builder().namingPattern("example-schedule-pool-%d").daemon(true).build());
executorService.scheduleAtFixedRate(new Runnable() {
    @Override
    public void run() {
        //do something
    }
},initialDelay,period, TimeUnit.HOURS);

所以我們這里修改 Timer 為 ScheduledExecutorService：

private ScheduledExecutorService mExecutorService;

public RecyclerViewAdapter(Activity activity, List<Long> itemList) {
    if (activity == null || itemList == null) {
        throw new IllegalArgumentException("params can't be null");
    }
    this.activity = activity;
    this.itemList = itemList;
    mHolders = new HashSet<>();
    mExecutorService = new ScheduledThreadPoolExecutor(1, new ThreadFactory() {
        @Override
        public Thread newThread(@NonNull Runnable r) {
            Thread thread = new Thread(r);
            thread.setName("countdown");
            return thread;
        }
    });
    mExecutorService.scheduleAtFixedRate(new Runnable() {
        @Override
        public void run() {
            for (RecyclerViewViewHolder holder : mHolders) {
                updateTime(holder, holder.getTime());
            }
        }
    }, 0, 1000, TimeUnit.MILLISECONDS);
}

全部代碼見：https://github.com/nesger/RecyclerView/tree/feature/refresh_4

有更多方法歡迎到上面的 GitHub 鏈接提 PR，可以基於 feature/refresh 分支新建分支。

有另外一位朋友提出了自定義 View 的處理方式，將倒計時的功能放到 View 里面去處理，這個感興趣的小伙伴可以實現然后提 PR 哈，這里提供額外一種思路。