例外処理

例外とは、アプリケーションの実行中に発生する予期しない不具合の動作です。Python環境上に構築されたCatalystアプリケーションによってスローされるすべてのエラーと例外は、Exceptionsモジュールとその中のクラスによって処理されます。

アプリケーションでエラーまたは例外が発生すると、例外の以下のプロパティが返されます：

• code: エラーの一意の識別子です。
• errorMsg: エラーに関する一般的な説明です。
• errorDetails: エラーに関する追加情報です。
• originalException: HTTPリクエストの場合はHTTPステータスコードを返します。それ以外の場合は「None」を返します。

基底クラスCatalystErrorは、Catalyst Python SDKパッケージのExceptionsモジュールに定義済みです。これは複数のサブクラスによって継承され、アプリケーションでのCatalystコンポーネントの実行中に発生する可能性のある例外やエラーのシナリオを処理します。

Python SDKの一部として、各Catalystコンポーネントに個別のエラークラスが構成されており、コンポーネント実行の定義されたフローで予期しないイベントが発生した場合、それぞれのエラーがスローされます。

例：

CatalystアプリケーションでCatalyst Serverless functionを実行し、関数がレスポンスとしてエラーコードを返す場合を考えてみましょう。この場合、Functionsコンポーネント用に定義済みのそれぞれのエラークラス(CatalystFunctionError)がシナリオを処理します。

同様に、Catalyst DataStoreで不正なデータベース固有の操作を実行した場合、例外はCatalystDataStoreErrorクラス内でキャッチされ処理されます。

したがって、Exceptionsモジュールの一部として、各Catalystコンポーネントに固有のエラークラスが定義されています。モジュールに含まれるその他の一般的なクラスには、CatalystAuthenticationError、Catalyst FileStore Error、Catalyst CacheError、Catalyst CronError、CatalystZiaErrorなどがあります。

さらに、コンポーネント固有のPythonクラスでキャッチされない例外は、CatalystAPIErrorクラスで処理されます。このクラスはAPIレベルでキャッチされた例外を処理し、失敗したAPIリクエストのエラーコードを定義します。

以下は、すべてのCatalystコンポーネントに適用される一般的なAPIエラーコードの一覧です：