自定义控制器简介

您可能还了解过 Visualforce 如何支持构建 Web 应用程序的模型–视图–控制器 (MVC) 设计模式。控制器通常检索要在 Visualforce 页面中显示的数据，并包含响应页面操作（如单击按钮）的代码。当您使用标准控制器时，平台会为您提供大量的 标准 功能。

毕竟众口难调，并非所有 Web 应用程序都是标准的。当您想要覆盖现有功能、通过应用程序自定义导航、使用调用或 Web 服务，或者需要更好地控制访问页面信息的方式时，借助 Visualforce，这一切都游刃有余。您可以使用 Apex 编写自定义控制器，并从头到尾完全控制应用程序的逻辑。

创建使用自定义控制器的 Visualforce 页面

当页面使用了自定义控制器时，不能再使用标准控制器。页面使用不同的属性来设置自定义控制器。

<apex:page controller="ContactsListWithController">
    <apex:form>
        <apex:pageBlock title="Contacts List" id="contacts_list">
            <!-- Contacts List goes here -->
        </apex:pageBlock>
    </apex:form>
</apex:page>

有很多系统和实用程序类可以帮助您编写自定义控制器逻辑，但是将类用作自定义控制器的唯一 要求 是这个类必须存在。

public class ContactsListWithController {
    // Controller code goes here
}

乍一看，您创建的这两个新项目似乎不是很有趣。但即便这两个项目 90% 都是占位符代码，Visualforce 页面和 Apex 控制器还是相互链接的。一旦向控制器添加更多代码，您的页面就可以使用控制器。

您可能已经注意到，这个自定义控制器类没有继承另一个类，也不承诺实现符合 Visualforce 控制器要求的接口。即使是复杂的控制器也不会执行这些操作，因为没有任何这样的类可以继承或实现接口。随着对 Apex 的逐步了解，您可以自由地创建自己的类和接口。

添加检索记录的方法

创建运行 SOQL 查询的 getter 方法，返回页面上显示的记录。

大多数控制器的主要目的是检索显示的数据，或处理数据更新。在这个简单的控制器中，您需要做的就是运行一个基础的 SOQL 查询来查找联系人记录，然后将这些记录提供给 Visualforce 页面。

private String sortOrder = 'LastName';
public List<Contact> getContacts() {
    List<Contact> results = Database.query(
        'SELECT Id, FirstName, LastName, Title, Email ' +
        'FROM Contact ' +
        'ORDER BY ' + sortOrder + ' ASC ' +
        'LIMIT 10'
    return results;
}

在 ContactsListWithController 页面中，将 <！--Contacts List goes here--> 注释行替换为以下标记。

<!-- Contacts List -->
<apex:pageBlockTable value="{! contacts }" var="ct">
    <apex:column value="{! ct.FirstName }"/>
    <apex:column value="{! ct.LastName }"/>
    <apex:column value="{! ct.Title }"/>
    <apex:column value="{! ct.Email }"/>
</apex:pageBlockTable>

当您保存此页面时，您应该会看到一个熟悉的联系人信息表。

ContactsListWithController 页面的标记看起来应该很熟悉。除了 <apex:page> 标签的 controller 属性以外，它与您使用标准控制器创建页面时使用的代码几乎相同。

区别在于评估 {! contacts } 表达式时返回的结果。在该页面上，Visualforce 将表达式转换为对控制器的 getContacts() 方法的调用。该方法返回联系人记录列表，这正符合 <apex:pageBlockTable> 的预期。

getContacts() 方法称为 getter 方法，这是一种通用模式，其中 Visualforce 标记中的 {! someExpression } 自动连接到控制器中名为 getSomeExpression () 的方法。这是页面访问需要显示的数据的最简单方法。

在自定义控制器中创建操作方法以响应页面上的用户输入。

显示数据固然重要，但对任何网页应用来说，响应用户行为都是必不可少的。借助自定义控制器，您可以通过编写操作方法来响应用户活动，在页面上创建大量的自定义操作。

public void sortByLastName() {
    this.sortOrder = 'LastName';
public void sortByFirstName() {
    this.sortOrder = 'FirstName';
}

<apex:column value="{! ct.FirstName }">
    <apex:facet name="header">
        <apex:commandLink action="{! sortByFirstName }"
            reRender="contacts_list">First Name
        </apex:commandLink>
    </apex:facet>
</apex:column>
<apex:column value="{! ct.LastName }">
    <apex:facet name="header">
        <apex:commandLink action="{! sortByLastName }"
            reRender="contacts_list">Last Name
        </apex:commandLink>
    </apex:facet>
</apex:column>

新标记向每个 <apex:column> 组件添加了两个嵌套组件。 <apex:column> 本身有一个纯文本标题，但我们想让标题变成可点击的效果。 <apex:facet> 允许我们自定义列标题的内容。我们想要的是一个调用正确操作方法的链接。链接是使用 <apex:commandLink> 组件创建的，将 action 属性设置为引用控制器中操作方法的表达式。（请注意，与 getter 方法相比，操作方法名称与引用操作方法的表达式相同。）

单击链接会触发控制器中的操作方法。操作方法更改私有变量的排序，然后重新显示表。重新显示表时，会重新评估 {! contacts } ，通过刚设置的排序重新运行查询。最终结果是按照用户点击请求的顺序重新排列表格。

名字和姓氏列的标题文本在此标记中是硬编码。但是，如果您的用户并非都使用英文怎么办？标准 Salesforce 用户界面具有所有标准对象字段名称的翻译版本，您可以为自定义对象提供自己的译文。如何访问字段名称的翻译版本？不是纯文本，试试这个标记 <apex:outputText value="{! $ObjectType.Contact.Fields.FirstName.Label }"/> 。这是引用字段标签的正确方法，即使您的组织都使用相同的语言，如果更改了字段名称，字段标签也会自动更新。

了解详细信息...

自定义控制器和 Apex 语言让您可以在 Visualforce 页面中执行任何您能想到的事情。

getter 方法将数据从控制器提取到页面。相应的 setter 方法可将值从页面提交回控制器。与 getter 方法一样，setter 方法也使用“set”前缀。此外，这两种都只是带实际参数的方法。

getter 和 setter 的替代方法是使用 Apex 属性。属性是变量与 getter 和 setter 方法的组合，其语法可以更清楚地将它们组合在一起。引用自定义对象的简单属性可以这样声明。

public MyObject__c myVariable { get; set; }

通过省略 get 或者 set，属性可以是公共的或私有的，也可以是只读的，甚至是只写的。除了简单地保存和检索值之外，还可以为 get 或 set 方法创建实现。

属性是 Apex 的通用功能，并非 Visualforce 所特有。Apex 是一种完整的编程语言，它不仅是构建复杂 Visualforce 页面的天然合作伙伴，还用于多种 Lightning 平台开发环境。请参阅此处汇总的 Apex 主题，以及本页面末尾的资源，深度学习 Apex 的多种使用方法。