Apex简介
Apex特点
Salesforce为开发者提供了Apex语言。它是一种语法上类似于Java的编程语言,有以下特点:
- 面向对象
- 完全在云端处理,包括保存、编译、执行
- 强类型
- 大小写不敏感(这一点和其他大部分语言不一样)
Apex的数据类型
Apex中的数据类型分为以下几种:
- 基本类型。比如整形(Integer),双精度类型(Double),字符串类型(String),布尔值(Boolean),小数类型(Decimal),ID类型等
- sObject类型。这是Salesforce特有的一种类型,系统中的对象都是继承自sObject类型,比如Account(客户)、Opportunity(机会),还包括各种自定义对象,它们的API名字都以“__c”结尾,比如“Example_Object__c”
- 集合类型。包括了列表(List),集合(Set),地图(Map)等
- 枚举类型
基本类型中要注意的地方
-
Boolean类型的值可以是true、false或null
-
Date(日期)和Datetime(日期时间)是两种不同的类型。这两个类型的变量必须使用系统提供的静态方法来创建(比如:DateTime.newInstance())。Date类型的数学运算只限于增减Integer类型的值,Datetime类型的数学运算只限于增减Intger或Double类型的值。两个或更多这些类型的变量之间无法直接进行数学运算,必须使用系统提供的Date或Datetime类的静态方法
-
在Salesforce中可以定义Currency(货币)类型的字段,这些字段中包含的值默认是Decimal(小数)类型
-
ID类型是Salesforce特有的一个基本类型,由18个大小写不敏感的字符组成。ID类型也有包含15个字符的,这时其值是大小写敏感的
-
String类型的值在Apex中只能使用单引号(')表示,不能使用双引号("),比如:'Hello World!',而非:"Hello World!"
集合类型的初始化语法
// List类型
List<String> exampleList = new List<String>();
List<String> exampleList = new List<String> {'Hello', 'World'};
List<String> exampleList = new String[20];
String[] exampleList = new String[20];
// Set类型
Set<String> exampleSet = new Set<String>();
Set<String> exampleSet = new Set<String> {'Hello', 'World'};
// Map类型
Map<ID, Set<String>> exampleMap = new Map<ID, Set<String>>();
Map<String, String> MyStrings = new Map<String, String> {'a' => 'b', 'c' => 'd'.toUpperCase()};
列表类型List
List类型是最常用的一种集合类型,和数组等价,可以相互转换。
用add()函数可以向列表中添加元素:
List<String> shapes = new List<String> { 'circle', 'rectangle', 'triangle' };
shapes.add('square');
从列表中读取元素可以通过索引的方式,每个列表的索引都是从0开始。
读取元素可以直接用方括号加索引,或者用get()函数加索引:
String shape1 = shapes[0];
String shape2 = shapes.get(1);
for(Integer i=0; i<shapes.size(); i++) {
// 将内容输出到控制台
System.debug(shapes[i]);
}
集合类型要注意的部分
- Set类型中每个元素必须唯一,所以Set类型的变量可以使用contains()函数来检查是否包含某元素,比如:
Set<String> exampleSet = new Set<String> {'a', 'b'};
Boolean result1 = exampleSet.contains('a'); // result1为真
Boolean result2 = exampleSet.contains('c'); // result2为假
-
Map类型的键值(Key)可以是null值
-
当向Map类型变量中增加值时,如果对应的键值已经存在,则新的值会覆盖原有的值。比如:
Map<String, String> exampleMap = new Map<String, String> {'a' => 'b', 'c' => 'd'};
String result1 = exampleMap.get('a'); // result1的值为'b'
exampleMap.put('a', 'e');
String result2 = exampleMap.get('a'); // result2的值为'e'
- 当Map类型的键值为String类型时,所有键值都是大小写敏感的(这一点和Apex本身的特点不一样)
常量定义
Apex中使用final关键字定义常量,比如:
public class ExampleClass {
public static final Integer EXAMPLE_INT_CONST = 200;
}
类型转换
Apex中默认是要求显式类型转换的,比如Integer类型不能直接转换为String类型,而需要使用String类的format()函数。
但是有一些例外:
- 对于Integer,Long,Double,Decimal四种数值类型,它们形成了一组由低到高的类型层次,所以低层次类型的变量可以自动赋值给高层次类型的变量,比如:
Integer i = 10;
Long l = i;
Double d = l;
Decimal decm = d;
- ID类型可以使用String类型赋值。但是在运行时,系统会自动检测String类型的值是否是合法的ID值,如果不是,则会抛出异常。比如:
String exampleString = 'abcde';
ID exampleId = exampleString; // 运行时会提示异常,因为字符串的值不是合法的ID类型的值
- instanceOf()函数可以用来检查一个字符串是否符合某对象的ID类型,比如:
String str = 'abcde';
Boolean result = str instanceOf Account; // 检查字符串str的值是否代表了一个合法的Account对象的ID。这种情况下result的值为假
Apex的类(Class)
和大部分编程语言一样,Apex中可以定义类。类的内部可以定义函数和变量,也可以通过public等关键字控制访问权限。
public class Student {
public String name;
private String studentNumber;
public String showName() {
return name;
}
public String getNumber() {
return studentNumber;
}
private void setNumber(String num) {
studentNumber = num;
}
}
在Apex中,类和类中的方法默认都是private的。如果想让它们变为公有,必须添加public关键字。
类的扩展
使用extends关键字可以扩展类,比如:
public class BaseClass {
...
}
public class ExtendedClass extends BaseClass {
...
}
共享关键字
在Apex中,每一个类都可以添加共享关键字,即“with sharing”和“without sharing”。
当加入了“with sharing”关键字后,在用户执行该类的时候,系统会参照当前用户的共享权限来决定代码是否执行成功。如果用户对于代码中涉及到的对象、字段没有权限,则该代码会执行失败。
匿名代码段
一个例外的情况是当代码在匿名代码段(Anonymous Blocks)执行的时候,“with sharing”关键字不起作用。匿名代码段可以通过以下方式执行:
- Developer Console
- executeAnonymous() SOAP API 方法
- Force.com IDE
注意,执行匿名代码段的用户必须获得“Apex作者(Author Apex)”的权限。
与此相反,“without sharing”关键字则声明了当前用户的共享权限对于该段代码没有作用。
嵌套类
共享关键字只会影响到当前的类,不会影响到嵌套类。它们可以独立的声明共享规则。比如:
public with sharing OuterClass {
...
public without sharing InnerClass {
...
}
}
在上面的代码段中,外层类OuterClass和嵌套类InnerClass的共享设定是不同的,它们相互独立。
Apex的逻辑语句
在Apex中也有着各种逻辑语句,比如“if...else”、“for”、“while”和“do...while”。
有一点要注意的是,截至本文的时间(Apex版本v41.0),在Apex中没有“switch”语句。
Developer Console简介
Salesforce中的Developer Console是默认的集成开发环境,用来进行Apex和数据库的编程和操作。
在Salesforce中主界面点击右上角的用户名菜单,在下拉列表中点击“Developer Console”。
建立新的Apex类
在Developer Console主界面,点击“File”,指向“New”,在子菜单中选择“Apex Class”。在弹出的对话框中输入类名,即可建立新的Apex类。
在中间的编辑区域即可对类进行编辑。
控制台
界面下方的区域是控制台,可以查看日志(Log)、运行测试(Tests)、进行数据查询(Query Editor)等。