Apex 開発者ガイド
jキャンバスの例外
Canvas 名前空間には、例外クラスが含まれています。
すべての例外クラスは、エラーメッセージや例外型を返す組込みメソッドをサポートしています。「Exception クラスおよび組み込み例外」を参照してください。
Canvas 名前空間には、次の例外があります。
| 例外 | 説明 |
|---|---|
| Canvas.CanvasRenderException | Canvas.CanvasLifecycleHandler.onRender(renderContext) の実装でこのクラスを使用します。onRender() 実装でユーザにエラーを表示するには、Canvas.CanvasRenderException を発生させます。これにより、キャンバスフレームワークでエラーメッセージがユーザに表示されます。この例外は、onRender() メソッド内でのみ管理されます。 |
例
onRender() の次の実装例では、最大長を超えた文字列でキャンバス URL が設定されたことが原因で発生した CanvasException をキャッチします。CanvasRenderException が作成されて発生し、ユーザにエラーが表示されます。
1public class MyCanvasListener
2implements Canvas.CanvasLifecycleHandler {
3
4 public void onRender(Canvas.RenderContext renderContext) {
5 Canvas.ApplicationContext app = renderContext.getApplicationContext();
6
7 // Code to generate a URL string that is too long
8
9 // ...
10
11 // Try to set the canvas app URL using the invalid URL string
12 try {
13 app.setCanvasUrlPath(aUrlPathThatIsTooLong);
14 } catch (CanvasException e) {
15 // Display error to user by throwing a new CanvasRenderException
16 throw new Canvas.CanvasRenderException(e.getMessage());
17 }
18 }
19}