Java中调用pagingData.map()转换PagingData数据流异常问题

Java开发Android Paging3时pagingData.map()标红、转换逻辑不生效，核心原因是PagingData.map()是Kotlin实现的顶层扩展函数，Java无法直接以类成员方法的形式调用这类扩展，IDE无法识别方法签名直接报红，编译阶段也无法通过。

纯Java项目：直接调用编译生成的静态转换类 #

Kotlin顶层扩展函数编译后会生成对应Java静态方法，Paging3官方已经把所有数据转换逻辑封装在androidx.paging.PagingDataTransforms类中，直接静态调用map方法即可，不需要额外引入其他依赖：

// 先导入对应类
import androidx.paging.PagingDataTransforms;
import java.util.concurrent.Executors;

// 错误写法：直接调用成员方法，会直接标红
// PagingData<UiModel> result = originPagingData.map(item -> convertItem(item));

// 正确写法：静态调用，传入执行线程池 + 转换逻辑
PagingData<UiModel> result = PagingDataTransforms.map(
        originPagingData,
        Executors.newSingleThreadExecutor(), // 传入后台线程池，禁止用主线程
        item -> {
            // 这里写你的数据转换逻辑，比如把网络返回的Model转成页面用的UiModel
            return convertToUiModel(item);
        }
);

注意事项：

• 第二个参数必须传入后台线程池，若传入主线程会触发Paging的线程校验，直接抛出异常
• 转换逻辑的返回值不允许为null，Paging3不支持分页列表中存在null项
• 如果是对Flow/PublishProcessor/LiveData包裹的PagingData做转换，要在拿到流内的PagingData实例后再调用转换方法，不要和流自身的map操作符混淆

混合开发项目：封装Kotlin扩展供Java调用 #

如果项目中存在Kotlin代码，可以自行封装一层兼容Java调用的转换方法，减少重复传参的冗余代码：

// 新建一个Kotlin工具类文件，比如PagingMapUtils.kt
import androidx.paging.PagingData
import java.util.concurrent.Executor

fun <T : Any, R : Any> PagingData<T>.mapOnExecutor(
    executor: Executor,
    transform: (T) -> R
): PagingData<R> {
    // 内部直接调用官方Kotlin扩展的map方法
    return this.map { transform(it) }
}

Java层直接调用封装好的方法即可：

PagingData<UiModel> result = PagingMapUtilsKt.mapOnExecutor(
        originPagingData,
        AppExecutors.getIoExecutor(),
        item -> convertToUiModel(item)
);

• 转换逻辑写在流的外部，没有在流收集/订阅的回调中拿到最新的PagingData实例后再做转换
• 转换后没有把新的PagingData提交给PagingDataAdapter，还是用了原始的PagingData提交
• 传入的线程池是主线程池，导致转换逻辑被阻塞，数据无法正常刷新

内容的提问来源于stack exchange，提问作者sasaaibo