public class NativeJavaMap extends NativeJavaObject
NativeJavaMap is a wrapper for java objects implementing java.util.Map
interface. When Context.FEATURE_ENABLE_JAVA_MAP_ACCESS is enabled, property based
access like map[key] is delegated to Map.get(Object) or Map.put(Object, Object) operations so that a JavaMap acts very similar to a
javascript Object There is also an iterator to iterate over entries with
for .. of.
Limitations: The wrapped map should have String or Integer as
key. Otherwise, property based access may not work properly.
isAdapter, javaObject, members, parent, prototype, staticTypeNOT_FOUND| Constructor and Description |
|---|
NativeJavaMap(Scriptable scope,
java.lang.Object map) |
| Modifier and Type | Method and Description |
|---|---|
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.Object |
get(Symbol key,
Scriptable start)
Return the value of the property with the specified key, or
NOT_FOUND.
|
java.lang.String |
getClassName()
Get the name of the set of objects implemented by this Java class.
|
java.lang.Object[] |
getIds()
Get an array of property ids.
|
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 |
has(Symbol key,
Scriptable start)
Return true if the specified property exists.
|
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.
|
canConvert, coerceType, createInterfaceAdapter, delete, delete, delete, getDefaultValue, getParentScope, getPrototype, hasInstance, initMembers, put, setParentScope, setPrototype, unwrap, wrappublic NativeJavaMap(Scriptable scope, java.lang.Object map)
public java.lang.String getClassName()
ScriptableSee ECMA 8.6.2 and 15.2.4.2.
getClassName in interface ScriptablegetClassName in class NativeJavaObjectpublic 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 Scriptablehas in class NativeJavaObjectname - the name of the propertystart - the object in which the lookup beganScriptable.get(String, Scriptable),
ScriptableObject.getProperty(Scriptable, String)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 Scriptablehas in class NativeJavaObjectindex - the numeric index for the propertystart - the object in which the lookup beganScriptable.get(int, Scriptable),
ScriptableObject.getProperty(Scriptable, int)public boolean has(Symbol key, Scriptable start)
SymbolScriptablehas in interface SymbolScriptablehas in class NativeJavaObjectpublic java.lang.Object get(java.lang.String name,
Scriptable start)
Scriptableget 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 Scriptableget in class NativeJavaObjectname - the name of the propertystart - the object in which the lookup beganContext.getUndefinedValue()public java.lang.Object get(int index,
Scriptable start)
Scriptableget(String, Scriptable) except that
an integral index is used to select the property.get in interface Scriptableget in class NativeJavaObjectindex - the numeric index for the propertystart - the object in which the lookup beganScriptable.get(String,Scriptable)public java.lang.Object get(Symbol key, Scriptable start)
SymbolScriptableget in interface SymbolScriptableget in class NativeJavaObjectpublic 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 Scriptableput in class NativeJavaObjectname - the name of the propertystart - the object whose property is being setvalue - value to set the property toScriptable.has(String, Scriptable),
Scriptable.get(String, Scriptable),
ScriptableObject.putProperty(Scriptable, String, Object),
Context.toObject(Object, Scriptable)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 Scriptableput in class NativeJavaObjectindex - the numeric index for the propertystart - the object whose property is being setvalue - value to set the property toScriptable.has(int, Scriptable),
Scriptable.get(int, Scriptable),
ScriptableObject.putProperty(Scriptable, int, Object),
Context.toObject(Object, Scriptable)public java.lang.Object[] getIds()
ScriptablegetIds in interface ScriptablegetIds in class NativeJavaObject