Package com.caplin.management.jmx.relations

Defines the classes used to represent "to many" relationships within the Caplin JMX implementation.

See: Description

Interface Summary

Interface	Description
RelationSetUpdateListener	The listener interface that must be implemented by any class that needs to be informed when an element is added to, or removed from, a RelationSet.

Class Summary

Class	Description
RelationSet	Represents a "to many" relationship, where a particular MBean attribute defines a link between that MBean and many other MBeans.
RelationSetNotification	Represents a change to the state of a RelationSet.
RelationSetNotification.NotificationType	A type safe enumeration representation of the different possible types of RelationSet notifications.
RelationSetNotificationFilter	Implementation of the NotificationFilter interface that filters out all Notifications that do not apply to a specific RelationSet.

Package com.caplin.management.jmx.relations Description

Defines the classes used to represent "to many" relationships within the Caplin JMX implementation.

A RelationSet contains all the elements that belong to the "to many" side of a relationship. Examples of "to many" relationships are users to user sessions, user sessions to cached objects and cached objects to user sessions.

RelationSet example:

 public void getAttribute(ObjectName objectName, String attributeName)
 {
    // get the value of a specific attribute for a particular MBean
    Object attributeValue = mbeanServer.getAttribute(objectName, attributeName);
    
    if (attributeValue instanceof RelationSet)
    {
       // if the attribute is a RelationSet, add an update listener and register a notification listener and filter with the server
       RelationSet relationSet = (RelationSet) attributeValue;
          
       relationSet.addUpdateListener(new RelationSetUpdateListenerImpl() {
          public void elementAdded(Object addedElement, String type)
          {
             System.out.println("Element added: " + addedElement);
          }
          
          public void elementRemoved(Object removedElement, String type)
          {
             System.out.println("Element removed: " + removedElement);
          }
       });
          
       mbeanServer.addNotificationListener(objectName, relationSet.getNotificationListener(), relationSet.getNotificationFilter(), null);
    }
    
    // call a method that displays the value of the attribute according to its type
    displayAttributeValue(attributeValue);
 }