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

本文主要是介绍Android限制参数传递之StringDef注解的使用，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

- 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;
}