Класс JConsolePlugin
public abstract class JConsolePlugin extends Object
service provider для поиска плагинов JConsole. Пользователи могут предоставлять свои плагины JConsole в JAR-файле, содержащем файл с именем 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.
- Since:
- 1.6
- See Also:
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Конструктор. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final void |
addContextPropertyChangeListener |
Добавляет PropertyChangeListener к объекту JConsoleContext для этого плагина. |
void |
dispose() |
Удаляет этот плагин. |
final JConsoleContext |
getContext() |
Возвращает объект JConsoleContext, представляющий подключение к приложению. |
abstract Map |
getTabs() |
Возвращает вкладки, которые нужно добавить в окно JConsole. |
abstract SwingWorker |
newSwingWorker() |
Возвращает SwingWorker для выполнения обновления графического интерфейса для этого плагина с той же периодичностью, что и JConsole обновляет графический интерфейс. |
final void |
removeContextPropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей объекта JConsoleContext для этого плагина. |
final void |
setContext |
Устанавливает объект JConsoleContext, представляющий подключение к приложению. |
Подробное описание конструкторов
JConsolePlugin
protected JConsolePlugin()
Подробное описание методов
setContext
public final void setContext(JConsoleContext context)
JConsoleContext, представляющий подключение к приложению. Этот метод будет вызван только один раз после создания плагина и перед вызовом getTabs(). Переданный context может находиться в любом connection state состоянии при вызове этого метода.- Параметры:
-
context- объектJConsoleContext
getContext
public final JConsoleContext getContext()
JConsoleContext, представляющий подключение к приложению. Этот метод может вернуть null, если он вызван до инициализации context.- Возвращает:
- объект
JConsoleContext, представляющий подключение к приложению.
getTabs
public abstract Map<String,JPanel> getTabs()
Возвращаемый массив содержит одну запись для каждой вкладки, которая должна быть добавлена в вкладку JConsole, с именем вкладки в качестве ключа и объектом JPanel в качестве значения. Этот метод возвращает пустой массив, если этот плагин не добавляет никаких вкладок. Этот метод будет вызван из потока обработки событий один раз при новом подключении.
- Возвращает:
- массив имен вкладок и объектов
JPanel, представляющих вкладки, которые необходимо добавить в окно JConsole; или пустой массив.
newSwingWorker
public abstract SwingWorker<?,?> newSwingWorker()
SwingWorker для выполнения обновления графического интерфейса пользователя для этого плагина с тем же интервалом, что и JConsole обновляет графический интерфейс пользователя. JConsole планирует обновление графического интерфейса пользователя с интервалом, указанным для подключения. Этот метод будет вызываться при каждом обновлении для получения SwingWorker для каждого плагина.
JConsole вызовет метод execute() для планирования возвращаемого SwingWorker для выполнения, если:
- объект
SwingWorkerне был выполнен (т.е. методSwingWorker.getState()возвращает состояниеPENDING); и - объект
SwingWorker, возвращённый в предыдущем обновлении, завершил задачу, если он не былnull(т.е. методSwingWorker.isDoneвозвращаетtrue).
В противном случае, объект
SwingWorker не будет запланирован на работу. Плагин может планировать собственное обновление графического интерфейса пользователя, и этот метод вернёт null.
- Возвращает:
SwingWorkerдля выполнения обновления графического интерфейса пользователя; илиnull.
dispose
public void dispose()
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)
PropertyChangeListener из списка слушателей объекта JConsoleContext для этого плагина. Если listener никогда не добавлялся, исключение не выбрасывается, и никаких действий не выполняется.- Параметры:
-
listener- удаляемыйPropertyChangeListener - Исключения:
-
NullPointerException- еслиlistenernull.
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/jdk.jconsole/com/sun/tools/jconsole/JConsolePlugin.html