Android Toast 中的传参限制

最新推荐文章于 2024-07-09 15:08:59 发布

原创最新推荐文章于 2024-07-09 15:08:59 发布 · 865 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#android #源码

android 专栏收录该内容

19 篇文章

订阅专栏

本文解析了Android Toast消息提示的持续时间如何通过注解实现限制，介绍了@IntDef注解的作用及使用方法。

Android Toast 的duration(int)传参只能是Taost.LENGTH_SHORT和Taost.LENGTH_LONG，这个是怎么实现的呢？

查看源码

    public static final int LENGTH_SHORT = 0;
    public static final int LENGTH_LONG = 1;

    @IntDef({LENGTH_SHORT, LENGTH_LONG})
    @Retention(RetentionPolicy.SOURCE)
    public @interface Duration {}

    public static Toast makeText(Context context, CharSequence text, @Duration int duration) {
        return makeText(context, null, text, duration);
    }

duration 的参数前面有个注解＠Duration而这个@Duration中又有个注解＠Intdef

@Retention(SOURCE)
@Target({ANNOTATION_TYPE})
public @interface IntDef {
    /** Defines the allowed constants for this element */
    long[] value() default {};

    /** Defines whether the constants can be used as a flag, or just as an enum (the default) */
    boolean flag() default false;
}

@Intdef是 android.support.annotation包下的一个注解，@Target({ANNOTATION_TYPE})表明它只能用来修饰注解．android.support.annotation包下有很多预定义的注解可以使用，能够帮你检查代码，比如＠MainThread,`@IntRange” 等．

如果你写了个方法，并且只想让调用者传入固定的几个值，那么就可以参照Toast中的写法．
１，把值定义成常量
２，写一个注解，用@Indef引用你写的那几个常量
３，用刚写的注解修饰你需要限定的传参
eg:

    //参照　Taost

如果你只是想限制一个取值范围，比如（０～１００）那么你可以用@IntRange(from 0,to 100)那么调用者就不能够传参这个范围以外的值
eg:

    public static void input(@IntRange(from 0,to 100) int i){
        //do something
    }

这些注解只会保留到源码级别，不会对运行时造成影响．