Class NativeJavaMethod

java.lang.Object

org.mozilla.javascript.ScriptableObject

org.mozilla.javascript.IdScriptableObject

org.mozilla.javascript.BaseFunction

org.mozilla.javascript.NativeJavaMethod

All Implemented Interfaces:

Serializable, Callable, ConstProperties, Constructable, DebuggableObject, Function, IdFunctionCall, Scriptable, SymbolScriptable

Direct Known Subclasses:

FieldAndMethods

public class NativeJavaMethod
extends BaseFunction

This class reflects Java methods into the JavaScript environment and handles overloading of methods.

See Also:

• NativeJavaArray
• NativeJavaPackage
• NativeJavaClass
• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class ScriptableObject

ScriptableObject.KeyComparator

Field Summary

Fields

Modifier and Type	Field	Description
private static final boolean	debug
private String	functionName
(package private) MemberBox[]	methods
private final CopyOnWriteArrayList<ResolvedOverload>	overloadCache
private static final int	PREFERENCE_AMBIGUOUS	No clear "easy" conversion
private static final int	PREFERENCE_EQUAL	Types are equal
private static final int	PREFERENCE_FIRST_ARG
private static final int	PREFERENCE_SECOND_ARG
private static final long	serialVersionUID

Fields inherited from class BaseFunction

GENERATOR_FUNCTION_CLASS

Fields inherited from class ScriptableObject

CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

Fields inherited from interface Scriptable

NOT_FOUND

Constructor Summary

Constructors

Constructor	Description
NativeJavaMethod(Method method, String name)
NativeJavaMethod(MemberBox[] methods)
NativeJavaMethod(MemberBox[] methods, String name)
NativeJavaMethod(MemberBox method, String name)

Method Summary

Modifier and Type	Method	Description
Object	call(Context cx, Scriptable scope, Scriptable thisObj, Object[] args)	Should be overridden.
(package private) String	decompile(int indent, int flags)	Decompile the source information associated with this js function/script back into a string.
(package private) int	findCachedFunction(Context cx, Object[] args)
(package private) static int	findFunction(Context cx, MemberBox[] methodsOrCtors, Object[] args)	Find the index of the correct function to call given the set of methods or constructors and the arguments.
String	getFunctionName()
private static int	preferSignature(Object[] args, Class<?>[] sig1, boolean vararg1, Class<?>[] sig2, boolean vararg2)	Determine which of two signatures is the closer fit.
private static void	printDebug(String msg, MemberBox member, Object[] args)
(package private) static String	scriptSignature(Object[] values)
String	toString()

Methods inherited from class BaseFunction

construct, createObject, execIdCall, fillConstructorProperties, findInstanceIdInfo, findPrototypeId, getArity, getClassName, getClassPrototype, getInstanceIdName, getInstanceIdValue, getLength, getMaxInstanceId, getPrototypeProperty, getTypeOf, hasInstance, hasPrototypeProperty, init, initAsGeneratorFunction, initPrototypeId, isApply, isApplyOrCall, isGeneratorFunction, setImmunePrototypeProperty, setInstanceIdAttributes, setInstanceIdValue, setPrototypeProperty, setPrototypePropertyAttributes, setStandardPropertyAttributes, setupDefaultPrototype

Methods inherited from class IdScriptableObject

activatePrototypeMap, addIdFunctionProperty, defaultGet, defaultHas, defaultPut, defineOwnProperty, delete, delete, ensureType, exportAsJSClass, findInstanceIdInfo, findPrototypeId, get, get, getAttributes, getAttributes, getIds, getOwnPropertyDescriptor, has, has, hasPrototypeMap, initPrototypeConstructor, initPrototypeMethod, initPrototypeMethod, initPrototypeMethod, initPrototypeValue, initPrototypeValue, instanceIdInfo, put, put, setAttributes

Methods inherited from class ScriptableObject

addLazilyInitializedValue, applyDescriptorToAttributeBitset, associateValue, avoidObjectDetection, buildClassCtor, buildDataDescriptor, callMethod, callMethod, checkPropertyChange, checkPropertyDefinition, checkValidAttributes, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureSymbolScriptable, equivalentValues, get, get, getAllIds, getArrayPrototype, getAssociatedValue, getAttributes, getAttributes, getAttributes, getClassPrototype, getDefaultValue, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getIds, getObjectPrototype, getParentScope, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, has, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGetterOrSetter, isSealed, isTrue, preventExtensions, put, putConst, putConstProperty, putProperty, putProperty, putProperty, querySlot, redefineProperty, sameValue, sealObject, setAttributes, setAttributes, setAttributes, setAttributes, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setParentScope, setPrototype, size

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface Scriptable

delete, delete, get, get, getDefaultValue, getIds, getParentScope, getPrototype, has, has, put, put, setParentScope, setPrototype

Field Details

serialVersionUID

private static final long serialVersionUID

See Also:

• Constant Field Values

PREFERENCE_EQUAL

private static final int PREFERENCE_EQUAL

Types are equal

See Also:

• Constant Field Values

PREFERENCE_FIRST_ARG

private static final int PREFERENCE_FIRST_ARG

See Also:

• Constant Field Values

PREFERENCE_SECOND_ARG

private static final int PREFERENCE_SECOND_ARG

See Also:

• Constant Field Values

PREFERENCE_AMBIGUOUS

private static final int PREFERENCE_AMBIGUOUS

No clear "easy" conversion

See Also:

• Constant Field Values

debug

private static final boolean debug

See Also:

• Constant Field Values

methods

MemberBox[] methods

functionName

private String functionName

overloadCache

private final transient CopyOnWriteArrayList<ResolvedOverload> overloadCache

Constructor Details

NativeJavaMethod

NativeJavaMethod(MemberBox[] methods)

NativeJavaMethod

NativeJavaMethod(MemberBox[] methods,
 String name)

NativeJavaMethod

NativeJavaMethod(MemberBox method,
 String name)

NativeJavaMethod

public NativeJavaMethod(Method method,
 String name)

Method Details

getFunctionName

public String getFunctionName()

Overrides:

getFunctionName in class BaseFunction

scriptSignature

static String scriptSignature(Object[] values)

decompile

String decompile(int indent,
 int flags)

Description copied from class: BaseFunction

Decompile the source information associated with this js function/script back into a string.

Overrides:

decompile in class BaseFunction

Parameters:

indent - How much to indent the decompiled result.

flags - Flags specifying format of decompilation output.

toString

public String toString()

Overrides:

toString in class Object

call

public Object call(Context cx,
 Scriptable scope,
 Scriptable thisObj,
 Object[] args)

Description copied from class: BaseFunction

Should be overridden.

Specified by:

call in interface Callable

Specified by:

call in interface Function

Overrides:

call in class BaseFunction

Parameters:

cx - the current Context for this thread

scope - 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 object

args - the array of arguments

Returns:

the result of the call

findCachedFunction

int findCachedFunction(Context cx,
 Object[] args)

findFunction

static int findFunction(Context cx,
 MemberBox[] methodsOrCtors,
 Object[] args)

Find the index of the correct function to call given the set of methods or constructors and the arguments. If no function can be found to call, return -1.

preferSignature

private static int preferSignature(Object[] args,
 Class<?>[] sig1,
 boolean vararg1,
 Class<?>[] sig2,
 boolean vararg2)

Determine which of two signatures is the closer fit. Returns one of PREFERENCE_EQUAL, PREFERENCE_FIRST_ARG, PREFERENCE_SECOND_ARG, or PREFERENCE_AMBIGUOUS.

printDebug

private static void printDebug(String msg,
 MemberBox member,
 Object[] args)