モジュール jdk.jshell
パッケージ jdk.jshell.tool

インタフェースJavaShellToolBuilder


  • public interface JavaShellToolBuilder
    Javaシェル・ツール・インスタンスを構成および実行するためのインタフェース。 ビルダーのインスタンスは、静的なbuilder()メソッドを使用して作成されます。 このBuilderは、必要に応じて構成メソッドを使用して構成できます。 すべての構成メソッドは、連鎖初期化で使用するBuilderインスタンスを戻します。 すべての構成メソッドは、呼び出されない場合に使用される適切なデフォルトを持っています。 0回以上構成メソッドを呼び出した後、run(java.lang.String...)を呼び出してツールを起動します。
    導入されたバージョン:
    9
    • メソッドの詳細

      • builder

        static JavaShellToolBuilder builder()
        JDK jshellツールを起動するためのビルダーを作成します。
        戻り値:
        jshellツールの構成と起動に使用できるビルダー
      • in

        JavaShellToolBuilder in​(InputStream cmdIn,
                                InputStream userIn)
        入力チャネルを設定します。
        実装要件:
        このメソッドが呼び出されない場合、その動作はin(System.in, null)を呼び出すことと同等でなければなりません。
        パラメータ:
        cmdIn - コマンド入力元
        userIn - ユーザー・コードを実行するための入力ソース、またはcmdInからユーザー入力を抽出するnull
        戻り値:
        JavaShellToolBuilderインスタンス
      • out

        JavaShellToolBuilder out​(PrintStream output)
        出力チャネルを設定します。 out(output, output, output)と同じです。
        実装要件:
        どちらもoutメソッドが呼び出されない場合、その動作はout(System.out)を呼び出すのと同じでなければなりません。
        パラメータ:
        output - コマンド・フィード・バックの宛先、コンソール対話、およびユーザー・コード出力
        戻り値:
        JavaShellToolBuilderインスタンス
      • out

        JavaShellToolBuilder out​(PrintStream cmdOut,
                                 PrintStream console,
                                 PrintStream userOut)
        出力チャネルを設定します。
        実装要件:
        どちらもoutメソッドが呼び出されない場合、その動作はout(System.out, System.out, System.out)を呼び出すのと同じでなければなりません。
        パラメータ:
        cmdOut - ユーザーに対するエラー・メッセージを含むコマンド・フィード・バックの宛先
        console - コンソール対話の宛先
        userOut - ユーザー・コード出力先。 たとえば、Helloを実行すると、ユーザー・スニペットSystem.out.println("Hello")がuserOutに移動します。
        戻り値:
        JavaShellToolBuilderインスタンス
      • err

        JavaShellToolBuilder err​(PrintStream error)
        エラー・チャネルを設定します。 err(error, error)と同じです。
        実装要件:
        どちらもerrメソッドが呼び出されない場合、その動作はerr(System.err)を呼び出すのと同じでなければなりません。
        パラメータ:
        error - ツール・エラーの宛先、ユーザー・コード・エラー
        戻り値:
        JavaShellToolBuilderインスタンス
      • err

        JavaShellToolBuilder err​(PrintStream cmdErr,
                                 PrintStream userErr)
        エラー・チャネルを設定します。
        実装要件:
        どちらもerrメソッドが呼び出されない場合、その動作はerr(System.err, System.err, System.err)を呼び出すのと同じでなければなりません。
        パラメータ:
        cmdErr - ツールの起動先と致命的なエラー
        userErr - ユーザー・コード・エラー出力先。 たとえば、Oopsが実行されると、ユーザー・スニペットSystem.err.println("Oops")がuserErrに移動します。
        戻り値:
        JavaShellToolBuilderインスタンス
      • persistence

        JavaShellToolBuilder persistence​(Preferences prefs)
        入力履歴と保持されている設定を含む永続情報用の記憶機構を設定します。
        実装要件:
        どちらもpersistenceメソッドが呼び出されない場合は、ツールの標準永続化メカニズムを使用するように動作する必要があります。
        パラメータ:
        prefs - 永続的情報を取得して格納するために使用されるPreferencesのインスタンス
        戻り値:
        JavaShellToolBuilderインスタンス
      • persistence

        JavaShellToolBuilder persistence​(Map<String,​String> prefsMap)
        入力履歴と保持されている設定を含む永続情報用の記憶機構を設定します。
        実装要件:
        どちらもpersistenceメソッドが呼び出されない場合は、ツールの標準永続化メカニズムを使用するように動作する必要があります。
        パラメータ:
        prefsMap - 永続的情報を取得して格納するために使用されるMapのインスタンス
        戻り値:
        JavaShellToolBuilderインスタンス
      • env

        JavaShellToolBuilder env​(Map<String,​String> vars)
        環境変数のソースを設定します。
        実装要件:
        このメソッドが呼び出されない場合、その動作はenv(System.getenv())を呼び出すことと同等でなければなりません。
        パラメータ:
        vars - 環境変数名から値へのマップ
        戻り値:
        JavaShellToolBuilderインスタンス
      • locale

        JavaShellToolBuilder locale​(Locale locale)
        ロケールを設定します。
        実装要件:
        このメソッドが呼び出されない場合、その動作はlocale(Locale.getDefault())を呼び出すことと同等でなければなりません。
        パラメータ:
        locale - ロケール
        戻り値:
        JavaShellToolBuilderインスタンス
      • promptCapture

        JavaShellToolBuilder promptCapture​(boolean capture)
        コマンド・キャプチャ・プロンプトを有効にするように設定します。
        実装要件:
        このメソッドが呼び出されない場合、その動作はpromptCapture(false)を呼び出すことと同等でなければなりません。
        パラメータ:
        capture - trueの場合、基本プロンプトはENQ文字であり、継続プロンプトはACK文字です。 falseの場合、プロンプトはセット・アップまたはユーザー/setコマンドで設定されたとおりです。
        戻り値:
        JavaShellToolBuilderインスタンス
      • run

        void run​(String... arguments)
          throws Exception
        このインタフェースの他のメソッドで構成されたJavaシェル・ツールのインスタンスを実行します。 この呼び出しは破壊的ではなく、構成されたビルダーからこのメソッドの複数の呼び出しを行うことができます。 Javaシェル・ツールの終了コードは無視されます。
        パラメータ:
        arguments - コマンドライン引数(オプションを含む)(存在する場合)
        例外:
        Exception - 予期しない致命的な例外
      • start

        default int start​(String... arguments)
                   throws Exception
        このインタフェースの他のメソッドで構成されたJavaシェル・ツールのインスタンスを実行します。 この呼び出しは破壊的ではなく、構成されたビルダーからこのメソッドの複数の呼び出しを行うことができます。
        実装要件:
        デフォルト実装は常にゼロを返します。 このインタフェースの実装は、このメソッドをオーバーライドして、終了ステータスを返します。
        パラメータ:
        arguments - コマンドライン引数(オプションを含む)(存在する場合)
        戻り値:
        ツールが明示的に(もしあれば)を終了した終了ステータス。成功した場合は0、失敗の場合は1
        例外:
        Exception - 予期しない致命的な例外