Module org.htmlunit.corejs

Package org.htmlunit.corejs.javascript

Class Synchronizer

java.lang.Object

org.htmlunit.corejs.javascript.Delegator

org.htmlunit.corejs.javascript.Synchronizer

All Implemented Interfaces:

Callable, Constructable, Function, PropHolder<Scriptable>, Scriptable, SymbolScriptable

public class Synchronizer
extends Delegator

This class provides support for implementing Java-style synchronized methods in Javascript.

Synchronized functions are created from ordinary Javascript functions by the Synchronizer constructor, e.g. new Packages.org.htmlunit.corejs.javascript.Synchronizer(fun) . The resulting object is a function that establishes an exclusive lock on the this object of its invocation.

The Rhino shell provides a short-cut for the creation of synchronized methods: sync(fun) has the same effect as calling the above constructor.

Author:

Matthias Radestock

See Also:

• Delegator

Field Summary

Fields inherited from class org.htmlunit.corejs.javascript.Delegator

obj

Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor	Description
Synchronizer(Scriptable obj)	Create a new synchronized function from an existing one.
Synchronizer(Scriptable obj, Object syncObject)	Create a new synchronized function from an existing one using an explicit object as synchronization object.

Method Summary

Modifier and Type	Method	Description
Object	call(Context cx, VarScope scope, Object thisObj, Object[] args)	Call the function.

Methods inherited from class org.htmlunit.corejs.javascript.Delegator

construct, delete, delete, delete, get, get, get, getClassName, getDefaultValue, getDelegee, getIds, getParentScope, getPrototype, has, has, has, hasInstance, newInstance, put, put, put, setDelegee, setParentScope, setPrototype

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.htmlunit.corejs.javascript.Constructable

construct

Methods inherited from interface org.htmlunit.corejs.javascript.Function

getDeclarationScope, isConstructor

Methods inherited from interface org.htmlunit.corejs.javascript.Scriptable

getAncestor

Constructor Details

Synchronizer

public Synchronizer(Scriptable obj)

Create a new synchronized function from an existing one.

Parameters:

obj - the existing function

Synchronizer

public Synchronizer(Scriptable obj,
 Object syncObject)

Create a new synchronized function from an existing one using an explicit object as synchronization object.

Parameters:

obj - the existing function

syncObject - the object to synchronized on

Method Details

call

public Object call(Context cx,
 VarScope scope,
 Object thisObj,
 Object[] args)

Description copied from interface: Function

Call the function.

Note that the array of arguments is not guaranteed to have length greater than 0.

Specified by:

call in interface Callable

Specified by:

call in interface Function

Overrides:

call in class Delegator

Parameters:

cx - the current Context for this thread

scope - the scope to execute the function relative to. This is set to the value returned by getParentScope() except when the function is called from a closure.

thisObj - the JavaScript this object

args - the array of arguments

Returns:

the result of the call

See Also:

• Function.call(org.htmlunit.corejs.javascript.Context, org.htmlunit.corejs.javascript.VarScope, java.lang.Object, java.lang.Object[])