在Apex中使用sObject

sObject对象的定义

Salesforce中的标准对象或自定义对象在Apex中使用时被称作“sObject”。sObject对象的一个实例相当于Salesforce中的一条记录。

比如：Account代表了“客户”对象，Contact代表了“联系人”对象。

在Apex中使用sObject对象

用new关键字可以建立sObject对象，并初始化某些字段。

Account acc = new Account(Name='test name', NumberOfEmployees=200);

在代码中可以用“.”来连接对象和字段。

Account acc = new Account();

acc.Phone = '12345678';
acc.Name = 'test name';

API名字

每个对象和字段都有一个唯一的名字，这个名字被称为API名字（API Name）。

比如“客户”的API名字是“Account”，“名字”字段的API名字是“Name”，“创建人”字段的API名字是“CreatedBy”。

后缀

对于自定义对象和字段，它们的API名字必须以“__c”结尾。

比如：有一个“地址”自定义对象，其API名字是“Address__c”而不能是“Address”

当一个字段的类型是自定义关系类型，那么该字段的后缀不用“__c”，而用“__r”。

对于外部对象，其API名字以“__x”结尾。

sObject泛型

所有的对象都是sObject类型，所以当创建任何一个对象时，可以声明为sObject类型。

sObject obj1 = new Account();
sObject obj2 = new Student__c();

上面的代码建立了一个“Account”（标准对象）和“Student__c”（自定义对象）实例。

sObject类型可以转换为某一对象类型，反之则不行。

另外，新建sObject类型的实例只能通过函数newSObject()，而不能通过new关键字。

sObject sObj = Schema.getGlobalDescribe().get('Account').newSObject();
// 这里还是需要声明创建的sObject类型，比如这里的“Account”

// sObject obj = new sObject(); // 错误的用法

sObject的权限

一般情况下，Apex代码在运行时是不考虑当前用户对对象和字段的权限的，匿名代码段除外。

如果想让Apex代码在执行的时候考虑当前用户的权限，可以调用Schema.DescribeSObjectResult和Schema.DescribeFieldResult类中的功能。

代码示例

// 使用Schema.DescribeSObjectResult类的方法来检查
Schema.DescribeSObjectResult objectDescribe = Example_Object__c.SObjectType.getDescribe();

// 检查该对象是否可以被创建
Boolean isCreateable = objectDescribe.isCreateable();

// 检查该对象是否可以被更新
Boolean isUpdateable = objectDescribe.isUpdateable();

// 检查当前用户对该对象是否有权限
Boolean isAccessible = objectDescribe.isAccessible();

// 检查该对象是否可以被删除
Boolean isDeletable = objectDescribe.isDeletable();

// 直接用Schema.SObjectType来检查
Boolean isCreateable = Schema.SObjectType.Example_Object__c.isCreateable();
Boolean isUpdateable = Schema.SObjectType.Example_Object__c.isUpdateable();
Boolean isAccessible = Schema.SObjectType.Example_Object__c.isAccessible();
Boolean isDeletable = Schema.SObjectType.Example_Object__c.isDeletable();

// 使用Schema.DescribeFieldResult类的方法来检查
Schema.DescribeFieldResult fieldDescribe = Example_Object__c.SObjectType.fields.Example_Field__c.getDescribe();

Boolean isCreateable = fieldDescribe.isCreateable();
Boolean isUpdateable = fieldDescribe.isUpdateable();
Boolean isAccessible = fieldDescribe.isAccessible();

// 直接使用Schema.sObjectType来检查
Boolean isCreateable = Schema.sObjectType.Example_Object__c.fields.Example_Field__c.isCreateable();
Boolean isUpdateable = Schema.sObjectType.Example_Object__c.fields.Example_Field__c.isUpdateable();
Boolean isAccessible = Schema.sObjectType.Example_Object__c.fields.Example_Field__c.isAccessible();