Android 注释语法

/**
 * 这里要引用一个类 {@link package.MyClass} <br/>
 * 这里要引用一个类里面的子类 {@link package.MyClass.SubClass}<br/>
 * 这里要引用一个类里面的方法 {@link package.MyClass#method(Context, Object)} // 注意这里()里面的是方法的参数类型，使用不同的参数签名可以来区别不同的重载方法 <br/>
 * 这里要引用一个类李曼的字段 {@link package.MyClass#field} // 这里不区分字段是否是public 或者 static，都可以直接引用 <br/>
 * 这里要引用改类本身的方法或者字段 {@link #method(Context, Object)}和{@link #field}
 */

/**
 * 这里要引用一个类 {@linkplain package.MyClass 别名} <br/>
 */

/**
 * 这是方法的说明
 * @param param1 这里是参数1的说明
 * @param param2 这是是参数2的说明
 */
void method(int 参数1, int 参数2) { }

/**
     * 这是方法的说明
     *
     * @param 参数1 这里是参数1的说明
     * @param 参数2 这是是参数2的说明
     *            
     * @see #method()
     * @see #method(int)
     */
    void method(int 参数1, int 参数2) {

    }

    void method() {
    }

    void method(int 参数1) {
    }

 /**
     * @deprecated 已废弃，建议使用{@link #method(int)} (int)}
     */
    void method() {
    }

 /**
     * 这是方法说明
     * @param age
     * @exception IllegalArgumentException 校验参数有问题将抛出，如age < 0
     */
    void method(int age) {
        if (age < 0) {
            throw new IllegalArgumentException("age must >= 0!!!");
        }
        // TODO ...
    }

/**
 * 以下是本类方法的执行顺序
 * <pre class="prettyprint">
 * public class Activity extends ApplicationContext {
 *     protected void onCreate(Bundle savedInstanceState);
 *
 *     protected void onStart();
 *
 *     protected void onRestart();
 *
 *     protected void onResume();
 *
 *     protected void onPause();
 *
 *     protected void onStop();
 *
 *     protected void onDestroy();
 * }
 * </pre>
 */

/**
 * 第一行<br />
 * 第二行<br />
 * 最后一行
 */

/**
 * <ul>
 *     <li><a href="#FROM_WHERE_SHOW_TEAM">可以参考这个字段</a></li>
 *     <li><a href="package.MyClass">参考这个类</a></li>
 * </ul>
 */

/**
 * <h3>Class Info</h3>
 *  我是Class Info内容
 * <h3>Usages</h3>
 *  我是Usages内容
 * <h3>Help</h3>
 *  我是Help内容
 */