mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-30 00:01:50 +00:00
added support for implementing Java-style synchronized methods in Javascript
This commit is contained in:
matthias%sorted.org
parent
2688504595
commit
e5ae12e585
@ -16,4 +16,5 @@ apiClasses=\
|
||||
org/mozilla/javascript/ScriptableObject.java,\
|
||||
org/mozilla/javascript/SecuritySupport.java,\
|
||||
org/mozilla/javascript/WrapHandler.java,\
|
||||
org/mozilla/javascript/Wrapper.java
|
||||
org/mozilla/javascript/Wrapper.java,\
|
||||
org/mozilla/javascript/Synchronizer.java
|
||||
|
||||
250
js/rhino/org/mozilla/javascript/Delegator.java
Normal file
250
js/rhino/org/mozilla/javascript/Delegator.java
Normal file
@ -0,0 +1,250 @@
|
||||
/* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
||||
* The contents of this file are subject to the Mozilla Public License
|
||||
* Version 1.1 (the "License"); you may not use this file except in
|
||||
* compliance with the License. You may obtain a copy of the License at
|
||||
* http://www.mozilla.org/MPL/
|
||||
*
|
||||
* Software distributed under the License is distributed on an "AS IS"
|
||||
* basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
|
||||
* License for the specific language governing rights and limitations
|
||||
* under the License.
|
||||
*
|
||||
* The Original Code is Delegator.java, released Sep 27, 2000.
|
||||
*
|
||||
* The Initial Developer of the Original Code is Matthias Radestock.
|
||||
* <matthias@sorted.org>. Portions created by Matthias Radestock are
|
||||
* Copyright (C) 2000 Matthias Radestock. All Rights Reserved.
|
||||
*
|
||||
* Contributor(s):
|
||||
* Redfig Ltd (http://www.redfig.com)
|
||||
* LShift Ltd (http://www.lshift.net)
|
||||
*
|
||||
* Alternatively, the contents of this file may be used under the terms
|
||||
* of the GNU Public License (the "GPL License"), in which case the
|
||||
* provisions of the GPL License are applicable instead of those
|
||||
* above. If you wish to allow use of your version of this file only
|
||||
* under the terms of the GPL License and not to allow others to use
|
||||
* your version of this file under the MPL, indicate your decision by
|
||||
* deleting the provisions above and replace them with the notice and
|
||||
* other provisions required by the GPL License. If you do not delete
|
||||
* the provisions above, a recipient may use your version of this file
|
||||
* under either the MPL or the GPL License.
|
||||
*/
|
||||
|
||||
// API class
|
||||
|
||||
package org.mozilla.javascript;
|
||||
|
||||
/**
|
||||
* This is a helper class for implementing wrappers around Scriptable
|
||||
* objects. It implements the Function interface and delegates all
|
||||
* invocations to a delegee Scriptable object. The normal use of this
|
||||
* class involves creating a sub-class and overriding one or more of
|
||||
* the methods.
|
||||
*
|
||||
* A useful application is the implementation of interceptors,
|
||||
* pre/post conditions, debugging.
|
||||
*
|
||||
* @see Function
|
||||
* @see Scriptable
|
||||
* @author Matthias Radestock
|
||||
*/
|
||||
|
||||
public class Delegator implements Function {
|
||||
|
||||
protected Scriptable obj = null;
|
||||
|
||||
/**
|
||||
* Create a Delegator prototype.
|
||||
*
|
||||
* This constructor should only be used for creating prototype
|
||||
* objects of Delegator.
|
||||
*
|
||||
* @see org.mozilla.javascript.Delegator#construct
|
||||
*/
|
||||
public Delegator() {
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a new Delegator that forwards requests to a delegee
|
||||
* Scriptable object.
|
||||
*
|
||||
* @param obj the delegee
|
||||
* @see org.mozilla.javascript.Scriptable
|
||||
*/
|
||||
public Delegator(Scriptable obj) {
|
||||
this.obj = obj;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve the delegee.
|
||||
*
|
||||
* @return the delegee
|
||||
*/
|
||||
public Scriptable getDelegee() {
|
||||
return obj;
|
||||
}
|
||||
/**
|
||||
* Set the delegee.
|
||||
*
|
||||
* @param obj the delegee
|
||||
* @see org.mozilla.javascript.Scriptable
|
||||
*/
|
||||
public void setDelegee(Scriptable obj) {
|
||||
this.obj = obj;
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getClassName
|
||||
*/
|
||||
public String getClassName() {
|
||||
return obj.getClassName();
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#get
|
||||
*/
|
||||
public Object get(String name, Scriptable start) {
|
||||
return obj.get(name,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#get
|
||||
*/
|
||||
public Object get(int index, Scriptable start) {
|
||||
return obj.get(index,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#has
|
||||
*/
|
||||
public boolean has(String name, Scriptable start) {
|
||||
return obj.has(name,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#has
|
||||
*/
|
||||
public boolean has(int index, Scriptable start) {
|
||||
return obj.has(index,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#put
|
||||
*/
|
||||
public void put(String name, Scriptable start, Object value) {
|
||||
obj.put(name,start,value);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#put
|
||||
*/
|
||||
public void put(int index, Scriptable start, Object value) {
|
||||
obj.put(index,start,value);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#delete
|
||||
*/
|
||||
public void delete(String name) {
|
||||
obj.delete(name);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#delete
|
||||
*/
|
||||
public void delete(int index) {
|
||||
obj.delete(index);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getPrototype
|
||||
*/
|
||||
public Scriptable getPrototype() {
|
||||
return obj.getPrototype();
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#setPrototype
|
||||
*/
|
||||
public void setPrototype(Scriptable prototype) {
|
||||
obj.setPrototype(prototype);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getParentScope
|
||||
*/
|
||||
public Scriptable getParentScope() {
|
||||
return obj.getParentScope();
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#setParentScope
|
||||
*/
|
||||
public void setParentScope(Scriptable parent) {
|
||||
obj.setParentScope(parent);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getIds
|
||||
*/
|
||||
public Object[] getIds() {
|
||||
return obj.getIds();
|
||||
}
|
||||
/**
|
||||
* Note that this method does not get forwarded to the delegee if
|
||||
* the <code>hint</code> parameter is null,
|
||||
* <code>ScriptRuntime.ScriptableClass</code> or
|
||||
* <code>ScriptRuntime.FunctionClass</code>. Instead the object
|
||||
* itself is returned.
|
||||
*
|
||||
* @param hint the type hint
|
||||
* @return the default value
|
||||
*
|
||||
* @see org.mozilla.javascript.Scriptable#getDefaultValue
|
||||
*/
|
||||
public Object getDefaultValue(Class hint) {
|
||||
return (hint == null ||
|
||||
hint == ScriptRuntime.ScriptableClass ||
|
||||
hint == ScriptRuntime.FunctionClass) ?
|
||||
this : obj.getDefaultValue(hint);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#hasInstance
|
||||
*/
|
||||
public boolean hasInstance(Scriptable instance) {
|
||||
return obj.hasInstance(instance);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Function#call
|
||||
*/
|
||||
public Object call(Context cx, Scriptable scope, Scriptable thisObj,
|
||||
Object[] args)
|
||||
throws JavaScriptException {
|
||||
return ((Function)obj).call(cx,scope,thisObj,args);
|
||||
}
|
||||
|
||||
/**
|
||||
* Note that if the <code>delegee</code> is <code>null</code>,
|
||||
* this method creates a new instance of the Delegator itself
|
||||
* rathert than forwarding the call to the
|
||||
* <code>delegee</code>. This permits the use of Delegator
|
||||
* prototypes.
|
||||
*
|
||||
* @param cx the current Context for this thread
|
||||
* @param scope an enclosing scope of the caller except
|
||||
* when the function is called from a closure.
|
||||
* @param args the array of arguments
|
||||
* @return the allocated object
|
||||
* @exception JavaScriptException if an uncaught exception
|
||||
* occurred while executing the constructor
|
||||
*
|
||||
* @see org.mozilla.javascript.Function#construct
|
||||
*/
|
||||
public Scriptable construct(Context cx, Scriptable scope, Object[] args)
|
||||
throws JavaScriptException {
|
||||
if (obj == null) {
|
||||
//this little trick allows us to declare prototype objects for
|
||||
//Delegators
|
||||
try {
|
||||
Delegator n = (Delegator)this.getClass().newInstance();
|
||||
n.setDelegee((Scriptable)args[0]);
|
||||
return n;
|
||||
}
|
||||
catch (Exception e) {
|
||||
e.printStackTrace();
|
||||
System.exit(0);
|
||||
}
|
||||
return (Scriptable)null;
|
||||
}
|
||||
else {
|
||||
return ((Function)obj).construct(cx,scope,args);
|
||||
}
|
||||
}
|
||||
}
|
||||
77
js/rhino/org/mozilla/javascript/Synchronizer.java
Normal file
77
js/rhino/org/mozilla/javascript/Synchronizer.java
Normal file
@ -0,0 +1,77 @@
|
||||
/* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
||||
* The contents of this file are subject to the Mozilla Public License
|
||||
* Version 1.1 (the "License"); you may not use this file except in
|
||||
* compliance with the License. You may obtain a copy of the License at
|
||||
* http://www.mozilla.org/MPL/
|
||||
*
|
||||
* Software distributed under the License is distributed on an "AS IS"
|
||||
* basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
|
||||
* License for the specific language governing rights and limitations
|
||||
* under the License.
|
||||
*
|
||||
* The Original Code is Synchronizer.java code, released Sep 27, 2000.
|
||||
*
|
||||
* The Initial Developer of the Original Code is Matthias Radestock
|
||||
* <matthias@sorted.org>. Portions created by Matthias Radestock are
|
||||
* Copyright (C) 2000 Matthias Radestock. All Rights Reserved.
|
||||
*
|
||||
* Contributor(s):
|
||||
* Redfig Ltd (http://www.redfig.com)
|
||||
* LShift Ltd (http://www.lshift.net)
|
||||
*
|
||||
* Alternatively, the contents of this file may be used under the terms
|
||||
* of the GNU Public License (the "GPL License"), in which case the
|
||||
* provisions of the GPL License are applicable instead of those
|
||||
* above. If you wish to allow use of your version of this file only
|
||||
* under the terms of the GPL License and not to allow others to use
|
||||
* your version of this file under the MPL, indicate your decision by
|
||||
* deleting the provisions above and replace them with the notice and
|
||||
* other provisions required by the GPL License. If you do not delete
|
||||
* the provisions above, a recipient may use your version of this file
|
||||
* under either the MPL or the GPL License.
|
||||
*/
|
||||
|
||||
// API class
|
||||
|
||||
package org.mozilla.javascript;
|
||||
|
||||
/**
|
||||
* This class provides support for implementing Java-style synchronized
|
||||
* methods in Javascript.
|
||||
*
|
||||
* Synchronized functions are created from ordinary Javascript
|
||||
* functions by the <code>Synchronizer</code> constructor, e.g.
|
||||
* <code>new Packages.org.mozilla.javascript.Synchronizer(fun)</code>.
|
||||
* The resulting object is a function that establishes an exclusive
|
||||
* lock on the <code>this</code> object of its invocation.
|
||||
*
|
||||
* The Rhino shell provides a short-cut for the creation of
|
||||
* synchronized methods: <code>sync(fun)</code> has the same effect as
|
||||
* calling the above constructor.
|
||||
*
|
||||
* @see org.mozilla.javascript.Delegator
|
||||
* @author Matthias Radestock
|
||||
*/
|
||||
|
||||
public class Synchronizer extends Delegator {
|
||||
|
||||
/**
|
||||
* Create a new synchronized function from an existing one.
|
||||
*
|
||||
* @param obj the existing function
|
||||
*/
|
||||
public Synchronizer(Scriptable obj) {
|
||||
super(obj);
|
||||
}
|
||||
|
||||
/**
|
||||
* @see org.mozilla.javascript.Function#call
|
||||
*/
|
||||
public Object call(Context cx, Scriptable scope, Scriptable thisObj,
|
||||
Object[] args)
|
||||
throws JavaScriptException {
|
||||
synchronized(thisObj) {
|
||||
return ((Function)obj).call(cx,scope,thisObj,args);
|
||||
}
|
||||
}
|
||||
}
|
||||
250
js/rhino/src/org/mozilla/javascript/Delegator.java
Normal file
250
js/rhino/src/org/mozilla/javascript/Delegator.java
Normal file
@ -0,0 +1,250 @@
|
||||
/* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
||||
* The contents of this file are subject to the Mozilla Public License
|
||||
* Version 1.1 (the "License"); you may not use this file except in
|
||||
* compliance with the License. You may obtain a copy of the License at
|
||||
* http://www.mozilla.org/MPL/
|
||||
*
|
||||
* Software distributed under the License is distributed on an "AS IS"
|
||||
* basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
|
||||
* License for the specific language governing rights and limitations
|
||||
* under the License.
|
||||
*
|
||||
* The Original Code is Delegator.java, released Sep 27, 2000.
|
||||
*
|
||||
* The Initial Developer of the Original Code is Matthias Radestock.
|
||||
* <matthias@sorted.org>. Portions created by Matthias Radestock are
|
||||
* Copyright (C) 2000 Matthias Radestock. All Rights Reserved.
|
||||
*
|
||||
* Contributor(s):
|
||||
* Redfig Ltd (http://www.redfig.com)
|
||||
* LShift Ltd (http://www.lshift.net)
|
||||
*
|
||||
* Alternatively, the contents of this file may be used under the terms
|
||||
* of the GNU Public License (the "GPL License"), in which case the
|
||||
* provisions of the GPL License are applicable instead of those
|
||||
* above. If you wish to allow use of your version of this file only
|
||||
* under the terms of the GPL License and not to allow others to use
|
||||
* your version of this file under the MPL, indicate your decision by
|
||||
* deleting the provisions above and replace them with the notice and
|
||||
* other provisions required by the GPL License. If you do not delete
|
||||
* the provisions above, a recipient may use your version of this file
|
||||
* under either the MPL or the GPL License.
|
||||
*/
|
||||
|
||||
// API class
|
||||
|
||||
package org.mozilla.javascript;
|
||||
|
||||
/**
|
||||
* This is a helper class for implementing wrappers around Scriptable
|
||||
* objects. It implements the Function interface and delegates all
|
||||
* invocations to a delegee Scriptable object. The normal use of this
|
||||
* class involves creating a sub-class and overriding one or more of
|
||||
* the methods.
|
||||
*
|
||||
* A useful application is the implementation of interceptors,
|
||||
* pre/post conditions, debugging.
|
||||
*
|
||||
* @see Function
|
||||
* @see Scriptable
|
||||
* @author Matthias Radestock
|
||||
*/
|
||||
|
||||
public class Delegator implements Function {
|
||||
|
||||
protected Scriptable obj = null;
|
||||
|
||||
/**
|
||||
* Create a Delegator prototype.
|
||||
*
|
||||
* This constructor should only be used for creating prototype
|
||||
* objects of Delegator.
|
||||
*
|
||||
* @see org.mozilla.javascript.Delegator#construct
|
||||
*/
|
||||
public Delegator() {
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a new Delegator that forwards requests to a delegee
|
||||
* Scriptable object.
|
||||
*
|
||||
* @param obj the delegee
|
||||
* @see org.mozilla.javascript.Scriptable
|
||||
*/
|
||||
public Delegator(Scriptable obj) {
|
||||
this.obj = obj;
|
||||
}
|
||||
|
||||
/**
|
||||
* Retrieve the delegee.
|
||||
*
|
||||
* @return the delegee
|
||||
*/
|
||||
public Scriptable getDelegee() {
|
||||
return obj;
|
||||
}
|
||||
/**
|
||||
* Set the delegee.
|
||||
*
|
||||
* @param obj the delegee
|
||||
* @see org.mozilla.javascript.Scriptable
|
||||
*/
|
||||
public void setDelegee(Scriptable obj) {
|
||||
this.obj = obj;
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getClassName
|
||||
*/
|
||||
public String getClassName() {
|
||||
return obj.getClassName();
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#get
|
||||
*/
|
||||
public Object get(String name, Scriptable start) {
|
||||
return obj.get(name,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#get
|
||||
*/
|
||||
public Object get(int index, Scriptable start) {
|
||||
return obj.get(index,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#has
|
||||
*/
|
||||
public boolean has(String name, Scriptable start) {
|
||||
return obj.has(name,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#has
|
||||
*/
|
||||
public boolean has(int index, Scriptable start) {
|
||||
return obj.has(index,start);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#put
|
||||
*/
|
||||
public void put(String name, Scriptable start, Object value) {
|
||||
obj.put(name,start,value);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#put
|
||||
*/
|
||||
public void put(int index, Scriptable start, Object value) {
|
||||
obj.put(index,start,value);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#delete
|
||||
*/
|
||||
public void delete(String name) {
|
||||
obj.delete(name);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#delete
|
||||
*/
|
||||
public void delete(int index) {
|
||||
obj.delete(index);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getPrototype
|
||||
*/
|
||||
public Scriptable getPrototype() {
|
||||
return obj.getPrototype();
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#setPrototype
|
||||
*/
|
||||
public void setPrototype(Scriptable prototype) {
|
||||
obj.setPrototype(prototype);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getParentScope
|
||||
*/
|
||||
public Scriptable getParentScope() {
|
||||
return obj.getParentScope();
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#setParentScope
|
||||
*/
|
||||
public void setParentScope(Scriptable parent) {
|
||||
obj.setParentScope(parent);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#getIds
|
||||
*/
|
||||
public Object[] getIds() {
|
||||
return obj.getIds();
|
||||
}
|
||||
/**
|
||||
* Note that this method does not get forwarded to the delegee if
|
||||
* the <code>hint</code> parameter is null,
|
||||
* <code>ScriptRuntime.ScriptableClass</code> or
|
||||
* <code>ScriptRuntime.FunctionClass</code>. Instead the object
|
||||
* itself is returned.
|
||||
*
|
||||
* @param hint the type hint
|
||||
* @return the default value
|
||||
*
|
||||
* @see org.mozilla.javascript.Scriptable#getDefaultValue
|
||||
*/
|
||||
public Object getDefaultValue(Class hint) {
|
||||
return (hint == null ||
|
||||
hint == ScriptRuntime.ScriptableClass ||
|
||||
hint == ScriptRuntime.FunctionClass) ?
|
||||
this : obj.getDefaultValue(hint);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Scriptable#hasInstance
|
||||
*/
|
||||
public boolean hasInstance(Scriptable instance) {
|
||||
return obj.hasInstance(instance);
|
||||
}
|
||||
/**
|
||||
* @see org.mozilla.javascript.Function#call
|
||||
*/
|
||||
public Object call(Context cx, Scriptable scope, Scriptable thisObj,
|
||||
Object[] args)
|
||||
throws JavaScriptException {
|
||||
return ((Function)obj).call(cx,scope,thisObj,args);
|
||||
}
|
||||
|
||||
/**
|
||||
* Note that if the <code>delegee</code> is <code>null</code>,
|
||||
* this method creates a new instance of the Delegator itself
|
||||
* rathert than forwarding the call to the
|
||||
* <code>delegee</code>. This permits the use of Delegator
|
||||
* prototypes.
|
||||
*
|
||||
* @param cx the current Context for this thread
|
||||
* @param scope an enclosing scope of the caller except
|
||||
* when the function is called from a closure.
|
||||
* @param args the array of arguments
|
||||
* @return the allocated object
|
||||
* @exception JavaScriptException if an uncaught exception
|
||||
* occurred while executing the constructor
|
||||
*
|
||||
* @see org.mozilla.javascript.Function#construct
|
||||
*/
|
||||
public Scriptable construct(Context cx, Scriptable scope, Object[] args)
|
||||
throws JavaScriptException {
|
||||
if (obj == null) {
|
||||
//this little trick allows us to declare prototype objects for
|
||||
//Delegators
|
||||
try {
|
||||
Delegator n = (Delegator)this.getClass().newInstance();
|
||||
n.setDelegee((Scriptable)args[0]);
|
||||
return n;
|
||||
}
|
||||
catch (Exception e) {
|
||||
e.printStackTrace();
|
||||
System.exit(0);
|
||||
}
|
||||
return (Scriptable)null;
|
||||
}
|
||||
else {
|
||||
return ((Function)obj).construct(cx,scope,args);
|
||||
}
|
||||
}
|
||||
}
|
||||
77
js/rhino/src/org/mozilla/javascript/Synchronizer.java
Normal file
77
js/rhino/src/org/mozilla/javascript/Synchronizer.java
Normal file
@ -0,0 +1,77 @@
|
||||
/* -*- Mode: java; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
|
||||
* The contents of this file are subject to the Mozilla Public License
|
||||
* Version 1.1 (the "License"); you may not use this file except in
|
||||
* compliance with the License. You may obtain a copy of the License at
|
||||
* http://www.mozilla.org/MPL/
|
||||
*
|
||||
* Software distributed under the License is distributed on an "AS IS"
|
||||
* basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
|
||||
* License for the specific language governing rights and limitations
|
||||
* under the License.
|
||||
*
|
||||
* The Original Code is Synchronizer.java code, released Sep 27, 2000.
|
||||
*
|
||||
* The Initial Developer of the Original Code is Matthias Radestock
|
||||
* <matthias@sorted.org>. Portions created by Matthias Radestock are
|
||||
* Copyright (C) 2000 Matthias Radestock. All Rights Reserved.
|
||||
*
|
||||
* Contributor(s):
|
||||
* Redfig Ltd (http://www.redfig.com)
|
||||
* LShift Ltd (http://www.lshift.net)
|
||||
*
|
||||
* Alternatively, the contents of this file may be used under the terms
|
||||
* of the GNU Public License (the "GPL License"), in which case the
|
||||
* provisions of the GPL License are applicable instead of those
|
||||
* above. If you wish to allow use of your version of this file only
|
||||
* under the terms of the GPL License and not to allow others to use
|
||||
* your version of this file under the MPL, indicate your decision by
|
||||
* deleting the provisions above and replace them with the notice and
|
||||
* other provisions required by the GPL License. If you do not delete
|
||||
* the provisions above, a recipient may use your version of this file
|
||||
* under either the MPL or the GPL License.
|
||||
*/
|
||||
|
||||
// API class
|
||||
|
||||
package org.mozilla.javascript;
|
||||
|
||||
/**
|
||||
* This class provides support for implementing Java-style synchronized
|
||||
* methods in Javascript.
|
||||
*
|
||||
* Synchronized functions are created from ordinary Javascript
|
||||
* functions by the <code>Synchronizer</code> constructor, e.g.
|
||||
* <code>new Packages.org.mozilla.javascript.Synchronizer(fun)</code>.
|
||||
* The resulting object is a function that establishes an exclusive
|
||||
* lock on the <code>this</code> object of its invocation.
|
||||
*
|
||||
* The Rhino shell provides a short-cut for the creation of
|
||||
* synchronized methods: <code>sync(fun)</code> has the same effect as
|
||||
* calling the above constructor.
|
||||
*
|
||||
* @see org.mozilla.javascript.Delegator
|
||||
* @author Matthias Radestock
|
||||
*/
|
||||
|
||||
public class Synchronizer extends Delegator {
|
||||
|
||||
/**
|
||||
* Create a new synchronized function from an existing one.
|
||||
*
|
||||
* @param obj the existing function
|
||||
*/
|
||||
public Synchronizer(Scriptable obj) {
|
||||
super(obj);
|
||||
}
|
||||
|
||||
/**
|
||||
* @see org.mozilla.javascript.Function#call
|
||||
*/
|
||||
public Object call(Context cx, Scriptable scope, Scriptable thisObj,
|
||||
Object[] args)
|
||||
throws JavaScriptException {
|
||||
synchronized(thisObj) {
|
||||
return ((Function)obj).call(cx,scope,thisObj,args);
|
||||
}
|
||||
}
|
||||
}
|
||||
Loading…
Reference in New Issue
Block a user