在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();