2007/10/10のコア開発者向けセミナー資料です

1. 株式会社セールスフォース･ドットコム ビジネス開発本部 Apex コア開発者向けセミナー ～ Apex コード編 ～

2. 本セミナーの内容 Apex コードの概要 Apex コードの文法 トリガの作成 Web サービスの公開 デバッグ、テスト、配備 参考： Visualforce

3. Apex コード Your Code Our Servers Integer NUM = 10; Account[] accs; // Clean up old data accs = [select id from account where name like 'test%']; delete accs; commit; accs = new Account[NUM]; for (Integer i = 0; i < NUM; i++) { accs[i] = new Account(name='test ' + i, outstandingshares__c=i); } insert accs; Contact[] cons = new Contact[0];

4. Force.com プラットフォームにおけるコンポーネント プラットフォーム データベース ユーザインターフェース ビジネスロジック

5. Apex コードの基本 オンデマンド型のプログラミング言語 Salesforce サーバ上でネイティブに動作する ロジックの記述にフォーカスしている ユーザインターフェースからは、ボタンやイベント、 API などを介してアクセスする 特徴 Java に類似した構文 ストアド・プロシージャ的な言語スコープ 強い型付けと依存関係のメタデータ保存 マルチテナント環境での動作を前提とするリソース管理 単体テストのサポート

6. トリガ レコードの作成、更新、削除などのイベントで駆動されるロジックを記述 クラスを呼び出し可能 クラス Java のクラスに類似 WebService 修飾子でカスタム Web サービスとしてロジックを公開 Apex コードの種類 global class HelloWorld2 { // パブリック WebService メソッドにするときは、キーワード WebService を付ける WebService static String sayHelloWorld(String arg) { return 'Hello '+arg; } } trigger helloWorldAccountTrigger on Account (before insert) { Account[] accs = Trigger.new; MyHelloWorld.addHelloWorld(accs); }

7. Summer’07 で何が新しくなった？ 1.0 言語仕様ファイナル クラス（“パッケージ”から変更）、正規表現、バルクトリガ、暗黙的トランザクション テストおよびコードの移行 Salesforce.com の UI からテスト可能 開発組織から他の組織へのデプロイのサポート Eclipse チーム開発のサポート 外部 Web サービス呼び出し（ Salesforce SOA ） 3rd party の Web サービスを Apex コードのクラスから呼び出し可能

8. Apex コードの文法

9. Apex コードと Java の類似点、相違点 類似点 制御構文（ if else, for, while ） イテレーション , ジェネリクス（ Java5 ） 正規表現クラス 相違点 変数、関数名は大文字小文字を区別しない 文字列はシングルクオート（一重引用符）で括る パッケージ階層はない クラス継承（デフォルトでは有効でない） インラインの SOQL クエリ、 DML 文 global, webService, testMethod などの修飾子

10. インライン SOQL クエリ Web サービス API の SOQL とほぼ同じ 記述方法 Apex コード中に [ … ] セクションで指定する 結果が 1 件のみの場合は SObject に直接代入可能 Apex コード内の変数を「 : 」を付けることで文中にバインド可能 Account[] accounts = [SELECT Id, Name FROM Account]; Account a = [SELECT Id, Name FROM Account WHERE Id = :accId]; Account[] accs = [SELECT Id, Name FROM Account WHERE Name LIKE :(s + '%')]; Account a = [SELECT Id, Name FROM Account LIMIT 1];

11. DML 文 種類： insert( 挿入 ), update （更新） , delete （削除） , upsert( 上書き作成 ) データベースアクセス後のトランザクション制御（ commit, rollback ）は必要ない リクエスト正常終了時は暗黙的にコミット、異常時にはロールバックされる insert <SObject>; insert <SObject[]>; update <SObject>; update <SObject[]>; delete <SObject>; delete <SObject[]>;

12. Apex コードのクラス システム静的 System Math Limits コレクション List （リスト配列） Set （集合） Map （ハッシュマップ、連想配列） 正規表現 Pattern Matcher 基本データ型 Double Integer String Date Datetime SObject 型 ユーザ定義のクラス

13. SObject 型 Salesforce 内のオブジェクト（標準／カスタム）をあらわす抽象データ型 宣言時には常に具象的な型（ Account, Contact など）を使う コンストラクタに項目の属性値をセットできる Account account = new Account(Name=' 東京建設 ', NumberOfEmployees=200);

14. コレクションクラス： List リスト構造の格納 Apex コード上では配列と同じ扱い String[] colors = new List<String>(); colors.add('red'); colors.add('white'); colors.add('green'); System.debug(colors[1]); // => 'white'; System.debug(colors.size()); // => 3

15. コレクションクラス： Map ハッシュマップ（連想配列）用のデータ構造 インターフェースでなくクラス実装（ Java とは異なる） Map<String, String> myStrings = new Map<String, String>{'a' => 'b', 'c' => 'd' };

16. コレクションクラス： Set データの集合を現すデータ構造 インターフェースではなくクラス実装（ Java とは異なる） 重複を排除 利用例 複数レコードの親レコードを重複なく取得 Set<ID> accountIds = new Set<ID>(); for (Contact c : contacts) accountIds.add(c.AccountId); Account[] accounts = [SELECT Id, Name FROM Account WHERE Id IN :accountIds];

17. 正規表現クラス Pattern, Matcher ほぼ JavaSE の同名クラスと同じ http://java.sun.com/j2se/1.5.0/docs/api/index.html?java/util/regex/Pattern.html 高度な入力値検査、構文解析などが可能に Boolean match = Pattern.matches('a*b', 'aaaaab');

18. ユーザ定義クラス ほぼ Java と同様 定義 インスタンス化 外部クラス・内部クラスの定義も可能 Java における「パッケージ」に相当する用途に代用できる public class MyClass { public MyClass (String a, Integer b) { // コンストラクタ } private void doSomething () { // プライベートメソッド } } MyClass c = new MyClass('abc', 12);

19. トリガの作成

20. トリガ データベース操作に対する各種イベント発生時に起動される Apex コードのロジック データベース・ストアドプロシージャのトリガに類似 トリガ定義の構文 イベント発生のタイミング before insert / before update / before delete after insert / after update / after delete after undelete trigger < トリガ名 > on < オブジェクト名 > ( < イベント > ) { // トリガの処理 }

21. トリガの記述方法 トリガのコード内から、システム変数 Trigger.new/Trigger.old を用いて新旧レコード情報にアクセスする Trigger.new/Trigger.old からリスト（配列）としてアクセス可能 Trigger.newMap/Trigger.oldMap で ID をキーとするマップ構造としてアクセス可能 trigger testTrigger on Account (after insert) { for (Account a : Trigger.new ) { // 作成された各レコードに対して反復処理する } } trigger oppTrigger on Opportunity (before delete) { for (Quote__c q : [SELECT Opportunity__c FROM Quote__c WHERE Opportunity__c IN :Trigger.oldMap .keySet()]) { Trigger.oldMap .get(q.opportunity__c) .addError('Cannot delete opportunity with a quote'); } }

22. トリガに対する注意事項 トリガはすべてバルクトリガ（レコードを一括で処理） API のリクエストなど、作成・更新要求は一度に複数レコードが送信されることが多い トリガから１レコードごとに DB 処理 ?  DB 負荷が高い トリガの中から DB にアクセスするときは、 Apex VM ヒープ中でレコード処理してから、まとめてアクセスすること  ガバナ制限（実行時のリソース制限） に引っかからないように

23. ガバナ制限（ Governor Limit ） 共有されたマルチテナント環境であるがための機能 暴走スクリプト、リソースを大量に消費するコードをプラットフォームが排除する 制限に達したコードは例外を起こして途中終了される モニタリングしているリソースの例 実行される SOQL クエリの総数 SOQL クエリで取得されるレコードの総数 実行される DML ステートメントの総数 実行されるスクリプトステートメントの総数 合計ヒープサイズ 詳細は言語リファレンスマニュアルを参照

24. SOQL for ループ イテレーション処理を SOQL 結果レコードに対して直接適用 通常のリスト配列イテレーションの違い レコードを一時的に格納するためのメモリを必要としない ガバナ制限値を回避して多量のレコードを処理できる for (Account a : [SELECT Id, Name FROM Account WHERE Name LIKE :(s+'%')]) { // 繰り返しコード }

25. トリガ実装の例 悪い実装例 よい実装例 trigger myTrigger on Emp__c (after insert) { Map<Id, Integer> deptEmps = new Map<Id, Integer>(); for (Emp__c emp : Trigger.new) { Integer count = deptEmps.get(emp.Dept__c); if (count==null) count=0; deptEmps.put(emp.Dept__c, count+1); } Dept__c[] depts = [SELECT Id FROM Dept__c WHERE Id IN :deptEmps.keySet()]; for (Dept__c d : depts) { d.EmployeesNumber__c += deptEmps.get(d.Id); } update depts; } trigger myTrigger on Emp__c (after insert) { for (Emp__c emp : Trigger.new) { Dept__c dept = [SELECT Id, Name FROM Account WHERE Id = :emp.Dept__c]; dept.EmployeesNumber__c++; update dept; } } ループ内で DML を発行しているため、 DML 文数のガバナ制限値に抵触する ループ内でクエリを発行しているため、クエリ数のガバナ制限値に抵触する すぐにデータベースに更新するのでなく、一旦値をマップ構造に格納 ループの外側で 一括クエリ＆一括 DML 処理

26. Web サービスの公開

27. Apex コード と Web サービス API 外部サーバ or クライアント端末 SOAP WSDL WSDL WSDL SOAP ロジックをカスタム Web サービスとして公開

28. Web サービスとしての公開 Web サービスを含むクラスを修飾子 global を付けて宣言する Web サービスとして公開するメソッドを修飾子 webService を付けて宣言する global class HelloWorld { // パブリック WebService メソッドにするときは、キーワード WebService を付ける w ebService static String sayHello (String msg ) { return 'Hello , ' + msg ; } }

29. WSDL のダウンロード [ 設定 ]  [ 開発 ]  [ コード ] 開発したクラス毎に WSDL としてダウンロード可能

30. Apex コードのセキュリティについて クラスごとに実行権限を設定可能 呼び出し可能なクラスをユーザプロファイル毎に設定することでアクセスコントロールする システム管理者権限はすべて呼び出し可能 Apex コード実行時はすべてシステム権限で動きます 共有設定によるアクセスコントロールはすべて無視されるので注意！

31. 外部 Web サービス呼び出し （ Salesforce SOA ） 外部 Web サービスを Apex コードから呼び出す機能 WSDL ファイルを読み込み、自動的に Apex コードのクラスに変換 [ 設定 ]  [ 開発 ]  [ コード ]  [WSDL からの生成 ] 現在、対応 Web サービスは SOAP 形式のみ（サービス情報が WSDL として提供されているもののみ） 次バージョン（ Winter’08 ）から通常の XML Web サービス（ REST 形式）も呼び出し可能に 注：トリガ内からの呼び出しは不可

32. デバッグ・テスト・配備

33. デバッグ System.debug() で文字列として出力 ブレークポイントなどの機能はない デバッグログの出力先 [ 設定 ] - [ 監視 ] - [Monitor Apex Logs] Apex ログウィンドウ

34. Apex ログウィンドウ ブラウザにデバッグ情報を出力 トリガ内で発生したデバッグ情報 Apex コードの即時実行が可能 匿名ブロックを記述して Execute ボタンで実行

35. Apex コードのテスト Apex コード開発は、テスト駆動型開発で 最初にテストケースを作りましょう 結局本番環境へのデプロイの際に必要になります クラスだけでなくトリガについてもテストする必要あり テストコードとしてトリガとなるイベントを発生するような DML 処理を記述する テストの実行方法 Web 画面から [ 設定 ]  [ 開発 ]  [ コード ]  [Run all Tests] Eclipse プラグインから runTests API メソッドを内部的に使用

36. テストコードの記述 testMethod 修飾子を含むメソッドを定義 テストコード内での DML 文によるデータベースへのデータ変更はコミットされない startTest/stopTest メソッドにより、ガバナ制限を意識したテストが可能 public class MyClass { // ユニットテストのメソッドは static で宣言し、引数は定義しない static testMethod void myTest1() { // ユニットテスト用のコード } }

37. Apex コードの配備 ＜注意＞本番環境に配備するには以下の手順に従う必要があります！ 開発組織（ DE ）上で、クラス・トリガなどのコードに加え ｢単体テストのコードを含めて」 開発します 上記のコードを Sandbox 組織でテストします（オプション） 最後に本番の運用組織（ UE ）にデプロイします デプロイに成功するためには、テストコードが ７５％以上 のコードカバレッジで成功する必要あり

38. 配備方法 API による配備 compileAndTest メソッド 配備用プロセスをカスタムでコーディングする必要がある場合などに利用可能 Ant Tools Apache Ant を利用したデプロイツール 正式にサポートされているツール [ 設定 ]  [ 開発 ]  [Tools] からダウンロード Apex コードをローカルに保存、デプロイ用の build.xml を記述する Eclipse 用プラグイン 推奨（ただし、あくまでコミュニティプロダクトであり正規のサポートはありません）

40. Apex コード と Visualforce View Controller Model

41. Visualforce Page による View の定義 <apex:page> <h1>Hello World</h1> </apex:page> <apex:detail subject=“ id expression ” relatedList=“false” />

42. Visualforce Controller ブラウザからのイベントハンドリング、および画面遷移のコントロールを行う Java におけるサーブレット、 Struts に相当 コントロールロジックの記述は Apex コードで 例） カスタムコントローラのほかにデフォルトコントローラもあり public class MyController { private String name; public String getName() { return this.name; } public void setName(String name) { this.name = name; } public PageReference save() { Account newAcc = new Account(Name=this.name); insert newAcc; return Page.success; } }

43. その他

44. Apex コードのはじめかた Apex Developer Network に登録して、 Developer Edition アカウントを取得 Apex Developer Network Japan h ttp:// developer.salesforce.co.jp / （オプション） Eclipse IDE へのプラグインをインストール Apex Toolkit for Eclipse http://developer.salesforce.co.jp/tool.html#apex_toolkit_eclipse Apex コード言語リファレンス サンプルコードあり

45. 世界初のオンデマンドプログラム言語のための IDE for Apex Code の編集 Apex Code のデバッグ Apex Project の管理

46. Apex コード言語リファレンス 日本語訳ができました Apex Developer Network からダウンロード可能 http://developer.salesforce.co.jp/document.html#apex_code