org.mozilla.javascript

Class IdScriptableObject

java.lang.Object

org.mozilla.javascript.ScriptableObject

org.mozilla.javascript.IdScriptableObject

All Implemented Interfaces:

Serializable, ConstProperties, DebuggableObject, IdFunctionCall, Scriptable

Direct Known Subclasses:

BaseFunction, NativeArray, NativeArrayBuffer, NativeArrayBufferView, NativeCall, NativeCallSite, NativeContinuation, NativeGenerator, NativeIterator, NativeJSON, NativeObject, NativeRegExp, TopLevel, XMLObject

public abstract class IdScriptableObject
extends ScriptableObject
implements IdFunctionCall

Base class for native object implementation that uses IdFunctionObject to export its methods to script via .prototype object. Any descendant should implement at least the following methods: findInstanceIdInfo getInstanceIdName execIdCall methodArity To define non-function properties, the descendant should override getInstanceIdValue setInstanceIdValue to get/set property value and provide its default attributes. To customize initialization of constructor and prototype objects, descendant may override scopeInit or fillConstructorProperties methods.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.mozilla.javascript.ScriptableObject

CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

Fields inherited from interface org.mozilla.javascript.Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor and Description
IdScriptableObject()
IdScriptableObject(Scriptable scope, Scriptable prototype)

Method Summary

Modifier and Type	Method and Description
void	activatePrototypeMap(int maxPrototypeId)
void	defineOwnProperty(Context cx, Object key, ScriptableObject desc) Defines a property on an object.
void	delete(String name) Removes a named property from the object.
Object	execIdCall(IdFunctionObject f, Context cx, Scriptable scope, Scriptable thisObj, Object[] args) 'thisObj' will be null if invoked as constructor, in which case instance of Scriptable should be returned.
IdFunctionObject	exportAsJSClass(int maxPrototypeId, Scriptable scope, boolean sealed)
Object	get(String name, Scriptable start) Returns the value of the named property or NOT_FOUND.
int	getAttributes(String name) Get the attributes of a named property.
boolean	has(String name, Scriptable start) Returns true if the named property is defined.
boolean	hasPrototypeMap()
void	initPrototypeConstructor(IdFunctionObject f)
void	initPrototypeMethod(Object tag, int id, String name, int arity)
void	initPrototypeValue(int id, String name, Object value, int attributes)
void	put(String name, Scriptable start, Object value) Sets the value of the named property, creating it if need be.
void	setAttributes(String name, int attributes) Set the attributes of a named property.

Methods inherited from class org.mozilla.javascript.ScriptableObject

associateValue, avoidObjectDetection, callMethod, callMethod, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineProperty, defineProperty, defineProperty, defineProperty, delete, deleteProperty, deleteProperty, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getClassName, getClassPrototype, getDefaultValue, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGetterOrSetter, getIds, getObjectPrototype, getParentScope, getProperty, getProperty, getPropertyIds, getPrototype, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, has, hasInstance, hasProperty, hasProperty, isConst, isEmpty, isExtensible, isSealed, preventExtensions, put, putConst, putConstProperty, putProperty, putProperty, redefineProperty, sealObject, setAttributes, setAttributes, setAttributes, setExternalArrayData, setGetterOrSetter, setParentScope, setPrototype, size

Methods inherited from class java.lang.Object

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

Constructor Detail

IdScriptableObject

public IdScriptableObject()

IdScriptableObject

public IdScriptableObject(Scriptable scope,
                          Scriptable prototype)

Method Detail

has

public boolean has(String name,
                   Scriptable start)

Description copied from class: ScriptableObject

Returns true if the named property is defined.

Specified by:

has in interface Scriptable

Overrides:

has in class ScriptableObject

Parameters:

name - the name of the property

start - the object in which the lookup began

Returns:

true if and only if the property was found in the object

See Also:

Scriptable.get(String, Scriptable), ScriptableObject.getProperty(Scriptable, String)

get

public Object get(String name,
                  Scriptable start)

Description copied from class: ScriptableObject

Returns the value of the named property or NOT_FOUND. If the property was created using defineProperty, the appropriate getter method is called.

Specified by:

get in interface Scriptable

Overrides:

get in class ScriptableObject

Parameters:

name - the name of the property

start - the object in which the lookup began

Returns:

the value of the property (may be null), or NOT_FOUND

See Also:

Context.getUndefinedValue()

put

public void put(String name,
                Scriptable start,
                Object value)

Description copied from class: ScriptableObject

Sets the value of the named property, creating it if need be. If the property was created using defineProperty, the appropriate setter method is called.

If the property's attributes include READONLY, no action is taken. This method will actually set the property in the start object.

Specified by:

put in interface Scriptable

Overrides:

put in class ScriptableObject

Parameters:

name - the name of the property

start - the object whose property is being set

value - value to set the property to

See Also:

Scriptable.has(String, Scriptable), Scriptable.get(String, Scriptable), ScriptableObject.putProperty(Scriptable, String, Object), Context.toObject(Object, Scriptable)

delete

public void delete(String name)

Description copied from class: ScriptableObject

Removes a named property from the object. If the property is not found, or it has the PERMANENT attribute, no action is taken.

Specified by:

delete in interface Scriptable

Overrides:

delete in class ScriptableObject

Parameters:

name - the name of the property

See Also:

Scriptable.get(String, Scriptable), ScriptableObject.deleteProperty(Scriptable, String)

getAttributes

public int getAttributes(String name)

Description copied from class: ScriptableObject

Get the attributes of a named property. The property is specified by name as defined for has.

Overrides:

getAttributes in class ScriptableObject

Parameters:

name - the identifier for the property

Returns:

the bitset of attributes

See Also:

ScriptableObject.has(String, Scriptable), ScriptableObject.READONLY, ScriptableObject.DONTENUM, ScriptableObject.PERMANENT, ScriptableObject.EMPTY

setAttributes

public void setAttributes(String name,
                          int attributes)

Description copied from class: ScriptableObject

Set the attributes of a named property. The property is specified by name as defined for has.

The possible attributes are READONLY, DONTENUM, and PERMANENT. Combinations of attributes are expressed by the bitwise OR of attributes. EMPTY is the state of no attributes set. Any unused bits are reserved for future use.

Overrides:

setAttributes in class ScriptableObject

Parameters:

name - the name of the property

attributes - the bitset of attributes

See Also:

Scriptable.has(String, Scriptable), ScriptableObject.READONLY, ScriptableObject.DONTENUM, ScriptableObject.PERMANENT, ScriptableObject.EMPTY

execIdCall

public Object execIdCall(IdFunctionObject f,
                         Context cx,
                         Scriptable scope,
                         Scriptable thisObj,
                         Object[] args)

'thisObj' will be null if invoked as constructor, in which case instance of Scriptable should be returned.

Specified by:

execIdCall in interface IdFunctionCall

exportAsJSClass

public final IdFunctionObject exportAsJSClass(int maxPrototypeId,
                                              Scriptable scope,
                                              boolean sealed)

hasPrototypeMap

public final boolean hasPrototypeMap()

activatePrototypeMap

public final void activatePrototypeMap(int maxPrototypeId)

initPrototypeMethod

public final void initPrototypeMethod(Object tag,
                                      int id,
                                      String name,
                                      int arity)

initPrototypeConstructor

public final void initPrototypeConstructor(IdFunctionObject f)

initPrototypeValue

public final void initPrototypeValue(int id,
                                     String name,
                                     Object value,
                                     int attributes)

defineOwnProperty

public void defineOwnProperty(Context cx,
                              Object key,
                              ScriptableObject desc)

Description copied from class: ScriptableObject

Defines a property on an object.

Overrides:

defineOwnProperty in class ScriptableObject

Parameters:

cx - the current Context

key - the name/index of the property

desc - the new property descriptor, as described in 8.6.1