Salesforce Apex 类深度解析：开发者综合指南

十一月 28, 2025

作为一名 Salesforce 开发人员 (Salesforce Developer)，Apex 类是我们日常工作中不可或缺的核心构建块。无论是处理复杂的业务逻辑、与外部系统集成，还是为 Lightning 组件提供后端支持，Apex 类都扮演着至关重要的角色。本文将从开发人员的视角，深入探讨 Apex 类的基本原理、应用场景、代码实践以及在企业级项目中需要遵循的最佳实践，旨在为初学者提供清晰的指引，也为有经验的开发者提供一份备忘和参考。

背景与应用场景

在 Salesforce 平台中，管理员可以通过大量的声明式工具（如 Flow、校验规则、批准过程）来实现丰富的业务自动化。然而，当业务需求变得高度复杂、需要精细化的数据处理或与外部系统进行实时交互时，声明式工具便会显得力不从心。这时，我们就需要借助编程的方式来扩展平台的能力，而 Apex 就是 Salesforce 提供的强类型、面向对象的编程语言。

Apex Classes (Apex 类) 是 Apex 语言的基本组织单元，它们是创建对象 (Object) 的蓝图。一个类封装了数据（以成员变量的形式）和行为（以方法的形式）。理解并熟练运用 Apex 类，是成为一名合格 Salesforce 开发人员的基石。其主要应用场景包括：

1. 复杂的业务逻辑实现

当业务逻辑涉及跨多个对象的复杂计算、需要精密的条件判断或无法通过公式字段或 Flow 实现的算法时，Apex 类是唯一的选择。例如，在创建订单时，需要根据客户等级、历史购买记录、产品库存和实时促销活动动态计算折扣。

2. 自定义 Web 服务

通过使用 @RestResource 或 @WebService 注解，我们可以将 Apex 类暴露为 REST 或 SOAP API 端点，允许外部系统（如 ERP、移动应用）安全地访问和操作 Salesforce 中的数据。

3. 后端控制器

Apex 类是 Visualforce 页面 和 Aura/Lightning Web Components (LWC) 的后端数据和服务提供者。前端组件通过调用 Apex 控制器中的方法来查询数据（如 @AuraEnabled(cacheable=true)）或执行 DML 操作。

4. 异步处理

对于耗时较长或需要处理大量数据的操作，为了不阻塞用户界面并避免超出 Governor Limits (执行限制)，我们会使用异步 Apex。这包括：Batch Apex（用于处理海量数据）、Queueable Apex（用于解耦和链式调用异步任务）、Schedulable Apex（用于定时执行任务）和 Future Methods（用于简单的异步调用，如外部 API Callout）。这些异步模式都是通过实现特定的接口或使用特定注解的 Apex 类来完成的。

5. Trigger 业务逻辑处理

虽然业务逻辑的入口是 Trigger，但最佳实践是保持 Trigger 文件本身轻量化，仅用于事件分发。实际的、复杂的处理逻辑应全部封装在专门的 Apex 类（通常称为 Trigger Handler 或 Service Class）中，以提高代码的可维护性、可重用性和可测试性。

原理说明

要深入理解 Apex 类，我们需要掌握其核心的 Object-Oriented Programming (面向对象编程, OOP) 概念和 Salesforce 平台特有的关键字。

1. 类的定义与结构

一个 Apex 类由访问修饰符、类名、可选的共享关键字以及类主体组成。类主体中包含变量、构造函数和方法。

访问修饰符 (Access Modifiers):

private: 仅在当前类内部可见。这是最严格的访问级别。
protected: 对当前类以及所有继承该类的子类可见。
public: 在您的应用程序或命名空间 (namespace) 内的任何地方都可见。
global: 对所有 Apex 代码都可见，无论其命名空间如何。通常用于开发托管包 (Managed Package) 或定义供外部调用的 Web 服务。

共享关键字 (Sharing Keywords):

这是 Salesforce 平台的一个关键安全特性，它决定了类的代码在执行时是否遵循当前用户的记录级共享规则。

with sharing: 强制执行当前用户的共享规则。如果用户没有访问某条记录的权限，代码也无法访问。这是默认行为（如果类被 Trigger 或其他 `with sharing` 类调用）。
without sharing: 在系统模式下运行，忽略用户的共享规则。代码可以访问组织内的所有相关记录，但仍然受限于对象的 CRUD/FLS 权限。
inherited sharing: 继承调用它的类的共享模式。这是推荐用于通用工具类或 Handler 类的方式，以使其行为更具可预测性。

2. 成员变量与方法

变量用于存储对象的状态，而方法定义了对象的行为。它们可以是实例级别的（每个对象实例都有一份拷贝），也可以是静态的（属于类本身，所有实例共享）。

static 关键字表示该变量或方法属于类，而不是类的某个特定实例。可以直接通过类名调用，例如 `MyClass.myStaticMethod()`，无需先创建类的实例。

3. 构造函数 (Constructors)

构造函数是一种特殊的方法，用于在创建类的实例时进行初始化。它的名称必须与类名完全相同，并且没有返回类型。如果未定义任何构造函数，系统会提供一个默认的、无参数的公共构造函数。

示例代码

以下是一个来自 Salesforce 官方文档的经典示例，展示了一个名为 `EmailManager` 的公共类。这个类包含一个公共方法，用于向指定的联系人列表发送邮件。这个例子很好地展示了类的定义、方法、参数、DML 操作以及异常处理。

// A class that contains a method to send email.
public class EmailManager {
    // Public method
    public void sendMail(String[] toAddresses, String[] subjects, String[] messages) {

        // Create a new list of SingleEmailMessage objects
        Messaging.SingleEmailMessage[] mails = new Messaging.SingleEmailMessage[0];

        for (Integer i = 0; i < toAddresses.size(); i++) {
            // Create a new SingleEmailMessage object.
            // This object is a single email that will be sent.
            // It contains all the information for the email,
            // such as the recipient, sender, subject, and body.
            Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage();

            // Set the destination addresses.
            mail.setToAddresses(new String[] {toAddresses[i]});

            // Set the subject.
            // The subject can only be plain text.
            mail.setSubject(subjects[i]);

            // Set the text body.
            mail.setPlainTextBody(messages[i]);
            
            // Add the email to the list of emails.
            mails.add(mail);
        }

        // Send all emails in the list
        try {
            Messaging.sendEmail(mails);
        } catch (Exception e) {
            System.debug('An exception occurred: ' + e.getMessage());
        }
    }
}

代码注释详解

public class EmailManager: 定义了一个名为 `EmailManager` 的公共类，这意味着在当前命名空间下的任何其他 Apex 代码都可以访问它。

public void sendMail(...): 定义了一个名为 `sendMail` 的公共方法。`void` 表示该方法不返回任何值。它接收三个参数：`toAddresses`（收件人地址数组）、`subjects`（主题数组）和 `messages`（邮件正文数组）。这种设计支持批量发送邮件。

Messaging.SingleEmailMessage[] mails = ...: 初始化一个 `SingleEmailMessage` 类型的列表。这是 Salesforce 中用于构建单封邮件的内置对象。

for (...) loop: 循环遍历传入的地址、主题和正文数组，为每一封邮件创建一个 `Messaging.SingleEmailMessage` 实例。

mail.setToAddresses(...), mail.setSubject(...), mail.setPlainTextBody(...): 设置邮件的各个属性，包括收件人、主题和纯文本正文。

mails.add(mail): 将构建好的邮件对象添加到一个列表中。这是一个非常重要的最佳实践——批量化处理。我们不是每构建一封邮件就发送一次，而是将它们全部收集起来，最后统一发送。

try { ... } catch (Exception e) { ... }: 使用 `try-catch` 块来包裹 `Messaging.sendEmail(mails)` 这个 DML 操作。`sendEmail` 方法可能会因为无效的邮箱地址、超出每日邮件发送限制等原因而抛出异常。通过 `try-catch`，我们可以捕获这些异常，记录错误信息（如此处的 `System.debug`），并防止整个事务因异常而回滚，从而使程序更加健壮。

注意事项

1. Governor Limits (执行限制)

Salesforce 是一个多租户平台，为了保证所有用户共享资源的公平性，对 Apex 代码的执行有严格的限制。例如，单个事务中 SOQL 查询不能超过 100 次，DML 操作不能超过 150 次。作为开发者，必须时刻牢记这些限制，并编写“批量化”的代码。绝对禁止在循环中执行 SOQL 查询或 DML 操作，这通常是导致超出限制的罪魁祸首。

2. 安全与共享

始终明确指定类的共享模式（`with sharing`, `without sharing`, or `inherited sharing`）。不指定共享模式的类在运行时行为可能不确定，这会带来安全风险。对于需要访问用户无权访问的数据的后台进程，可以使用 `without sharing`，但必须谨慎，并确保逻辑是安全的。此外，在返回数据给 LWC 或处理用户输入时，应手动检查字段级安全 (Field-Level Security, FLS) 和对象权限，可以使用 `Schema` 类中的 `isAccessible()`、`isUpdateable()` 等方法。

3. Apex 测试

为了确保代码质量和平台稳定性，Salesforce 强制要求所有部署到生产环境的 Apex 代码（Triggers 和 Classes）必须有至少 75% 的代码覆盖率。每个类都应有对应的测试类（使用 `@isTest` 注解），测试类需要覆盖代码的各种逻辑分支，包括正面场景、负面场景（如传入空值）和边界条件。测试还应验证代码是否能够正确处理批量数据。

4. 异常处理

健壮的 Apex 代码必须包含完善的异常处理机制。对于任何可能失败的操作，如 DML、SOQL（查询不到记录时会抛出异常）或 API Callout，都应使用 `try-catch` 块进行包裹。在 `catch` 块中，应记录详细的错误信息，并根据业务需求决定是向用户显示友好的错误提示，还是执行其他回退逻辑。

总结与最佳实践

Apex 类是 Salesforce 平台定制开发的核心，它赋予了我们超越声明式工具的强大能力。作为一名专业的 Salesforce 开发人员，我们不仅要掌握其语法，更要理解其背后的设计哲学和平台限制。

核心最佳实践包括：

1. 遵循单一职责原则: 每个类应该只负责一件事情。例如，创建一个专门处理客户业务逻辑的 `AccountService` 类，一个专门用于与外部系统集成的 `ERPIntegrationService` 类。这使得代码更易于理解、维护和测试。

2. 代码批量化: 始终假设你的代码会处理成百上千条记录，而不是单条。在方法签名中使用 `List` 或 `Map` 等集合类型，并确保所有数据处理逻辑都是批量安全的。

3. 避免硬编码 ID: 切勿在 Apex 代码中直接写入记录 ID、URL 或其他环境特定的值。应使用自定义元数据、自定义设置或通过 SOQL 查询动态获取这些值，以保证代码在不同环境（如沙箱和生产）之间的可移植性。

4. 采用分层设计: 对于复杂的应用，可以考虑采用分层架构，如服务层（Service Layer）、领域层（Domain Layer）和选择器层（Selector Layer），将业务逻辑、数据查询和对象行为清晰地分离开来，提升代码的可扩展性和可维护性。

5. 编写有意义的注释和文档: 你的代码不仅是写给机器执行的，更是写给未来的你和其他同事看的。为复杂的方法和逻辑块添加清晰的注释，并遵循统一的命名规范，将极大地提高团队的协作效率。

通过遵循这些原则和实践，我们可以编写出高效、健壮且可维护的 Apex 代码，从而真正发挥 Salesforce 平台的强大威力，为企业交付卓越的业务解决方案。

Salesforce中文网