File Doc Category Size Date Package
Listener.java API Doc Glassfish v2 API 6955 Fri May 04 22:31:16 BST 2007 com.sun.enterprise.admin.monitor.callflow

Listener

public interface Listener

This interface exposes the call flow Listener API. This interface is implemented by listeners that are registered with the call flow agent, in order to receive the call flow trap point notifications. Note 1: There are no ordering guaratees for the various notifications. Note 2: A listener implementation must be stateless. This is allow the listener to be accessed concurrently by multiple threads, and yet avoid synchronization overhead associated with protected access to shared state, in a multi-threaded environment. Note 3: It is also imperative that the listener implementation is light-weight, and avoids time consuming operations such as disk access, logging, synchronization locks, et cetera. This will ensure that the listener does not negatively impact the performance of the application thread.

author: Ram Jeyaraman
date: October 11, 2005

Fields Summary
Constructors Summary
Methods Summary
public void ejbMethodEnd(java.lang.String requestId, java.lang.Throwable exception)
This notification indicates that an EJB method has completed. The parameters provide information on the outcome of the invocation such as exception, if any.
public void ejbMethodStart(java.lang.String requestId, java.lang.String methodName, java.lang.String applicationName, java.lang.String moduleName, java.lang.String componentName, ComponentType componentType, java.lang.String callerPrincipal, java.lang.String transactionId)
This notification indicates that an EJB method is about to be invoked. This parameters provide information such as method name, component name, component type, application name, module name, caller principal.
public void entityManagerMethodEnd(java.lang.String requestId)
This notification indicates that an EntityManager method has completed.
public void entityManagerMethodStart(java.lang.String requestId, EntityManagerMethod entityManagerMethod, java.lang.String applicationName, java.lang.String moduleName, java.lang.String componentName, ComponentType componentType, java.lang.String callerPrincipal)
This notification indicates that an EntityManager method is about to be invoked. This parameters provide information such as method name, component name, component type, application name, module name, caller principal.
public void entityManagerQueryEnd(java.lang.String requestId)
This notification indicates that an EntityManager Query method has completed.
public void entityManagerQueryStart(java.lang.String requestId, EntityManagerQueryMethod queryMethod, java.lang.String applicationName, java.lang.String moduleName, java.lang.String componentName, ComponentType componentType, java.lang.String callerPrincipal)
This notification indicates that an EntityManager Query method is about to be invoked. This parameters provide information such as method name, component name, component type, application name, module name, caller principal.
public void requestEnd(java.lang.String requestId)
This notification indicates that a request is about to complete.
public void requestStart(java.lang.String requestId, RequestType requestType, java.lang.String callerIPAddress, java.lang.String remoteUser)
This notification indicates that a request is being started. Allowed request types are: 1. Remote HTTP Web request. 2. Remote EJB request. 3. MDB request. 4. Timer EJB.
param
requestType Type of the request.
param
callerIPAddress Client host IP address of caller.
public void webMethodEnd(java.lang.String requestId, java.lang.Throwable exception)
This notification indicates that a web method has completed. The parameters provide information on the outcome of the invocation such as exception, if any.
public void webMethodStart(java.lang.String requestId, java.lang.String methodName, java.lang.String applicationName, java.lang.String moduleName, java.lang.String componentName, ComponentType componentType, java.lang.String callerPrincipal)
This notification indicates that a web method is about to be invoked. This parameters provide information such as method name, component name, component type, application name, module name, caller principal, and caller IP address.