console

2023-03-04 19:17:16 +00:00 · 2012-01-11 14:11:04 +08:00
parent 223d3406ba
commit 0b9c2e7084
9 changed files with 1687 additions and 8 deletions
@@ -0,0 +1,90 @@
+package com.alibaba.druid.pool.console;
+
+
+import java.beans.PropertyChangeListener;
+
+import javax.management.MBeanServerConnection;
+
+/**
+ * {@code JConsoleContext} represents a JConsole connection to a target 
+ * application.
+ * <p> 
+ * {@code JConsoleContext} notifies any {@code PropertyChangeListeners}
+ * about the {@linkplain #CONNECTION_STATE_PROPERTY <i>ConnectionState</i>} 
+ * property change to {@link ConnectionState#CONNECTED CONNECTED} and
+ * {@link ConnectionState#DISCONNECTED DISCONNECTED}.
+ * The {@code JConsoleContext} instance will be the source for 
+ * any generated events.
+ * <p>  
+ *  
+ * @since 1.6
+ */
+public interface JConsoleContext {
+    /**
+     * The {@link ConnectionState ConnectionState} bound property name.
+     */
+    public static String CONNECTION_STATE_PROPERTY = "connectionState";
+
+    /**
+     * Values for the {@linkplain #CONNECTION_STATE_PROPERTY 
+     * <i>ConnectionState</i>} bound property.
+     */
+    public enum ConnectionState {
+        /**
+         * The connection has been successfully established.
+         */
+        CONNECTED,
+        /**
+         * No connection present. 
+         */
+        DISCONNECTED,
+        /**
+         * The connection is being attempted.
+         */
+        CONNECTING
+    }
+
+    /**
+     * Returns the {@link MBeanServerConnection MBeanServerConnection} for the 
+     * connection to an application.  The returned 
+     * {@code MBeanServerConnection} object becomes invalid when 
+     * the connection state is changed to the 
+     * {@link ConnectionState#DISCONNECTED DISCONNECTED} state.
+     *
+     * @return the {@code MBeanServerConnection} for the
+     * connection to an application.
+     */
+    public MBeanServerConnection getMBeanServerConnection();
+
+    /**
+     * Returns the current connection state.
+     * @return the current connection state.
+     */
+    public ConnectionState getConnectionState();
+
+    /**
+     * Add a {@link java.beans.PropertyChangeListener PropertyChangeListener}
+     * to the listener list.
+     * The listener is registered for all properties.
+     * The same listener object may be added more than once, and will be called
+     * as many times as it is added.
+     * If {@code listener} is {@code null}, no exception is thrown and 
+     * no action is taken.
+     *
+     * @param listener  The {@code PropertyChangeListener} to be added
+     */
+    public void addPropertyChangeListener(PropertyChangeListener listener);
+ 
+    /**
+     * Removes a {@link java.beans.PropertyChangeListener PropertyChangeListener}
+     * from the listener list. This
+     * removes a {@code PropertyChangeListener} that was registered for all
+     * properties. If {@code listener} was added more than once to the same
+     * event source, it will be notified one less time after being removed. If
+     * {@code listener} is {@code null}, or was never added, no exception is
+     * thrown and no action is taken.
+     *
+     * @param listener the {@code PropertyChangeListener} to be removed
+     */
+    public void removePropertyChangeListener(PropertyChangeListener listener);
+}