精通 Salesforce 标准对象：面向开发人员的 SOQL 与 DML 深度指南

背景与应用场景

大家好，我是一名 Salesforce 开发人员。在我们的日常工作中，与数据打交道是不可避免的核心环节。而这些数据的基石，就是 Salesforce 平台中的 Standard Objects (标准对象)。Standard Objects 是 Salesforce 预先构建好的数据模型，用于存储核心的客户关系管理 (CRM) 信息，例如 Account (客户)、Contact (联系人)、Opportunity (业务机会)、Lead (潜在客户) 和 Case (个案) 等。

对于 Salesforce 开发人员而言，Standard Objects 不仅仅是数据表。在 Apex 代码中，它们被抽象为 sObjects，成为我们进行业务逻辑开发、数据处理和集成的基本单元。无论是构建一个复杂的业务流程自动化，还是开发一个自定义的 Lightning Web Component 来展示客户信息，我们都离不开对 Standard Objects 的查询、创建、更新和删除操作。例如，当一个销售赢得一个 Opportunity 时，我们可能需要通过 Apex Trigger 自动创建一个关联的 Contract (合同) 记录并更新 Account 的状态。这个过程就深度依赖于对 Opportunity, Account, 和 Contract 这几个 Standard Objects 的程序化操作。

因此，深刻理解如何通过 Apex 高效、安全地操作 Standard Objects，是每一位 Salesforce 开发人员的必备技能。本文将从开发人员的视角，深入探讨使用 SOQL (Salesforce Object Query Language) 和 DML (Data Manipulation Language) 与 Standard Objects 交互的核心原理、代码实践及最佳方案。

---

原理说明

在 Apex 中与 Standard Objects 交互主要依赖两个核心技术：SOQL 和 DML。它们共同构成了 Salesforce 数据操作的基石。

1. sObjects 和 Apex 类的映射

在 Salesforce 平台上，每一个 Standard Object (如 Account) 都对应一个同名的 Apex 类。这意味着我们可以在代码中直接实例化一个对象，并像操作普通类属性一样访问它的字段。例如，Account myAccount = new Account(); 就创建了一个 Account 对象的内存实例。我们可以通过点表示法来设置或获取其字段值，如 myAccount.Name = 'My Test Account'; 或 String accName = myAccount.Name;。这种强类型的映射机制带来了编译时检查的好处，大大减少了运行时因字段名拼写错误等问题导致的 bug。

2. SOQL (Salesforce Object Query Language)

SOQL 是一种专门用于从 Salesforce 数据库中查询记录的语言。它的语法与标准的 SQL 非常相似，但又针对 Salesforce 的多租户架构和对象模型进行了优化。作为开发人员，我们使用 SOQL 来精确地检索我们需要的 Standard Object 记录。

• 基本查询: SELECT Id, Name FROM Account WHERE Industry = 'Technology'
• 关系查询 (Relationship Queries): 这是 SOQL 最强大的特性之一。我们可以轻松地在一次查询中获取父对象或子对象的数据。
  • 子查父 (Child-to-Parent): 通过关系字段（如 Contact 上的 AccountId）的引用，直接获取父对象的字段。例如：SELECT Name, Account.Name FROM Contact。
  • 父查子 (Parent-to-Child): 在父对象的查询中使用内嵌的子查询来获取关联的子记录。例如：SELECT Name, (SELECT LastName FROM Contacts) FROM Account。

在 Apex 中，SOQL 查询可以直接嵌入代码中，并返回一个 sObject 列表 (List) 或单个 sObject。

3. DML (Data Manipulation Language)

DML 是用于在数据库中插入、更新、删除记录的 Apex 语言命令。Salesforce 提供了简单直接的 DML 语句，也提供了功能更强大的 Database 类方法。

• DML 语句: 包括 insert, update, delete, upsert, undelete, merge。这些语句简单易用，但如果其中一条记录处理失败，整个事务将回滚，并抛出一个 DmlException。
• Database 类方法: 如 Database.insert(), Database.update() 等。这些方法提供了一个可选参数 allOrNone。当设置为 false 时，它允许部分记录成功，部分记录失败，而不会导致整个事务回滚。方法会返回一个结果对象数组（如 Database.SaveResult[]），我们可以遍历这个数组来检查每条记录的处理结果，进行精细化的错误处理。

理解并熟练运用 SOQL 和 DML，是高效进行 Salesforce 开发，特别是处理 Standard Objects 的关键。

---

示例代码

以下代码示例均来自 Salesforce 官方文档，旨在展示在实际开发中如何操作 Standard Objects。

示例 1：使用 SOQL 查询 Account 及其关联的 Contacts

这个例子展示了如何使用父查子 (Parent-to-Child) 的关系查询，在一次 SOQL 调用中同时获取 Account 和其下所有 Contact 记录，这是避免多次查询、遵守 Governor Limits 的最佳实践。

// SOQL query to retrieve account records and their related contacts
// 查询 Account 记录及其关联的 Contact 记录
List<Account> acctsWithContacts = [SELECT Id, Name, (SELECT Id, LastName FROM Contacts)
                                 FROM Account
                                 WHERE Name LIKE 'S%'];

// Iterate through the query results
// 遍历查询结果
for (Account a : acctsWithContacts) {
    // Get the account name
    // 获取客户名称
    System.debug('Account: ' + a.Name);

    // Get the list of contacts for this account
    // 获取该客户下的联系人列表
    List<Contact> cons = a.Contacts;
    if (cons.isEmpty()) {
        System.debug('  No contacts for this account.');
    } else {
        // Iterate through the child contacts
        // 遍历子联系人记录
        for (Contact c : cons) {
            System.debug('  Contact: ' + c.LastName);
        }
    }
}

注释：此代码首先执行一个 SOQL 查询，查找所有名称以 'S' 开头的 Account。通过内嵌的 (SELECT Id, LastName FROM Contacts) 子查询，Salesforce 会自动将每个 Account 关联的 Contact 记录填充到 a.Contacts 这个隐式的 List 属性中，极大地简化了数据获取逻辑。

示例 2：批量创建和更新 Standard Object 记录

这个例子演示了 DML 操作的批量化 (Bulkification) 原则。我们先创建一个 Account 列表，然后通过一次 insert 调用将其全部插入，从而高效地利用系统资源并避免触及 DML 限制。

// Create a list of Account sObjects
// 创建一个 Account sObject 列表
List<Account> acctList = new List<Account>();
for(Integer i=0; i<10; i++) {
    // Create a new Account sObject and add it to the list
    // 创建一个新的 Account sObject 并将其添加到列表中
    acctList.add(new Account(Name='Test Account ' + i,
                             BillingState='CA'));
}

// Bulk insert all accounts in the list with one DML call
// 通过一次 DML 调用批量插入列表中的所有客户
Database.SaveResult[] srList = Database.insert(acctList, false);

// Iterate through the results to see if any records failed
// 遍历结果以检查是否有记录失败
for (Database.SaveResult sr : srList) {
    if (sr.isSuccess()) {
        // Operation was successful, so get the ID of the new record
        // 操作成功，获取新记录的 ID
        System.debug('Successfully inserted account. Account ID: ' + sr.getId());
    } else {
        // Operation failed, so get all errors
        // 操作失败，获取所有错误信息
        for(Database.Error err : sr.getErrors()) {
            System.debug('The following error has occurred.');
            System.debug(err.getStatusCode() + ': ' + err.getMessage());
            System.debug('Account fields that affected this error: ' + err.getFields());
        }
    }
}

注释：此代码片段遵循了 Salesforce 开发的最佳实践。它将所有待创建的 Account 对象收集到一个 List 中，然后调用 Database.insert(acctList, false)。使用 Database 类方法并设置第二个参数为 false，可以实现部分成功，并通过返回的 SaveResult 数组对失败的记录进行详细的错误诊断。

---

注意事项

在操作 Standard Objects 时，开发人员必须时刻注意平台的限制和安全要求，以确保代码的健壮性和可扩展性。

1. 权限与安全 (Permissions & Security)

Apex 代码默认在系统模式 (System Mode)下运行，这意味着它会忽略当前用户的对象权限和字段级安全 (Field-Level Security, FLS)。这在某些自动化场景下是必要的，但也可能带来数据安全风险。为了强制执行当前用户的权限，可以在 SOQL 查询中使用 WITH SECURITY_ENFORCED 子句。

// This query will only return fields the user has read access to
// and will throw an exception if the user doesn't have access to any of the queried fields.
// 此查询将只返回用户有权读取的字段，如果用户对任何一个查询字段没有访问权限，则会抛出异常。
List<Account> securedAccounts = [SELECT Id, Name, Phone FROM Account WITH SECURITY_ENFORCED];

此外，在执行 DML 操作前，最好使用 Schema 类的方法（如 SObjectType.Account.isCreateable(), Schema.sObjectType.Account.fields.AnnualRevenue.isUpdateable()）来动态检查用户的权限，从而提供更友好的用户体验和更安全的代码。

2. API 限制 (Governor Limits)

Salesforce 是一个多租户平台，为了保证所有用户共享资源的公平性，对每个执行事务 (Execution Transaction) 都设有严格的资源限制，即 Governor Limits。与 Standard Object 操作最相关的限制包括：

• SOQL 查询总数： 每个事务中最多执行 100 次 SOQL 查询。
• DML 语句总数： 每个事务中最多执行 150 次 DML 操作。
• DML 操作总记录数： 每个事务中通过 DML 操作的记录总数不能超过 10,000 条。

违反这些限制将导致事务失败并抛出 LimitException。避免这种情况的唯一方法就是批量化你的代码：绝不要在循环（如 for 或 while）中执行 SOQL 查询或 DML 语句。始终将数据收集到集合（List, Set, Map）中，进行一次性的批量处理。

3. 错误处理 (Error Handling)

健壮的错误处理是生产级代码的标志。当执行 DML 操作时，总要预备处理可能发生的异常。使用 try-catch 块来捕获 DmlException 是一种基本策略。更高级的策略是使用 Database 类方法，并检查返回的 SaveResult 或 DeleteResult 对象，这样即使在部分记录失败的情况下，你也能精确地知道哪些记录成功、哪些失败以及失败的原因，从而进行记录日志、通知用户或重试等后续操作。

---

总结与最佳实践

Standard Objects 是 Salesforce 平台的核心，作为开发人员，我们的大部分工作都围绕着它们展开。高效、安全地操作这些对象是衡量我们专业水平的重要标准。以下是一些关键的最佳实践总结：

1. 永远批量化你的代码 (Always Bulkify Your Code): 这是 Salesforce 开发的第一法则。永远不要在循环中放置 SOQL 或 DML。始终使用集合来处理多条记录。

2. 查询所需的最少字段 (Query Only What You Need): 在 SOQL SELECT 语句中，只指定你业务逻辑中确实需要用到的字段。避免使用 SELECT *（SOQL 根本不支持），因为查询过多字段会增加查询时间和堆内存消耗。

3. 善用关系查询 (Leverage Relationship Queries): 优先使用 SOQL 的父子和子父关系查询，在一次调用中获取相关数据，以减少 SOQL 查询次数。

4. 编码时考虑安全性 (Code with Security in Mind): 根据业务需求，决定是使用系统权限还是用户权限。必要时使用 WITH SECURITY_ENFORCED 或 Schema 可访问性检查来强制执行数据安全策略。

5. 实施稳健的错误处理 (Implement Robust Error Handling): 使用 try-catch 块，并优先考虑使用 Database 类方法来处理 DML 结果，为用户提供清晰的反馈，并确保数据完整性。

遵循这些原则，你将能够编写出不仅能完成功能，而且性能优异、安全可靠、易于维护的 Apex 代码，从而在 Salesforce 开发的道路上走得更远。