IBM WebSphere Adapters User Manual page 188

public interface EventSourceContext
{
/**
* Returns an event source for a monitored element.
* @param elementKind an artifact kind that can be monitored e.g ResourceAdapter.
* @param elementName the name of the monitored element
* @return the event source object that encapsulates the element to be monitored
*/
EventSource getEventSource(String elementKind, String elementName);
/**
* Creates an event source for a monitored element. The usage is similar to
* java.util.logging.Logger.
* @param componentTypeQName : The element type can be specified using the element
* type from
* a schema which defines the structure/syntax of the artifact itself
* e.g.http://www.ibm.com/xmlns/prod/websphere/scdl/eis/6.0.0:JCAAdapter"
* @param componentQName the name of the component ,
* e.g http://www.ibm.com/j2ca/ResourceAdapter:Customer"
* @return the event source factory for the component to be monitored
*/
public interface Factory{
EventSourceContext create(String componentTypeQName, String componentQName);
}
}
EventSource
Event Sources are applications or components that submit event creation requests
to CEI. Each monitorable element defines an event source an example of event
source is an adapter. An event source is used to retrieve event points in order to
send monitoring events to a CEI logger.
package com.ibm.j2ca.extension.monitoring.CEI;
/**
* An event source represents a monitoarable element kind such as an adapter....
* Each monitorable element defines an event source, Each event source defines a
* set of component-element specific event points. An event source object is used
* to retrieve event points to fire monitoring events
*/
public interface EventSource
{
/**
* returns an EventPoint for the monitored element
* @param eventPointName a valid event nature for this event
*/
public EventPoint getEventPoint(String eventPointName);
}
EventPoint
Every monitorable component needs to define the event points. Each event point
defines an event and the data or payload associated with that event. The
EventPoint is used to fire monitoring events. The client of an event point needs to
know the payload of the fired events. Where the payload of an event can be
specified in an event catalog for each component.
package com.ibm.j2ca.extension.monitoring.CEI;
/**
* Every monitorable component needs to defines the event points. Each event point
* defines an event and the data/payload associated with that event. The EventPoint
* is used to fire monitoring events.
182
WebSphere Adapters: WebSphere Adapter Toolkit User Guide