|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.mozilla.javascript.NativeJavaObject | +--org.mozilla.javascript.NativeJavaClass
This class reflects Java classes into the JavaScript environment, mainly for constructors and static members. We lazily reflect properties, and currently do not guarantee that a single j.l.Class is only reflected once into the JS environment, although we should. The only known case where multiple reflections are possible occurs when a j.l.Class is wrapped as part of a method return or property access, rather than by walking the Packages/java tree.
NativeJavaArray
,
NativeJavaObject
,
NativeJavaPackage
, Serialized FormFields inherited from class org.mozilla.javascript.NativeJavaObject |
CONVERSION_NONE, CONVERSION_NONTRIVIAL, CONVERSION_TRIVIAL |
Fields inherited from interface org.mozilla.javascript.Scriptable |
NOT_FOUND |
Constructor Summary | |
NativeJavaClass(Scriptable scope,
java.lang.Class cl)
|
Method Summary | |
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)
Call the function as a constructor. |
static Scriptable |
constructSpecific(Context cx,
Scriptable scope,
Scriptable thisObj,
java.lang.reflect.Constructor ctor,
java.lang.Object[] args)
|
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.Class |
getClassObject()
|
java.lang.Object |
getDefaultValue(java.lang.Class hint)
Get the default value of the object with a given hint. |
java.lang.Object[] |
getIds()
Get an array of property ids. |
boolean |
has(java.lang.String name,
Scriptable start)
Indicates whether or not a named property is defined in an object. |
boolean |
hasInstance(Scriptable value)
Determines if prototype is a wrapped Java object and performs a Java "instanceof". |
void |
put(java.lang.String name,
Scriptable start,
java.lang.Object value)
Sets a named property in this object. |
void |
readExternal(java.io.ObjectInput in)
|
java.lang.String |
toString()
|
static NativeJavaClass |
wrap(Scriptable scope,
java.lang.Class cls)
|
void |
writeExternal(java.io.ObjectOutput out)
|
Methods inherited from class org.mozilla.javascript.NativeJavaObject |
canConvert, coerceType, delete, delete, get, getConversionWeight, getParentScope, getPrototype, has, initJSObject, put, setParentScope, setPrototype, unwrap, wrap |
Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Methods inherited from interface org.mozilla.javascript.Scriptable |
delete, delete, get, getParentScope, getPrototype, has, put, setParentScope, setPrototype |
Constructor Detail |
public NativeJavaClass(Scriptable scope, java.lang.Class cl)
Method Detail |
public java.lang.String getClassName()
Scriptable
See ECMA 8.6.2 and 15.2.4.2.
getClassName
in interface Scriptable
getClassName
in class NativeJavaObject
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
has
in class NativeJavaObject
org.mozilla.javascript.Scriptable
name
- the name of the propertystart
- the object in which the lookup beganScriptable.get(java.lang.String, org.mozilla.javascript.Scriptable)
,
ScriptableObject.getProperty(org.mozilla.javascript.Scriptable, java.lang.String)
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
get
in class NativeJavaObject
org.mozilla.javascript.Scriptable
name
- the name of the propertystart
- the object in which the lookup beganContext.getUndefinedValue()
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
put
in class NativeJavaObject
org.mozilla.javascript.Scriptable
name
- the name of the propertystart
- the object whose property is being setvalue
- value to set the property toScriptable.has(java.lang.String, org.mozilla.javascript.Scriptable)
,
Scriptable.get(java.lang.String, org.mozilla.javascript.Scriptable)
,
ScriptableObject.putProperty(org.mozilla.javascript.Scriptable, java.lang.String, java.lang.Object)
,
Context.toObject(java.lang.Object, org.mozilla.javascript.Scriptable)
public java.lang.Object[] getIds()
Scriptable
getIds
in interface Scriptable
getIds
in class NativeJavaObject
org.mozilla.javascript.Scriptable
public java.lang.Class getClassObject()
public static NativeJavaClass wrap(Scriptable scope, java.lang.Class cls)
public java.lang.Object getDefaultValue(java.lang.Class hint)
Scriptable
A hint
of null means "no hint".
See ECMA 8.6.2.6.
getDefaultValue
in interface Scriptable
getDefaultValue
in class NativeJavaObject
org.mozilla.javascript.Scriptable
hint
- the type hintpublic java.lang.Object call(Context cx, Scriptable scope, Scriptable thisObj, java.lang.Object[] args) throws JavaScriptException
Function
call
in interface Function
org.mozilla.javascript.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 argumentsJavaScriptException
- if an uncaught exception
occurred while executing the functionpublic Scriptable construct(Context cx, Scriptable scope, java.lang.Object[] args) throws JavaScriptException
Function
new
operator. This method is
expected to create a new object and return it.construct
in interface Function
org.mozilla.javascript.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 argumentsJavaScriptException
- if an uncaught exception
occurred while executing the constructorpublic static Scriptable constructSpecific(Context cx, Scriptable scope, Scriptable thisObj, java.lang.reflect.Constructor ctor, java.lang.Object[] args) throws JavaScriptException
public java.lang.String toString()
toString
in class java.lang.Object
public boolean hasInstance(Scriptable value)
hasInstance
in interface Scriptable
hasInstance
in class NativeJavaObject
org.mozilla.javascript.Scriptable
instance
- The value that appeared on the LHS of the instanceof
operatorpublic void writeExternal(java.io.ObjectOutput out) throws java.io.IOException
writeExternal
in class NativeJavaObject
public void readExternal(java.io.ObjectInput in) throws java.io.IOException, java.lang.ClassNotFoundException
readExternal
in class NativeJavaObject
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |