android源码出现的@字符代表什么意思
2015-09-02 10:29
531 查看
1.背景
在android源码中我们能看到各种以@开头的字符,他们大多出现在注释中,如下图所示
但是可不要小看了它们地作用,昨天当我编译源码的时候,就在一个“@link”处报错了,下面就总结下常用的@字符的意义。
2.总结篇
(1)最讨厌的@字符
<span style="font-size:18px;">@hide</span>
@hide字符一般出现在源码类或者方法的开头注释部分,表示这个方法或者类是在google提供的sdk中隐藏起来的,不能直接调用。要是想使用可以用反射,编译源码等方法。
(2)@link
<span style="font-size:18px;">@link</span>
@link字符是可以单独使用如:@link sth 或者@link sth1#sth2。主要是用来生成javadoc文件使用。当我们去掉这个字符是否会对编译造成影响我还在实验,稍后会贴上结果。
(3)@param
<span style="font-size:18px;">@param</span>
查看本栏目更多精彩内容:http://www.bianceng.cn/OS/extra/
@param出现的频率最高,它也是javadoc也就是文本记录的字符之一。主要是用来注释以下方法中用到的参数的功能。
(4)@see
<span style="font-size:18px;">@see</span>
@see提示用户相关的类或是函数信息。
在android源码中我们能看到各种以@开头的字符,他们大多出现在注释中,如下图所示
但是可不要小看了它们地作用,昨天当我编译源码的时候,就在一个“@link”处报错了,下面就总结下常用的@字符的意义。
2.总结篇
(1)最讨厌的@字符
<span style="font-size:18px;">@hide</span>
@hide字符一般出现在源码类或者方法的开头注释部分,表示这个方法或者类是在google提供的sdk中隐藏起来的,不能直接调用。要是想使用可以用反射,编译源码等方法。
(2)@link
<span style="font-size:18px;">@link</span>
@link字符是可以单独使用如:@link sth 或者@link sth1#sth2。主要是用来生成javadoc文件使用。当我们去掉这个字符是否会对编译造成影响我还在实验,稍后会贴上结果。
(3)@param
<span style="font-size:18px;">@param</span>
查看本栏目更多精彩内容:http://www.bianceng.cn/OS/extra/
@param出现的频率最高,它也是javadoc也就是文本记录的字符之一。主要是用来注释以下方法中用到的参数的功能。
<span style="font-size:18px;">/** *@param context *@param attrs */ Public DotView(Context context, Attribute attrs) { super(context, attrs); setFocusAbleInTouch(true); }</span>
(4)@see
<span style="font-size:18px;">@see</span>
@see提示用户相关的类或是函数信息。
<span style="font-size:18px;">public abstract class MyBase { protected abstract void myFunc(); } class MyImpl extends MyBase { /** * @see MyBase#myFunc() */ @Override protected void myFunc() { .. } }</span>
相关文章推荐
- 强大Android图片加载的框架:Fresco
- Android搜索芽发展clientVersion1.0结束(过程和结果显示)
- Android NDK开发学习(一)
- android viewpager 一页显示多个图片
- Android笔记(十五)Handler初步
- android 学习 数据存储
- 彻底解决Android 应用方法数不能超过65K的问题
- Android studio
- Android 编程权威指南 阅读笔记
- Android Tween Animation
- android_文件下载
- 每个Android开发者应该知道的6个SDK和API
- AndroidManifest.xml文件详解(uses-feature)
- android 获取屏幕宽高、view宽高
- android 自定义LabelView实现各类小标签,重要功能已标注
- android 自定义LabelView实现各类小标签,重要功能已标注
- Android -- 混淆
- AndroidManifest.xml中的<uses-feature>以及和<uses-permission>之间的联系
- Android Studio 快捷键大全
- Android中SQLite应用详解