Android中常用的注解

序列化和反序列化
序列化是指将对象转换为字节序列的过程，以便于存储或传输。在序列化过程中，对象的状态信息将被转换为字节流，可以保存到文件中或通过网络传输给其他计算机。反序列化则是将字节序列恢复为对象的过程。

gson解析
Gson是Google提供的一个Java库，用于将Java对象转换为JSON字符串，或将JSON字符串转换为Java对象。它可以通过注解来定制序列化和反序列化过程，以满足特定的需求。

gson中的注解

@SerializedName：用于指定字段序列化时的名称，即映射数据字段的key。

 @SerializedName("hvac_state")
    private Integer hvacState;
1
2

@Expose：用于标记字段或方法是否参与序列化和反序列化。serialize：序列化，deserialize：反序列化，默认值都为true

    //可以序列化，不可以反序列化
    @Expose(serialize = true, deserialize = false)
   private String name2;
1
2
3

@Since和@Until：用于标记字段或方法在特定版本范围内是否参与序列化和反序列化。@Since：从某个版本开始生效，@Until：到某个特定版本之前生效。

@Since(2.1) 
private int model;

@Until(1.9)
private String type;
1
2
3
4
5

@JsonAdapter：可以自定义序列化和反序列化。继承自TypeAdapter。

public class CarTypeAdapter extends TypeAdapter<Car> {
...
}

@JsonAdapter(CarTypeAdapter.class)
public class Car{
...
}
1
2
3
4
5
6
7
8

androidx的注解

Android系统提供的SDK中，有四个原生注解。位于android.annotation包中：

@TargetApi 使高版本API的代码在低版本SDK不报错。
@SuppressLint 使用此标注让Lint忽略指定的警告。

@Nullable 变量、参数或返回值可以为空
@NonNull 变量、参数或返回值不能为空

@Retention(SOURCE) // 只保留在源文件中，编译期间删除
@Target({METHOD, PARAMETER, FIELD}) // 此注解使用范围：方法，参数，字段
public @interface NonNull { // 声明注解
}

1
2
3
4
5
6

Java注解

@Override // 重写方法
@Deprecated // 废弃方法
@SuppressWarnings // 关闭不当的编译器警告信息, 常用的有：
▪ @SuppressWarnings(“unused”) // 去除单类型告警
▪ @SuppressWarnings(“unused”, “unchecked”) // 去除多类型告警
▪ @SuppressWarnings(“all”) // 去除全部类型告警

---

其他常见的注解可以参考这篇文章 Android常用注解一览

参考链接

• Google-Gson注解使用详解
• Gson的使用进阶之注解