模块  jdk.jshell
软件包  jdk.jshell

Class JShell

    • 方法详细信息

      • builder

        public static JShell.Builder builder()
        JShell.Builder工厂方法，用于创建JShell实例。 创建的默认实例JShell与JShell.builder().build() 。 有关更多施工选项，请参阅JShell.Builder 。
        结果
        Builder一个实例。
        另请参见：
        JShell.Builder

      • sourceCodeAnalysis

        public SourceCodeAnalysis sourceCodeAnalysis()
        访问源代码分析功能。 JShell的实例将始终从sourceCodeAnalysis()返回相同的SourceCodeAnalysis实例。
        结果
        SourceCodeAnalysis的一个实例，可用于源分析，例如完成检测和完成建议。

      • eval

        public List<SnippetEvent> eval​(String input)                        throws IllegalStateException
        评估输入字符串，包括定义和/或执行（如果适用）。 检查输入是否有错误，除非可以延迟错误（如某些unresolvedDependencies引用的情况），错误将中止评估。

        输入应该只是一个完整的源代码片段，即一个表达式，语句，变量声明，方法声明，类声明或导入。 要将任意输入分解为单个完整代码段，请使用SourceCodeAnalysis.analyzeCompletion(String) 。

        对于导入，添加导入。 类，接口。 方法和变量是定义的。 执行变量，语句和表达式的初始化程序。 修饰符public，protected，private，static和final在op级声明中是不允许的，并且会被警告忽略。 不允许使用同步，本机，抽象和默认的顶级方法，这些方法都是错误的。 如果覆盖了声明的先前定义，则会有一个事件显示其状态已更改为OVERWRITTEN，这对于删除，拒绝或已经覆盖的声明不会发生。

        如果执行环境不在进程中（默认情况下），那么如果评估的代码导致执行环境终止，则此JShell实例将关闭，但调用进程和VM仍然有效。

        参数
        input - 要评估的输入String
        结果
        此评估直接或间接导致的事件列表。
        异常
        IllegalStateException - 如果此 JShell实例已关闭。
        另请参见：
        SourceCodeAnalysis.analyzeCompletion(String) ， onShutdown(java.util.function.Consumer)

      • addToClasspath

        public void addToClasspath​(String path)
        指定的路径将添加到eval（）中使用的类路径的末尾。 请注意，无法从放置eval(String)代码的程序包访问未命名的程序包。
        参数
        path - 要添加到类路径的路径。
        异常
        IllegalStateException - 如果此 JShell实例已关闭。

      • stop

        public void stop()
        尝试停止当前正在运行的评估。 在eval(java.lang.String)方法运行且正在执行用户代码时调用时，将尝试停止用户代码。 请注意，通常需要从与运行eval方法的线程不同的线程调用eval方法。

        如果eval(java.lang.String)方法未运行，则不执行任何操作。

        在某些情况下，尝试停止用户代码可能会失败，这可能包括在I / O操作上阻止执行时，或者当用户代码捕获ThreadDeath异常时。

      • close

        public void close()
        关闭此状态引擎。 释放资源。 应该在不再需要此状态引擎时调用。
        Specified by:
        close在界面 AutoCloseable

      • snippets

        public Stream<Snippet> snippets()
        返回所有片段。
        结果
        id顺序中所有当前片段的片段。

      • variables

        public Stream<VarSnippet> variables()
        返回活动变量片段。 这种便利方法相当于snippets()过滤为status(snippet).isActive() && snippet.kind() == Kind.VARIABLE并转换为VarSnippet 。
        结果
        活动声明的变量。

      • methods

        public Stream<MethodSnippet> methods()
        返回活动方法片段。 此便捷方法相当于snippets()过滤为status(snippet).isActive() && snippet.kind() == Kind.METHOD并已转换为MethodSnippet。
        结果
        主动声明的方法。

      • types

        public Stream<TypeDeclSnippet> types()
        返回活动类型声明（类，接口，注释类型和枚举）片段。 这种方便方法相当于snippets()过滤为status(snippet).isActive() && snippet.kind() == Kind.TYPE_DECL并转换为TypeDeclSnippet。
        结果
        活动声明的类型声明。

      • imports

        public Stream<ImportSnippet> imports()
        返回活动的导入片段。 此便捷方法相当于snippets()过滤了status(snippet).isActive() && snippet.kind() == Kind.IMPORT并转换为ImportSnippet。
        结果
        活动声明的导入声明。

      • status

        public Snippet.Status status​(Snippet snippet)
        返回代码段的状态。 由于显式eval()调用或依赖项触发的自动更新，因此更新。
        参数
        snippet - 查询 Snippet
        结果
        与此代码段对应的状态
        异常
        IllegalStateException - 如果此 JShell实例已关闭。
        IllegalArgumentException - 如果该代码段与此 JShell实例 JShell 。

      • diagnostics

        public Stream<Diag> diagnostics​(Snippet snippet)
        返回最新评估片段的诊断信息。 评估可以是因为显式调用eval()或依赖项触发的自动更新。
        参数
        snippet - 查询 Snippet
        结果
        与此代码段对应的诊断程序。 这不包括unresolvedDependencies()报告的unresolvedDependencies引用。
        异常
        IllegalStateException - 如果此 JShell实例已关闭。
        IllegalArgumentException - 如果该代码段与此 JShell实例 JShell 。

      • onShutdown

        public JShell.Subscription onShutdown​(Consumer<JShell> listener)                               throws IllegalStateException
        注册此JShell实例终止时要调用的回调。 这是因为客户端进程已结束（例如，称为System.exit（0））或连接已关闭，如close（）。 每次通话都会添加新订阅。
        参数
        listener - 状态终止时要执行的操作。
        结果
        可用于此订阅的令牌，可用于 unsubscribe 。
        异常
        IllegalStateException - 如果此JShell实例已关闭

      • unsubscribe

        public void unsubscribe​(JShell.Subscription token)
        取消回拨订阅。
        参数
        token - 与要取消订阅的订阅对应的令牌。