适配RoomDatabase的android.net.Uri最佳转换方法及最优TypeConverter选型

一、Uri类型的最优TypeConverter是什么？ #

其实Uri本身就自带了非常成熟的序列化/反序列化能力，最优的TypeConverter就是基于它原生的toString()和Uri.parse()方法，理由很实在：

• 这是Android官方提供的API，兼容性拉满，不会因为自定义序列化逻辑搞砸Uri的格式
• 实现简单到离谱，不需要额外依赖，性能也是最优的——毕竟是系统底层优化过的方法

完全没必要搞复杂的序列化逻辑，就靠这两个原生方法就能完美搞定Uri的转换需求。

二、在Room Database中适配android.net.Uri的最佳实现方法 #

Room默认不支持直接存储Uri类型，所以我们需要自定义TypeConverter来让Room能识别并处理它。下面是我在多个项目里验证过的靠谱方案：

1. 编写TypeConverter类 #

创建一个专门的转换器类，里面放两个静态方法，分别负责Uri转String和String转Uri，记得处理null的情况，避免空指针：

import android.net.Uri
import androidx.room.TypeConverter

class UriConverter {
    @TypeConverter
    fun fromUri(uri: Uri?): String? {
        return uri?.toString()
    }

    @TypeConverter
    fun toUri(uriString: String?): Uri? {
        return uriString?.let { Uri.parse(it) }
    }
}

如果用Java写的话，代码是这样：

import android.net.Uri;
import androidx.room.TypeConverter;

public class UriConverter {
    @TypeConverter
    public static String fromUri(Uri uri) {
        return uri != null ? uri.toString() : null;
    }

    @TypeConverter
    public static Uri toUri(String uriString) {
        return uriString != null ? Uri.parse(uriString) : null;
    }
}

2. 在Room Database类中注册转换器 #

接下来，在你的Room Database类上添加@TypeConverters注解，把刚才写的转换器类传进去，这样整个数据库都会自动用这个转换器处理Uri类型：

import androidx.room.Database
import androidx.room.RoomDatabase
import androidx.room.TypeConverters

@Database(entities = [YourEntity::class], version = 1)
@TypeConverters(UriConverter::class)
abstract class AppDatabase : RoomDatabase() {
    // 你的DAO定义
    abstract fun yourDao(): YourDao
}

3. 在Entity中直接使用Uri类型 #

现在你就可以在Entity类里直接声明Uri类型的字段了，Room会自动帮你做存储和读取的转换：

import android.net.Uri
import androidx.room.Entity
import androidx.room.PrimaryKey

@Entity(tableName = "your_table")
data class YourEntity(
    @PrimaryKey val id: Int,
    val mediaUri: Uri? // 直接用Uri类型就行
)

为什么这是最佳方案？ #

• 可靠性：依赖系统原生API，不会出现自定义序列化导致的Uri解析错误，比如遗漏scheme、host这类关键信息
• 简洁性：代码量极少，维护成本几乎为零
• 兼容性：从低版本Android到最新版本都能正常工作，没有API适配问题
• 性能：系统方法的性能肯定比自定义的序列化逻辑要好，毕竟是底层优化过的

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