当一个 java 方法(无论是静态的还是非静态的)在一个范围内作为一个全局函数可用时,我们使用以下逻辑:
FunctionObject javascriptFunction = new FunctionObject(/* String*/ javascriptFunctionName, /* Method */ javaMethod, /*Scriptable */ parentScope);
boundScope.put(javascriptFunctionName, boundScope, javascriptFunction);
这里boundScope
应该始终是函数可用的范围。
然而,父作用域的值取决于我们是绑定实例方法还是静态方法。在静态方法的情况下,它可以是任何有意义的范围。它甚至可以与boundScope
.
但在实例方法的情况下,parentScope
应该是其方法被绑定的实例。
以上只是背景信息。现在我将解释问题是什么,并给出一个自然的解决方案,即允许直接调用实例方法作为全局函数,而不是显式创建对象的实例,然后使用该实例调用方法。
当一个函数被调用时,Rhino 会调用FunctionObject.call()
传递一个引用的方法this
。如果函数是全局函数,则调用它时没有引用this
(即xxx()
代替this.xxx()
),this
传递给FunctionObject.call()
方法的变量的值是进行调用的范围(即在这种情况下,this
参数将与参数的值相同)scope
。
如果被调用的 java 方法是实例方法,这将成为一个问题,因为根据FunctionObject
类的构造函数的 JavaDocs:
如果方法不是静态的,Javathis
值将对应于 JavaScriptthis
值。任何尝试使用this
不属于正确 Java 类型的值调用函数都会导致错误。
在上述场景中,情况正是如此。javascriptthis
值与 java 值不对应,this
并导致不兼容的对象错误。
解决方案是子类FunctionObject
化,覆盖call()
方法,强制“修复”this
引用,然后让调用正常进行。
所以像:
FunctionObject javascriptFunction = new MyFunctionObject(javascriptFunctionName, javaMethod, parentScope);
boundScope.put(javascriptFunctionName, boundScope, javascriptFunction);
private static class MyFunctionObject extends FunctionObject {
private MyFunctionObject(String name, Member methodOrConstructor, Scriptable parentScope) {
super(name, methodOrConstructor, parentScope);
}
@Override
public Object call(Context cx, Scriptable scope, Scriptable thisObj, Object[] args) {
return super.call(cx, scope, getParentScope(), args);
}
}
我认为最好通过下面粘贴的自包含/完整示例来理解。在此示例中,我们将实例方法:myJavaInstanceMethod(Double number) 公开为 javascript 范围内的全局函数 ('scriptExecutionScope')。因此在这种情况下,'parentScope' 参数的值必须是包含此方法的类的实例(即 MyScriptable)。
package test;
import org.mozilla.javascript.*;
import java.lang.reflect.Member;
import java.lang.reflect.Method;
//-- This is the class whose instance method will be made available in a JavaScript scope as a global function.
//-- It extends from ScriptableObject because instance methods of only scriptable objects can be directly exposed
//-- in a js scope as a global function.
public class MyScriptable extends ScriptableObject {
public static void main(String args[]) throws Exception {
Context.enter();
try {
//-- Create a top-level scope in which we will execute a simple test script to test if things are working or not.
Scriptable scriptExecutionScope = new ImporterTopLevel(Context.getCurrentContext());
//-- Create an instance of the class whose instance method is to be made available in javascript as a global function.
Scriptable myScriptable = new MyScriptable();
//-- This is not strictly required but it is a good practice to set the parent of all scriptable objects
//-- except in case of a top-level scriptable.
myScriptable.setParentScope(scriptExecutionScope);
//-- Get a reference to the instance method this is to be made available in javascript as a global function.
Method scriptableInstanceMethod = MyScriptable.class.getMethod("myJavaInstanceMethod", new Class[]{Double.class});
//-- Choose a name to be used for invoking the above instance method from within javascript.
String javascriptFunctionName = "myJavascriptGlobalFunction";
//-- Create the FunctionObject that binds the above function name to the instance method.
FunctionObject scriptableInstanceMethodBoundJavascriptFunction = new MyFunctionObject(javascriptFunctionName,
scriptableInstanceMethod, myScriptable);
//-- Make it accessible within the scriptExecutionScope.
scriptExecutionScope.put(javascriptFunctionName, scriptExecutionScope,
scriptableInstanceMethodBoundJavascriptFunction);
//-- Define a simple test script to test if things are working or not.
String testScript = "function simpleJavascriptFunction() {" +
" try {" +
" result = myJavascriptGlobalFunction(12.34);" +
" java.lang.System.out.println(result);" +
" }" +
" catch(e) {" +
" throw e;" +
" }" +
"}" +
"simpleJavascriptFunction();";
//-- Compile the test script.
Script compiledScript = Context.getCurrentContext().compileString(testScript, "My Test Script", 1, null);
//-- Execute the test script.
compiledScript.exec(Context.getCurrentContext(), scriptExecutionScope);
} catch (Exception e) {
throw e;
} finally {
Context.exit();
}
}
public Double myJavaInstanceMethod(Double number) {
return number * 2.0d;
}
@Override
public String getClassName() {
return getClass().getName();
}
private static class MyFunctionObject extends FunctionObject {
private MyFunctionObject(String name, Member methodOrConstructor, Scriptable parentScope) {
super(name, methodOrConstructor, parentScope);
}
@Override
public Object call(Context cx, Scriptable scope, Scriptable thisObj, Object[] args) {
return super.call(cx, scope, getParentScope(), args);
// return super.call(cx, scope, thisObj, args);
}
}
}
如果您想通过修复查看行为,请取消注释第 78 行和第 79 行:
return super.call(cx, scope, getParentScope(), args);
//return super.call(cx, scope, thisObj, args);
如果您想查看没有修复的行为,请注释第 78 行并取消注释第 79 行:
//return super.call(cx, scope, getParentScope(), args);
return super.call(cx, scope, thisObj, args);
希望这可以帮助。