Annotations Overview

同学们，咱们这节课来说说 Apex 里的“注释”，或者叫注解，英文是 Annotation。它跟我们平常写双斜杠那种解释代码的注释不一样，这个是专门用来修改类或者方法的行为的，就跟 Java 里的注解几乎一模一样。 你可以把它想象成贴一个小标签，告诉 Salesforce 平台：“嘿，这个方法或类，你要用特殊的方式对待它哦。” 那怎么写呢？很简单，就是一个 @ 符号，后面跟上关键字。比如大家以后会经常碰到的 @isTest，用来标记测试类；或者是 @AuraEnabled，让方法能被 Lightning 组件调用。你把它放在哪呢？一定要紧挨着方法或类的定义之前，单独一行。别塞到代码里面去，那样就失效了。 比如说，你想把一个方法标记为未来执行的异步方法，就可以这样写： @future public static void doSomethingAsync() { ... } 看到了吧，@future 这一行就贴在方法签名上面。 那如果我既想让它能被 Aura 组件调用，又需要它异步执行呢？很简单，你可以用一个以上的注释，每个注释单独占一行，叠在一起。像这样： @AuraEnabled @future public static void myMethod() { ... } 这样，两个标签的需求就都满足了。但是一定要注意，不是所有注释都能像乐高积木一样随便拼在一起的。有些注释彼此是冲突的，不能同时使用。具体哪些不能混搭，文档里每个注释的介绍页面都会有详细说明。所以我们用的时候，要是看到开发控制台报错，或者说行为不对劲，记得回头去查一下那个注释的限制。 总之一句话：Apex 的注释就是用 @ 开头的标签，放在类或方法前面，用来给它附加特殊能力。可以单用，也可以多行连用，但要遵守各自的规则。把这一点记牢，后面的开发会顺手很多。好了，这块就这么简单，咱们继续往下看。