精通 Salesforce Apex 类：开发者深度解析

九月 26, 2025

大家好，我是一名 Salesforce 开发人员。在 Salesforce 平台上进行定制化开发时，Apex 类是我们手中最强大、最核心的工具。无论是实现复杂的业务逻辑、与外部系统集成，还是为 Lightning 组件提供后端支持，Apex 类都扮演着不可或TAINI的角色。今天，我将从开发者的角度，带大家深入探索 Apex 类的世界，分享其核心原理、实用代码示例以及在实际项目中必须遵循的最佳实践。

背景与应用场景

在 Salesforce 平台中，虽然声明式工具（如 Flow、Validation Rules）能够满足许多业务需求，但总有一些场景需要更灵活、更强大的编程能力来解决。这正是 Apex 的用武之地。Apex 是一种在 Salesforce 多租户架构上执行的、强类型的、面向对象的编程语言，其语法与 Java 非常相似。

而 Apex Classes (Apex 类) 则是 Apex 代码的基本构建单元。它们如同蓝图，定义了对象的属性（变量）和行为（方法）。通过创建和使用 Apex 类，我们可以在 Salesforce 平台上实现几乎任何可以想象到的功能。

常见的应用场景包括：

复杂的业务逻辑实现：当业务规则涉及多个对象、需要进行复杂计算或无法通过标准验证规则实现时，可以使用 Apex Trigger 调用 Apex 类中的方法来处理。
自定义 Web 服务：通过创建暴露为 REST 或 SOAP API 的 Apex 类，允许外部系统安全地与 Salesforce 数据进行交互。
异步处理：对于耗时较长或资源密集型的操作，例如大规模数据清理、调用外部系统的 callout，可以使用异步 Apex（如 Future 方法、Queueable Apex 或 Batch Apex）来避免超出 Governor Limits (治理限制)。
Lightning 组件后端控制器：为 Lightning Web Components (LWC) 或 Aura 组件提供数据查询、处理和持久化的服务器端逻辑。
自定义 Visualforce 控制器：为 Visualforce 页面提供复杂的业务逻辑和数据操作能力。
邮件服务：创建 Apex 类来处理入站电子邮件，并根据邮件内容自动创建或更新 Salesforce 记录。

理解 Apex 类的结构和原理，是成为一名合格的 Salesforce 开发人员的基石。

原理说明

一个 Apex 类是一个模板或蓝图，用于创建对象。它封装了数据和在这些数据上操作的方法。下面我们来分解一个 Apex 类的核心构成部分。

1. 访问修饰符 (Access Modifiers)

访问修饰符定义了类、方法或变量的可见性。

private: 仅在当前类内部可见。这是默认的访问级别。
protected: 对当前类及其子类可见。
public: 在您的应用程序或命名空间 (namespace) 内的任何地方都可见。
global: 对所有 Apex 代码都可见，无论其命名空间如何。通常用于构建对外暴露的 API 或托管包 (managed package) 中的全局方法。

2. 共享关键字 (Sharing Keywords)

这些关键字决定了类的代码在执行时是否遵循当前用户的共享规则。

with sharing: 强制执行当前用户的共享规则。如果用户没有访问某条记录的权限，代码也无法访问。
without sharing: 在系统模式下运行，忽略用户的共享规则。代码可以访问组织内的所有记录。
inherited sharing: 继承调用它的类的共享模式。这是 LWC 控制器的推荐做法。

3. 类定义 (Class Definition)

一个基本的类定义如下：

public with sharing class MyCustomClass {
    // 类的内容在这里
}

4. 变量 (Variables)

也称为成员变量或属性，用于存储对象的状态。它们可以是基本数据类型（如 `String`, `Integer`, `Boolean`），也可以是 sObjects（如 `Account`, `Contact`）或其他 Apex 类的实例。

实例变量 (Instance Variables): 每个类的实例都有自己的一份副本。
静态变量 (Static Variables): 所有类的实例共享同一份副本，属于类本身，而不是某个特定的对象。

5. 方法 (Methods)

方法定义了类的行为。它们是可以在对象上执行的操作。

public String getMessage() {
    return 'Hello, World!';
}

6. 构造函数 (Constructors)

构造函数是一种特殊的方法，用于在创建类的实例（对象）时进行初始化。如果未定义构造函数，系统会提供一个默认的、无参数的构造函数。

public class MyCustomClass {
    String name;

    // 这是一个构造函数
    public MyCustomClass(String inputName) {
        this.name = inputName;
        System.debug('对象已创建，名称为: ' + this.name);
    }
}

示例代码

理论知识需要通过实践来巩固。以下是几个来自 Salesforce 官方文档的示例，展示了 Apex 类的不同用法。

示例 1: 基础的 Apex 类与方法

这个简单的例子展示了一个包含静态方法的工具类。静态方法不需要创建类的实例即可调用，非常适合用于通用的辅助功能。

// EmailManager.cls
// A utility class for sending emails.
public class EmailManager {
    // Public method
    public void sendMail(String address, String subject, String body) {
        // Create an email message object
        Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage();
        String[] toAddresses = new String[] {address};
        mail.setToAddresses(toAddresses);
        mail.setSubject(subject);
        mail.setPlainTextBody(body);

        // Send the email
        Messaging.sendEmail(new Messaging.SingleEmailMessage[] { mail });
    }
}

注释:

第 2 行: 定义了一个名为 `EmailManager` 的 `public` 类。
第 4 行: 定义了一个名为 `sendMail` 的 `public` 方法，它接收三个 `String` 类型的参数：收件人地址、主题和正文。
第 6-12 行: 使用内置的 `Messaging` 类来构建一封 `SingleEmailMessage` 邮件。这是 Salesforce 平台发送单封邮件的标准方式。
第 15 行: 调用 `Messaging.sendEmail` 方法将邮件发送出去。这个操作会消耗一个 Governor Limit。

示例 2: 使用 SOQL 和 DML 操作数据

这是 Apex 类最常见的用途之一：查询数据并进行更新。这个例子展示了如何查询所有年度收入超过指定金额的客户，并更新它们的描述字段。

// AccountManager.cls
public with sharing class AccountManager {
    public static List getAccountsToUpdate(Decimal annualRevenue) {
        // Query for accounts with the specified annual revenue or greater
        List accounts = [SELECT Id, Name, Description FROM Account WHERE AnnualRevenue >= :annualRevenue];
        return accounts;
    }

    public static void updateAccountDescription(List accountsToUpdate) {
        // Bulk update the description for a list of accounts
        for (Account acc : accountsToUpdate) {
            acc.Description = 'This is an updated description for a high-value account.';
        }

        // Perform the DML update operation
        // Use a try-catch block for robust error handling
        try {
            update accountsToUpdate;
        } catch (DmlException e) {
            System.debug('An error occurred during the DML operation: ' + e.getMessage());
            // In a real-world scenario, you would log this error or notify an admin
        }
    }
}

注释:

第 2 行: 使用 `with sharing` 关键字确保该类的代码执行时遵守当前用户的共享规则。
第 3-7 行: `getAccountsToUpdate` 方法使用 SOQL (Salesforce Object Query Language) 查询符合条件的客户记录。注意，查询条件中使用了绑定变量 `:annualRevenue`，这是一种防止 SOQL 注入的安全实践。
第 10-14 行: `updateAccountDescription` 方法接收一个 `Account` 列表。它通过一个 `for` 循环遍历列表，并更新每个客户的 `Description` 字段。这种处理列表的方式被称为“批量化”或 Bulkification，是防止超出 Governor Limits 的关键。
第 18-22 行: 使用 `try-catch` 块来包裹 DML (Data Manipulation Language) 操作 `update`。如果更新过程中发生错误（例如，触发了某个验证规则），程序会捕获 `DmlException` 并进行处理，而不是直接崩溃。

注意事项

在编写 Apex 类时，必须时刻牢记 Salesforce 作为一个多租户平台的特性和限制。

1. Governor Limits (治理限制)

Salesforce 强制执行严格的资源限制，以确保没有单个租户能够独占共享资源。开发者必须在这些限制内编写高效的代码。关键限制包括：

SOQL 查询: 在一个同步事务中，最多执行 100 次 SOQL 查询。
DML 语句: 在一个同步事务中，最多执行 150 次 DML 操作（如 `insert`, `update`, `delete`）。
CPU 时间: 在一个同步事务中，最多消耗 10,000 毫秒的 CPU 时间。
总记录数: DML 操作处理的总记录数不能超过 10,000 条。

⚠️ 避免在循环中执行 SOQL 查询或 DML 语句是防止触达这些限制的最重要原则。

2. 安全与数据共享 (Security & Data Sharing)

始终明确指定共享模式（`with sharing`, `without sharing`, `inherited sharing`）。忽略它会导致类默认以 `without sharing` 模式运行（除非被 `with sharing` 的类调用），这可能导致严重的数据泄露风险，即用户可能会看到或修改他们本不应有权访问的记录。

3. 异常处理 (Error Handling)

永远不要假设你的代码会完美运行。使用 `try-catch` 块来捕获并处理潜在的异常，如 `DmlException`、`QueryException` 等。为用户提供友好的错误提示，并在后端记录详细的错误日志，以便于排查问题。

4. 单元测试 (Unit Testing)

Salesforce 要求 Apex 代码至少有 75% 的测试覆盖率才能部署到生产环境。但这只是最低要求。一个优秀的开发者会力求更高的覆盖率，并编写能够验证各种业务场景（包括正面和负面场景）的断言 (`System.assertEquals()`)。测试类使用 `@isTest` 注解进行标记。

总结与最佳实践

Apex 类是 Salesforce 平台开发的核心。精通它不仅意味着掌握其语法，更重要的是理解其在多租户架构下的运行机制和限制。作为开发者，我们应始终追求编写高效、健壮且安全的代码。

最佳实践清单：

代码批量化 (Bulkify Your Code): 始终假设你的代码会处理多条记录，而不是单条。使用集合（`List`, `Set`, `Map`）来处理数据。
避免在循环中执行 SOQL/DML: 这是性能第一法则。在循环开始前查询所有需要的数据，在循环结束后统一执行 DML 操作。
使用高效的 SOQL 查询: 在 `WHERE` 子句中使用索引字段，避免 `LIKE` 语句中的前导通配符，只查询你需要的字段。
遵循单一职责原则: 让每个类和方法只做一件事，并把它做好。这能让你的代码更易于理解、测试和维护。
明确共享上下文: 总是显式地声明类的共享模式。
编写有意义的测试: 不要只为了覆盖率而写测试。确保你的测试能够真正验证代码的逻辑正确性，并覆盖边界条件和异常情况。
利用静态代码分析工具: 使用如 PMD、Checkmarx 等工具来检查代码质量和潜在的安全漏洞。

通过遵循这些原则和实践，你将能够构建出功能强大、性能卓越且可扩展的 Salesforce 应用，为企业创造真正的价值。

Salesforce中文网