パッケージ jakarta.servlet

クラス UnavailableException

  • 実装されているすべてのインターフェース:
    SerializableSE
    public class UnavailableException
extends ServletException
    サーブレットまたはフィルターがスローする例外を定義して、永続的または一時的に使用できないことを示します。

    サーブレットまたはフィルターが永続的に利用できない場合、何か問題があり、何らかのアクションが実行されるまでリクエストを処理できません。例: サーブレットが正しく構成されていないか、フィルターの状態が破損している可能性があります。コンポーネントは、エラーと必要な修正処置の両方を記録する必要があります。

    サーブレットまたはフィルターは、システム全体の問題のために一時的にリクエストを処理できない場合、一時的に利用できません。例: 第 3 層サーバーにアクセスできないか、リクエストを処理するためのメモリまたはディスクストレージが不足している可能性があります。システム管理者は修正措置を講じる必要がある場合があります。

    サーブレットコンテナーは、両方の種類の利用できない例外を同じ方法で安全に処理できます。ただし、一時的な使用不可を効果的に処理すると、サーブレットコンテナーがより堅牢になります。具体的には、サーブレットコンテナーは、サーブレットコンテナーが再起動するまでリクエストを拒否するのではなく、例外への提案された期間、サーブレットまたはフィルターへのリクエストをブロックする場合があります。

    作成者:
    Various
    関連事項:
    連載形式

    • コンストラクターの詳細

      • UnavailableException

        public UnavailableException​(StringSE msg)
        サーブレットが永続的に利用できないことを示す説明メッセージを使用して、新しい例外を構築します。
        パラメーター:
        msg - 説明的なメッセージを指定する String 

      • UnavailableException

        public UnavailableException​(StringSE msg,
                            int seconds)
        サーブレットが一時的に使用不可であることを示し、使用不可になる期間の推定値を示す説明メッセージを使用して、新しい例外を構築します。

        場合によっては、サーブレットは推定を行うことができません。例: サーブレットは、必要なサーバーが実行されていないことを知っている可能性がありますが、機能が復元されるまでにかかる時間を報告できません。これは、seconds 引数の負の値またはゼロの値で示すことができます。

        パラメーター:
        msg - 説明的なメッセージを指定する String。ログファイルに書き込むか、ユーザーに表示できます。
        seconds - サーブレットが利用できないと予想される秒数を指定する整数。ゼロまたは負の場合、サーブレットが推定できないことを示します

    • メソッドの詳細

      • isPermanent

        public boolean isPermanent()
        サーブレットが永続的に利用できないかどうかを示す boolean を返します。その場合、サーブレットに何か問題があり、システム管理者は修正アクションを実行する必要があります。
        戻り値:
        true サーブレットが永続的に利用できない場合。サーブレットが使用可能または一時的に使用不可の場合、false 

      • getUnavailableSeconds

        public int getUnavailableSeconds()
        サーブレットが一時的に利用できないと予想される秒数を返します。

        このメソッドが負の数を返した場合、サーブレットは永久に利用できないか、利用できない期間の推定値を提供できません。例外が最初に報告されてから経過した時間を修正する努力は行われません。

        戻り値:
        サーブレットが一時的に使用不可になる秒数を指定する整数、またはサーブレットが永久に使用不可であるか推定できない場合は負の数