001: /*
002: * JBoss, Home of Professional Open Source.
003: * Copyright 2006, Red Hat Middleware LLC, and individual contributors
004: * as indicated by the @author tags. See the copyright.txt file in the
005: * distribution for a full listing of individual contributors.
006: *
007: * This is free software; you can redistribute it and/or modify it
008: * under the terms of the GNU Lesser General Public License as
009: * published by the Free Software Foundation; either version 2.1 of
010: * the License, or (at your option) any later version.
011: *
012: * This software is distributed in the hope that it will be useful,
013: * but WITHOUT ANY WARRANTY; without even the implied warranty of
014: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
015: * Lesser General Public License for more details.
016: *
017: * You should have received a copy of the GNU Lesser General Public
018: * License along with this software; if not, write to the Free
019: * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
021: */
022: package org.jboss.management.mejb;
023:
024: import org.jboss.logging.Logger;
025:
026: import javax.management.Notification;
027: import java.rmi.RemoteException;
028:
029: /**
030: * Notification Listener Implementation registered as
031: * MBean on the remote JMX Server and the added as
032: * Notification Listener on the remote JMX Server.
033: * Each notification received will be transfered to
034: * the remote client using RMI Callback Objects.
035: *
036: * @author <A href="mailto:andreas@jboss.org">Andreas Schaefer</A>
037: * @version $Revision: 57197 $
038: * @jmx:mbean extends="org.jboss.management.mejb.ListenerMBean"
039: */
040: public class RMINotificationListener implements
041: RMINotificationListenerMBean {
042: private static final Logger log = Logger
043: .getLogger(RMINotificationListener.class);
044:
045: // -------------------------------------------------------------------------
046: // Members
047: // -------------------------------------------------------------------------
048:
049: private RMIClientNotificationListenerInterface mClientListener;
050:
051: // -------------------------------------------------------------------------
052: // Constructor
053: // -------------------------------------------------------------------------
054:
055: /**
056: * Creates the RMI Notification Listener MBean implemenation which
057: * will be registered at the remote JMX Server as notificatin listener
058: * and then send the notification over the provided RMI Notification
059: * sender to the client
060: *
061: * @param pClientListener RMI-Stub used to transfer the Notification over
062: * the wire.
063: */
064: public RMINotificationListener(
065: RMIClientNotificationListenerInterface pClientListener) {
066: log.debug("RMINotificationListener(), client listener: "
067: + pClientListener);
068: mClientListener = pClientListener;
069: }
070:
071: // -------------------------------------------------------------------------
072: // Public Methods
073: // -------------------------------------------------------------------------
074:
075: /**
076: * Handles the given notifcation event and passed it to the registered
077: * RMI Notification Sender
078: *
079: * @param pNotification NotificationEvent
080: * @param pHandback Handback object
081: */
082: public void handleNotification(Notification pNotification,
083: Object pHandback) {
084: try {
085: log.debug("RMINotificationListener.handleNotification() "
086: + ", notification: " + pNotification
087: + ", handback: " + pHandback
088: + ", client listener: " + mClientListener);
089: mClientListener
090: .handleNotification(pNotification, pHandback);
091: } catch (RemoteException e) {
092: throw new org.jboss.util.NestedRuntimeException(e);
093: }
094: }
095:
096: /**
097: * Test if this and the given Object are equal. This is true if the given
098: * object both refer to the same local listener
099: *
100: * @param pTest Other object to test if equal
101: * @return True if both are of same type and
102: * refer to the same local listener
103: */
104: public boolean equals(Object pTest) {
105: if (pTest instanceof RMINotificationListener) {
106: return mClientListener
107: .equals(((RMINotificationListener) pTest).mClientListener);
108: }
109: return false;
110: }
111:
112: /**
113: * @return Hashcode of the remote listener
114: */
115: public int hashCode() {
116: return mClientListener.hashCode();
117: }
118: }
|