com.goldencode.p2j.net

Class ExportTracker

java.lang.Object

com.goldencode.p2j.net.ExportTracker

All Implemented Interfaces:

SessionListener

class ExportTracker
extends java.lang.Object
implements SessionListener

A session tracker for each static exported API. The exported APIs are tracked by:

• the defining jar
• the interface which exports the API
• the interface method for this API

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.HashMap<java.net.URL,java.util.Map<java.lang.Class<?>,java.util.Map<java.lang.reflect.Method,java.util.Set<Session>>>>	data The tracked data.
private static CentralLogger	LOG Logger
private static ExportTracker	tracker The tracker instance, we need only one; needed to notify the tracker when a session is closed, to remove it.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ExportTracker() C'tor, forces a singleton.

Method Summary

Modifier and Type	Method and Description
(package private) static ExportTracker	getTracker() Get the singleton tracker instance.
(package private) static boolean	hasActiveSessions(java.lang.Class<?> iface) Check if there are active sessions which have invoked an exported method in the given class.
(package private) static boolean	hasActiveSessions(java.lang.Class<?> iface, java.lang.reflect.Method method) Check if there are active sessions which have invoked the given method.
void	initialize(Session session) This method is called when the session is starting.
(package private) static java.util.Set<Session>	listSessions(java.lang.Class<?> iface) List the active sessions which have invoked exported methods in the given class.
(package private) static java.util.Set<Session>	listSessions(java.lang.Class<?> iface, java.lang.reflect.Method method) List the active sessions which have invoked the given exported method.
(package private) static java.util.Set<Session>	listSessions(java.lang.String jar, java.lang.String iface) List the active sessions which have invoked APIs in the given jar.
void	terminate(Session session) This method is called when the session is ending.
(package private) static void	trackRequest(java.lang.Class<?> iface, java.lang.reflect.Method method, Session session) Track the request to the given method.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

LOG

private static final CentralLogger LOG

Logger

tracker

private static final ExportTracker tracker

The tracker instance, we need only one; needed to notify the tracker when a session is closed, to remove it.

data

private static final java.util.HashMap<java.net.URL,java.util.Map<java.lang.Class<?>,java.util.Map<java.lang.reflect.Method,java.util.Set<Session>>>> data

The tracked data.

Constructor Detail

ExportTracker

private ExportTracker()

C'tor, forces a singleton.

Method Detail

listSessions

static java.util.Set<Session> listSessions(java.lang.String jar,
                                           java.lang.String iface)

List the active sessions which have invoked APIs in the given jar. If the jar name is null, list all active tracked sessions.

Parameters:

jar - The jar name; if null, list all active tracked sessions.

iface - The interface for which we need the sessions; if null, search through the entire jar.

Returns:

See above.

getTracker

static ExportTracker getTracker()

Get the singleton tracker instance.

Returns:

See above.

hasActiveSessions

static boolean hasActiveSessions(java.lang.Class<?> iface,
                                 java.lang.reflect.Method method)

Check if there are active sessions which have invoked the given method.

Parameters:

iface - The interface used to register the method as an API.

method - The exported method.

Returns:

See above.

hasActiveSessions

static boolean hasActiveSessions(java.lang.Class<?> iface)

Check if there are active sessions which have invoked an exported method in the given class.

Parameters:

iface - The interface used to register the method as an API.

Returns:

See above.

listSessions

static java.util.Set<Session> listSessions(java.lang.Class<?> iface)

List the active sessions which have invoked exported methods in the given class.

Parameters:

iface - The interface used to register the method as an API.

Returns:

See above.

listSessions

static java.util.Set<Session> listSessions(java.lang.Class<?> iface,
                                           java.lang.reflect.Method method)

List the active sessions which have invoked the given exported method.

Parameters:

iface - The interface used to register the method as an API.

method - The exported method.

Returns:

See above.

trackRequest

static void trackRequest(java.lang.Class<?> iface,
                         java.lang.reflect.Method method,
                         Session session)

Track the request to the given method.

Parameters:

iface - The interface used to register the method as an API.

method - The invoked exported method.

session - The sessions which is invoking the exported method.

initialize

public void initialize(Session session)

This method is called when the session is starting.

Specified by:

initialize in interface SessionListener

Parameters:

session - The session that is starting.

terminate

public void terminate(Session session)

This method is called when the session is ending. It removes all tracked data for this session.

Specified by:

terminate in interface SessionListener

Parameters:

session - The session that is ending.