1 /* 2 * The contents of this file are subject to the terms 3 * of the Common Development and Distribution License 4 * (the License). You may not use this file except in 5 * compliance with the License. 6 * 7 * You can obtain a copy of the license at 8 * https://glassfish.dev.java.net/public/CDDLv1.0.html or 9 * glassfish/bootstrap/legal/CDDLv1.0.txt. 10 * See the License for the specific language governing 11 * permissions and limitations under the License. 12 * 13 * When distributing Covered Code, include this CDDL 14 * Header Notice in each file and include the License file 15 * at glassfish/bootstrap/legal/CDDLv1.0.txt. 16 * If applicable, add the following below the CDDL Header, 17 * with the fields enclosed by brackets [] replaced by 18 * you own identifying information: 19 * "Portions Copyrighted [year] [name of copyright owner]" 20 * 21 * Copyright 2006 Sun Microsystems, Inc. All rights reserved. 22 */ 23 24 /** 25 * PROPRIETARY/CONFIDENTIAL. Use of this product is subject to license terms. 26 * 27 * Copyright 2001-2002 by iPlanet/Sun Microsystems, Inc., 28 * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. 29 * All rights reserved. 30 */ 31 package com.sun.enterprise.admin.event; 32 33 import com.sun.enterprise.admin.event.AdminEventListener; 34 35 /** 36 * Listener interface to handle monitoring events. 37 */ 38 public interface MonitoringEventListener extends AdminEventListener { 39 40 /** 41 * Start monitoring on the component specified by the event. This method is 42 * called whenever a monitoring event with action of 43 * MonitoringEvent.START_MONITORING is received. 44 * @throws AdminEventListenerException when the listener is unable to 45 * process the event. 46 */ 47 public void startMonitoring(MonitoringEvent event) 48 throws AdminEventListenerException; 49 50 /** 51 * Stop monitoring on the component specified by the event. This method is 52 * called whenever a monitoring event with action of 53 * MonitoringEvent.STOP_MONITORING is received. 54 * @throws AdminEventListenerException when the listener is unable to 55 * process the event. 56 */ 57 public void stopMonitoring(MonitoringEvent event) 58 throws AdminEventListenerException; 59 60 /** 61 * Get monitoring data for the component specified in the event. This method 62 * is called whenever a monitoring event with action of 63 * MonitoringEvent.GET_MONITOR_DATA is received. 64 * @throws AdminEventListenerException when the listener is unable to 65 * process the event. 66 */ 67 public void getMonitoringData(MonitoringEvent event) 68 throws AdminEventListenerException; 69 70 /** 71 * Set monitoring data for the component specified in the event. This method 72 * is called whenever a monitoring event with action of 73 * MonitoringEvent.SET_MONITOR_DATA is received. 74 * @throws AdminEventListenerException when the listener is unable to 75 * process the event. 76 */ 77 public void setMonitoringData(MonitoringEvent event) 78 throws AdminEventListenerException; 79 80 /** 81 * Get list of monitorable(s) for the component specified in the event. 82 * This method is called whenever a monitoring event with action of 83 * MonitoringEvent.LIST_MONITORABLE is received. 84 * @throws AdminEventListenerException when the listener is unable to 85 * process the event. 86 */ 87 public void listMonitorable(MonitoringEvent event) 88 throws AdminEventListenerException; 89 } 90