public class Delegator extends java.lang.Object implements Function
Function
,
Scriptable
Modifier and Type | Field and Description |
---|---|
protected Scriptable |
obj |
NOT_FOUND
Constructor and Description |
---|
Delegator()
Create a Delegator prototype.
|
Delegator(Scriptable obj)
Create a new Delegator that forwards requests to a delegee
Scriptable object.
|
Modifier and Type | Method and Description |
---|---|
java.lang.Object |
call(Context cx,
Scriptable scope,
Scriptable thisObj,
java.lang.Object[] args)
Call the function.
|
Scriptable |
construct(Context cx,
Scriptable scope,
java.lang.Object[] args)
Note that if the
delegee is null ,
this method creates a new instance of the Delegator itself
rathert than forwarding the call to the
delegee . |
void |
delete(int index)
Removes a property from this object.
|
void |
delete(java.lang.String name)
Removes a property from this object.
|
java.lang.Object |
get(int index,
Scriptable start)
Get a property from the object selected by an integral index.
|
java.lang.Object |
get(java.lang.String name,
Scriptable start)
Get a named property from the object.
|
java.lang.String |
getClassName()
Get the name of the set of objects implemented by this Java class.
|
java.lang.Object |
getDefaultValue(java.lang.Class<?> hint)
Note that this method does not get forwarded to the delegee if
the
hint parameter is null,
ScriptRuntime.ScriptableClass or
ScriptRuntime.FunctionClass . |
Scriptable |
getDelegee()
Retrieve the delegee.
|
java.lang.Object[] |
getIds()
Get an array of property ids.
|
Scriptable |
getParentScope()
Get the parent scope of the object.
|
Scriptable |
getPrototype()
Get the prototype of the object.
|
boolean |
has(int index,
Scriptable start)
Indicates whether or not an indexed property is defined in an object.
|
boolean |
has(java.lang.String name,
Scriptable start)
Indicates whether or not a named property is defined in an object.
|
boolean |
hasInstance(Scriptable instance)
The instanceof operator.
|
protected Delegator |
newInstance()
Crete new Delegator instance.
|
void |
put(int index,
Scriptable start,
java.lang.Object value)
Sets an indexed property in this object.
|
void |
put(java.lang.String name,
Scriptable start,
java.lang.Object value)
Sets a named property in this object.
|
void |
setDelegee(Scriptable obj)
Set the delegee.
|
void |
setParentScope(Scriptable parent)
Set the parent scope of the object.
|
void |
setPrototype(Scriptable prototype)
Set the prototype of the object.
|
protected Scriptable obj
public Delegator()
public Delegator(Scriptable obj)
obj
- the delegeeScriptable
protected Delegator newInstance()
public Scriptable getDelegee()
public void setDelegee(Scriptable obj)
obj
- the delegeeScriptable
public java.lang.String getClassName()
Scriptable
See ECMA 8.6.2 and 15.2.4.2.
getClassName
in interface Scriptable
Scriptable.getClassName()
public java.lang.Object get(java.lang.String name, Scriptable start)
Scriptable
get
that takes an
integer:
JavaScript code | Java code |
---|---|
a.b | a.get("b", a) |
a["foo"] | a.get("foo", a) |
a[3] | a.get(3, a) |
a["3"] | a.get(3, a) |
a[3.0] | a.get(3, a) |
a["3.0"] | a.get("3.0", a) |
a[1.1] | a.get("1.1", a) |
a[-4] | a.get(-4, a) |
The values that may be returned are limited to the following:
get
in interface Scriptable
name
- the name of the propertystart
- the object in which the lookup beganScriptable.get(String, Scriptable)
public java.lang.Object get(int index, Scriptable start)
Scriptable
get(String, Scriptable)
except that
an integral index is used to select the property.get
in interface Scriptable
index
- the numeric index for the propertystart
- the object in which the lookup beganScriptable.get(int, Scriptable)
public boolean has(java.lang.String name, Scriptable start)
Scriptable
The property is specified by a String name
as defined for the get
method.
has
in interface Scriptable
name
- the name of the propertystart
- the object in which the lookup beganScriptable.has(String, Scriptable)
public boolean has(int index, Scriptable start)
Scriptable
The property is specified by an integral index
as defined for the get
method.
has
in interface Scriptable
index
- the numeric index for the propertystart
- the object in which the lookup beganScriptable.has(int, Scriptable)
public void put(java.lang.String name, Scriptable start, java.lang.Object value)
Scriptable
The property is specified by a string name
as defined for get
.
The possible values that may be passed in are as defined for
get
. A class that implements this method may choose
to ignore calls to set certain properties, in which case those
properties are effectively read-only.
For properties defined in a prototype chain,
use putProperty
in ScriptableObject.
Note that if a property a is defined in the prototype p
of an object o, then evaluating o.a = 23
will cause
set
to be called on the prototype p with
o as the start parameter.
To preserve JavaScript semantics, it is the Scriptable
object's responsibility to modify o.
This design allows properties to be defined in prototypes and implemented in terms of getters and setters of Java values without consuming slots in each instance.
The values that may be set are limited to the following:
Arbitrary Java objects may be wrapped in a Scriptable by first calling
Context.toObject
. This allows the property of a JavaScript
object to contain an arbitrary Java object as a value.
Note that has
will be called by the runtime first before
set
is called to determine in which object the
property is defined.
Note that this method is not expected to traverse the prototype chain,
which is different from the ECMA [[Put]] operation.
put
in interface Scriptable
name
- the name of the propertystart
- the object whose property is being setvalue
- value to set the property toScriptable.put(String, Scriptable, Object)
public void put(int index, Scriptable start, java.lang.Object value)
Scriptable
The property is specified by an integral index
as defined for get
.
Identical to put(String, Scriptable, Object)
except that
an integral index is used to select the property.
put
in interface Scriptable
index
- the numeric index for the propertystart
- the object whose property is being setvalue
- value to set the property toScriptable.put(int, Scriptable, Object)
public void delete(java.lang.String name)
Scriptable
A property can be made permanent by ignoring calls to remove it.
The property is specified by a String name
as defined for get
.
To delete properties defined in a prototype chain, see deleteProperty in ScriptableObject.
delete
in interface Scriptable
name
- the identifier for the propertyScriptable.delete(String)
public void delete(int index)
Scriptable
get
.
To delete properties defined in a prototype chain,
see deleteProperty in ScriptableObject.
Identical to delete(String)
except that
an integral index is used to select the property.
delete
in interface Scriptable
index
- the numeric index for the propertyScriptable.delete(int)
public Scriptable getPrototype()
Scriptable
getPrototype
in interface Scriptable
Scriptable.getPrototype()
public void setPrototype(Scriptable prototype)
Scriptable
setPrototype
in interface Scriptable
prototype
- the prototype to setScriptable.setPrototype(org.mozilla.javascript.Scriptable)
public Scriptable getParentScope()
Scriptable
getParentScope
in interface Scriptable
Scriptable.getParentScope()
public void setParentScope(Scriptable parent)
Scriptable
setParentScope
in interface Scriptable
parent
- the parent scope to setScriptable.setParentScope(org.mozilla.javascript.Scriptable)
public java.lang.Object[] getIds()
Scriptable
getIds
in interface Scriptable
Scriptable.getIds()
public java.lang.Object getDefaultValue(java.lang.Class<?> hint)
hint
parameter is null,
ScriptRuntime.ScriptableClass
or
ScriptRuntime.FunctionClass
. Instead the object
itself is returned.getDefaultValue
in interface Scriptable
hint
- the type hintScriptable.getDefaultValue(java.lang.Class<?>)
public boolean hasInstance(Scriptable instance)
Scriptable
The JavaScript code "lhs instanceof rhs" causes rhs.hasInstance(lhs) to be called.
The return value is implementation dependent so that embedded host objects can return an appropriate value. See the JS 1.3 language documentation for more detail.
This operator corresponds to the proposed EMCA [[HasInstance]] operator.
hasInstance
in interface Scriptable
instance
- The value that appeared on the LHS of the instanceof
operatorScriptable.hasInstance(org.mozilla.javascript.Scriptable)
public java.lang.Object call(Context cx, Scriptable scope, Scriptable thisObj, java.lang.Object[] args)
Function
call
in interface Callable
call
in interface Function
cx
- the current Context for this threadscope
- 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
objectargs
- the array of argumentsFunction.call(org.mozilla.javascript.Context, org.mozilla.javascript.Scriptable, org.mozilla.javascript.Scriptable, java.lang.Object[])
public Scriptable construct(Context cx, Scriptable scope, java.lang.Object[] args)
delegee
is null
,
this method creates a new instance of the Delegator itself
rathert than forwarding the call to the
delegee
. This permits the use of Delegator
prototypes.construct
in interface Function
cx
- the current Context for this threadscope
- an enclosing scope of the caller except
when the function is called from a closure.args
- the array of argumentsFunction.construct(Context, Scriptable, Object[])