BBjNamespace::setCallbackForVariableChange

Description

In BBj 3.01 and higher, this BBjNamespace method sets a callback that will be called whenever the specified variable is changed.

Syntax

Return Value	Method
void	setCallbackForVariableChange(String `varName`, String `callbackName`)
void	setCallbackForVariableChange(String `varName`, CustomObject `customObj`, String `methodName`)
void	setCallbackForVariableChange(String `varName`, Object `object`, String `methodName`)

Parameters

Parameter	Description
varName	Specifies the name of the object being watched.
callbackName	Specifies the name of the callback to be called when the value changes.
customObj	Specifies a CustomObject that has a method which is to be called when the value changes.
methodName	Specifies the method of the Object which is to be called.
object	Specifies a Java Object that has a method which is to be called when the value changes.

Return Value

None.

Remarks

The callback set using setCallbackForVariableChange() will be called whenever the value for the specified variable is set to a new value that is different from its previous value. This is different from a callback set using the setCallbackForVariable(), which will only be called each time the value of a variable is set even if the new value is the same as the old value.

All callbacks that a program registered on a BBjNamespace are removed when that program executes START, STOP, END, or BEGIN. All callbacks registered by a BBj process are removed when the BBj process terminates.

Example

namespace! = BBjAPI().getNamespace("test","test",1)

rem 'set a callback that will be called if *any* value in namespace changes
namespace!.setCallbackForNamespaceChange("someValueChanged")

rem 'set a callback that will be called if the value changes
namespace!.setCallbackForVariableChange("x","xChanged")

rem 'set a callback that will be called if *any* value is
rem 'set (even if the value is not changed)
namespace!.setCallbackForNamespace("someValueSet")

rem 'set a callback that will be called if the value of x is set
rem '(even if the values is not changed)
namespace!.setCallbackForVariable("x","xSet")

rem 'remove all callbacks
namespace!.removeCallbackForNamespace()
namespace!.removeCallbackForNamespaceChange()
namespace!.removeCallbackForVariableChange("x")
namespace!.removeCallbackForVariable("x")
end

someValueChanged:
    print "some value in ", namespace!.getName(), " has changed"
return

someValueSet:
    print "some value in ", namespace!.getName(), " has been set"
return

xChanged:
    print "the value of x in ", namespace!.getName(), " has changed"
return

xSet:
    print "the value of x in ", namespace!.getName(), " has been set"
return