第4章 结绳注解

注解用于补充说明一个成员。
* = 罕见的注解
** = 原生封装才用的注解
*** = 一般人用不了的注解

---

🏷️ 基础注解

@隐藏

指定成员为私有的，附加private修饰符，在类外无法直接访问。

类 我的类
    @隐藏
    变量 私有变量 : 文本
    
    @隐藏
    方法 私有方法()
        // 只能在类内部调用
    结束 方法
结束 类

@静态

指定成员为静态的，属于类本身而不是实例，以"类名.成员名"调用。

类 工具类
    @静态
    方法 计算和(a : 整数, b : 整数) : 整数
        返回 a + b
    结束 方法
结束 类

// 调用方式
变量 结果 : 整数 = 工具类.计算和(5, 10)

@调试

指定该方法为调试方法，在正式打包后会去除。

类 应用
    @调试
    方法 打印调试信息()
        调试输出("这只在调试时显示")
    结束 方法
结束 类

@禁止调用

指定该方法在任何地点都不得调用。

类 特殊类
    @禁止调用
    方法 不能调用()
        // 这个方法不能被调用
    结束 方法
结束 类

@废弃使用(文本)

指定该方法已过时，调用会输出警告。

类 旧接口
    @废弃使用("请使用新的方法替代")
    方法 旧方法()
        // 已废弃
    结束 方法
结束 类

@禁止继承

指定类不能有子类，不能成为任何类的父类。

@禁止继承
类 最终类
    // 此类不能被继承
结束 类

---

🎨 高级注解

@运算符重载

指定方法重载运算符。可重载: = ? + - * / % == != < > <= >= [] []=

类 向量
    变量 x : 小数
    变量 y : 小数
    
    @运算符重载(+)
    方法 加(另一个向量 : 向量) : 向量
        // 重载加法运算符
        变量 结果 : 向量
        结果.x = 我的x + 另一个向量.x
        结果.y = 我的y + 另一个向量.y
        返回 结果
    结束 方法
结束 类

@外部Java文件(文本)

在类上标注，打包时附加该Java文件进行编译。

@外部Java文件("com/example/Helper.java")
类 我的类
    // 使用外部Java类
结束 类

@全局主题(文本)

设置整个应用的主题。

@全局主题("蓝色主题")
类 应用主类
    变量 蓝色主题 : 主题资源
结束 类

@附加权限(文本)

添加应用权限。

@附加权限("android.permission.INTERNET")
@附加权限("android.permission.ACCESS_FINE_LOCATION")
类 位置应用
    // 需要网络和位置权限的应用
结束 类

@异步方法

标记方法为异步执行。

类 网络请求
    @异步方法
    方法 获取数据() : 数据
        // 异步获取数据
    结束 方法
结束 类

---

📋 注解速查表

注解	使用位置	说明
@隐藏	成员	私有化成员
@静态	成员	静态成员
@调试	方法	调试时有效
@禁止调用	方法	禁止调用
@废弃使用	方法	标记已废弃
@禁止继承	类	禁止继承
@运算符重载	方法	重载运算符
@外部Java文件	类	包含外部Java
@全局主题	类	设置全局主题
@附加权限	类	添加权限
@异步方法	方法	异步执行

---

🔗 相关链接

• 第3章 结绳语法
• 第5章 结绳特性

---

完整的注解列表（4.1-4.45）请参考官方完整文档。