JavascriptEngine (Eaching-all 3.7 API)

java.lang.Object
- cn.sucang.core.util.JavascriptEngine

All Implemented Interfaces:: IScriptEngine

public class JavascriptEngine
extends java.lang.Object
implements IScriptEngine

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.Object`	`callFunction(java.lang.String functionName, java.lang.Object[] args)` 调用初始化后的脚本中的JS函数,适用于一段脚本中有多个函数对象
`void`	`destory()` 执行完成后的销毁
`java.lang.Object`	`evalScript(java.lang.String js, java.io.PrintWriter writer, java.lang.String jsname)` 用于初始全局脚本
`java.lang.Object`	`evaluate(java.lang.String script)` 执行脚本片断，如果有异常则返回null,如果是debug模式则返回为数组: [输出文本内容, 运行返回值]
`static java.lang.Object`	`executeByFunction(java.lang.String scripts, java.lang.Object params)`
`java.lang.Object`	`executeFunction(java.lang.Object[] args, java.lang.String funName)` 配合evaluate($script)方法执行后，再执行里面的某个函数
`java.lang.Object`	`executeFunction(java.lang.String scripts, java.lang.Object[] args, java.lang.String funName)` 如果是debug则需要检查返回值是否为数组，以确定调试的中间输出内容，参数2为执行返回值返回null表示脚本解释错误,scripts需要自己封装，且以function 为前缀
`int`	`executeScript(java.lang.String scripts, java.util.Map params)`
`java.lang.String`	`getErrMsg()` 获取错误信息
`static JavascriptEngine`	`getInstance()` 总是返回新的对象new，类似于工厂方法。
`org.mozilla.javascript.Scriptable`	`getScope()`
`java.lang.Object`	`getVariant(java.lang.String key)` 获取脚本片断中的变量值，必须evaluate()方法执行后才有效
`boolean`	`isDebug()`
`static org.mozilla.javascript.NativeArray`	`javaArray2js(java.lang.Object objs, org.mozilla.javascript.Scriptable scope)`
`static java.lang.Object[]`	`jsarray2java(org.mozilla.javascript.NativeArray array, org.mozilla.javascript.Scriptable scope)`
`static java.util.Map`	`jsobject2map(org.mozilla.javascript.NativeObject obj, org.mozilla.javascript.Scriptable scope)`
`static void`	`main(java.lang.String[] args)`
`static org.mozilla.javascript.NativeObject`	`map2Jsobject(java.util.Map m, org.mozilla.javascript.Scriptable scope)`
`void`	`putAllObject(java.util.Map<java.lang.String,java.lang.Object> contextMap)` 添加上下文环境变量
`void`	`putJsObject(java.lang.String varName, java.lang.Object obj)` 将Java对象$obj转换到JS运行环境中以$varName为引用变量名
`IScriptEngine`	`putObject(java.lang.String key, java.lang.Object val)` 设置全局变量
`void`	`setDebug()`
`void`	`setDebug(boolean bl)` 设置为debug模式

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Method Detail
  - getInstance
```
public static JavascriptEngine getInstance()
```
    总是返回新的对象new，类似于工厂方法。
    
    Returns:
  - isDebug
```
public boolean isDebug()
```
    Specified by:
    
    isDebug in interface IScriptEngine
  - setDebug
```
public void setDebug()
```
  - setDebug
```
public void setDebug(boolean bl)
```
    Description copied from interface: IScriptEngine
    
    设置为debug模式
    
    Specified by:
    
    setDebug in interface IScriptEngine
  - evalScript
```
public java.lang.Object evalScript(java.lang.String js,
                                   java.io.PrintWriter writer,
                                   java.lang.String jsname)
```
    用于初始全局脚本
    
    Parameters:
    
    js -
    
    writer -
    
    Returns:
    
    Object //返回最后执行的一句话
  - getScope
```
public org.mozilla.javascript.Scriptable getScope()
```
  - destory
```
public void destory()
```
    Description copied from interface: IScriptEngine
    
    执行完成后的销毁
    
    Specified by:
    
    destory in interface IScriptEngine
  - executeScript
```
public int executeScript(java.lang.String scripts,
                         java.util.Map params)
```
    Parameters:
    
    scripts - as String //需要执行的Js脚本
    
    map0 - as Map
    
    request - as HttpServletRequest //用于传递给自定义处理接口的代码调用
    
    Returns:
    
    Map
  - putJsObject
```
public void putJsObject(java.lang.String varName,
                        java.lang.Object obj)
```
    将Java对象$obj转换到JS运行环境中以$varName为引用变量名
    
    Parameters:
    
    varName -
    
    obj -
  - getErrMsg
```
public java.lang.String getErrMsg()
```
    Description copied from interface: IScriptEngine
    
    获取错误信息
    
    Specified by:
    
    getErrMsg in interface IScriptEngine
    
    Returns:
  - callFunction
```
public java.lang.Object callFunction(java.lang.String functionName,
                                     java.lang.Object[] args)
```
    调用初始化后的脚本中的JS函数,适用于一段脚本中有多个函数对象
    
    Parameters:
    
    functionName - as String //JS函数名,如果是执行JS函数脚本内容则调用executeFunction(...)
    
    args - as Object[] //参数数组
    
    Returns:
    
    Object
  - executeByFunction
```
public static java.lang.Object executeByFunction(java.lang.String scripts,
                                                 java.lang.Object params)
```
  - executeFunction
```
public java.lang.Object executeFunction(java.lang.String scripts,
                                        java.lang.Object[] args,
                                        java.lang.String funName)
```
    如果是debug则需要检查返回值是否为数组，以确定调试的中间输出内容，参数2为执行返回值返回null表示脚本解释错误,scripts需要自己封装，且以function 为前缀
    
    Specified by:
    
    executeFunction in interface IScriptEngine
    
    Parameters:
    
    scripts - as String //函数文本内容,而非函数名。函数名调用请用方法callFunction(..);
    
    args - as Object[] //函数Function的参数
    
    funName - as String //函数名，用于识别日志参数分类用
    
    Returns:
    
    Object|Object[调试的中间输出内容，返回值] //如果是调试模式是才有数组返回值
  - main
```
public static void main(java.lang.String[] args)
```
    Parameters:
    
    scripts - as String //需要执行的Js脚本
    
    map0 - as Map
    
    request - as HttpServletRequest //用于传递给自定义处理接口的代码调用
  - map2Jsobject
```
public static org.mozilla.javascript.NativeObject map2Jsobject(java.util.Map m,
                                                               org.mozilla.javascript.Scriptable scope)
```
  - jsobject2map
```
public static java.util.Map jsobject2map(org.mozilla.javascript.NativeObject obj,
                                         org.mozilla.javascript.Scriptable scope)
```
  - jsarray2java
```
public static java.lang.Object[] jsarray2java(org.mozilla.javascript.NativeArray array,
                                              org.mozilla.javascript.Scriptable scope)
```
    Parameters:
    
    array - as NativeArray
    
    scope -
    
    Returns:
  - javaArray2js
```
public static org.mozilla.javascript.NativeArray javaArray2js(java.lang.Object objs,
                                                              org.mozilla.javascript.Scriptable scope)
```
  - evaluate
```
public java.lang.Object evaluate(java.lang.String script)
                          throws ScriptEvaluateException
```
    Description copied from interface: IScriptEngine
    
    执行脚本片断，如果有异常则返回null,如果是debug模式则返回为数组: [输出文本内容, 运行返回值]
    
    Specified by:
    
    evaluate in interface IScriptEngine
    
    Returns:
    
    Throws:
    
    ScriptEvaluateException
  - getVariant
```
public java.lang.Object getVariant(java.lang.String key)
```
    Description copied from interface: IScriptEngine
    
    获取脚本片断中的变量值，必须evaluate()方法执行后才有效
    
    Specified by:
    
    getVariant in interface IScriptEngine
    
    Returns:
  - executeFunction
```
public java.lang.Object executeFunction(java.lang.Object[] args,
                                        java.lang.String funName)
                                 throws ScriptEvaluateException
```
    Description copied from interface: IScriptEngine
    
    配合evaluate($script)方法执行后，再执行里面的某个函数
    
    Specified by:
    
    executeFunction in interface IScriptEngine
    
    Returns:
    
    Throws:
    
    ScriptEvaluateException
  - putAllObject
```
public void putAllObject(java.util.Map<java.lang.String,java.lang.Object> contextMap)
```
    Description copied from interface: IScriptEngine
    
    添加上下文环境变量
    
    Specified by:
    
    putAllObject in interface IScriptEngine
  - putObject
```
public IScriptEngine putObject(java.lang.String key,
                               java.lang.Object val)
```
    Description copied from interface: IScriptEngine
    
    设置全局变量
    
    Specified by:
    
    putObject in interface IScriptEngine
    
    Returns:

Class JavascriptEngine

Method Summary

Methods inherited from class java.lang.Object

Method Detail

getInstance

isDebug

setDebug

setDebug

evalScript

getScope

destory

executeScript

putJsObject

getErrMsg

callFunction

executeByFunction

executeFunction

main

map2Jsobject

jsobject2map

jsarray2java

javaArray2js

evaluate

getVariant

executeFunction

putAllObject

putObject