編寫SOQL查詢
SOQL代表Salesforce Object Query Language, 用它來直接讀取記錄. SOQL可以說是Force.com上面的SQL語句 。由於Apex能直接訪問salsforce數據庫中的記錄,所以可以直接在apex代碼中嵌入SOQL查詢並獲得查詢結果。只要用方括號將查詢語句包起來,然后把返回值賦予一個Sobject對象的數組即可。比如下面的例子,獲取所有的客戶的名稱和電話:
Account[] accts = [SELECT Name,Phone FROM Account];
Developer Console提供了Query Editor console, 可以用來運行SOQL查詢並查看結果。
跟SQL語句不同的是,SOQL中不支持使用Select * 來獲取所有字段,必須要寫出所有你要拿的字段(除了ID,ID是默認拿的),
where的使用則跟SQL一樣, %代表零個,一個或多個字母,_則代表一個字母。
SELECT Name,Phone FROM Account WHERE (Name like 'SFDC%' OR (NumberOfEmployees>25 AND BillingCity='Los Angeles'))
在Apex的SOQL查詢中使用變量
SOQL語句在Apex中可以使用變量,只要在其表達式前面加上冒號,在SOQL語句中使用本地的變量的行為叫做‘綁定’。
下面的例子顯示在where中使用targetDepartment 變量:
String targetDepartment = 'Wingo'; Contact[] techContacts = [SELECT FirstName,LastName FROM Contact WHERE Department=:targetDepartment];
查詢Related對象的記錄
Salesforce中的記錄可以通過兩種關系聯系在一起:Lookup和Master-detail。你能在UI(相關列表)中查看related記錄,那你也能在SOQL中查詢它們。
要獲取parent記錄下面的child記錄,就需要使用內查詢。From要用關系的名稱而不是對象的名稱,下面的例子中Contact正好是客戶和聯系人的關系的名稱:
SELECT Name, (SELECT LastName FROM Contacts) FROM Account WHERE Name = 'SFDC Computing'
通過名稱和點可以在子對象(child)上面訪問母對象的字段
Contact[] cts = [SELECT Account.Name FROM Contact WHERE FirstName = 'Carol' AND LastName='Ruiz']; Contact carol = cts[0]; String acctName = carol.Account.Name; System.debug('Carol\'s account name is ' + acctName);
用SOQL 的For循環批量查詢記錄
for (variable : [soql_query]) { code_block }
for (variable_list : [soql_query]) { code_block }
第二種使用的對象列表,每一次批量執行200條記錄然后再執行DML操作,這樣做的話能更好的避免受到管理限制。具體參考下面的例子:
insert new Account[]{new Account(Name = 'for loop 1'), new Account(Name = 'for loop 2'), new Account(Name = 'for loop 3')}; // The sObject list format executes the for loop once per returned batch // of records Integer i=0; Integer j=0; for (Account[] tmp : [SELECT Id FROM Account WHERE Name LIKE 'for loop _']) { j = tmp.size(); i++; } System.assertEquals(3, j); // The list should have contained the three accounts // named 'yyy' System.assertEquals(1, i); // Since a single batch can hold up to 200 records and, // only three records should have been returned, the // loop should have executed only once