Class FunctionObject

All Implemented Interfaces:
Serializable, Callable, ConstProperties, Constructable, DebuggableObject, Function, IdFunctionCall, Scriptable, SymbolScriptable

public class FunctionObject extends BaseFunction
See Also:
  • Field Details

    • serialVersionUID

      private static final long serialVersionUID
      See Also:
    • VARARGS_METHOD

      private static final short VARARGS_METHOD
      See Also:
    • VARARGS_CTOR

      private static final short VARARGS_CTOR
      See Also:
    • sawSecurityException

      private static boolean sawSecurityException
    • JAVA_UNSUPPORTED_TYPE

      public static final int JAVA_UNSUPPORTED_TYPE
      See Also:
    • JAVA_STRING_TYPE

      public static final int JAVA_STRING_TYPE
      See Also:
    • JAVA_INT_TYPE

      public static final int JAVA_INT_TYPE
      See Also:
    • JAVA_BOOLEAN_TYPE

      public static final int JAVA_BOOLEAN_TYPE
      See Also:
    • JAVA_DOUBLE_TYPE

      public static final int JAVA_DOUBLE_TYPE
      See Also:
    • JAVA_SCRIPTABLE_TYPE

      public static final int JAVA_SCRIPTABLE_TYPE
      See Also:
    • JAVA_OBJECT_TYPE

      public static final int JAVA_OBJECT_TYPE
      See Also:
    • member

      MemberBox member
    • functionName

      private String functionName
    • typeTags

      private transient byte[] typeTags
    • parmsLength

      private int parmsLength
    • hasVoidReturn

      private transient boolean hasVoidReturn
    • returnTypeTag

      private transient int returnTypeTag
    • isStatic

      private boolean isStatic
  • Constructor Details

    • FunctionObject

      public FunctionObject(String name, Member methodOrConstructor, Scriptable scope)
      Create a JavaScript function object from a Java method.

      The member argument must be either a java.lang.reflect.Method or a java.lang.reflect.Constructor and must match one of two forms.

      The first form is a member with zero or more parameters of the following types: Object, String, boolean, Scriptable, int, or double. The Long type is not supported because the double representation of a long (which is the EMCA-mandated storage type for Numbers) may lose precision. If the member is a Method, the return value must be void or one of the types allowed for parameters.

      The runtime will perform appropriate conversions based upon the type of the parameter. A parameter type of Object specifies that no conversions are to be done. A parameter of type String will use Context.toString to convert arguments. Similarly, parameters of type double, boolean, and Scriptable will cause Context.toNumber, Context.toBoolean, and Context.toObject, respectively, to be called.

      If the method is not static, the Java 'this' value will correspond to the JavaScript 'this' value. Any attempt to call the function with a 'this' value that is not of the right Java type will result in an error.

      The second form is the variable arguments (or "varargs") form. If the FunctionObject will be used as a constructor, the member must have the following parameters

            (Context cx, Object[] args, Function ctorObj,
             boolean inNewExpr)
      and if it is a Method, be static and return an Object result.

      Otherwise, if the FunctionObject will not be used to define a constructor, the member must be a static Method with parameters

            (Context cx, Scriptable thisObj, Object[] args,
             Function funObj) 
      and an Object result.

      When the function varargs form is called as part of a function call, the args parameter contains the arguments, with thisObj set to the JavaScript 'this' value. funObj is the function object for the invoked function.

      When the constructor varargs form is called or invoked while evaluating a new expression, args contains the arguments, ctorObj refers to this FunctionObject, and inNewExpr is true if and only if a new expression caused the call. This supports defining a function that has different behavior when called as a constructor than when invoked as a normal function call. (For example, the Boolean constructor, when called as a function, will convert to boolean rather than creating a new object.)

      Parameters:
      name - the name of the function
      methodOrConstructor - a java.lang.reflect.Method or a java.lang.reflect.Constructor that defines the object
      scope - enclosing scope of function
      See Also:
  • Method Details