Module  java.jnlp
软件包  javax.jnlp

Interface ExtensionInstallerService


  • public interface ExtensionInstallerService
    ExtensionInstallerService由扩展安装程序用于与JNLP客户端通信。 它提供以下类型的功能：
    • 访问优先安装位置，以及有关JNLP客户端的其他信息
    • 操纵JNLP客户端的下载屏幕
    • 使用已安装代码更新JNLP客户端的方法

    安装程序的正常事件顺序是：

    1. 使用ServiceManager.lookup("javax.jnlp.ExtensionInstallerService")获取服务。
    2. 更新状态，航向和安装进展（进展setStatus ， setHeading和updateProgress ）。
    3. 根据是否安装JRE或库，调用setJREInfo或setNativeLibraryInfo
    4. 如果成功调用installSucceeded ，否则调用installFailed 。
    从以下版本开始：
    1.4.2

    • 方法详细信息

      • getInstallPath

        String getInstallPath​()
        返回安装程序建议安装扩展程序的目录。安装程序不需要安装在此目录中，这只是一个建议的路径。
        结果
        建议安装程序安装扩展程序的目录

      • getExtensionVersion

        String getExtensionVersion​()
        返回正在安装的扩展程序的版本
        结果
        正在安装的扩展版本

      • getExtensionLocation

        URL getExtensionLocation​()
        返回正在安装的扩展的位置
        结果
        扩展的位置被安装

      • hideProgressBar

        void hideProgressBar​()
        隐藏进度条。 任何后续调用updateProgress将强制它可见。

      • hideStatusWindow

        void hideStatusWindow​()
        隐藏状态窗口。 如果您要向用户提供有关安装进度的反馈意见，则应该仅调用此方法。

      • setHeading

        void setHeading​(String heading)
        更新进度窗口的标题文本。
        参数
        heading - 标题文本

      • setStatus

        void setStatus​(String status)
        更新进度窗口的状态文本。
        参数
        status - 状态文本

      • updateProgress

        void updateProgress​(int value)
        更新进度条。
        参数
        value - 进度条值 - 应在0到100之间。

      • installSucceeded

        void installSucceeded​(boolean needsReboot)
        成功安装扩展程序后，安装程序应调用此操作。 这将导致JNLP客户端重新获得控制权并继续其正常运行。
        参数
        needsReboot - 如果为真，则需要重新启动

      • installFailed

        void installFailed​()
        如果安装失败，应该调用这个。 JNLP客户端将继续运行，并通知用户安装失败。

      • setJREInfo

        void setJREInfo​(String platformVersion,
                String jrePath)
        通知JNLP客户端JRE的可执行文件的路径，如果这是JRE的安装程序，以及该JRE实现的平台版本。
        参数
        platformVersion - 这个JRE实现的平台版本
        jrePath - JRE可执行文件的路径

      • setNativeLibraryInfo

        void setNativeLibraryInfo​(String path)
        通知JNLP客户端应搜索本机库的目录。
        参数
        path - 本机库的搜索路径

      • getInstalledJRE

        String getInstalledJRE​(URL url,
                       String version)
        返回给定JRE的可执行文件的路径。 该方法可以由需要在给定JRE中查找信息的扩展使用，或增强给定的JRE。
        参数
        url - JRE的产品位置
        version - JRE的产品版本
        结果
        给定JRE的可执行文件的路径，如果没有安装JRE， null 。