Android开发 ListView分页加载数据

封面图 • 2025-10-18 • Android开发

在 Android 开发中，使用 `ListView` 实现**分页加载数据**是一种常见的需求，特别是在从网络获取数据时，避免一次性加载过多数据导致性能问题。下面是实现分页加载的完整步骤和示例代码。

---

## ✅ 一、基本思路

1. **初始化数据**：初始加载第一页数据。
2. **监听滚动事件**：当用户滚动到 ListView 底部时，加载下一页数据。
3. **更新数据集**：将新加载的数据添加到已有的数据集中，并通知 Adapter 更新 UI。
4. **防止重复加载**：使用标志位控制是否正在加载数据，避免重复请求。

---

## ✅ 二、实现步骤

### 1. 创建一个 `ListView` 布局（activity_main.xml）

```xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

</LinearLayout>
```

---

### 2. 创建一个 Item 布局（list_item.xml）

```xml
<TextView
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/tvItem"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp"
    android:textSize="18sp" />
```

---

### 3. 创建一个自定义的 `Adapter`

```java
public class MyAdapter extends ArrayAdapter<String> {
    public MyAdapter(Context context, List<String> items) {
        super(context, 0, items);
    }

@Override
    public View getView(int position, View convertView, ViewGroup parent) {
        String item = getItem(position);
        if (convertView == null) {
            convertView = LayoutInflater.from(getContext()).inflate(R.layout.list_item, parent, false);
        }
        TextView tvItem = convertView.findViewById(R.id.tvItem);
        tvItem.setText(item);
        return convertView;
    }
}
```

---

### 4. 在 Activity 中实现分页逻辑

```java
public class MainActivity extends AppCompatActivity {

private ListView listView;
    private MyAdapter adapter;
    private List<String> dataList = new ArrayList<>();
    private int currentPage = 1;
    private boolean isLoading = false;

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

listView = findViewById(R.id.listView);
        adapter = new MyAdapter(this, dataList);
        listView.setAdapter(adapter);

// 初始加载第一页
        loadData();

// 监听 ListView 滚动
        listView.setOnScrollListener(new AbsListView.OnScrollListener() {
            @Override
            public void onScrollStateChanged(AbsListView view, int scrollState) {
                // 当滚动停止时判断是否需要加载下一页
                if (scrollState == AbsListView.OnScrollListener.SCROLL_STATE_IDLE) {
                    if (isLastItemVisible()) {
                        if (!isLoading) {
                            isLoading = true;
                            currentPage++;
                            loadData();
                        }
                    }
                }
            }

@Override
            public void onScroll(AbsListView view, int firstVisibleItem, int visibleItemCount, int totalItemCount) {
                // 可选：用于其他逻辑
            }
        });
    }

private boolean isLastItemVisible() {
        return listView.getLastVisiblePosition() == dataList.size() - 1;
    }

private void loadData() {
        // 模拟网络请求
        new Handler(Looper.getMainLooper()).postDelayed(() -> {
            for (int i = 0; i < 10; i++) {
                dataList.add("Item " + (dataList.size() + 1));
            }
            adapter.notifyDataSetChanged();
            isLoading = false;
        }, 1000); // 模拟延迟
    }
}
```

---

## ✅ 三、优化建议

- 使用 `RecyclerView` 替代 `ListView`，因为 `RecyclerView` 更现代、灵活，支持更多特性（如分页、动画等）。
- 添加“加载中”提示或进度条。
- 处理网络错误、无数据等情况。
- 使用 `Paging Library`（Android 官方推荐）来简化分页逻辑。

---

## ✅ 四、使用 Paging Library 的简单示例（推荐）

如果你使用的是 Android Jetpack 的 `Paging Library`，可以更简洁地实现分页加载：

```gradle
implementation "androidx.paging:paging-runtime:3.1.1"
```

然后创建一个 `PagingSource` 和 `PagingDataAdapter`，并用 `PagedList` 来加载数据。

---

## ✅ 总结

| 步骤 | 内容 |
|------|------|
| 1 | 创建 `ListView` 和 `Adapter` |
| 2 | 监听滚动事件，判断是否到达底部 |
| 3 | 加载下一页数据并更新 UI |
| 4 | 控制加载状态，防止重复请求 |

---

如果你需要我提供使用 `RecyclerView` 或 `Paging Library` 的示例，也可以告诉我，我可以继续为你详细讲解。