@hide

Eclipse 如何访问源码中@hide,{@hide}注解的对象

夙愿已清 提交于 2019-11-28 10:21:09
Android开发中,时常要去查看源码,我们会发现源码里面有些方法是加上了 @hide ,或者 {@hide} 注解的,就像下面这 2 个方法。 (代码截取自:android.os.storage.StorageManager.java) 那么这两个注解有什么用处呢? 在说这两个注解标记之前,首先我们要知道 java 里面 /** xxx */ 表示javadoc(文档)注释。 当你在方法、类名、或者变量上加上这样的文档注释之后,别的地方引用到这些被你添加了文档注释的方法、类、变量时,就能很方便的看到原作者(也就是你)留下的注释信息,这将会有利于别人理解你的想法或者思路。当然居然是文档注释,那么通过javadoc生成文档时,这些注释信息也就会被输出来。比如我们创建如下方法,并加上适当的文档注释信息: 当我们调用这个方法时,我们添加的文档注释信息就会显示出来了。 切记:一定要是 /** */,只有它才表示 文档注释,只有文档注释的信息才会在调用出显示,或者随javadoc输出。 /* */ 只表示普通的多行注释,注释信息是不能显示或者输出的! 单行注释 // 就更不用说了,绝对出不来的! 这里我们就不掩饰 javadoc 输出的文档信息了。(PS:实际上是博主没用过,还不知道怎么用,有兴趣的可以自己查查资料) 当我们知道什么是文档注释之后,接下来就可以说说 @hide ,{@hide