模块 jdk.jconsole

类 JConsolePlugin

java.lang.Object
com.sun.tools.jconsole.JConsolePlugin

public abstract class JConsolePlugin extends Object
JConsole 插件类。 JConsole 使用 service provider 机制来搜索 JConsole 插件。用户可以在包含名为
 META-INF/services/com.sun.tools.jconsole.JConsolePlugin

该文件为每个插件包含一行,例如,

 com.sun.example.JTop

这是实现 JConsolePlugin 的类的完全限定类名。

要在 JConsole 中加载 JConsole 插件,请运行:

 jconsole -pluginpath <plugin-path> 

其中 <plugin-path> 指定要查找的 JConsole 插件的路径,可以是目录或 jar 文件。多个路径由平台的路径分隔符分隔。

当为连接创建新的 JConsole 窗口时,将创建每个 JConsolePlugin 的实例。 JConsoleContext 对象在其构造时不可用。创建插件对象后,JConsole 将为插件设置 JConsoleContext 对象。然后它将调用其 getTabs 方法并将返回的选项卡添加到 JConsole 窗口。

自从:
1.6
参见:
  • 构造方法详细信息

    • JConsolePlugin

      protected JConsolePlugin()
      构造函数。
  • 方法详情

    • setContext

      public final void setContext(JConsoleContext  context)
      设置表示与应用程序连接的 JConsoleContext 对象。这个方法只会在插件创建之后和getTabs() 被调用之前被调用一次。调用此方法时,给定的 context 可以在任何 connection state 中。
      参数:
      context - 一个 JConsoleContext 对象
    • getContext

      public final JConsoleContext  getContext()
      返回表示与应用程序的连接的 JConsoleContext 对象。如果在 context 初始化之前调用此方法,则它可能返回 null
      返回:
      JConsoleContext 对象表示与应用程序的连接。
    • getTabs

      public abstract Map <String ,JPanel > getTabs()
      返回要在 JConsole 窗口中添加的选项卡。

      对于要添加到 JConsole 窗口的选项卡式窗格中的每个选项卡,返回的映射都包含一个条目,选项卡名称作为键,JPanel 对象作为值。如果此插件未添加任何选项卡,此方法将返回一个空map。这个方法将从事件派发线程在新的连接时间一次。

      返回:
      选项卡名称和代表要在 JConsole 窗口中添加的选项卡的 JPanel 对象的映射;或空map。
    • newSwingWorker

      public abstract SwingWorker <?,?> newSwingWorker()
      返回一个 SwingWorker 以与 JConsole 更新 GUI 相同的时间间隔为此插件执行 GUI 更新。

      JConsole 按为连接指定的时间间隔安排 GUI 更新。每次更新时都会调用此方法以获得每个插件的SwingWorker

      如果出现以下情况,JConsole 将调用 execute() 方法来安排返回的 SwingWorker 执行:


      否则,SwingWorker 对象将不会被安排工作。

      插件可以安排自己的 GUI 更新,此方法将返回 null

      返回:
      a SwingWorker 执行 GUI 更新;或 null
    • dispose

      public void dispose()
      处理这个插件。此方法由 JConsole 调用以通知此插件将被丢弃并且它应该释放它已分配的所有资源。调用此方法时,JConsoleContext 可以在任何 connection state 中。
    • addContextPropertyChangeListener

      public final void addContextPropertyChangeListener(PropertyChangeListener  listener)
      PropertyChangeListener 添加到此插件的 JConsoleContext 对象。此方法是此插件在 JConsoleContext 对象可能可用或不可用时注册监听器的便捷方法。

      例如,插件构造函数可以调用此方法注册一个监听器来监听connectionState 属性的变化,并且该监听器将在可用时添加到JConsoleContext 对象中。

      参数:
      listener - 要添加的 PropertyChangeListener
      抛出:
      NullPointerException - 如果 listenernull
    • removeContextPropertyChangeListener

      public final void removeContextPropertyChangeListener(PropertyChangeListener  listener)
      从此插件的 JConsoleContext 对象的监听器列表中删除 PropertyChangeListener 。如果从未添加 listener,则不会抛出任何异常,也不会采取任何操作。
      参数:
      listener - 要删除的 PropertyChangeListener
      抛出:
      NullPointerException - 如果 listenernull