什么?还在傻傻地手写Parcelable实现?
缘起
序列化已经是Android司空见惯的东西了,场景太多了。就拿Intent
来说吧,extra能放的数据,除了基本类型外,就是序列化的数据了,有两种:
-
Serializable
:Java世界自带的序列化工具,大道至简,是一个无方法接口 -
Parcelable
:Androgradle依赖冲突强制指定id的官配序列化工具
这二者在性能、用法乃至kotlin怎么读适用场接口和抽象类的区别景上均有不同,网上的讨论已经很多了,这里不再赘接口crc错误计数述。
下面来看看官配正品怎么用的。
Android的Parcelable
首先看看官方示例:
public class MyParcelable implements Parcelable {
private int mData;
public int describeContents() {
return 0;
}
public void writeToParcel(Parcel out, int flags) {
out.writeInt(mData);
}
public static final Parcelable.Creator<MyParcelable> CREATOR
= new Parcelable.Creator<MyParcelable>() {
public MyParcelable createFromParcel(Parcel in) {
return new MyParcelable(in);
}
public MyParcelable[] newArray(int size) {
return new MyParcelable[size];
}
};
private MyParcelable(Parcel in) {
mData = in.readInt();
}
}
可以总结,实现Parcelable
的数据类,有两个要点:
- 必须有一个 非空的、静态的且名为”CREATOR” 的对象,该对象实现
Par接口是什么celable.Creator
接口 - 实现方法
describeContents
,描述内容; 实现方gradle是什么法wrandroid什么意思iteToParcel
,gradle教程将类数据打入parcel内
示例中,实际的数据只有一个简单的整型。
实验:Intent中的Par接口自动化celable传递
这里通过android什么意思一个案例来说明一下Parcelable
的使用。
首先,定义一个数据类User,它包含一个String和一个Int:
class User() : Parcelable {
var name: String? = ""
var updatedTime: Long = 0L
constructor(parcel: Parcel) : this() {
name = parcel.readString()
updatedTime = parcel.readLong()
}
constructor(name: String?, time: Long) : this() {
this.name = name
updatedTime = time
}
override fun writeToParcel(parcel: Parcel, flags: Int) {
Log.d("p-test", "write to")
parcel.writeString(name)
parcel.writeLong(updatedTime)
}
override fun describeContents(): Int {
return 0
}
companion object CREATOR : Parcelable.Creator<User> {
override fun createFromParcel(parcel: Parcel): User {
Log.d("p-test", "createFromParcel")
return User(parcel)
}
override fun newArray(size: Int): Array<User?> {
return arrayOfNulls(size)
}
}
override fun toString(): String = "$name - [${
DateFormat.getInstance().format(Date(updatedTime))
}]"
}
启动方带上User数据:
Log.d("p-test", "navigate to receiver")
context.startActivity(Intent(context, ReceiverActivity::class.java).apply {
putExtra("user", User("Dale", System.currentTimeMillis())) // 调用Intent.putExtra(String name, @Nullable Parcelable value)
})
接收方读接口测试用例设计取并显示User数据android/harmonyos:
Log.d("p-test", "onCreate")
val desc: User? = intent?.getParcelableExtra("user")
// 省略展示:desc?.toString()
来看看日志:
2022-05-18 11:45:28.280 26148-26148 p-test com.jacee.example.parcelabletest D navigate to receiver
2022-05-18 11:45:28.282 26148-26148 p-test com.jacee.example.parcelabletest D write to
2022-05-18 11:45:28.342 26148-26148 p-test com.jacee.example.parcelabletest D onCreate
2022-05-18 11:45:28.343 26148-26148 p-test com.jacee.example.parcelabletest D createFromParcel
其过程为:
- 启动
- User类调用
writeToParcelandroid是什么系统
,将数据写入Parcel
- 接收
-
CREATOR
调用createFromParcel
,从Parcel中读取数据,并构造相应的User数据类对象
界面上,Userandroid是什么手机牌子正确展示:
由此,Parcelable的数据类算是正字节码是什么意思确实现了。
看起来,虽然没有很难,接口是什么但是,是真心有点儿烦啊,尤其是相较于Java的Serializable
来说。有没有简化之法呢?当然有啊,要知道,现在可是Kotlin时代了!
kotlin-parcelize插件
隆重介绍kotlin-kotlin怎么读parcelize
插件:它提供了一个接口卡 Parcelable
的实现生成器。有了此生成器,就不必再写如前的复杂代码了。
怎么使用呢?
首先,需要在gradle里面添加此插件:
plugins {
id 'kotlin-parcelize'
}
然后,在需要 Parcelable
的数据类上添加 @kotlinx.parcelize.Pandroid是什么系统arcelize
注解就行了。
来吧,改造前面的例子:
import kotlinx.parcelize.Parcelize
@Parcelize
data class User(
val name: String?,
val updatedTime: Long
): Parcelable {
override fun toString(): String = "new: $name - [${
DateFormat.getInstance().format(Date(updatedTime))
}]"
}
哇,简化如斯,真能实现?还是来看看上述代码kotlin和java区别对应的字节码吧:
@Metadata(
mv = {1, 6, 0},
k = 1,
d1 = {"u0000:nu0002u0018u0002nu0002u0018u0002nu0000nu0002u0010u000enu0000nu0002u0010tnu0002btnu0002u0010bnu0000nu0002u0010u000bnu0000nu0002u0010u0000nu0002bu0003nu0002u0010u0002nu0000nu0002u0018u0002nu0002bu0002bu0087bu0018u00002u00020u0001Bu0017u0012bu0010u0002u001au0004u0018u00010u0003u0012u0006u0010u0004u001au00020u0005u0006u0002u0010u0006Ju000bu0010u000bu001au0004u0018u00010u0003Hu0003Jtu0010fu001au00020u0005Hu0003Ju001fu0010ru001au00020u00002nbu0002u0010u0002u001au0004u0018u00010u00032bbu0002u0010u0004u001au00020u0005Hu0001Jtu0010u000eu001au00020u000fHu0001Ju0013u0010u0010u001au00020u00112bu0010u0012u001au0004u0018u00010u0013Hu0003Jtu0010u0014u001au00020u000fHu0001Jbu0010u0015u001au00020u0003Hu0016Ju0019u0010u0016u001au00020u00172u0006u0010u0018u001au00020u00192u0006u0010u001au001au00020u000fHu0001Ru0013u0010u0002u001au0004u0018u00010u0003u0006bnu0000u001au0004bu0007u0010bRu0011u0010u0004u001au00020u0005u0006bnu0000u001au0004btu0010nu0006u001b"},
d2 = {"Lcom/jacee/example/parcelabletest/data/User;", "Landroid/os/Parcelable;", "name", "", "updatedTime", "", "(Ljava/lang/String;J)V", "getName", "()Ljava/lang/String;", "getUpdatedTime", "()J", "component1", "component2", "copy", "describeContents", "", "equals", "", "other", "", "hashCode", "toString", "writeToParcel", "", "parcel", "Landroid/os/Parcel;", "flags", "parcelable-test_debug"}
)
@Parcelize
public final class User implements Parcelable {
@Nullable
private final String name;
private final long updatedTime;
public static final android.os.Parcelable.Creator CREATOR = new User.Creator();
@NotNull
public String toString() {
return "new: " + this.name + " - [" + DateFormat.getInstance().format(new Date(this.updatedTime)) + ']';
}
@Nullable
public final String getName() {
return this.name;
}
public final long getUpdatedTime() {
return this.updatedTime;
}
public User(@Nullable String name, long updatedTime) {
this.name = name;
this.updatedTime = updatedTime;
}
@Nullable
public final String component1() {
return this.name;
}
public final long component2() {
return this.updatedTime;
}
@NotNull
public final User copy(@Nullable String name, long updatedTime) {
return new User(name, updatedTime);
}
// $FF: synthetic method
public static User copy$default(User var0, String var1, long var2, int var4, Object var5) {
if ((var4 & 1) != 0) {
var1 = var0.name;
}
if ((var4 & 2) != 0) {
var2 = var0.updatedTime;
}
return var0.copy(var1, var2);
}
public int hashCode() {
String var10000 = this.name;
return (var10000 != null ? var10000.hashCode() : 0) * 31 + Long.hashCode(this.updatedTime);
}
public boolean equals(@Nullable Object var1) {
if (this != var1) {
if (var1 instanceof User) {
User var2 = (User)var1;
if (Intrinsics.areEqual(this.name, var2.name) && this.updatedTime == var2.updatedTime) {
return true;
}
}
return false;
} else {
return true;
}
}
public int describeContents() {
return 0;
}
public void writeToParcel(@NotNull Parcel parcel, int flags) {
Intrinsics.checkNotNullParameter(parcel, "parcel");
parcel.writeString(this.name);
parcel.writeLong(this.updatedTime);
}
@Metadata(
mv = {1, 6, 0},
k = 3
)
public static class Creator implements android.os.Parcelable.Creator {
@NotNull
public final User[] newArray(int size) {
return new User[size];
}
// $FF: synthetic method
// $FF: bridge method
public Object[] newArray(int var1) {
return this.newArray(var1);
}
@NotNull
public final User createFromParcel(@NotNull Parcel in) {
Intrinsics.checkNotNullParameter(in, "in");
return new User(in.readString(), in.readLong());
}
// $FF: synthetic method
// $FF: bridge method
public Object createFromParcel(Parcel var1) {
return this.createFromParcel(var1);
}
}
}
嗯,十分眼熟 —— 这不就是 完美且完整地实现了Parcelable
吗?当然是能正确工作的!
2022-05-18 13:13:30.197 27258-27258 p-test com.jacee.example.parcelabletest D navigate to receiver
2022-05-18 13:13:30.237 27258-27258 p-test com.jacee.example.parcelabletest D onCreate
复杂的序列化逻辑
如果需要添加更复杂的序列化逻辑,就需要额外通过伴随对象实现,该对象需要实现接口 Parcelegradle怎么读r
:
interface Parceler<T> {
/**
* Writes the [T] instance state to the [parcel].
*/
fun T.write(parcel: Parcel, flags: Int)
/**
* Reads the [T] instance state from the [parcel], constructs the new [T] instance and returns it.
*/
fun create(parcel: Parcel): T
/**
* Returns a new [Array]<T> with the given array [size].
*/
fun newArray(size: Int): Array<T> {
throw NotImplementedError("Generated by Android Extensions automatically")
}
}
看样子,Parceler
和原生 Parcelable.Creator
十分像啊,不过多了一个 write
函数 —— 其实就是kotlin是什么对应了Parcelable.writeToParcel
方法。
简单打印点日志模拟所谓的“复杂的序列化逻辑”:
@Parcelize
data class User(
val name: String?,
val updatedTime: Long
): Parcelable {
override fun toString(): String = "new: $name - [${
DateFormat.getInstance().format(Date(updatedTime))
}]"
private companion object : Parceler<User> {
override fun create(parcel: Parcel): User {
Log.d("p-test", "new: create")
return User(parcel.readString(), parcel.readLong())
}
override fun User.write(parcel: Parcel, flags: Int) {
Log.d("p-test", "new: write to")
parcel.writeString("【${name}】")
parcel.writeLong(updatedTime)
}
}
}
来看看:
2022-05-18 13:24:49.365 29603-29603 p-test com.jacee.example.parcelabletest D navigate to receiver
2022-05-18 13:24:49.366 29603-29603 p-test com.jacee.example.parcelabletest D new: write to
2022-05-18 13:24:49.450 29603-29603 p-test com.jacee.example.parcelabletest D onCreate
2022-05-18 13:24:49.450 29603-29603 p-test com.jacee.example.parcelabletest D new: create
果然调用了,其中,接收方拿到的name,确实就是write
函数改造过的(加了“【】”):
映射序列化kotlin怎么读
假如数据类不能直接支持序列化,那就可以通过自定义一个Parceler
,实现映射序列化。
怎么理解呢?假如有一接口是什么个数据类A,是一个普通实现,不支持序列化(或者有其他原因,总之是不支字节码持),但是呢,我们又有需求是将它序列化后使用,这接口英文时候就可以实现 Parcelergradle项目<A>
类,然后用包裹A的类B来实现序列化 —— 即,通过Parceler
,接口类型将普通的A包裹成了序列化的B。
// 目标数据类A
data class User(
val name: String?,
val updatedTime: Long
) {
override fun toString(): String = "new: $name - [${
DateFormat.getInstance().format(Date(updatedTime))
}]"
}
// 实现的Parceler<A>
object UserParceler: Parceler<User> {
override fun create(parcel: Parcel): User {
Log.d("djx_test", "1 new: create")
return User(parcel.readString(), parcel.readLong())
}
override fun User.write(parcel: Parcel, flags: Int) {
Log.d("djx_test", "1 new: write to")
parcel.writeString("【${name}】")
parcel.writeLong(updatedTime)
}
}
// 映射类B
@Parcelize
@TypeParceler<User, UserParceler>
class Target(val value: User): Parcelable // 这个类来实现Parcelable
如上就是 Akotlin和java -> B 的序列化映射,同样没问题:
2022-05-18 14:08:26.091 30639-30639 p-test com.jacee.example.parcelabletest D navigate to receiver
2022-05-18 14:08:26.094 30639-30639 p-test com.jacee.example.parcelabletest D 1 new: write to
2022-05-18 14:08:26.148 30639-30639 p-test com.jacee.example.parcelabletest D onCreate
2022-05-18 14:08:26.148 30639-30639 p-test com.jacee.example.parcelabletest D 1 new: create
上面的映射类B,还可以这kotlin语言么写:
@Parcelize
class Target(@TypeParceler<User, UserParceler> val value: User): Parcelable
// 或
@Parcelize
class Target(val value: @WriteWith<UserParceler> User): Parcelable
总结
说了这么多,其字节码文件扩展名实总结一下就是:
插件kotlin-parcelize
接管了套路化、模版化的工作,帮我们自动生成了序列化的实现,它并没有改变 Parcelable
的实现方式。
用它就对了!