util

Class MethodCoordinator

java.lang.Object

util.MethodCoordinator

public class MethodCoordinator
extends java.lang.Object

Class to coordinate execution of a method such that it only gets run once per VM even though it is called concurrently. To used this, create an instance of this class giving a static method name and class. For every thread that tries to execute the given class and method name via a call to executeOnce, only one thread will actually execute it. After one thread has executed it, all other calls to executeOnce() is a noop. To execute the same method again in a "once per VM" manner, you must create a new instance of this class.

Constructor Summary

Constructors

Constructor and Description
MethodCoordinator(java.lang.String className, java.lang.String methodName) Constructor to specify a class and method to execute

Method Summary

Modifier and Type	Method and Description
java.lang.Object	executeOnce(java.lang.Object receiver, java.lang.Object[] args) Execute this instance's class/method one time only.
boolean	methodWasExecuted() Return whether this instance's method has been executed or not.

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodCoordinator

public MethodCoordinator(java.lang.String className,
                         java.lang.String methodName)

Constructor to specify a class and method to execute

Method Detail

executeOnce

public java.lang.Object executeOnce(java.lang.Object receiver,
                                    java.lang.Object[] args)

Execute this instance's class/method one time only. All threads calling this method will only result in one of them actually executing the method. Others will just be a noop. To execute this method again later, a new instance of this class must be created.

Parameters:

receiver - The object to receive the method; can be null for a static method.

args - The arguments used to invoke the method.

Returns:

The return value of executing this instance's method.

methodWasExecuted

public boolean methodWasExecuted()

Return whether this instance's method has been executed or not.