end-of-support の今後の AWS SDK for Java (v1) を発表しました
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
例外処理
が例外を AWS SDK for Java スローする方法とタイミングを理解することは、 SDK を使用して高品質のアプリケーションを構築する上で重要です。以下のセクションでは、SDK によってスローされる例外のさまざまなケース、および例外の適切な処理方法について説明します。
非チェック例外を使用する理由
は、次の理由により、チェックされた例外の代わりにランタイム (またはチェックされていない) 例外 AWS SDK for Java を使用します。
-
懸念がない場合には例外ケースの処理を強制的に適用せずに (さらにコードを冗長にすることなく)、開発者がエラーを細かく制御できるようにするため。
-
サイズの大きいアプリケーションで、チェック例外に関連する拡張性の問題が発生するのを防ぐため。
一般的に、チェック例外は小規模なアプリケーションでは役立ちますが、アプリケーションのサイズが大きくなり、複雑化すると、チェック例外が問題となる場合があります。
チェック例外と非チェック例外の使用方法の詳細については、以下を参照してください。
AmazonServiceException (およびサブクラス)
AmazonServiceException は、 の使用時に発生する最も一般的な例外です AWS SDK for Java。この例外は、 AWS のサービスからのエラーレスポンスを表します。例えば、存在しない Amazon EC2 インスタンスを終了しようとすると、EC2 はエラーレスポンスを返し、そのエラーレスポンスのすべての詳細がスローされる AmazonServiceException
に含まれます。場合によっては、AmazonServiceException
のサブクラスがスローされ、開発者は catch ブロックを使用して、エラーケースの処理を細かく制御できるようになります。
が発生するとAmazonServiceException
、リクエストは正常に に送信されました AWS のサービス が、正常に処理できなかったことがわかります。これは、リクエストのパラメータに含まれるエラーまたはサービス側の問題が原因です。
AmazonServiceException
では次のような情報がわかります。
-
返された HTTP ステータスコード
-
返された AWS エラーコード
-
サービスからの詳細なエラーメッセージ
-
AWS 失敗したリクエストの リクエスト ID
AmazonServiceException
には、失敗したリクエストが発信者の障害 (不正な値を持つリクエスト) か、 AWS のサービスの障害 (内部サービスエラー) かに関する情報も含まれています。
AmazonClientException
AmazonClientException は、 にリクエストを送信しようとしたとき、 AWS または からのレスポンスを解析しようとしたときに、Java クライアントコード内で問題が発生したことを示します AWS。AmazonClientException
は通常、 よりも深刻でありAmazonServiceException
、クライアントが のサービスへのサービス呼び出しを妨げている重大な問題を示します AWS 。例えば、いずれかのクライアントで オペレーションを呼び出そうとすると、 はネットワーク接続が利用AmazonClientException
できない場合に を AWS SDK for Java スローします。