Apex 入门教程
学习目标
完成本单元后，您将能够：
- 定义什么是代码。
- 描述在何处存储和编辑代码。
- 描述创建代码注释的两种方法。
- 解释为何说代码注释很重要。
您知道您可以向专家学习吗？观看此视频，了解与本模块主题相关的更多信息：
那么，您对拓展 Salesforce 知识以学习 Apex 代码感兴趣吗？那您来对了地方。准备好一步步进入阅读和编写代码的世界吧。刚开始您可能会觉得有些难，但不用担心，哪怕是最复杂的概念我们也会进行简化。
作为管理员，您已经了解 Salesforce 功能的方方面面以及它们目前的局限性。您已经开始使用 Flow Builder 来自动化业务流程，并且热衷于为客户提供最棒的自定义应用程序。在学习本模块时，您将首先了解编程的各项概念，然后是一些您可以自行测试的示例。
准备好开始了吗？让我们开始吧！
什么是代码？
代码是人类用来与计算机交流的语言。我们使用代码编写一组精确的指令，以执行特定的操作。把代码想象成一个食谱。每种配料和说明都需要准确无误，这样做出的菜肴才能达到预期的效果。
就像世界各地的人们使用不同的语言一样，计算机也使用不同的语言，例如 JavaScript、Java、Ruby、Python 等等。虽然编程语言在许多方面存在差异，但它们都基于相同的基本结构，并且都可以由计算机进行解释以创建应用程序。随着您对 Apex 编程语言的了解越来越多，您将开始懂得编程结构。
Apex 代码存储在何处？
您问我要从哪里开始？首先，我们需要弄清楚的是代码存储在何处。代码存储在文件中。这些文件可以放在本地（在您的 PC 或 Mac 上），也可以在云中（您的 Salesforce 组织），或者可以将它们保存在本地并自动同步到云中。这个功能很酷吧？
Developer Console
作为管理员，您可能听说过 Developer Console。Developer Console 是开发人员用来创建和编辑代码文件的工具。在整个模块中，我们使用 Developer Console 在 Salesforce 组织中存储和执行（运行）代码。我们来看一看。
要访问 Developer Console：
- 首先，确保您已登录 Trailhead。
- 然后，单击此页面右上角的用户头像并从下拉列表中选择 Hands-on Orgs（实践组织）。
- 单击用户名启动您的组织。想要创建新的组织？请参考 Trailhead Playground 管理模块学习如何操作。
- 在您的 Trailhead Playground 中，单击
并选择 Developer Console。
将 Developer Console 保持打开状态。在整个模块中，我们都将使用它来测试代码。
写伪代码
作为 Salesforce 管理员，在您参与的任何项目中最重要的部分就是规划。规划帮助您了解客户的需求，整理自己的想法，并预测在开发应用程序过程中可能遇到的问题。
在项目规划期间，开发人员在开始写 Apex 代码之前会写伪代码。伪代码是对程序或功能必须执行什么操作的一种详细但可读性强的描述。它是使用自然语言而不是编程语言编写的。伪代码允许非程序员审查这些步骤，以确认拟议中的代码是否满足应用程序的要求。开发人员会在单独的文档、白板或 Developer Console 中写伪代码。
为了了解写伪代码如何能帮助开发人员记录关于如何编写应用程序的思考过程，让我们就泡一壶茶招待朋友来写一段伪代码。
- 在 Developer Console 中，选择文件 | 新建 | Apex 类。
备注
别担心现在使用的是哪一类。您可以在更高级的模块中了解 Apex 类。现在，请将此文件视为一个文本文件。
- 将类命名为
Teatime。 - 单击确定。
- 命名类后，会出现一个包含新类的窗口。
- 将这些指令复制并粘贴到现有类上。
Get Utensils and Ingredients Boil Water in a Tea Kettle Make Tea in Teapot Add Tea and Sugar to a Teacup Serve Tea to Friend
每个伪代码语句（指令）都应该说明一个操作。如果您给机器人发送这些指令，您认为机器人能正确执行每一步吗？
可能不行。机器人需要知道要准备哪些器具和原料，如何将水烧开，以及每种原料要加多少。这个伪代码需要更多的细节。
- 返回 Developer Console。
- 用以下代码替换现有代码：
Get Utensils and Ingredients Get Teacup Get Spoon Get Tea Kettle Get Teapot Get Tea Get Sugar Boil water in a Tea Kettle Fill Kettle with Water Switch Kettle On Wait for Kettle to Boil Make Tea in Teapot Put Tea in Teapot Put Boiling Water in Teapot Wait 2 Minutes Add Tea and Sugar to Teacup Pour Tea in Teacup Put 1 teaspoon of Sugar in Teacup Stir Tea in Teacup Serve Tea to a Friend public class Teatime { }
写伪代码时，要逐步进行，并尽可能详细地考虑到每种情况。例如，这个伪代码指示要将茶壶装满水。如果茶壶中的水已经满了怎么办？机器人应该继续往茶壶里加水吗？还是应该将茶壶里的水倒空？当您作为开发人员思考时，您必须从不同的角度思考，并考虑到多种可能性。
代码注释
作为管理员，您是否见过不包含描述的自定义字段？除非该字段有一个非常清晰且描述性强的名称，否则其用途可能不明显。在代码中，注释的作用是描述一个代码块（一行或多行代码）的用途。注释帮助开发人员了解应该写什么代码、现有代码的功能以及失败代码原本的用途。开发人员将注释嵌入到代码中，但会使用特殊字符将其括起来，告诉计算机不要读取或执行注释。
让我们来看一下添加代码注释的两种方法：单行注释和多行注释。
单行注释
单行注释以两个斜杠 ( // ) 开头。计算机运行时会忽略在 // 右侧同一行上的字符。示例：
Integer i = 1; //This comment will be ignored when the code is run.
多行注释
多行注释以斜杠星号 ( /* ) 开头，并以星号斜杠 ( */ ) 结尾。示例：
Integer i = 1; /*This comment is
ignored when the
code runs*/
备注
在多行注释中，您是否注意到尽管代码跨越多行，但它们都进行了缩进？一致的缩进提高了可读性，是一种重要的最佳实践。
让我们将 Teatime 伪代码转换为注释。为了使代码开发走上正轨，像写大纲一样写伪代码是一种很好的做法。
- 在 Developer Console 中，将多行注释添加到伪代码中。它看起来应该是这样的。
/*Get Utensils and Ingredients Get Teacup Get Spoon Get Tea Kettle Get Teapot Get Tea Get Sugar Boil water in a Tea Kettle Fill Kettle with Water Switch Kettle On Wait for Kettle to Boil Make Tea in Teapot Put Tea in Teapot Put Boiling Water in Teapot Wait 2 Minutes Add Tea and Sugar to Teacup Pour Tea in Teacup Put 1 teaspoon of Sugar in Teacup Stir Tea in Teacup Serve Tea to a Friend*/ public class Teatime { } - 单击 File（文件） | Save（保存）。
在本模块中，您学习了在写 Apex 代码时如何遵循最佳实践。这将为您成为一名出色的开发人员打下基础。
既然您已经涉足了这个领域，就让我们深入探索并开始编码吧。