com.goldencode.p2j.util

Class AccumulatorManager

java.lang.Object

com.goldencode.p2j.util.AccumulatorManager

All Implemented Interfaces:

Scopeable

public class AccumulatorManager
extends java.lang.Object
implements Scopeable

Provides context-local scoped accumulators.

All references can be added to the top scope (closest enclosing scope).

Implements the Scopeable interface to allow this class to be automatically notified of all scope start and end occurances. This removes the need for client code to be instrumented to provide this service. The use of this class is now tied to the TransactionManager class. In particular, the singleton instance of this class is used in each context- local list of Scopeable objects as a dispatcher. This bit of nastiness is necessary since the Java Interface can't be implemented on a static basis but instead requires an instance method implementation. These instance methods then call the static counterparts which is where the content-local versions of the resource pools are accessed.

Author:

CA

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	AccumulatorManager.ContextContainer Simple ContextLocal subclass that properly initializes the context-local reference to a new instance of a case-sensitive ScopedSymbolDictionary that has a global scope.
private static class	AccumulatorManager.WorkArea Stores global data relating to the state of the current context.

Field Summary

Fields

Modifier and Type	Field and Description
private static AccumulatorManager.ContextContainer	context Pool of accums which is context-local.
private AccumulatorManager.WorkArea	wa The container with the instance state.

Constructor Summary

Constructors

Constructor and Description
AccumulatorManager()

Method Summary

Modifier and Type	Method and Description
static void	addAccumulator(Accumulator accum) Adds an accumulator to the current set of accumulators.
static AccumulatorManager	getInstance() Get the AccumulatorManager context-local instance.
ScopeId	getScopeId() Get the ScopeId for the instance.
void	scopeDeleted() Provides notification that the external procedure scope has been deleted.
void	scopeFinished() Provides a notification that a scope is about to be exited.
void	scopeStart(BlockDefinition block) Provides a notification that a new scope is about to be entered.

Methods inherited from class java.lang.Object

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

Field Detail

context

private static AccumulatorManager.ContextContainer context

Pool of accums which is context-local. Initializes upon first use.

wa

private final AccumulatorManager.WorkArea wa

The container with the instance state.

Constructor Detail

AccumulatorManager

public AccumulatorManager()

Method Detail

getInstance

public static AccumulatorManager getInstance()

Get the AccumulatorManager context-local instance.

Returns:

See above.

addAccumulator

public static void addAccumulator(Accumulator accum)

Adds an accumulator to the current set of accumulators.

Parameters:

accum - The accumulator

scopeStart

public void scopeStart(BlockDefinition block)

Provides a notification that a new scope is about to be entered.

Specified by:

scopeStart in interface Scopeable

Parameters:

block - The explicit block definition which required this notification.

scopeFinished

public void scopeFinished()

Provides a notification that a scope is about to be exited.

Specified by:

scopeFinished in interface Scopeable

scopeDeleted

public void scopeDeleted()

Provides notification that the external procedure scope has been deleted.

This is a no-op for accumulators.

Specified by:

scopeDeleted in interface Scopeable

getScopeId

public ScopeId getScopeId()

Get the ScopeId for the instance.

Specified by:

getScopeId in interface Scopeable

Returns:

ScopeId.ACCUMULATOR_MANAGER.