Android限制参数传递之StringDef注解的使用

news2024/11/25 0:36:45

文章目录

- 1. 引言
- 2. 注解 @StringDef
- - 2.1 举例
  - 2.2 @StringDef源码解释
- 3. 其他类似注解 @IntDef、@LongDef
- 4. 总结

1. 引言

在参数传递时，如果你想限制传入的参数只能是特定的几个值，该怎么做呢？
除了把参数类型定义为枚举值，还可以使用注解来限制参数只能是你规定的几个值。以下3个注解就是起到了这样的作用：

@StringDef 限制参数只能是规定的几个String类型的值
@IntDef 限制参数只能是规定的几个Int类型的值
@LongDef 限制参数只能是规定的几个Long类型的值

2. 注解 @StringDef

@StringDef：限制参数只能是规定的几个String类型的值。它作用到注解身上，接收你规定的几个字符串作为特定的值。

2.1 举例

在Java中，自定义注解 @ServiceName 来表示想要获取的系统服务的名字👇。

   @Retention(SOURCE)
   @StringDef({
        "power",
        "window",
        "layout_inflater"
   })
   public @interface ServiceName {
   }

上面代码声明了 @ServiceName 注解，并且限制了被该注解修饰的参数只能是 “power”、“window”、“layout_inflater”。

接下来使用该注解，发挥作用！
比如，封装一个获取系统服务的方法，传入的参数为系统服务的名字。

   public Object getSystemService(@ServiceName String name) {
		// 省略...获取服务
   }

外界在调用的时候，由于 String name 前面有@ServiceName 的修饰，因此只能传入 "power"、"window"、"layout_inflater" 这几个字符串。

否则的话，就会提示报错：👇

包错信息已经很明显：传入的参数必须是 "power"、"window"、"layout_inflater"其中之一。

2.2 @StringDef源码解释

从 @StringDef 的源码也可以看出它的作用，下面是源码：👇

/**
 * Denotes that the annotated String element, represents a logical
 * type and that its value should be one of the explicitly named constants.
 * <p>
 * Example:
 * <pre><code>
 *  &#64;Retention(SOURCE)
 *  &#64;StringDef({
 *     POWER_SERVICE,
 *     WINDOW_SERVICE,
 *     LAYOUT_INFLATER_SERVICE
 *  })
 *  public @interface ServiceName {}
 *  public static final String POWER_SERVICE = "power";
 *  public static final String WINDOW_SERVICE = "window";
 *  public static final String LAYOUT_INFLATER_SERVICE = "layout_inflater";
 *  ...
 *  public abstract Object getSystemService(@ServiceName String name);
 * </code></pre>
 */
@Retention(SOURCE)
@Target({ANNOTATION_TYPE})
public @interface StringDef {
    /** Defines the allowed constants for this element */
    String[] value() default {};

    /**
     * Whether any other values are allowed. Normally this is
     * not the case, but this allows you to specify a set of
     * expected constants, which helps code completion in the IDE
     * and documentation generation and so on, but without
     * flagging compilation warnings if other values are specified.
     */
    boolean open() default false;
}