Browse Source
* commit 'b7603c29a7e9bae515c25f38df319a667c00a38f': KERNEL-12469 js引擎j2v8剥离成独立插件bugfix/11.0
superman
2 years ago
72 changed files with 0 additions and 11105 deletions
@ -1,6 +0,0 @@ |
|||||||
*.iml |
|
||||||
.idea/ |
|
||||||
.DS_Store |
|
||||||
.project |
|
||||||
.classpath |
|
||||||
*.gradle |
|
||||||
@ -1,18 +0,0 @@ |
|||||||
<?xml version="1.0" encoding="UTF-8"?> |
|
||||||
<project xmlns="http://maven.apache.org/POM/4.0.0" |
|
||||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
|
||||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> |
|
||||||
<modelVersion>4.0.0</modelVersion> |
|
||||||
|
|
||||||
<parent> |
|
||||||
<groupId>com.fr.third</groupId> |
|
||||||
<artifactId>step1</artifactId> |
|
||||||
<version>${revision}</version> |
|
||||||
<relativePath>../base-third-project/base-third-step1</relativePath> |
|
||||||
</parent> |
|
||||||
|
|
||||||
<artifactId>fine-j2v8</artifactId> |
|
||||||
<version>${revision}</version> |
|
||||||
|
|
||||||
|
|
||||||
</project> |
|
||||||
@ -1,37 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* Classes that implement this interface provide a method |
|
||||||
* which can be invoked from JavaScript. The method can return |
|
||||||
* a result. |
|
||||||
* |
|
||||||
* After creating an instance of a class that implements this |
|
||||||
* interface it can be registered as a Callback on a V8Object. |
|
||||||
*/ |
|
||||||
public interface JavaCallback { |
|
||||||
|
|
||||||
/** |
|
||||||
* Called when a JS Function invokes a the registered Java |
|
||||||
* method. |
|
||||||
* |
|
||||||
* @param receiver The V8Object that the function was called on. |
|
||||||
* @param parameters The parameters passed to the JS Function. The |
|
||||||
* parameter array does not need to be released, by any objects accessed |
|
||||||
* from the array must be. |
|
||||||
* |
|
||||||
* @return A result that should be passed back to JavaScript. The |
|
||||||
* result must be either an Integer, Double, Boolean, String or V8Value. |
|
||||||
*/ |
|
||||||
public Object invoke(V8Object receiver, V8Array parameters); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,33 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* Classes that implement this interface provide a method |
|
||||||
* which can be invoked from JavaScript. |
|
||||||
* |
|
||||||
* After creating an instance of a class that implements this |
|
||||||
* interface it can be registered as a Callback on a V8Object. |
|
||||||
*/ |
|
||||||
public interface JavaVoidCallback { |
|
||||||
|
|
||||||
/** |
|
||||||
* Called when a JS Function invokes a the registered Java |
|
||||||
* method. |
|
||||||
* |
|
||||||
* @param receiver The V8Object that the function was called on. |
|
||||||
* @param parameters The parameters passed to the JS Function. The |
|
||||||
* parameter array does not need to be released, by any objects accessed |
|
||||||
* from the array must be. |
|
||||||
*/ |
|
||||||
public void invoke(V8Object receiver, V8Array parameters); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,243 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
* Wolfgang Steiner - code separation PlatformDetector/LibraryLoader |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
import java.io.File; |
|
||||||
import java.io.FileOutputStream; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStream; |
|
||||||
import java.lang.management.ManagementFactory; |
|
||||||
|
|
||||||
class LibraryLoader { |
|
||||||
|
|
||||||
static final String SEPARATOR; |
|
||||||
static final String DELIMITER; |
|
||||||
|
|
||||||
static final String SWT_LIB_DIR = ".j2v8"; |
|
||||||
|
|
||||||
static final String MINIMUM_VERSION = "6.2"; |
|
||||||
|
|
||||||
static { |
|
||||||
DELIMITER = System.getProperty("line.separator"); //$NON-NLS-1$
|
|
||||||
SEPARATOR = System.getProperty("file.separator"); //$NON-NLS-1$
|
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the base-name for the native J2V8 library file. |
|
||||||
* @param withLinuxVendor include/exclude the {vendor} part from the returned filename |
|
||||||
* <p>NOTE: Vendors are only included for linux systems</p> |
|
||||||
* @return The filename string has the following structure: |
|
||||||
* <pre><code>{arch}-[vendor]-{operating_system}</pre></code> |
|
||||||
*/ |
|
||||||
public static String computeLibraryShortName(boolean withLinuxVendor) { |
|
||||||
String prefix = "j2v8"; |
|
||||||
String vendor = withLinuxVendor && PlatformDetector.OS.isLinux() ? PlatformDetector.Vendor.getName() : null; |
|
||||||
String os = PlatformDetector.OS.getName(); |
|
||||||
String arch = PlatformDetector.Arch.getName(); |
|
||||||
|
|
||||||
final String separator = "-"; |
|
||||||
|
|
||||||
return |
|
||||||
prefix + |
|
||||||
(vendor != null ? separator + vendor : "") + |
|
||||||
separator + os + |
|
||||||
separator + arch; |
|
||||||
} |
|
||||||
|
|
||||||
public static String computeLibraryFullName(boolean withLinuxVendor) { |
|
||||||
return "lib" + computeLibraryShortName(withLinuxVendor) + "." + PlatformDetector.OS.getLibFileExtension(); |
|
||||||
} |
|
||||||
|
|
||||||
static boolean tryLoad(boolean withLinuxVendor, StringBuffer message) { |
|
||||||
String libShortName = computeLibraryShortName(withLinuxVendor); |
|
||||||
String libFullName = computeLibraryFullName(withLinuxVendor); |
|
||||||
String ideLocation = System.getProperty("user.dir") + SEPARATOR + "jni" + SEPARATOR + libFullName; |
|
||||||
|
|
||||||
/* Try loading library from java library path */ |
|
||||||
if (load(libFullName, message)) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
if (load(libShortName, message)) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/* Try loading library from the IDE location */ |
|
||||||
if (new File(ideLocation).exists()) { |
|
||||||
if (load(ideLocation, message)) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
static void loadLibrary(final String tempDirectory) { |
|
||||||
if (PlatformDetector.OS.isAndroid()) { |
|
||||||
System.loadLibrary("j2v8"); |
|
||||||
return; |
|
||||||
} |
|
||||||
|
|
||||||
StringBuffer message = new StringBuffer(); |
|
||||||
|
|
||||||
// try loading a vendor-specific library first
|
|
||||||
if (tryLoad(true, message)) |
|
||||||
return; |
|
||||||
|
|
||||||
// if there is no vendor-specific library, just try to load the default OS library
|
|
||||||
if (tryLoad(false, message)) |
|
||||||
return; |
|
||||||
|
|
||||||
String path = null; |
|
||||||
|
|
||||||
if (tempDirectory != null) { |
|
||||||
path = tempDirectory; |
|
||||||
} else { |
|
||||||
path = System.getProperty("java.io.tmpdir"); //$NON-NLS-1$
|
|
||||||
} |
|
||||||
|
|
||||||
// try extracting a vendor-specific library first
|
|
||||||
if (extract(path, true, message)) |
|
||||||
return; |
|
||||||
|
|
||||||
// if there is no vendor-specific library, just try to extract the default OS library
|
|
||||||
if (extract(path, false, message)) |
|
||||||
return; |
|
||||||
|
|
||||||
/* Failed to find the library */ |
|
||||||
throw new UnsatisfiedLinkError("Could not load J2V8 library. Reasons: " + message.toString()); //$NON-NLS-1$
|
|
||||||
} |
|
||||||
|
|
||||||
static boolean load(final String libName, final StringBuffer message) { |
|
||||||
try { |
|
||||||
if (libName.indexOf(SEPARATOR) != -1) { |
|
||||||
System.load(libName); |
|
||||||
} else { |
|
||||||
System.loadLibrary(libName); |
|
||||||
} |
|
||||||
return true; |
|
||||||
} catch (UnsatisfiedLinkError e) { |
|
||||||
if (message.length() == 0) { |
|
||||||
message.append(DELIMITER); |
|
||||||
} |
|
||||||
message.append('\t'); |
|
||||||
message.append(e.getMessage()); |
|
||||||
message.append(DELIMITER); |
|
||||||
} |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
static boolean extract(String libPath, boolean withLinuxVendor, StringBuffer message) { |
|
||||||
String libFullName = computeLibraryFullName(withLinuxVendor); |
|
||||||
return extract(libPath + SEPARATOR + libFullName, libFullName, message); |
|
||||||
} |
|
||||||
|
|
||||||
static boolean extract(final String fileName, final String mappedName, final StringBuffer message) { |
|
||||||
FileOutputStream os = null; |
|
||||||
InputStream is = null; |
|
||||||
File file = new File(fileName); |
|
||||||
//这部分自己修改过，主要是以为linux通过System.getProperty("java.io.tmpdir")获取到的是相对路径，但是System.load方法加载需要文件的绝对路径。
|
|
||||||
String absoluteName = file.getAbsolutePath(); |
|
||||||
boolean extracted = false; |
|
||||||
try { |
|
||||||
if (file.exists()) { |
|
||||||
file.delete(); |
|
||||||
} |
|
||||||
is = LibraryLoader.class.getResourceAsStream("/" + mappedName); //$NON-NLS-1$
|
|
||||||
if (is != null) { |
|
||||||
extracted = true; |
|
||||||
int read; |
|
||||||
byte[] buffer = new byte[4096]; |
|
||||||
os = new FileOutputStream(fileName); |
|
||||||
while ((read = is.read(buffer)) != -1) { |
|
||||||
os.write(buffer, 0, read); |
|
||||||
} |
|
||||||
os.close(); |
|
||||||
is.close(); |
|
||||||
chmod("755", fileName); |
|
||||||
if (load(absoluteName, message)) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
} |
|
||||||
} catch (Throwable e) { |
|
||||||
try { |
|
||||||
if (os != null) { |
|
||||||
os.close(); |
|
||||||
} |
|
||||||
} catch (IOException e1) { |
|
||||||
} |
|
||||||
try { |
|
||||||
if (is != null) { |
|
||||||
is.close(); |
|
||||||
} |
|
||||||
} catch (IOException e1) { |
|
||||||
} |
|
||||||
if (extracted && file.exists()) { |
|
||||||
file.delete(); |
|
||||||
} |
|
||||||
} |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
static void chmod(final String permision, final String path) { |
|
||||||
if (PlatformDetector.OS.isWindows()) { |
|
||||||
return; |
|
||||||
} |
|
||||||
try { |
|
||||||
Runtime.getRuntime().exec(new String[] { "chmod", permision, path }).waitFor(); //$NON-NLS-1$
|
|
||||||
} catch (Throwable e) { |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
//内核版本windows NT6.2以下存在加载dll之后无法正常退出的问题，注册钩子函数退出时杀掉进程
|
|
||||||
static void checkExceptionVersion() { |
|
||||||
String version = System.getProperty("os.version"); |
|
||||||
if (PlatformDetector.OS.isWindows() && belowMinimumVersion(version)) { |
|
||||||
registerExit(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
//低于指定版本，6.2以下
|
|
||||||
private static boolean belowMinimumVersion(String version) { |
|
||||||
return compareVersion(version, MINIMUM_VERSION) < 0; |
|
||||||
} |
|
||||||
|
|
||||||
private static int compareVersion(String version1, String version2) { |
|
||||||
String[] versionArray1 = version1.split("\\.");//注意此处为正则匹配，不能用"."；
|
|
||||||
String[] versionArray2 = version2.split("\\."); |
|
||||||
int idx = 0; |
|
||||||
int minLength = Math.min(versionArray1.length, versionArray2.length);//取最小长度值
|
|
||||||
int diff = 0; |
|
||||||
while (idx < minLength |
|
||||||
&& (diff = versionArray1[idx].length() - versionArray2[idx].length()) == 0//先比较长度
|
|
||||||
&& (diff = versionArray1[idx].compareTo(versionArray2[idx])) == 0) {//再比较字符
|
|
||||||
++idx; |
|
||||||
} |
|
||||||
//如果已经分出大小，则直接返回，如果未分出大小，则再比较位数，有子版本的为大；
|
|
||||||
diff = (diff != 0) ? diff : versionArray1.length - versionArray2.length; |
|
||||||
return diff; |
|
||||||
} |
|
||||||
|
|
||||||
//低于指定版本，6.2以下
|
|
||||||
private static void registerExit() { |
|
||||||
Runtime.getRuntime().addShutdownHook(new Thread() { |
|
||||||
@Override |
|
||||||
public void run() { |
|
||||||
String name = ManagementFactory.getRuntimeMXBean().getName(); |
|
||||||
String pid = name.split("@")[0]; |
|
||||||
try { |
|
||||||
Runtime.getRuntime().exec("taskkill /F /PID " + pid); |
|
||||||
} catch (Exception ignore) { |
|
||||||
} |
|
||||||
} |
|
||||||
}); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,239 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
import java.io.File; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.PrintWriter; |
|
||||||
|
|
||||||
/** |
|
||||||
* An isolate NodeJS runtime. |
|
||||||
* |
|
||||||
* This class is only available on some platforms. In particular any methods |
|
||||||
* on this class, on an Android device, will lead to an UnsupportedOperationException. |
|
||||||
*/ |
|
||||||
public class NodeJS { |
|
||||||
|
|
||||||
private static final String TMP_JS_EXT = ".js.tmp"; |
|
||||||
private static final String NEXT_TICK = "nextTick"; |
|
||||||
private static final String PROCESS = "process"; |
|
||||||
private static final String GLOBAL = "global"; |
|
||||||
private static final String STARTUP_CALLBACK = "__run"; |
|
||||||
private static final String STARTUP_SCRIPT = "global." + STARTUP_CALLBACK + "(require, exports, module, __filename, __dirname);"; |
|
||||||
private static final String STARTUP_SCRIPT_NAME = "startup"; |
|
||||||
private static final String VERSIONS = "versions"; |
|
||||||
private static final String NODE = "node"; |
|
||||||
private String nodeVersion = null; |
|
||||||
|
|
||||||
private V8 v8; |
|
||||||
private V8Function require; |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a NodeJS Runtime |
|
||||||
* |
|
||||||
* @return The NodeJS runtime. |
|
||||||
* |
|
||||||
* May throw an UnsupportedOperationException if node.js integration has not |
|
||||||
* been compiled for your platform. |
|
||||||
*/ |
|
||||||
public static NodeJS createNodeJS() { |
|
||||||
return createNodeJS(null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the version of Node.js that is runtime is built against. |
|
||||||
* This uses process.versions.node to get the version. |
|
||||||
* |
|
||||||
* @return The version of Node.js. |
|
||||||
*/ |
|
||||||
public String getNodeVersion() { |
|
||||||
if (nodeVersion != null) { |
|
||||||
return nodeVersion; |
|
||||||
} |
|
||||||
V8Object process = null; |
|
||||||
V8Object versions = null; |
|
||||||
try { |
|
||||||
process = v8.getObject(PROCESS); |
|
||||||
versions = process.getObject(VERSIONS); |
|
||||||
nodeVersion = versions.getString(NODE); |
|
||||||
} finally { |
|
||||||
safeRelease(process); |
|
||||||
safeRelease(versions); |
|
||||||
} |
|
||||||
return nodeVersion; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a NodeJS runtime and executes a JS Script |
|
||||||
* |
|
||||||
* @param file The JavaScript to execute or null for no script. |
|
||||||
* @return The NodeJS runtime. |
|
||||||
* |
|
||||||
* May throw an UnsupportedOperationException if node.js integration has not |
|
||||||
* been compiled for your platform. |
|
||||||
*/ |
|
||||||
public static NodeJS createNodeJS(final File file) { |
|
||||||
V8 v8 = V8.createV8Runtime(GLOBAL); |
|
||||||
final NodeJS node = new NodeJS(v8); |
|
||||||
v8.registerJavaMethod(new JavaVoidCallback() { |
|
||||||
|
|
||||||
@Override |
|
||||||
public void invoke(final V8Object receiver, final V8Array parameters) { |
|
||||||
V8Function require = (V8Function) parameters.get(0); |
|
||||||
try { |
|
||||||
node.init(require.twin()); |
|
||||||
} finally { |
|
||||||
require.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
}, STARTUP_CALLBACK); |
|
||||||
try { |
|
||||||
File startupScript = createTemporaryScriptFile(STARTUP_SCRIPT, STARTUP_SCRIPT_NAME); |
|
||||||
try { |
|
||||||
v8.createNodeRuntime(startupScript.getAbsolutePath()); |
|
||||||
} finally { |
|
||||||
startupScript.delete(); |
|
||||||
} |
|
||||||
} catch (IOException e) { |
|
||||||
throw new RuntimeException(e); |
|
||||||
} |
|
||||||
if (file != null) { |
|
||||||
node.exec(file); |
|
||||||
} |
|
||||||
return node; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the V8 runtime being used for this NodeJS instance. |
|
||||||
* |
|
||||||
* @return The V8 Runtime. |
|
||||||
*/ |
|
||||||
public V8 getRuntime() { |
|
||||||
return v8; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Handles the next message in the message loop. Returns True |
|
||||||
* if there are more messages to handle, false otherwise. |
|
||||||
* |
|
||||||
* @return True if there are more messages to handle, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean handleMessage() { |
|
||||||
v8.checkThread(); |
|
||||||
return v8.pumpMessageLoop(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Releases the NodeJS runtime. |
|
||||||
*/ |
|
||||||
public void release() { |
|
||||||
v8.checkThread(); |
|
||||||
if (!require.isReleased()) { |
|
||||||
require.close(); |
|
||||||
} |
|
||||||
if (!v8.isReleased()) { |
|
||||||
v8.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if there are more messages to process, false otherwise. |
|
||||||
* |
|
||||||
* @return True if there are more messages to process, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isRunning() { |
|
||||||
v8.checkThread(); |
|
||||||
return v8.isRunning(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Invokes NodeJS require() on the specified file. This will load the module, execute |
|
||||||
* it and return the exports object to the caller. The exports object must be released. |
|
||||||
* |
|
||||||
* @param file The module to load. |
|
||||||
* @return The exports object. |
|
||||||
*/ |
|
||||||
public V8Object require(final File file) { |
|
||||||
v8.checkThread(); |
|
||||||
V8Array requireParams = new V8Array(v8); |
|
||||||
try { |
|
||||||
requireParams.push(file.getAbsolutePath()); |
|
||||||
return (V8Object) require.call(null, requireParams); |
|
||||||
} finally { |
|
||||||
requireParams.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Execute a NodeJS script. This will load the script and execute it on the |
|
||||||
* next tick. This is the same as how NodeJS executes scripts at startup. Since |
|
||||||
* the script won't actually run until the next tick, this method does not return |
|
||||||
* a result. |
|
||||||
* |
|
||||||
* @param file The script to execute. |
|
||||||
*/ |
|
||||||
public void exec(final File file) { |
|
||||||
V8Function scriptExecution = createScriptExecutionCallback(file); |
|
||||||
V8Object process = null; |
|
||||||
V8Array parameters = null; |
|
||||||
try { |
|
||||||
process = v8.getObject(PROCESS); |
|
||||||
parameters = new V8Array(v8); |
|
||||||
parameters.push(scriptExecution); |
|
||||||
process.executeObjectFunction(NEXT_TICK, parameters); |
|
||||||
} finally { |
|
||||||
safeRelease(process); |
|
||||||
safeRelease(parameters); |
|
||||||
safeRelease(scriptExecution); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private V8Function createScriptExecutionCallback(final File file) { |
|
||||||
V8Function v8Function = new V8Function(v8, new JavaCallback() { |
|
||||||
@Override |
|
||||||
public Object invoke(final V8Object receiver, final V8Array parameters) { |
|
||||||
V8Array requireParams = new V8Array(v8); |
|
||||||
try { |
|
||||||
requireParams.push(file.getAbsolutePath()); |
|
||||||
return require.call(null, requireParams); |
|
||||||
} finally { |
|
||||||
requireParams.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
}); |
|
||||||
return v8Function; |
|
||||||
} |
|
||||||
|
|
||||||
private void safeRelease(final Releasable releasable) { |
|
||||||
if (releasable != null) { |
|
||||||
releasable.release(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private NodeJS(final V8 v8) { |
|
||||||
this.v8 = v8; |
|
||||||
} |
|
||||||
|
|
||||||
private void init(final V8Function require) { |
|
||||||
this.require = require; |
|
||||||
} |
|
||||||
|
|
||||||
private static File createTemporaryScriptFile(final String script, final String name) throws IOException { |
|
||||||
File tempFile = File.createTempFile(name, TMP_JS_EXT); |
|
||||||
PrintWriter writer = new PrintWriter(tempFile, "UTF-8"); |
|
||||||
try { |
|
||||||
writer.print(script); |
|
||||||
} finally { |
|
||||||
writer.close(); |
|
||||||
} |
|
||||||
return tempFile; |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,12 +0,0 @@ |
|||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
public class Platform { |
|
||||||
public static final String ANDROID = "android"; |
|
||||||
public static final String LINUX = "linux"; |
|
||||||
public static final String MACOSX = "macosx"; |
|
||||||
public static final String WINDOWS = "windows"; |
|
||||||
|
|
||||||
public static final String NATIVE_CLIENT = "nacl"; |
|
||||||
|
|
||||||
public static final String UNKNOWN = "unknown"; |
|
||||||
} |
|
||||||
@ -1,319 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2017 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* Trustin Lee - original OS/Arch/Vendor detection code (see: https://github.com/trustin/os-maven-plugin)
|
|
||||||
* Wolfgang Steiner - initial API and implementation |
|
||||||
* |
|
||||||
* Copyright 2014 Trustin Heuiseung Lee. |
|
||||||
* |
|
||||||
* Licensed under the Apache License, Version 2.0 (the "License"); |
|
||||||
* you may not use this file except in compliance with the License. |
|
||||||
* You may obtain a copy of the License at |
|
||||||
* |
|
||||||
* http://www.apache.org/licenses/LICENSE-2.0
|
|
||||||
* |
|
||||||
* Unless required by applicable law or agreed to in writing, software |
|
||||||
* distributed under the License is distributed on an "AS IS" BASIS, |
|
||||||
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
|
||||||
* See the License for the specific language governing permissions and |
|
||||||
* limitations under the License. |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
import java.io.BufferedReader; |
|
||||||
import java.io.Closeable; |
|
||||||
import java.io.File; |
|
||||||
import java.io.FileInputStream; |
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStreamReader; |
|
||||||
import java.util.Locale; |
|
||||||
|
|
||||||
public class PlatformDetector { |
|
||||||
public static class Arch { |
|
||||||
public static String getName() { |
|
||||||
final String archProperty = System.getProperty("os.arch"); |
|
||||||
final String archName = normalizeArch(archProperty); |
|
||||||
|
|
||||||
if (archName.equals(Platform.UNKNOWN)) { |
|
||||||
throw new UnsatisfiedLinkError("Unsupported arch: " + archProperty); |
|
||||||
} |
|
||||||
|
|
||||||
return archName; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
public static class OS { |
|
||||||
public static String getName() { |
|
||||||
final String osProperty = System.getProperty("os.name"); |
|
||||||
final String osName = normalizeOs(osProperty); |
|
||||||
|
|
||||||
final String vendorProperty = System.getProperty("java.specification.vendor"); |
|
||||||
final String vendorName = normalize(vendorProperty); |
|
||||||
|
|
||||||
// special handling for android
|
|
||||||
if (vendorName.contains("android") || osName.contains("android")) { |
|
||||||
return Platform.ANDROID; |
|
||||||
} |
|
||||||
|
|
||||||
if (osName.equals(Platform.UNKNOWN)) { |
|
||||||
throw new UnsatisfiedLinkError("Unsupported platform/vendor: " + osProperty + " / " + vendorProperty); |
|
||||||
} |
|
||||||
|
|
||||||
return osName; |
|
||||||
} |
|
||||||
|
|
||||||
public static boolean isWindows() { |
|
||||||
return getName().equals(Platform.WINDOWS); |
|
||||||
} |
|
||||||
|
|
||||||
public static boolean isMac() { |
|
||||||
return getName().equals(Platform.MACOSX); |
|
||||||
} |
|
||||||
|
|
||||||
public static boolean isLinux() { |
|
||||||
return getName().equals(Platform.LINUX); |
|
||||||
} |
|
||||||
|
|
||||||
public static boolean isNativeClient() { |
|
||||||
return getName().equals(Platform.NATIVE_CLIENT); |
|
||||||
} |
|
||||||
|
|
||||||
public static boolean isAndroid() { |
|
||||||
return getName().equals(Platform.ANDROID); |
|
||||||
} |
|
||||||
|
|
||||||
public static String getLibFileExtension() { |
|
||||||
if (isWindows()) { |
|
||||||
return "dll"; |
|
||||||
} |
|
||||||
|
|
||||||
if (isMac()) { |
|
||||||
return "dylib"; |
|
||||||
} |
|
||||||
|
|
||||||
if (isLinux() |
|
||||||
|| isAndroid() |
|
||||||
|| isNativeClient()) { |
|
||||||
return "so"; |
|
||||||
} |
|
||||||
|
|
||||||
throw new UnsatisfiedLinkError("Unsupported platform library-extension for: " + getName()); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
public static class Vendor { |
|
||||||
private static final String[] LINUX_OS_RELEASE_FILES = {"/etc/os-release", "/usr/lib/os-release"}; |
|
||||||
private static final String REDHAT_RELEASE_FILE = "/etc/redhat-release"; |
|
||||||
private static final String LINUX_ID_PREFIX = "ID="; |
|
||||||
|
|
||||||
public static String getName() { |
|
||||||
if (OS.isWindows()) { |
|
||||||
return "microsoft"; |
|
||||||
} |
|
||||||
if (OS.isMac()) { |
|
||||||
return "apple"; |
|
||||||
} |
|
||||||
if (OS.isLinux()) { |
|
||||||
return getLinuxOsReleaseId(); |
|
||||||
} |
|
||||||
if (OS.isAndroid()) { |
|
||||||
return "google"; |
|
||||||
} |
|
||||||
//如果if条件全部不符合，就会陷入死循环，代码存在风险
|
|
||||||
//throw new UnsatisfiedLinkError("Unsupported vendor: " + getName());
|
|
||||||
return null; |
|
||||||
} |
|
||||||
|
|
||||||
private static String getLinuxOsReleaseId() { |
|
||||||
// First, look for the os-release file.
|
|
||||||
for (String osReleaseFileName : LINUX_OS_RELEASE_FILES) { |
|
||||||
File file = new File(osReleaseFileName); |
|
||||||
if (file.exists()) { |
|
||||||
return parseLinuxOsReleaseFile(file); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
// Older versions of redhat don't have /etc/os-release. In this case, try
|
|
||||||
// parsing this file.
|
|
||||||
File file = new File(REDHAT_RELEASE_FILE); |
|
||||||
if (file.exists()) { |
|
||||||
return parseLinuxRedhatReleaseFile(file); |
|
||||||
} |
|
||||||
|
|
||||||
//linux系统下如果缺失/etc/os-release,/usr/lib/os-release,/etc/redhat-release三个文件，就会和getName方法就会一直互相调用
|
|
||||||
//throw new UnsatisfiedLinkError("Unsupported linux vendor: " + getName());
|
|
||||||
return null; |
|
||||||
} |
|
||||||
|
|
||||||
private static String parseLinuxOsReleaseFile(final File file) { |
|
||||||
BufferedReader reader = null; |
|
||||||
try { |
|
||||||
reader = new BufferedReader(new InputStreamReader(new FileInputStream(file), "utf-8")); |
|
||||||
|
|
||||||
String id = null; |
|
||||||
String line; |
|
||||||
while((line = reader.readLine()) != null) { |
|
||||||
// Parse the ID line.
|
|
||||||
if (line.startsWith(LINUX_ID_PREFIX)) { |
|
||||||
// Set the ID for this version.
|
|
||||||
id = normalizeOsReleaseValue(line.substring(LINUX_ID_PREFIX.length())); |
|
||||||
break; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
return id; |
|
||||||
} catch (IOException ignored) { |
|
||||||
// Just absorb. Don't treat failure to read /etc/os-release as an error.
|
|
||||||
} finally { |
|
||||||
closeQuietly(reader); |
|
||||||
} |
|
||||||
return null; |
|
||||||
} |
|
||||||
|
|
||||||
private static String parseLinuxRedhatReleaseFile(final File file) { |
|
||||||
BufferedReader reader = null; |
|
||||||
try { |
|
||||||
reader = new BufferedReader(new InputStreamReader(new FileInputStream(file), "utf-8")); |
|
||||||
|
|
||||||
// There is only a single line in this file.
|
|
||||||
String line = reader.readLine(); |
|
||||||
if (line != null) { |
|
||||||
line = line.toLowerCase(Locale.US); |
|
||||||
|
|
||||||
String id; |
|
||||||
if (line.contains("centos")) { |
|
||||||
id = "centos"; |
|
||||||
} else if (line.contains("fedora")) { |
|
||||||
id = "fedora"; |
|
||||||
} else if (line.contains("red hat enterprise linux")) { |
|
||||||
id = "rhel"; |
|
||||||
} else { |
|
||||||
// Other variants are not currently supported.
|
|
||||||
return null; |
|
||||||
} |
|
||||||
|
|
||||||
return id; |
|
||||||
} |
|
||||||
} catch (IOException ignored) { |
|
||||||
// Just absorb. Don't treat failure to read /etc/os-release as an error.
|
|
||||||
} finally { |
|
||||||
closeQuietly(reader); |
|
||||||
} |
|
||||||
return null; |
|
||||||
} |
|
||||||
|
|
||||||
private static void closeQuietly(final Closeable obj) { |
|
||||||
try { |
|
||||||
if (obj != null) { |
|
||||||
obj.close(); |
|
||||||
} |
|
||||||
} catch (IOException ignored) { |
|
||||||
// Ignore.
|
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static String normalizeOsReleaseValue(final String value) { |
|
||||||
// Remove any quotes from the string.
|
|
||||||
return value.trim().replace("\"", ""); |
|
||||||
} |
|
||||||
|
|
||||||
private static String normalizeOs(String value) { |
|
||||||
value = normalize(value); |
|
||||||
if (value.startsWith("aix")) { |
|
||||||
return "aix"; |
|
||||||
} |
|
||||||
if (value.startsWith("hpux")) { |
|
||||||
return "hpux"; |
|
||||||
} |
|
||||||
if (value.startsWith("os400")) { |
|
||||||
// Avoid the names such as os4000
|
|
||||||
if ((value.length() <= 5) || !Character.isDigit(value.charAt(5))) { |
|
||||||
return "os400"; |
|
||||||
} |
|
||||||
} |
|
||||||
if (value.startsWith("android")) { |
|
||||||
return Platform.ANDROID; |
|
||||||
} |
|
||||||
if (value.startsWith("linux")) { |
|
||||||
return Platform.LINUX; |
|
||||||
} |
|
||||||
if (value.startsWith("nacl")) { |
|
||||||
return Platform.NATIVE_CLIENT; |
|
||||||
} |
|
||||||
if (value.startsWith("macosx") || value.startsWith("osx")) { |
|
||||||
return Platform.MACOSX; |
|
||||||
} |
|
||||||
if (value.startsWith("freebsd")) { |
|
||||||
return "freebsd"; |
|
||||||
} |
|
||||||
if (value.startsWith("openbsd")) { |
|
||||||
return "openbsd"; |
|
||||||
} |
|
||||||
if (value.startsWith("netbsd")) { |
|
||||||
return "netbsd"; |
|
||||||
} |
|
||||||
if (value.startsWith("solaris") || value.startsWith("sunos")) { |
|
||||||
return "sunos"; |
|
||||||
} |
|
||||||
if (value.startsWith("windows")) { |
|
||||||
return Platform.WINDOWS; |
|
||||||
} |
|
||||||
|
|
||||||
return Platform.UNKNOWN; |
|
||||||
} |
|
||||||
|
|
||||||
private static String normalizeArch(String value) { |
|
||||||
value = normalize(value); |
|
||||||
if (value.matches("^(x8664|amd64|ia32e|em64t|x64)$")) { |
|
||||||
return "x86_64"; |
|
||||||
} |
|
||||||
if (value.matches("^(x8632|x86|i[3-6]86|ia32|x32)$")) { |
|
||||||
return "x86_32"; |
|
||||||
} |
|
||||||
if (value.matches("^(ia64|itanium64)$")) { |
|
||||||
return "itanium_64"; |
|
||||||
} |
|
||||||
if (value.matches("^(sparc|sparc32)$")) { |
|
||||||
return "sparc_32"; |
|
||||||
} |
|
||||||
if (value.matches("^(sparcv9|sparc64)$")) { |
|
||||||
return "sparc_64"; |
|
||||||
} |
|
||||||
if (value.matches("^(arm|arm32)$") || value.startsWith("armv7")) { |
|
||||||
return "arm_32"; |
|
||||||
} |
|
||||||
if ("aarch64".equals(value) || value.startsWith("armv8")) { |
|
||||||
return "aarch_64"; |
|
||||||
} |
|
||||||
if (value.matches("^(ppc|ppc32)$")) { |
|
||||||
return "ppc_32"; |
|
||||||
} |
|
||||||
if ("ppc64".equals(value)) { |
|
||||||
return "ppc_64"; |
|
||||||
} |
|
||||||
if ("ppc64le".equals(value)) { |
|
||||||
return "ppcle_64"; |
|
||||||
} |
|
||||||
if ("s390".equals(value)) { |
|
||||||
return "s390_32"; |
|
||||||
} |
|
||||||
if ("s390x".equals(value)) { |
|
||||||
return "s390_64"; |
|
||||||
} |
|
||||||
|
|
||||||
return Platform.UNKNOWN; |
|
||||||
} |
|
||||||
|
|
||||||
private static String normalize(final String value) { |
|
||||||
if (value == null) { |
|
||||||
return ""; |
|
||||||
} |
|
||||||
return value.toLowerCase(Locale.US).replaceAll("[^a-z0-9]+", ""); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,34 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* Callback used to track when native handles are created and released. |
|
||||||
*/ |
|
||||||
public interface ReferenceHandler { |
|
||||||
|
|
||||||
/** |
|
||||||
* Called when a native handle is first created. The V8Value |
|
||||||
* referenced by that handle is passed as a parameter. |
|
||||||
* |
|
||||||
* @param object The V8Value referenced by the handle |
|
||||||
*/ |
|
||||||
public void v8HandleCreated(V8Value object); |
|
||||||
|
|
||||||
/** |
|
||||||
* Called when a native handle is released. The V8Value |
|
||||||
* referenced by that handle is passed as a parameter. |
|
||||||
* |
|
||||||
* @param object The V8Value referenced by the handle |
|
||||||
*/ |
|
||||||
public void v8HandleDisposed(V8Value object); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,30 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
import java.io.Closeable; |
|
||||||
|
|
||||||
/** |
|
||||||
* An interface used to denote all V8 Classes which can be released. |
|
||||||
*/ |
|
||||||
public interface Releasable extends Closeable { |
|
||||||
|
|
||||||
/** |
|
||||||
* Release the underlying resources. Once an object is released |
|
||||||
* it typically cannot be used again. |
|
||||||
*/ |
|
||||||
void close(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Synonym for {@link #close()}. |
|
||||||
*/ |
|
||||||
void release(); |
|
||||||
} |
|
||||||
@ -1,5 +0,0 @@ |
|||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
public interface SignatureProvider { |
|
||||||
public byte[] getSignature(String uri); |
|
||||||
} |
|
||||||
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -1,472 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
import java.nio.ByteBuffer; |
|
||||||
import java.nio.ByteOrder; |
|
||||||
|
|
||||||
/** |
|
||||||
* V8ArrayBuffers represent ArrayBuffers from V8, but are backed by a |
|
||||||
* java.nio.ByteBuffer. This means that any data stored in a TypedArray |
|
||||||
* can be accessed by the java.nio.ByteBuffer. This significantly improves |
|
||||||
* performance of data access from Java to JavaScript. |
|
||||||
* |
|
||||||
* V8ArrayBuffers can either be constructed in Java, or returned from |
|
||||||
* JavaScript. |
|
||||||
* |
|
||||||
*/ |
|
||||||
public class V8ArrayBuffer extends V8Value { |
|
||||||
|
|
||||||
ByteBuffer byteBuffer; |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a new V8ArrayBuffer on a given V8Runtime with a |
|
||||||
* given capacity. |
|
||||||
* |
|
||||||
* @param v8 The runtime on which to create the ArrayBuffer |
|
||||||
* @param capacity The capacity of the buffer |
|
||||||
*/ |
|
||||||
public V8ArrayBuffer(final V8 v8, final int capacity) { |
|
||||||
super(v8); |
|
||||||
initialize(v8.getV8RuntimePtr(), capacity); |
|
||||||
byteBuffer = v8.createV8ArrayBufferBackingStore(v8.getV8RuntimePtr(), objectHandle, capacity); |
|
||||||
byteBuffer.order(ByteOrder.nativeOrder()); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer(final V8 v8, ByteBuffer byteBuffer) { |
|
||||||
super(v8); |
|
||||||
if (byteBuffer == null) { |
|
||||||
byteBuffer = ByteBuffer.allocateDirect(0); |
|
||||||
} |
|
||||||
if (!byteBuffer.isDirect()) { |
|
||||||
throw new IllegalArgumentException("ByteBuffer must be a allocated as a direct ByteBuffer"); |
|
||||||
} |
|
||||||
initialize(v8.getV8RuntimePtr(), byteBuffer); |
|
||||||
this.byteBuffer = byteBuffer; |
|
||||||
byteBuffer.order(ByteOrder.nativeOrder()); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
protected void initialize(final long runtimePtr, final Object data) { |
|
||||||
v8.checkThread(); |
|
||||||
if (data instanceof ByteBuffer) { |
|
||||||
ByteBuffer buffer = (ByteBuffer) data; |
|
||||||
int capacity = buffer.limit(); |
|
||||||
objectHandle = v8.initNewV8ArrayBuffer(v8.getV8RuntimePtr(), buffer, capacity); |
|
||||||
} else { |
|
||||||
int capacity = (Integer) data; |
|
||||||
objectHandle = v8.initNewV8ArrayBuffer(v8.getV8RuntimePtr(), capacity); |
|
||||||
} |
|
||||||
released = false; |
|
||||||
addObjectReference(objectHandle); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
protected V8Value createTwin() { |
|
||||||
return new V8ArrayBuffer(v8, byteBuffer); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see com.eclipsesource.v8.V8Object#twin() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V8ArrayBuffer twin() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return (V8ArrayBuffer) super.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the buffers limit |
|
||||||
* |
|
||||||
* @return the buffers limit |
|
||||||
*/ |
|
||||||
public int limit() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.limit(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the buffers capacity |
|
||||||
* |
|
||||||
* @return the buffers capacity |
|
||||||
*/ |
|
||||||
public final int capacity() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.capacity(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* |
|
||||||
* @return |
|
||||||
*/ |
|
||||||
public final int position() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.position(); |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer position(final int newPosition) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.position(newPosition); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer limit(final int newLimit) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.limit(newLimit); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer mark() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.mark(); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer reset() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.reset(); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer clear() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.clear(); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer flip() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.flip(); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer rewind() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.rewind(); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final int remaining() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.remaining(); |
|
||||||
} |
|
||||||
|
|
||||||
public final boolean hasRemaining() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.hasRemaining(); |
|
||||||
} |
|
||||||
|
|
||||||
public boolean isReadOnly() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.isReadOnly(); |
|
||||||
} |
|
||||||
|
|
||||||
public byte get() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.get(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer put(final byte b) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.put(b); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public byte get(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.get(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer put(final int index, final byte b) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.put(index, b); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer get(final byte[] dst, final int offset, final int length) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.get(dst, offset, length); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer get(final byte[] dst) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.get(dst); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer put(final ByteBuffer src) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.put(src); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer put(final byte[] src, final int offset, final int length) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.put(src, offset, length); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer put(final byte[] src) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.put(src); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public final boolean hasArray() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.hasArray(); |
|
||||||
} |
|
||||||
|
|
||||||
public final byte[] array() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.array(); |
|
||||||
} |
|
||||||
|
|
||||||
public final int arrayOffset() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.arrayOffset(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer compact() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.compact(); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public boolean isDirect() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.isDirect(); |
|
||||||
} |
|
||||||
|
|
||||||
public final ByteOrder order() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.order(); |
|
||||||
} |
|
||||||
|
|
||||||
public final V8ArrayBuffer order(final ByteOrder bo) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.order(bo); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public char getChar() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getChar(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putChar(final char value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putChar(value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public char getChar(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getChar(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putChar(final int index, final char value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putChar(index, value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public short getShort() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getShort(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putShort(final short value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putShort(value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public short getShort(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getShort(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putShort(final int index, final short value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putShort(index, value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public int getInt() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getInt(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putInt(final int value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putInt(value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public int getInt(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getInt(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putInt(final int index, final int value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.asIntBuffer().put(index, value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public long getLong() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getLong(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putLong(final long value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putLong(value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public long getLong(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getLong(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putLong(final int index, final long value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putLong(index, value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public float getFloat() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getFloat(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putFloat(final float value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putFloat(value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public float getFloat(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getFloat(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putFloat(final int index, final float value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putFloat(index, value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public double getDouble() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getDouble(); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putDouble(final double value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putDouble(value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public double getDouble(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.getDouble(index); |
|
||||||
} |
|
||||||
|
|
||||||
public V8ArrayBuffer putDouble(final int index, final double value) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
byteBuffer.putDouble(index, value); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
public int floatLimit() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.asFloatBuffer().limit(); |
|
||||||
} |
|
||||||
|
|
||||||
public int intLimit() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.asIntBuffer().limit(); |
|
||||||
} |
|
||||||
|
|
||||||
public int shortLimit() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.asShortBuffer().limit(); |
|
||||||
} |
|
||||||
|
|
||||||
public int doubleLimit() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return byteBuffer.asDoubleBuffer().limit(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,98 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* A V8Value that represents a JavaScript function. |
|
||||||
* JavaScript functions cannot be created in Java, but |
|
||||||
* can be returned as the result of invoking a JS script |
|
||||||
* or JS Function. |
|
||||||
*/ |
|
||||||
public class V8Function extends V8Object { |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a JavaScript function, that when invoked will call |
|
||||||
* the javaCallback passed to the receiver. |
|
||||||
* |
|
||||||
* @param v8 The v8 runtime on which to create this function |
|
||||||
* @param javaCallback The callback to invoke |
|
||||||
*/ |
|
||||||
public V8Function(final V8 v8, final JavaCallback javaCallback) { |
|
||||||
super(v8, javaCallback); |
|
||||||
} |
|
||||||
|
|
||||||
protected V8Function(final V8 v8) { |
|
||||||
this(v8, null); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
protected V8Value createTwin() { |
|
||||||
return new V8Function(v8); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see com.eclipsesource.v8.V8Object#toString() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
if (released || v8.isReleased()) { |
|
||||||
return "[Function released]"; |
|
||||||
} |
|
||||||
return super.toString(); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
protected void initialize(final long runtimePtr, final Object data) { |
|
||||||
if (data == null) { |
|
||||||
super.initialize(runtimePtr, null); |
|
||||||
return; |
|
||||||
} |
|
||||||
JavaCallback javaCallback = (JavaCallback) data; |
|
||||||
long[] pointers = v8.initNewV8Function(runtimePtr); |
|
||||||
// position 0 is the object reference, position 1 is the function reference
|
|
||||||
v8.createAndRegisterMethodDescriptor(javaCallback, pointers[1]); |
|
||||||
released = false; |
|
||||||
addObjectReference(pointers[0]); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see com.eclipsesource.v8.V8Object#twin() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V8Function twin() { |
|
||||||
return (V8Function) super.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Invoke the JavaScript function on the current runtime. |
|
||||||
* |
|
||||||
* @param receiver The object on which to call the function on. The |
|
||||||
* receiver will be mapped to 'this' in JavaScript. If receiver is null |
|
||||||
* or undefined, then the V8 runtime will be used instead. |
|
||||||
* @param parameters The parameters passed to the JS Function. |
|
||||||
* |
|
||||||
* @return The result of JavaScript function. |
|
||||||
*/ |
|
||||||
@SuppressWarnings("resource") |
|
||||||
public Object call(V8Object receiver, final V8Array parameters) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
v8.checkRuntime(receiver); |
|
||||||
v8.checkRuntime(parameters); |
|
||||||
receiver = receiver != null ? receiver : v8; |
|
||||||
long parametersHandle = parameters == null ? 0 : parameters.getHandle(); |
|
||||||
long receiverHandle = receiver.isUndefined() ? v8.getHandle() : receiver.getHandle(); |
|
||||||
return v8.executeFunction(v8.getV8RuntimePtr(), receiverHandle, objectHandle, parametersHandle); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,113 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents a lock for a V8Runtime that can be moved between |
|
||||||
* threads. When instantiated, the lock is automatically assigned |
|
||||||
* to the current thread. If another thread wishes to acquire the |
|
||||||
* lock, it must first be released. |
|
||||||
*/ |
|
||||||
public class V8Locker { |
|
||||||
|
|
||||||
private Thread thread = null; |
|
||||||
private boolean released = false; |
|
||||||
private V8 runtime; |
|
||||||
|
|
||||||
V8Locker(final V8 runtime) { |
|
||||||
this.runtime = runtime; |
|
||||||
acquire(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the current thread associated with locker. |
|
||||||
* |
|
||||||
* @return The currently locked thread. |
|
||||||
*/ |
|
||||||
public Thread getThread() { |
|
||||||
return thread; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Acquire the lock if it's currently not acquired by another |
|
||||||
* thread. If it's currently held by another thread, an |
|
||||||
* Error will be thrown. |
|
||||||
*/ |
|
||||||
public synchronized void acquire() { |
|
||||||
if ((thread != null) && (thread != Thread.currentThread())) { |
|
||||||
throw new Error("Invalid V8 thread access: current thread is " + Thread.currentThread() + " while the locker has thread " + thread); |
|
||||||
} else if ((thread == Thread.currentThread())) { |
|
||||||
return; |
|
||||||
} |
|
||||||
runtime.acquireLock(runtime.getV8RuntimePtr()); |
|
||||||
thread = Thread.currentThread(); |
|
||||||
released = false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Acquire the lock if it's currently not acquired by another |
|
||||||
* thread. If it's currently held by another thread, tryAcquire |
|
||||||
* will return false, otherwise true is returned. |
|
||||||
* |
|
||||||
* @return Returns true if the lock was acquired, false otherwise. |
|
||||||
*/ |
|
||||||
public synchronized boolean tryAcquire() { |
|
||||||
if ((thread != null) && (thread != Thread.currentThread())) { |
|
||||||
return false; |
|
||||||
} else if (thread == Thread.currentThread()) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
runtime.acquireLock(runtime.getV8RuntimePtr()); |
|
||||||
thread = Thread.currentThread(); |
|
||||||
released = false; |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Release the lock if it's currently held by the calling thread. |
|
||||||
* If the current thread does not hold the lock, and error will be |
|
||||||
* thrown. If no thread holds the lock then nothing will happen. |
|
||||||
*/ |
|
||||||
public synchronized void release() { |
|
||||||
if ((released && (thread == null)) || runtime.isReleased()) { |
|
||||||
return; |
|
||||||
} |
|
||||||
checkThread(); |
|
||||||
runtime.releaseLock(runtime.getV8RuntimePtr()); |
|
||||||
thread = null; |
|
||||||
released = true; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if the locker has access to the current thread. |
|
||||||
* If the locker holds a different thread, than an Error |
|
||||||
* is thrown. |
|
||||||
*/ |
|
||||||
public void checkThread() { |
|
||||||
if(released && (thread == null)){ |
|
||||||
throw new Error("Invalid V8 thread access: the locker has been released!"); |
|
||||||
} |
|
||||||
if ((thread != Thread.currentThread())) { |
|
||||||
throw new Error("Invalid V8 thread access: current thread is " + Thread.currentThread() + " while the locker has thread " + thread); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Check if the current thread holds this lock. |
|
||||||
* |
|
||||||
* @return Returns true if the current thread holds the lock, |
|
||||||
* false otherwise. |
|
||||||
*/ |
|
||||||
public boolean hasLock() { |
|
||||||
return thread == Thread.currentThread(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
File diff suppressed because it is too large
Load Diff
@ -1,17 +0,0 @@ |
|||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* @author Bjorn |
|
||||||
* @version 10.0 |
|
||||||
* Created by Bjorn on 2020-11-26 |
|
||||||
*/ |
|
||||||
public class V8OutOfMemoryError extends V8RuntimeException { |
|
||||||
|
|
||||||
V8OutOfMemoryError(final String message) { |
|
||||||
super(message); |
|
||||||
} |
|
||||||
|
|
||||||
V8OutOfMemoryError() { |
|
||||||
super(); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,32 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* An exception that's used to indicate that method that should have returned a |
|
||||||
* primitive, returned an Undefined instead. |
|
||||||
* |
|
||||||
* In Java, Undefined cannot be returned for all methods, especially if |
|
||||||
* the method returns a primitive (int, double, boolean) or a String. |
|
||||||
* In this case, if an Undefined should be returned from JS, then an instance |
|
||||||
* of this exception is thrown. |
|
||||||
*/ |
|
||||||
@SuppressWarnings("serial") |
|
||||||
public class V8ResultUndefined extends V8RuntimeException { |
|
||||||
|
|
||||||
V8ResultUndefined(final String message) { |
|
||||||
super(message); |
|
||||||
} |
|
||||||
|
|
||||||
V8ResultUndefined() { |
|
||||||
super(); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,27 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* A top-level exception used to indicate that a script failed. In most cases |
|
||||||
* a more specific exception will be thrown. |
|
||||||
*/ |
|
||||||
@SuppressWarnings("serial") |
|
||||||
public class V8RuntimeException extends RuntimeException { |
|
||||||
|
|
||||||
V8RuntimeException() { |
|
||||||
} |
|
||||||
|
|
||||||
V8RuntimeException(final String message) { |
|
||||||
super(message); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,24 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* An exception used to indicate that a script failed to compile. |
|
||||||
*/ |
|
||||||
@SuppressWarnings("serial") |
|
||||||
public class V8ScriptCompilationException extends V8ScriptException { |
|
||||||
|
|
||||||
V8ScriptCompilationException(final String fileName, final int lineNumber, |
|
||||||
final String message, final String sourceLine, final int startColumn, final int endColumn) { |
|
||||||
super(fileName, lineNumber, message, sourceLine, startColumn, endColumn, null, null); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,165 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* An exception that indicates that the execution of a script failed. |
|
||||||
* Details about the exception, such as the line number, stack trace, and |
|
||||||
* message can retrieved using the accessors. |
|
||||||
*/ |
|
||||||
@SuppressWarnings("serial") |
|
||||||
public abstract class V8ScriptException extends V8RuntimeException { |
|
||||||
|
|
||||||
private final String fileName; |
|
||||||
private final int lineNumber; |
|
||||||
private final String jsMessage; |
|
||||||
private final String sourceLine; |
|
||||||
private final int startColumn; |
|
||||||
private final int endColumn; |
|
||||||
private final String jsStackTrace; |
|
||||||
|
|
||||||
V8ScriptException(final String fileName, |
|
||||||
final int lineNumber, |
|
||||||
final String jsMessage, |
|
||||||
final String sourceLine, |
|
||||||
final int startColumn, |
|
||||||
final int endColumn, |
|
||||||
final String jsStackTrace, |
|
||||||
final Throwable cause) { |
|
||||||
this.fileName = fileName; |
|
||||||
this.lineNumber = lineNumber; |
|
||||||
this.jsMessage = jsMessage; |
|
||||||
this.sourceLine = sourceLine; |
|
||||||
this.startColumn = startColumn; |
|
||||||
this.endColumn = endColumn; |
|
||||||
this.jsStackTrace = jsStackTrace; |
|
||||||
if (cause != null) { |
|
||||||
initCause(cause); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the JavaScript Stack as a String. |
|
||||||
* |
|
||||||
* @return The JavaScript stack. |
|
||||||
*/ |
|
||||||
public String getJSStackTrace() { |
|
||||||
return jsStackTrace; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the file name contains the script that was currently executing. |
|
||||||
* |
|
||||||
* @return The file name that contains the script. |
|
||||||
*/ |
|
||||||
public String getFileName() { |
|
||||||
return fileName; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the line number that the failure occurred on. |
|
||||||
* |
|
||||||
* @return The line number the failure occurred on. |
|
||||||
*/ |
|
||||||
public int getLineNumber() { |
|
||||||
return lineNumber; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the JavaScript column where the error begins. |
|
||||||
* |
|
||||||
* @return The JavaScript column where the error begins. |
|
||||||
*/ |
|
||||||
public int getStartColumn() { |
|
||||||
return startColumn; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the JavaScript column where the error ends. |
|
||||||
* |
|
||||||
* @return The JavaScript column where the error ends. |
|
||||||
*/ |
|
||||||
public int getEndColumn() { |
|
||||||
return endColumn; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the JavaScript line of source that caused the error. |
|
||||||
* |
|
||||||
* @return The JavaScript line of source that caused the error. |
|
||||||
*/ |
|
||||||
public String getSourceLine() { |
|
||||||
return sourceLine; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
StringBuilder result = new StringBuilder(); |
|
||||||
result.append(createMessageLine()); |
|
||||||
result.append(createMessageDetails()); |
|
||||||
result.append(createJSStackDetails()); |
|
||||||
result.append("\n"); |
|
||||||
result.append(this.getClass().getName()); |
|
||||||
return result.toString(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.lang.Throwable#getMessage() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public String getMessage() { |
|
||||||
return createMessageLine(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the message set by the JavaScript exception. |
|
||||||
* |
|
||||||
* @return The message set by the JavaScript exception. |
|
||||||
*/ |
|
||||||
public String getJSMessage() { |
|
||||||
return jsMessage; |
|
||||||
} |
|
||||||
|
|
||||||
private String createMessageLine() { |
|
||||||
return fileName + ":" + lineNumber + ": " + jsMessage; |
|
||||||
} |
|
||||||
|
|
||||||
private String createJSStackDetails() { |
|
||||||
if (jsStackTrace != null) { |
|
||||||
return "\n" + jsStackTrace; |
|
||||||
} |
|
||||||
return ""; |
|
||||||
} |
|
||||||
|
|
||||||
private String createMessageDetails() { |
|
||||||
StringBuilder result = new StringBuilder(); |
|
||||||
if ((sourceLine != null) && !sourceLine.isEmpty()) { |
|
||||||
result.append('\n'); |
|
||||||
result.append(sourceLine); |
|
||||||
result.append('\n'); |
|
||||||
if (startColumn >= 0) { |
|
||||||
result.append(createCharSequence(startColumn, ' ')); |
|
||||||
result.append(createCharSequence(endColumn - startColumn, '^')); |
|
||||||
} |
|
||||||
} |
|
||||||
return result.toString(); |
|
||||||
} |
|
||||||
|
|
||||||
private char[] createCharSequence(final int length, final char c) { |
|
||||||
char[] result = new char[length]; |
|
||||||
for (int i = 0; i < length; i++) { |
|
||||||
result[i] = c; |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,40 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* An exception used to indicate that a script failed to execute. |
|
||||||
*/ |
|
||||||
@SuppressWarnings("serial") |
|
||||||
public class V8ScriptExecutionException extends V8ScriptException { |
|
||||||
|
|
||||||
V8ScriptExecutionException(final String fileName, |
|
||||||
final int lineNumber, |
|
||||||
final String message, |
|
||||||
final String sourceLine, |
|
||||||
final int startColumn, |
|
||||||
final int endColumn, |
|
||||||
final String jsStackTrace) { |
|
||||||
this(fileName, lineNumber, message, sourceLine, startColumn, endColumn, jsStackTrace, null); |
|
||||||
} |
|
||||||
|
|
||||||
V8ScriptExecutionException(final String fileName, |
|
||||||
final int lineNumber, |
|
||||||
final String message, |
|
||||||
final String sourceLine, |
|
||||||
final int startColumn, |
|
||||||
final int endColumn, |
|
||||||
final String jsStackTrace, |
|
||||||
final Throwable cause) { |
|
||||||
super(fileName, lineNumber, message, sourceLine, startColumn, endColumn, jsStackTrace, cause); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,183 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* A representation of a JS TypedArray in Java. The typed array is simply a 'view' onto |
|
||||||
* a back buffer. |
|
||||||
*/ |
|
||||||
public class V8TypedArray extends V8Array { |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a new TypedArray from a specified ArrayBuffer, type, offset and size. For |
|
||||||
* example, a V8Int32Array is a typed array where each value is a 32-bit integer. The |
|
||||||
* typed array is backed by the V8ArrayBuffer. |
|
||||||
* |
|
||||||
* @param v8 The V8Runtime on which to create this Int32Array |
|
||||||
* @param type The type of Array to create. Currently Integer and Byte are supported. |
|
||||||
* @param buffer The buffer used to back the typed array |
|
||||||
* @param offset The offset into the buffer at which to start the the array |
|
||||||
* @param size The size of the typed array |
|
||||||
*/ |
|
||||||
public V8TypedArray(final V8 v8, final V8ArrayBuffer buffer, final int type, final int offset, final int size) { |
|
||||||
super(v8, new V8ArrayData(buffer, offset, size, type)); |
|
||||||
} |
|
||||||
|
|
||||||
private V8TypedArray(final V8 v8) { |
|
||||||
super(v8); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
protected V8Value createTwin() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return new V8TypedArray(v8); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public Object get(final int index) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
int type = getType(); |
|
||||||
switch (type) { |
|
||||||
case FLOAT_32_ARRAY: |
|
||||||
return ((Number) super.get(index)).floatValue(); |
|
||||||
case FLOAT_64_ARRAY: |
|
||||||
return super.get(index); |
|
||||||
case INT_32_ARRAY: |
|
||||||
return super.get(index); |
|
||||||
case INT_16_ARRAY: |
|
||||||
return ((Number) super.get(index)).shortValue(); |
|
||||||
case INT_8_ARRAY: |
|
||||||
return ((Number) super.get(index)).byteValue(); |
|
||||||
case UNSIGNED_INT_16_ARRAY: |
|
||||||
return 0xFFFF & (Integer) super.get(index); |
|
||||||
case UNSIGNED_INT_32_ARRAY: |
|
||||||
return 0x00000000FFFFFFFF & ((Number) super.get(index)).longValue(); |
|
||||||
case UNSIGNED_INT_8_CLAMPED_ARRAY: |
|
||||||
return (short) (0x00FF & ((Number) super.get(index)).byteValue()); |
|
||||||
case UNSIGNED_INT_8_ARRAY: |
|
||||||
return (short) (0x00FF & ((Number) super.get(index)).shortValue()); |
|
||||||
} |
|
||||||
return null; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Provide access to the underlying ByteBuffer used for this TypedArray. |
|
||||||
* The V8ArrayBuffer must be released. |
|
||||||
* |
|
||||||
* @return The V8ArrayBuffer used to back this TypedArray. |
|
||||||
*/ |
|
||||||
public V8ArrayBuffer getBuffer() { |
|
||||||
return (V8ArrayBuffer) get("buffer"); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
protected void initialize(final long runtimePtr, final Object data) { |
|
||||||
v8.checkThread(); |
|
||||||
if (data == null) { |
|
||||||
super.initialize(runtimePtr, data); |
|
||||||
return; |
|
||||||
} |
|
||||||
V8ArrayData arrayData = (V8ArrayData) data; |
|
||||||
checkArrayProperties(arrayData); |
|
||||||
long handle = createTypedArray(runtimePtr, arrayData); |
|
||||||
released = false; |
|
||||||
addObjectReference(handle); |
|
||||||
} |
|
||||||
|
|
||||||
private long createTypedArray(final long runtimePtr, final V8ArrayData arrayData) { |
|
||||||
switch (arrayData.type) { |
|
||||||
case V8Value.FLOAT_32_ARRAY: |
|
||||||
return v8.initNewV8Float32Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.FLOAT_64_ARRAY: |
|
||||||
return v8.initNewV8Float64Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.UNSIGNED_INT_32_ARRAY: |
|
||||||
return v8.initNewV8UInt32Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.INT_16_ARRAY: |
|
||||||
return v8.initNewV8Int16Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.UNSIGNED_INT_16_ARRAY: |
|
||||||
return v8.initNewV8UInt16Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.INTEGER: |
|
||||||
return v8.initNewV8Int32Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.UNSIGNED_INT_8_ARRAY: |
|
||||||
return v8.initNewV8UInt8Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.INT_8_ARRAY: |
|
||||||
return v8.initNewV8Int8Array(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
case V8Value.UNSIGNED_INT_8_CLAMPED_ARRAY: |
|
||||||
return v8.initNewV8UInt8ClampedArray(runtimePtr, arrayData.buffer.objectHandle, arrayData.offset, arrayData.size); |
|
||||||
default: |
|
||||||
throw new IllegalArgumentException("Cannot create a typed array of type " + V8Value.getStringRepresentation(arrayData.type)); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Computes the size of the structures required for each TypedArray variation. |
|
||||||
* |
|
||||||
* @param type The type of the TypeArray |
|
||||||
* @return The size of the structures required |
|
||||||
*/ |
|
||||||
public static int getStructureSize(final int type) { |
|
||||||
switch (type) { |
|
||||||
case V8Value.FLOAT_64_ARRAY: |
|
||||||
return 8; |
|
||||||
case V8Value.INT_32_ARRAY: |
|
||||||
case V8Value.UNSIGNED_INT_32_ARRAY: |
|
||||||
case V8Value.FLOAT_32_ARRAY: |
|
||||||
return 4; |
|
||||||
case V8Value.UNSIGNED_INT_16_ARRAY: |
|
||||||
case V8Value.INT_16_ARRAY: |
|
||||||
return 2; |
|
||||||
case V8Value.INT_8_ARRAY: |
|
||||||
case V8Value.UNSIGNED_INT_8_ARRAY: |
|
||||||
case V8Value.UNSIGNED_INT_8_CLAMPED_ARRAY: |
|
||||||
return 1; |
|
||||||
default: |
|
||||||
throw new IllegalArgumentException("Cannot create a typed array of type " + V8Value.getStringRepresentation(type)); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void checkArrayProperties(final V8ArrayData arrayData) { |
|
||||||
checkOffset(arrayData); |
|
||||||
checkSize(arrayData); |
|
||||||
} |
|
||||||
|
|
||||||
private void checkSize(final V8ArrayData arrayData) { |
|
||||||
if (arrayData.size < 0) { |
|
||||||
throw new IllegalStateException("RangeError: Invalid typed array length"); |
|
||||||
} |
|
||||||
int limit = (arrayData.size * getStructureSize(arrayData.type)) + arrayData.offset; |
|
||||||
if (limit > arrayData.buffer.limit()) { |
|
||||||
throw new IllegalStateException("RangeError: Invalid typed array length"); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void checkOffset(final V8ArrayData arrayData) { |
|
||||||
if ((arrayData.offset % getStructureSize(arrayData.type)) != 0) { |
|
||||||
throw new IllegalStateException("RangeError: Start offset of Int32Array must be a multiple of " + getStructureSize(arrayData.type)); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static class V8ArrayData { |
|
||||||
private V8ArrayBuffer buffer; |
|
||||||
private int offset; |
|
||||||
private int size; |
|
||||||
private int type; |
|
||||||
|
|
||||||
public V8ArrayData(final V8ArrayBuffer buffer, final int offset, final int size, final int type) { |
|
||||||
this.buffer = buffer; |
|
||||||
this.offset = offset; |
|
||||||
this.size = size; |
|
||||||
this.type = type; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,391 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8; |
|
||||||
|
|
||||||
/** |
|
||||||
* A base class for all V8 resources. V8 resources must |
|
||||||
* be closed/released. The rules for releasing resources is as |
|
||||||
* follows: |
|
||||||
* |
|
||||||
* 1. If you created it, you must close it, with one exception; |
|
||||||
* if the object is being passed pack via a return statement, |
|
||||||
* the system will release it for you. |
|
||||||
* |
|
||||||
* 2. If the system created it, you don’t need to worry about it, |
|
||||||
* with one caveat; if the object was returned to you as a |
|
||||||
* result of a method call, you must close it. |
|
||||||
*/ |
|
||||||
abstract public class V8Value implements Releasable { |
|
||||||
|
|
||||||
public static final int NULL = 0; |
|
||||||
public static final int UNKNOWN = 0; |
|
||||||
public static final int INTEGER = 1; |
|
||||||
public static final int INT_32_ARRAY = 1; |
|
||||||
public static final int DOUBLE = 2; |
|
||||||
public static final int FLOAT_64_ARRAY = 2; |
|
||||||
public static final int BOOLEAN = 3; |
|
||||||
public static final int STRING = 4; |
|
||||||
public static final int V8_ARRAY = 5; |
|
||||||
public static final int V8_OBJECT = 6; |
|
||||||
public static final int V8_FUNCTION = 7; |
|
||||||
public static final int V8_TYPED_ARRAY = 8; |
|
||||||
public static final int BYTE = 9; |
|
||||||
public static final int INT_8_ARRAY = 9; |
|
||||||
public static final int V8_ARRAY_BUFFER = 10; |
|
||||||
public static final int UNSIGNED_INT_8_ARRAY = 11; |
|
||||||
public static final int UNSIGNED_INT_8_CLAMPED_ARRAY = 12; |
|
||||||
public static final int INT_16_ARRAY = 13; |
|
||||||
public static final int UNSIGNED_INT_16_ARRAY = 14; |
|
||||||
public static final int UNSIGNED_INT_32_ARRAY = 15; |
|
||||||
public static final int FLOAT_32_ARRAY = 16; |
|
||||||
public static final int UNDEFINED = 99; |
|
||||||
|
|
||||||
protected V8 v8; |
|
||||||
protected long objectHandle; |
|
||||||
protected boolean released = true; |
|
||||||
|
|
||||||
protected V8Value() { |
|
||||||
super(); |
|
||||||
} |
|
||||||
|
|
||||||
protected V8Value(final V8 v8) { |
|
||||||
if (v8 == null) { |
|
||||||
this.v8 = (V8) this; |
|
||||||
} else { |
|
||||||
this.v8 = v8; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
protected void initialize(final long runtimePtr, final Object data) { |
|
||||||
long objectHandle = v8.initNewV8Object(runtimePtr); |
|
||||||
released = false; |
|
||||||
addObjectReference(objectHandle); |
|
||||||
} |
|
||||||
|
|
||||||
protected void addObjectReference(final long objectHandle) throws Error { |
|
||||||
this.objectHandle = objectHandle; |
|
||||||
try { |
|
||||||
v8.addObjRef(this); |
|
||||||
} catch (Error e) { |
|
||||||
release(); |
|
||||||
throw e; |
|
||||||
} catch (RuntimeException e) { |
|
||||||
release(); |
|
||||||
throw e; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
|
|
||||||
/** |
|
||||||
* Returns a string representation of the V8 Type. |
|
||||||
* @param type Type to return as a string. See constants in V8Value. |
|
||||||
* @return The V8Value type as a string. |
|
||||||
* @deprecated Use |
|
||||||
*/ |
|
||||||
@Deprecated |
|
||||||
public static String getStringRepresentaion(final int type) { |
|
||||||
return getStringRepresentation(type); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns a string representation of the V8 Type. |
|
||||||
* @param type Type to return as a string. See constants in V8Value. |
|
||||||
* @return The V8Value type as a string. |
|
||||||
*/ |
|
||||||
public static String getStringRepresentation(final int type) { |
|
||||||
switch (type) { |
|
||||||
case NULL: |
|
||||||
return "Null"; |
|
||||||
case INTEGER: |
|
||||||
return "Integer"; |
|
||||||
case DOUBLE: |
|
||||||
return "Double"; |
|
||||||
case BOOLEAN: |
|
||||||
return "Boolean"; |
|
||||||
case STRING: |
|
||||||
return "String"; |
|
||||||
case V8_ARRAY: |
|
||||||
return "V8Array"; |
|
||||||
case V8_OBJECT: |
|
||||||
return "V8Object"; |
|
||||||
case V8_FUNCTION: |
|
||||||
return "V8Function"; |
|
||||||
case V8_TYPED_ARRAY: |
|
||||||
return "V8TypedArray"; |
|
||||||
case BYTE: |
|
||||||
return "Byte"; |
|
||||||
case V8_ARRAY_BUFFER: |
|
||||||
return "V8ArrayBuffer"; |
|
||||||
case UNSIGNED_INT_8_ARRAY: |
|
||||||
return "UInt8Array"; |
|
||||||
case UNSIGNED_INT_8_CLAMPED_ARRAY: |
|
||||||
return "UInt8ClampedArray"; |
|
||||||
case INT_16_ARRAY: |
|
||||||
return "Int16Array"; |
|
||||||
case UNSIGNED_INT_16_ARRAY: |
|
||||||
return "UInt16Array"; |
|
||||||
case UNSIGNED_INT_32_ARRAY: |
|
||||||
return "UInt32Array"; |
|
||||||
case FLOAT_32_ARRAY: |
|
||||||
return "Float32Array"; |
|
||||||
case UNDEFINED: |
|
||||||
return "Undefined"; |
|
||||||
default: |
|
||||||
throw new IllegalArgumentException("Invalid V8 type: " + type); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns a constructor name of the V8 Value. |
|
||||||
* |
|
||||||
* @return The V8Value constructor name as a string. |
|
||||||
*/ |
|
||||||
public String getConstructorName() { |
|
||||||
v8.checkThread(); |
|
||||||
v8.checkReleased(); |
|
||||||
return v8.getConstructorName(v8.getV8RuntimePtr(), objectHandle); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Determines if this value is undefined. |
|
||||||
* |
|
||||||
* @return Returns true if the value is undefined, false otherwise |
|
||||||
*/ |
|
||||||
public boolean isUndefined() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the runtime this Value was created on. |
|
||||||
* |
|
||||||
* @return Returns the V8 runtime this value is associated with. |
|
||||||
*/ |
|
||||||
public V8 getRuntime() { |
|
||||||
return v8; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the 'type' of this V8Value. The available types are defined |
|
||||||
* as constants in {@link V8Value}. Only types that inherit from |
|
||||||
* {@link V8Value} can be returned here. |
|
||||||
* |
|
||||||
* @return The 'type of this V8Value. |
|
||||||
*/ |
|
||||||
public int getV8Type() { |
|
||||||
if (isUndefined()) { |
|
||||||
return UNDEFINED; |
|
||||||
} |
|
||||||
v8.checkThread(); |
|
||||||
v8.checkReleased(); |
|
||||||
return v8.getType(v8.getV8RuntimePtr(), objectHandle); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a new Java object pointing at the same V8 Value |
|
||||||
* as this. If the value is mutated (by adding new members or |
|
||||||
* changing existing ones) then both the original and twin |
|
||||||
* will be updated. Twins are .equal and .strict equals, but |
|
||||||
* not == in Java. |
|
||||||
* |
|
||||||
* Twins must be closed separately since they have their own |
|
||||||
* native resources. |
|
||||||
* |
|
||||||
* @return A new Java object pointing at the same V8 Value |
|
||||||
* as this. |
|
||||||
*/ |
|
||||||
public V8Value twin() { |
|
||||||
if (isUndefined()) { |
|
||||||
return this; |
|
||||||
} |
|
||||||
v8.checkThread(); |
|
||||||
v8.checkReleased(); |
|
||||||
V8Value twin = createTwin(); |
|
||||||
v8.createTwin(this, twin); |
|
||||||
return twin; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the V8Value as weak reference. A weak reference will eventually |
|
||||||
* be closed when no more references exist to this object. Once setWeak |
|
||||||
* is called, you should check if {@link V8Value#isReleased()} is true |
|
||||||
* before invoking any methods on this object. |
|
||||||
* |
|
||||||
* If any other references exist to this object, the object will not be |
|
||||||
* reclaimed. Even if no reference exist, V8 does not give any guarantee |
|
||||||
* the object will be closed, so this should only be used if there is no |
|
||||||
* other way to track object usage. |
|
||||||
* |
|
||||||
* @return The receiver. |
|
||||||
*/ |
|
||||||
public V8Value setWeak() { |
|
||||||
v8.checkThread(); |
|
||||||
v8.checkReleased(); |
|
||||||
v8.v8WeakReferences.put(getHandle(), this); |
|
||||||
v8.setWeak(v8.getV8RuntimePtr(), getHandle()); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Clears any weak reference set on this V8Value and makes this a strong |
|
||||||
* reference. Strong references will not be garbage collected and this |
|
||||||
* Object must be explicitly released. |
|
||||||
* |
|
||||||
* Calling clearWeak does nothing if the object is not currently set |
|
||||||
* to weak. |
|
||||||
* |
|
||||||
* @return The receiver. |
|
||||||
*/ |
|
||||||
public V8Value clearWeak() { |
|
||||||
v8.checkThread(); |
|
||||||
v8.checkReleased(); |
|
||||||
v8.v8WeakReferences.remove(getHandle()); |
|
||||||
v8.clearWeak(v8.getV8RuntimePtr(), getHandle()); |
|
||||||
return this; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* If {@link V8Value#setWeak()} has been called on this Object, this method |
|
||||||
* will return true. Otherwise it will return false. |
|
||||||
* |
|
||||||
* @return Returns true if this object has been set 'Weak', return false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isWeak() { |
|
||||||
v8.checkThread(); |
|
||||||
v8.checkReleased(); |
|
||||||
return v8.isWeak(v8.getV8RuntimePtr(), getHandle()); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.io.Closeable#close() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
v8.checkThread(); |
|
||||||
if (!released) { |
|
||||||
try { |
|
||||||
v8.releaseObjRef(this); |
|
||||||
} finally { |
|
||||||
released = true; |
|
||||||
v8.release(v8.getV8RuntimePtr(), objectHandle); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Releases the native resources associated with this V8Value. |
|
||||||
* |
|
||||||
* @deprecated use close() instead. |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Determine if the native resources have been released. Once released |
|
||||||
* a V8 Value can no longer be used. |
|
||||||
* |
|
||||||
* @return Returns true if this object has been released, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isReleased() { |
|
||||||
return released; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Performs a JS === on the parameter and the receiver. |
|
||||||
* |
|
||||||
* @param that The Object to compare this object against. |
|
||||||
* @return Returns true iff this === that |
|
||||||
*/ |
|
||||||
public boolean strictEquals(final Object that) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
if (that == this) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
if (that == null) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
if (!(that instanceof V8Value)) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
if (isUndefined() && ((V8Value) that).isUndefined()) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
if (((V8Value) that).isUndefined()) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
return v8.strictEquals(v8.getV8RuntimePtr(), getHandle(), ((V8Value) that).getHandle()); |
|
||||||
} |
|
||||||
|
|
||||||
protected long getHandle() { |
|
||||||
checkReleased(); |
|
||||||
return objectHandle; |
|
||||||
} |
|
||||||
|
|
||||||
protected abstract V8Value createTwin(); |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.lang.Object#equals(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean equals(final Object that) { |
|
||||||
return strictEquals(that); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Performs a JS == on the parameter and the receiver. |
|
||||||
* |
|
||||||
* @param that The Object to compare this object against. |
|
||||||
* @return Returns true iff this == that |
|
||||||
*/ |
|
||||||
public boolean jsEquals(final Object that) { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
if (that == this) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
if (that == null) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
if (!(that instanceof V8Value)) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
if (isUndefined() && ((V8Value) that).isUndefined()) { |
|
||||||
return true; |
|
||||||
} |
|
||||||
if (((V8Value) that).isUndefined()) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
return v8.equals(v8.getV8RuntimePtr(), getHandle(), ((V8Value) that).getHandle()); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.lang.Object#hashCode() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public int hashCode() { |
|
||||||
v8.checkThread(); |
|
||||||
checkReleased(); |
|
||||||
return v8.identityHash(v8.getV8RuntimePtr(), getHandle()); |
|
||||||
} |
|
||||||
|
|
||||||
protected void checkReleased() { |
|
||||||
if (released) { |
|
||||||
throw new IllegalStateException("Object released"); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,55 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Holds information about break events. |
|
||||||
*/ |
|
||||||
public class BreakEvent extends EventData { |
|
||||||
|
|
||||||
private static final String SOURCE_LINE_TEXT = "sourceLineText"; |
|
||||||
private static final String SOURCE_COLUMN = "sourceColumn"; |
|
||||||
private static final String SOURCE_LINE = "sourceLine"; |
|
||||||
|
|
||||||
BreakEvent(final V8Object eventData) { |
|
||||||
super(eventData); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the source line that this break event occurred on. |
|
||||||
* |
|
||||||
* @return The line number that this break event occurred on. |
|
||||||
*/ |
|
||||||
public int getSourceLine() { |
|
||||||
return v8Object.executeIntegerFunction(SOURCE_LINE, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the source column that this break event occurred on. |
|
||||||
* |
|
||||||
* @return The column number that this break event occurred on. |
|
||||||
*/ |
|
||||||
public int getSourceColumn() { |
|
||||||
return v8Object.executeIntegerFunction(SOURCE_COLUMN, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the text of the line that this event occurred on. |
|
||||||
* |
|
||||||
* @return The text of the line that this event occurred on. |
|
||||||
*/ |
|
||||||
public String getSourceLineText() { |
|
||||||
return v8Object.executeStringFunction(SOURCE_LINE_TEXT, null); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,20 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
import com.eclipsesource.v8.debug.DebugHandler.DebugEvent; |
|
||||||
|
|
||||||
public interface BreakHandler { |
|
||||||
|
|
||||||
public void onBreak(DebugEvent type, ExecutionState state, EventData eventData, V8Object data); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,24 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Holds information about Compile Events. |
|
||||||
*/ |
|
||||||
public class CompileEvent extends EventData { |
|
||||||
|
|
||||||
CompileEvent(final V8Object eventData) { |
|
||||||
super(eventData); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,363 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.List; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.JavaVoidCallback; |
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Function; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* The entry point for the Debug API. The debug API is a Java API |
|
||||||
* that exposes V8's JavaScript API. |
|
||||||
* |
|
||||||
* The API requires that V8 be initialized with the runtime flag |
|
||||||
* '--expose-debug-as=__j2v8_debug_handler'. |
|
||||||
*/ |
|
||||||
public class DebugHandler implements Releasable { |
|
||||||
|
|
||||||
public static enum DebugEvent { |
|
||||||
Undefined(0), Break(1), Exception(2), NewFunction(3), BeforeCompile(4), AfterCompile(5), CompileError(6), PromiseError(7), AsyncTaskEvent(8); |
|
||||||
int index; |
|
||||||
|
|
||||||
DebugEvent(final int index) { |
|
||||||
this.index = index; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
public static String DEBUG_OBJECT_NAME = "__j2v8_Debug"; |
|
||||||
|
|
||||||
private static final String DEBUG_BREAK_HANDLER = "__j2v8_debug_handler"; |
|
||||||
private static final String SET_SCRIPT_BREAK_POINT_BY_NAME = "setScriptBreakPointByName"; |
|
||||||
private static final String SET_BREAK_POINT = "setBreakPoint"; |
|
||||||
private static final String SET_LISTENER = "setListener"; |
|
||||||
private static final String V8_DEBUG_OBJECT = "Debug"; |
|
||||||
private static final String DISABLE_SCRIPT_BREAK_POINT = "disableScriptBreakPoint"; |
|
||||||
private static final String ENABLE_SCRIPT_BREAK_POINT = "enableScriptBreakPoint"; |
|
||||||
private static final String CLEAR_BREAK_POINT = "clearBreakPoint"; |
|
||||||
private static final String DISABLE_ALL_BREAK_POINTS = "disableAllBreakPoints"; |
|
||||||
private static final String SCRIPT_BREAK_POINTS = "scriptBreakPoints"; |
|
||||||
private static final String FIND_SCRIPT_BREAK_POINT = "findScriptBreakPoint"; |
|
||||||
private static final String NUMBER = "number"; |
|
||||||
private static final String CHANGE_BREAK_POINT_CONDITION = "changeBreakPointCondition"; |
|
||||||
|
|
||||||
private V8 runtime; |
|
||||||
private V8Object debugObject; |
|
||||||
private List<BreakHandler> breakHandlers = new ArrayList<BreakHandler>(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates the Debug Handler for a particular V8 runtime. |
|
||||||
* Before the runtime was created, V8.setFlags("expose-debug-as=__j2v8_debug_handler"); |
|
||||||
* must be called. |
|
||||||
* |
|
||||||
* @param runtime The runtime on which to create the Debug Handler. |
|
||||||
*/ |
|
||||||
public DebugHandler(final V8 runtime) { |
|
||||||
this.runtime = runtime; |
|
||||||
setupDebugObject(runtime); |
|
||||||
setupBreakpointHandler(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Adds a handler to be notified when a breakpoint is hit. |
|
||||||
* |
|
||||||
* @param handler The handler to notify. |
|
||||||
*/ |
|
||||||
public void addBreakHandler(final BreakHandler handler) { |
|
||||||
runtime.getLocker().checkThread(); |
|
||||||
breakHandlers.add(handler); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Removes a handler from the list of breakpoint handlers. |
|
||||||
* If the handler is not present in the list, the list is unchanged. |
|
||||||
* |
|
||||||
* @param handler The handler to remove. |
|
||||||
*/ |
|
||||||
public void removeBreakHandler(final BreakHandler handler) { |
|
||||||
runtime.getLocker().checkThread(); |
|
||||||
breakHandlers.remove(handler); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Registers a function breakpoint. When the JavaScript function |
|
||||||
* is invoked, the breakpoint will be 'hit'. |
|
||||||
* |
|
||||||
* @param function The function on which to register the breakpoint. |
|
||||||
* @return The berakpointID. |
|
||||||
*/ |
|
||||||
public int setBreakpoint(final V8Function function) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(function); |
|
||||||
try { |
|
||||||
return debugObject.executeIntegerFunction(SET_BREAK_POINT, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Registers a breakpoint given a scriptID and line number. The breakpoint |
|
||||||
* will be 'hit' when the script is executed and the given line is reached. |
|
||||||
* |
|
||||||
* @param scriptID The ID of the script on which to set the breakpoint. |
|
||||||
* @param lineNumber The line number on which to set the breakpoint. |
|
||||||
* @return The berakpointID. |
|
||||||
*/ |
|
||||||
public int setScriptBreakpoint(final String scriptID, final int lineNumber) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(scriptID); |
|
||||||
parameters.push(lineNumber); |
|
||||||
try { |
|
||||||
return debugObject.executeIntegerFunction(SET_SCRIPT_BREAK_POINT_BY_NAME, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Enables a breakpoint. |
|
||||||
* |
|
||||||
* @param breakpointID The breakpoint to enable. |
|
||||||
*/ |
|
||||||
public void enableScriptBreakPoint(final int breakpointID) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(breakpointID); |
|
||||||
try { |
|
||||||
debugObject.executeVoidFunction(ENABLE_SCRIPT_BREAK_POINT, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Disables a breakpoint. |
|
||||||
* |
|
||||||
* @param breakpointID The breakpoint to disable |
|
||||||
*/ |
|
||||||
public void disableScriptBreakPoint(final int breakpointID) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(breakpointID); |
|
||||||
try { |
|
||||||
debugObject.executeVoidFunction(DISABLE_SCRIPT_BREAK_POINT, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Removes a Breakpoint. |
|
||||||
* |
|
||||||
* @param breakpointID The ID of the breakpoint to remove. |
|
||||||
*/ |
|
||||||
public void clearBreakPoint(final int breakpointID) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(breakpointID); |
|
||||||
try { |
|
||||||
debugObject.executeVoidFunction(CLEAR_BREAK_POINT, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Disables all breakpoints. |
|
||||||
*/ |
|
||||||
public void disableAllBreakPoints() { |
|
||||||
debugObject.executeVoidFunction(DISABLE_ALL_BREAK_POINTS, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns a count of all the breakpoints |
|
||||||
* |
|
||||||
* @return A V8Array of Breakpoints. |
|
||||||
*/ |
|
||||||
public int getScriptBreakPointCount() { |
|
||||||
V8Array breakPoints = debugObject.executeArrayFunction(SCRIPT_BREAK_POINTS, null); |
|
||||||
try { |
|
||||||
return breakPoints.length(); |
|
||||||
} finally { |
|
||||||
breakPoints.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get all the BreakPoint IDs as an array. |
|
||||||
* |
|
||||||
* @return A list of BreakPoint IDs. |
|
||||||
*/ |
|
||||||
public int[] getScriptBreakPointIDs() { |
|
||||||
V8Array breakPoints = debugObject.executeArrayFunction(SCRIPT_BREAK_POINTS, null); |
|
||||||
try { |
|
||||||
int[] result = new int[breakPoints.length()]; |
|
||||||
for (int i = 0; i < breakPoints.length(); i++) { |
|
||||||
V8Object breakPoint = breakPoints.getObject(i); |
|
||||||
try { |
|
||||||
result[i] = breakPoint.executeIntegerFunction(NUMBER, null); |
|
||||||
} finally { |
|
||||||
breakPoint.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
return result; |
|
||||||
} finally { |
|
||||||
breakPoints.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Get the BreakPoint as referenced by the given ID. |
|
||||||
* |
|
||||||
* @param breakPointID The BreakPoint ID. |
|
||||||
* @return The BreakPoint as referenced by the given ID. |
|
||||||
*/ |
|
||||||
public ScriptBreakPoint getScriptBreakPoint(final int breakPointID) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(breakPointID); |
|
||||||
parameters.push(false); |
|
||||||
V8Object scriptBreakPoint = null; |
|
||||||
try { |
|
||||||
scriptBreakPoint = debugObject.executeObjectFunction(FIND_SCRIPT_BREAK_POINT, parameters); |
|
||||||
return new ScriptBreakPoint(scriptBreakPoint); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if (scriptBreakPoint != null) { |
|
||||||
scriptBreakPoint.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Changes the current condition on the breakpoint as specified by the breakpoint ID |
|
||||||
* |
|
||||||
* @param breakpointID The ID of the breakpoint of which to change the condition on |
|
||||||
* @param condition The new condition to set |
|
||||||
*/ |
|
||||||
public void changeBreakPointCondition(final int breakpointID, final String condition) { |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
parameters.push(breakpointID); |
|
||||||
parameters.push(condition); |
|
||||||
try { |
|
||||||
debugObject.executeVoidFunction(CHANGE_BREAK_POINT_CONDITION, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.io.Closeable#close() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
debugObject.close(); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
private void setupDebugObject(final V8 runtime) { |
|
||||||
V8Object outerDebug = runtime.getObject(DEBUG_OBJECT_NAME); |
|
||||||
try { |
|
||||||
debugObject = outerDebug.getObject(V8_DEBUG_OBJECT); |
|
||||||
} finally { |
|
||||||
outerDebug.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void setupBreakpointHandler() { |
|
||||||
BreakpointHandler handler = new BreakpointHandler(); |
|
||||||
debugObject.registerJavaMethod(handler, DEBUG_BREAK_HANDLER); |
|
||||||
V8Function debugHandler = null; |
|
||||||
V8Array parameters = null; |
|
||||||
try { |
|
||||||
debugHandler = (V8Function) debugObject.getObject(DEBUG_BREAK_HANDLER); |
|
||||||
parameters = new V8Array(runtime); |
|
||||||
parameters.push(debugHandler); |
|
||||||
debugObject.executeFunction(SET_LISTENER, parameters); |
|
||||||
} finally { |
|
||||||
if ((debugHandler != null) && !debugHandler.isReleased()) { |
|
||||||
debugHandler.close(); |
|
||||||
} |
|
||||||
if ((parameters != null) && !parameters.isReleased()) { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private class BreakpointHandler implements JavaVoidCallback { |
|
||||||
|
|
||||||
@Override |
|
||||||
public void invoke(final V8Object receiver, final V8Array parameters) { |
|
||||||
if ((parameters == null) || parameters.isUndefined()) { |
|
||||||
return; |
|
||||||
} |
|
||||||
int event = parameters.getInteger(0); |
|
||||||
for (BreakHandler handler : breakHandlers) { |
|
||||||
invokeHandler(parameters, event, handler); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void invokeHandler(final V8Array parameters, final int event, final BreakHandler handler) { |
|
||||||
V8Object execState = null; |
|
||||||
V8Object eventData = null; |
|
||||||
V8Object data = null; |
|
||||||
ExecutionState state = null; |
|
||||||
EventData typedEventData = null; |
|
||||||
try { |
|
||||||
execState = parameters.getObject(1); |
|
||||||
eventData = parameters.getObject(2); |
|
||||||
data = parameters.getObject(3); |
|
||||||
state = new ExecutionState(execState); |
|
||||||
DebugEvent type = DebugEvent.values()[event]; |
|
||||||
typedEventData = createDebugEvent(type, eventData); |
|
||||||
handler.onBreak(type, state, typedEventData, data); |
|
||||||
} finally { |
|
||||||
safeRelease(execState); |
|
||||||
safeRelease(eventData); |
|
||||||
safeRelease(data); |
|
||||||
safeRelease(state); |
|
||||||
safeRelease(typedEventData); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private EventData createDebugEvent(final DebugEvent type, final V8Object eventData) { |
|
||||||
switch (type) { |
|
||||||
case Break: |
|
||||||
return new BreakEvent(eventData); |
|
||||||
case BeforeCompile: |
|
||||||
return new CompileEvent(eventData); |
|
||||||
case AfterCompile: |
|
||||||
return new CompileEvent(eventData); |
|
||||||
case Exception: |
|
||||||
return new ExceptionEvent(eventData); |
|
||||||
default: |
|
||||||
break; |
|
||||||
} |
|
||||||
return new EventData(eventData); |
|
||||||
} |
|
||||||
|
|
||||||
private void safeRelease(final Releasable object) { |
|
||||||
if ((object != null)) { |
|
||||||
object.release(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,40 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Typed information about different debug events. |
|
||||||
*/ |
|
||||||
public class EventData implements Releasable { |
|
||||||
|
|
||||||
protected V8Object v8Object; |
|
||||||
|
|
||||||
EventData(final V8Object eventData) { |
|
||||||
v8Object = eventData.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
if (!v8Object.isReleased()) { |
|
||||||
v8Object.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,24 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Holds information about Exception Events. |
|
||||||
*/ |
|
||||||
public class ExceptionEvent extends EventData { |
|
||||||
|
|
||||||
ExceptionEvent(final V8Object eventData) { |
|
||||||
super(eventData); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,100 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
import com.eclipsesource.v8.debug.mirror.Frame; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents the current execution state at a break. |
|
||||||
* The execution state provides methods for inspecting |
|
||||||
* the stack, variables and scopes. |
|
||||||
* |
|
||||||
* The ExecutionState should not be persisted as it |
|
||||||
* will be released when the debugger continues. |
|
||||||
* |
|
||||||
*/ |
|
||||||
public class ExecutionState implements Releasable { |
|
||||||
|
|
||||||
private static final String FRAME = "frame"; |
|
||||||
private static final String PREPARE_STEP = "prepareStep"; |
|
||||||
private static final String FRAME_COUNT = "frameCount"; |
|
||||||
|
|
||||||
private V8Object v8Object; |
|
||||||
|
|
||||||
ExecutionState(final V8Object v8Object) { |
|
||||||
this.v8Object = v8Object.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the current stack frame count. |
|
||||||
* |
|
||||||
* @return The stack frame count. |
|
||||||
*/ |
|
||||||
public int getFrameCount() { |
|
||||||
return v8Object.executeIntegerFunction(FRAME_COUNT, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Indicates to the debugger how to proceed. If not called, |
|
||||||
* the debugger will continue running until the next breakpoint |
|
||||||
* is hit. |
|
||||||
* |
|
||||||
* @param action The step action to use. |
|
||||||
*/ |
|
||||||
public void prepareStep(final StepAction action) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(action.index); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(PREPARE_STEP, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the Frame at a given index |
|
||||||
* |
|
||||||
* @param index The stack index |
|
||||||
* @return The stack frame at a given index |
|
||||||
*/ |
|
||||||
public Frame getFrame(final int index) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(index); |
|
||||||
V8Object frame = null; |
|
||||||
try { |
|
||||||
frame = v8Object.executeObjectFunction(FRAME, parameters); |
|
||||||
return new Frame(frame); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if (frame != null) { |
|
||||||
frame.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
if ((v8Object != null) && !v8Object.isReleased()) { |
|
||||||
v8Object.close(); |
|
||||||
v8Object = null; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,94 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
import com.eclipsesource.v8.V8ResultUndefined; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents a BreakPoint. |
|
||||||
*/ |
|
||||||
public class ScriptBreakPoint implements Releasable { |
|
||||||
|
|
||||||
private static final String CONDITION = "condition"; |
|
||||||
private static final String LINE = "line"; |
|
||||||
private static final String NUMBER = "number"; |
|
||||||
private static final String SET_CONDITION = "setCondition"; |
|
||||||
|
|
||||||
private V8Object v8Object; |
|
||||||
|
|
||||||
ScriptBreakPoint(final V8Object v8Object) { |
|
||||||
this.v8Object = v8Object.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the ID of this breakpoint. |
|
||||||
* |
|
||||||
* @return The ID (breakpoint number) of this breakpoint. |
|
||||||
*/ |
|
||||||
public int getBreakPointNumber() { |
|
||||||
return v8Object.executeIntegerFunction(NUMBER, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the line number of this breakpoint. |
|
||||||
* |
|
||||||
* @return The line number of this breakpoint. |
|
||||||
*/ |
|
||||||
public int getLine() { |
|
||||||
return v8Object.executeIntegerFunction(LINE, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets a condition to be evaluated before determining if |
|
||||||
* the breakpoint event should be fired. |
|
||||||
* |
|
||||||
* @param condition A JavaScript condition to be evaluated. |
|
||||||
*/ |
|
||||||
public void setCondition(final String condition) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(condition); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(SET_CONDITION, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the condition set on this breakpoint or the String |
|
||||||
* 'undefined' if a condition was not set. |
|
||||||
* |
|
||||||
* @return The condition set on this breakpoint. |
|
||||||
*/ |
|
||||||
public String getCondition() { |
|
||||||
try { |
|
||||||
return v8Object.executeStringFunction(CONDITION, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return "undefined"; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
if ((v8Object != null) && !v8Object.isReleased()) { |
|
||||||
v8Object.close(); |
|
||||||
v8Object = null; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,25 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
/** |
|
||||||
* An enumeration of possible Step Actions. A step action indicates to the |
|
||||||
* debugger how to proceed with the next step. |
|
||||||
*/ |
|
||||||
public enum StepAction { |
|
||||||
STEP_OUT(0), STEP_NEXT(1), STEP_IN(2), STEP_FRAME(3); |
|
||||||
int index; |
|
||||||
|
|
||||||
StepAction(final int index) { |
|
||||||
this.index = index; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,693 +0,0 @@ |
|||||||
/** |
|
||||||
* Copyright 2016, Genuitec, LLC |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* Genuitec LLC - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug; |
|
||||||
|
|
||||||
import java.io.IOException; |
|
||||||
import java.io.InputStream; |
|
||||||
import java.net.ServerSocket; |
|
||||||
import java.net.Socket; |
|
||||||
import java.nio.charset.Charset; |
|
||||||
import java.util.LinkedList; |
|
||||||
import java.util.List; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.JavaVoidCallback; |
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Function; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* <p>V8DebugServer enables debuggers to connect to J2V8 via V8 server sockets debug protocol. |
|
||||||
* Server has to be created in the same thread as the provided V8 runtime has been created (the V8 thread). |
|
||||||
* You can specify port and whether the {@link #start()} method should |
|
||||||
* block until a client connects. {@link #setTraceCommunication(boolean)} allows to output |
|
||||||
* communication details for debugging purposes. Before creating V8 runtime you need to set V8 flag to expose |
|
||||||
* debug object. If you do not intend to set other flags, than you can use {@link #configureV8ForDebugging()} |
|
||||||
* method, otherwise set {@code -expose-debug-as=__j2v8_Debug} flag through {@link V8#setFlags(String)}. |
|
||||||
* |
|
||||||
* <p>Client connection is handled in a separate thread, however, commands are processed in the V8 thread. |
|
||||||
* Therefore it is vital to provide an opportunity to process requests by calling |
|
||||||
* {@link #processRequests(long)} method from the V8 thread. This will for instance |
|
||||||
* allow to install breakpoints before the JavaScript code starts to execute. It is also good to call that |
|
||||||
* method when V8 thread is idle to promptly provide responses to the debugger to avoid timeouts. |
|
||||||
* |
|
||||||
* <p>Example code: |
|
||||||
* |
|
||||||
* <code><br> |
|
||||||
* //configure for debugging before creating runtime<br>
|
|
||||||
* V8DebugServer.configureV8ForDebugging();<br> |
|
||||||
* <br> |
|
||||||
* //create V8 runtime<br>
|
|
||||||
* V8 runtime = V8.createV8Runtime();<br> |
|
||||||
* <br> |
|
||||||
* //create and start debug server<br>
|
|
||||||
* int port = 0;<br> |
|
||||||
* boolean waitForConnection = true;<br> |
|
||||||
* server = new V8DebugServer(runtime, port, waitForConnection);<br> |
|
||||||
* System.out.println("V8 Debug Server listening on port "<br> |
|
||||||
* + server.getPort());<br> |
|
||||||
* server.start();<br> |
|
||||||
* <br> |
|
||||||
* //execute script and provide name for it<br>
|
|
||||||
* runtime.executeVoidScript("var i = 15", "myscript.js", 0);<br> |
|
||||||
* |
|
||||||
* </code> |
|
||||||
* |
|
||||||
* @author piotr@genuitec.com |
|
||||||
*/ |
|
||||||
@SuppressWarnings("nls") |
|
||||||
public class V8DebugServer { |
|
||||||
|
|
||||||
/** |
|
||||||
* Name under which internal V8 debug object is going to be exposed in the runtime. |
|
||||||
* You can change the name if you are passing a different one through {@code -expose-debug-as} |
|
||||||
* flag. |
|
||||||
*/ |
|
||||||
public static String DEBUG_OBJECT_NAME = "__j2v8_Debug"; |
|
||||||
|
|
||||||
private static final String DEBUG_BREAK_HANDLER = "__j2v8_debug_handler"; |
|
||||||
private static final String MAKE_BREAK_EVENT = "__j2v8_MakeBreakEvent"; |
|
||||||
private static final String MAKE_COMPILE_EVENT = "__j2v8_MakeCompileEvent"; |
|
||||||
private static final String SET_LISTENER = "setListener"; |
|
||||||
private static final String V8_DEBUG_OBJECT = "Debug"; |
|
||||||
|
|
||||||
//Headers
|
|
||||||
private static final String HEADER_TYPE = "Type: "; |
|
||||||
private static final String HEADER_V8_VERSION = "V8-Version: "; |
|
||||||
private static final String HEADER_PROTOCOL_VERSION = "Protocol-Version: "; |
|
||||||
private static final String HEADER_EMBEDDING_HOST = "Embedding-Host: "; |
|
||||||
|
|
||||||
private static final String V8_VERSION = "4.10.253"; |
|
||||||
private static final String J2V8_VERSION = "4.0.0"; |
|
||||||
private static final String PROTOCOL_VERSION = "1"; |
|
||||||
|
|
||||||
//Protocol consts
|
|
||||||
private static final Charset PROTOCOL_CHARSET = Charset.forName("UTF-8"); |
|
||||||
private static final String PROTOCOL_EOL = "\r\n"; |
|
||||||
private static final byte[] PROTOCOL_EOL_BYTES = PROTOCOL_EOL.getBytes(PROTOCOL_CHARSET); |
|
||||||
private static final String PROTOCOL_CONTENT_LENGTH_HEADER = "Content-Length:"; |
|
||||||
private static final byte[] PROTOCOL_CONTENT_LENGTH_BYTES = PROTOCOL_CONTENT_LENGTH_HEADER.getBytes(PROTOCOL_CHARSET); |
|
||||||
private static final int PROTOCOL_BUFFER_SIZE = 4096; |
|
||||||
|
|
||||||
/** |
|
||||||
* Utility method for simplification of configuring V8 for debugging support. |
|
||||||
*/ |
|
||||||
public static void configureV8ForDebugging() { |
|
||||||
try { |
|
||||||
V8.setFlags("-expose-debug-as=" + DEBUG_OBJECT_NAME); |
|
||||||
} catch (Throwable t) { |
|
||||||
t.printStackTrace(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private ServerSocket server; |
|
||||||
private Socket client; |
|
||||||
private Object clientLock = new Object(); |
|
||||||
|
|
||||||
private V8 runtime; |
|
||||||
private V8Object debugObject; |
|
||||||
private V8Object runningStateDcp; |
|
||||||
private V8Object stoppedStateDcp; |
|
||||||
private boolean waitForConnection; |
|
||||||
private boolean traceCommunication = false; |
|
||||||
|
|
||||||
private List<String> requests = new LinkedList<String>(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates V8DebugServer. |
|
||||||
* |
|
||||||
* @param runtime |
|
||||||
* @param port |
|
||||||
* @param waitForConnection |
|
||||||
*/ |
|
||||||
public V8DebugServer(final V8 runtime, final int port, final boolean waitForConnection) { |
|
||||||
this.runtime = runtime; |
|
||||||
this.waitForConnection = waitForConnection; |
|
||||||
|
|
||||||
V8Object debugScope = runtime.getObject(DEBUG_OBJECT_NAME); |
|
||||||
if (debugScope == null) { |
|
||||||
System.err.println("Cannot initialize debugger server - global debug object not found."); |
|
||||||
return; |
|
||||||
} |
|
||||||
try { |
|
||||||
debugObject = debugScope.getObject(V8_DEBUG_OBJECT); |
|
||||||
} finally { |
|
||||||
debugScope.close(); |
|
||||||
} |
|
||||||
|
|
||||||
runtime.executeVoidScript("(function() {\n" |
|
||||||
+ " " + DEBUG_OBJECT_NAME + ".Debug. " + MAKE_BREAK_EVENT + " = function (break_id,breakpoints_hit) {\n" |
|
||||||
+ " return new " + DEBUG_OBJECT_NAME + ".BreakEvent(break_id,breakpoints_hit);\n" |
|
||||||
+ " }\n" |
|
||||||
+ " " + DEBUG_OBJECT_NAME + ".Debug. " + MAKE_COMPILE_EVENT + " = function(script,type) {\n" |
|
||||||
+ " var scripts = " + DEBUG_OBJECT_NAME + ".Debug.scripts()\n" |
|
||||||
+ " for (var i in scripts) {\n" |
|
||||||
+ " if (scripts[i].id == script.id()) {\n" |
|
||||||
+ " return new " + DEBUG_OBJECT_NAME + ".CompileEvent(scripts[i], type);\n" |
|
||||||
+ " }\n" |
|
||||||
+ " }\n" |
|
||||||
+ " return {toJSONProtocol: function() {return ''}}\n" |
|
||||||
+ " }\n" |
|
||||||
+ "})()"); |
|
||||||
try { |
|
||||||
server = new ServerSocket(port); |
|
||||||
} catch (Exception e) { |
|
||||||
logError(e); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns port on which server is listening or -1 if server failed to bound to a port. |
|
||||||
* @return port or -1 if server failed to bound to a port |
|
||||||
*/ |
|
||||||
public int getPort() { |
|
||||||
return (server != null) && server.isBound() ? server.getLocalPort() : -1; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Output all communication to the console. For purpose of debugging V8DebugServer itself. |
|
||||||
* @param value |
|
||||||
*/ |
|
||||||
public void setTraceCommunication(final boolean value) { |
|
||||||
traceCommunication = value; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Starts accepting client connections and blocks until a client connects |
|
||||||
* if {@code waitForConnection} has been passed to V8DebugServer constructor. |
|
||||||
*/ |
|
||||||
public void start() { |
|
||||||
if (server == null) { |
|
||||||
return; |
|
||||||
} |
|
||||||
boolean waitForConnection = this.waitForConnection; |
|
||||||
Thread clientThread = new Thread(new ClientLoop(), "J2V8 Debugger Server"); |
|
||||||
clientThread.setDaemon(true); |
|
||||||
clientThread.start(); |
|
||||||
|
|
||||||
setupEventHandler(); |
|
||||||
|
|
||||||
runningStateDcp = runtime.executeObjectScript("(function() {return new " + DEBUG_OBJECT_NAME + ".DebugCommandProcessor(null, true)})()"); |
|
||||||
|
|
||||||
if (waitForConnection) { |
|
||||||
synchronized (clientLock) { |
|
||||||
while (this.waitForConnection) { |
|
||||||
try { |
|
||||||
clientLock.wait(); |
|
||||||
} catch (InterruptedException e) { |
|
||||||
//ignore
|
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
//Process initial requests
|
|
||||||
//Give 100ms for initial debugger connection setup
|
|
||||||
try { |
|
||||||
processRequests(100); |
|
||||||
} catch (InterruptedException e) { |
|
||||||
//ignore
|
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
public void stop() { |
|
||||||
try { |
|
||||||
server.close(); |
|
||||||
|
|
||||||
synchronized (clientLock) { |
|
||||||
if (client != null) { |
|
||||||
client.close(); |
|
||||||
client = null; |
|
||||||
} |
|
||||||
} |
|
||||||
} catch (IOException e) { |
|
||||||
logError(e); |
|
||||||
} |
|
||||||
|
|
||||||
//release resources
|
|
||||||
if (runningStateDcp != null) { |
|
||||||
runningStateDcp.close(); |
|
||||||
runningStateDcp = null; |
|
||||||
} |
|
||||||
if (debugObject != null) { |
|
||||||
debugObject.close(); |
|
||||||
debugObject = null; |
|
||||||
} |
|
||||||
if (stoppedStateDcp != null) { |
|
||||||
stoppedStateDcp.close(); |
|
||||||
stoppedStateDcp = null; |
|
||||||
} |
|
||||||
}; |
|
||||||
|
|
||||||
private void sendJson(String json) throws IOException { |
|
||||||
json = json.replace("\\/", "/"); // Unescape slashes.
|
|
||||||
sendMessage("", json); |
|
||||||
} |
|
||||||
|
|
||||||
protected void logError(final Throwable t) { |
|
||||||
t.printStackTrace(); |
|
||||||
} |
|
||||||
|
|
||||||
private void sendMessage(final String header, final String contents) throws IOException { |
|
||||||
synchronized (clientLock) { |
|
||||||
if (!isConnected()) { |
|
||||||
throw new IOException("There is no connected client."); |
|
||||||
} |
|
||||||
|
|
||||||
byte[] contentBytes = contents.getBytes(PROTOCOL_CHARSET); |
|
||||||
|
|
||||||
StringBuilder sb = new StringBuilder(); |
|
||||||
|
|
||||||
//append custom headers
|
|
||||||
sb.append(header); |
|
||||||
|
|
||||||
//append content length header
|
|
||||||
sb.append(PROTOCOL_CONTENT_LENGTH_HEADER); |
|
||||||
sb.append(Integer.toString(contentBytes.length)); |
|
||||||
sb.append(PROTOCOL_EOL); |
|
||||||
|
|
||||||
//skip tools info
|
|
||||||
sb.append(PROTOCOL_EOL); |
|
||||||
|
|
||||||
//send headers to the client
|
|
||||||
client.getOutputStream().write(sb.toString().getBytes( |
|
||||||
PROTOCOL_CHARSET)); |
|
||||||
|
|
||||||
//send contents to the client
|
|
||||||
if (contentBytes.length > 0) { |
|
||||||
client.getOutputStream().write(contentBytes); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private boolean isConnected() { |
|
||||||
synchronized (clientLock) { |
|
||||||
return (server != null) && (client != null) && client.isConnected(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
public void processRequests(final long timeout) throws InterruptedException { |
|
||||||
if (server == null) { |
|
||||||
return; |
|
||||||
} |
|
||||||
long start = System.currentTimeMillis(); |
|
||||||
do { |
|
||||||
String[] reqs; |
|
||||||
do { |
|
||||||
synchronized (requests) { |
|
||||||
reqs = requests.toArray(new String[requests.size()]); |
|
||||||
requests.clear(); |
|
||||||
} |
|
||||||
for (String req : reqs) { |
|
||||||
try { |
|
||||||
processRequest(req); |
|
||||||
} catch (Exception e) { |
|
||||||
logError(e); |
|
||||||
} |
|
||||||
} |
|
||||||
} while (reqs.length > 0); |
|
||||||
if (timeout > 0) { |
|
||||||
Thread.sleep(10); |
|
||||||
} |
|
||||||
} while ((timeout > 0) && ((start + timeout) > System.currentTimeMillis())); |
|
||||||
} |
|
||||||
|
|
||||||
private void processRequest(final String message) throws IOException { |
|
||||||
if (traceCommunication) { |
|
||||||
System.out.println("Got message: \n" + message.substring(0, Math.min(message.length(), 1000))); |
|
||||||
} |
|
||||||
V8Array params = new V8Array(runtime); |
|
||||||
params.push(message); |
|
||||||
|
|
||||||
@SuppressWarnings("resource") |
|
||||||
V8Object dcp = stoppedStateDcp != null ? stoppedStateDcp : runningStateDcp; |
|
||||||
Object result = dcp.executeFunction("processDebugJSONRequest", params); |
|
||||||
|
|
||||||
String json = result.toString(); |
|
||||||
|
|
||||||
if ((stoppedStateDcp == null) && json.contains("\"running\":false")) { |
|
||||||
//XXX Need to implement functionality by adding to V8 class
|
|
||||||
// breakpoints before initial script or function execution
|
|
||||||
json = json.replace("\"running\":false", "\"running\":true") |
|
||||||
.replace("\"success\":true", "\"success\":false") |
|
||||||
.replace("{\"", "{\"message\":\"Client requested suspension is not supported on J2V8.\",\""); |
|
||||||
dcp.add("running_", true); |
|
||||||
} |
|
||||||
|
|
||||||
if (traceCommunication) { |
|
||||||
System.out.println("Returning response: \n" + json.substring(0, Math.min(json.length(), 1000))); |
|
||||||
} |
|
||||||
sendJson(json); |
|
||||||
} |
|
||||||
|
|
||||||
private void setupEventHandler() { |
|
||||||
EventHandler handler = new EventHandler(); |
|
||||||
debugObject.registerJavaMethod(handler, DEBUG_BREAK_HANDLER); |
|
||||||
V8Function debugHandler = null; |
|
||||||
V8Array parameters = null; |
|
||||||
try { |
|
||||||
debugHandler = (V8Function) debugObject.getObject(DEBUG_BREAK_HANDLER); |
|
||||||
parameters = new V8Array(runtime); |
|
||||||
parameters.push(debugHandler); |
|
||||||
debugObject.executeFunction(SET_LISTENER, parameters); |
|
||||||
} finally { |
|
||||||
if ((debugHandler != null) && !debugHandler.isReleased()) { |
|
||||||
debugHandler.close(); |
|
||||||
} |
|
||||||
if ((parameters != null) && !parameters.isReleased()) { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void enterBreakLoop(final V8Object execState, final V8Object eventData) throws IOException { |
|
||||||
try { |
|
||||||
V8Array params = new V8Array(runtime); |
|
||||||
try { |
|
||||||
params.push(false); |
|
||||||
stoppedStateDcp = execState.executeObjectFunction("debugCommandProcessor", params); |
|
||||||
} finally { |
|
||||||
params.close(); |
|
||||||
} |
|
||||||
|
|
||||||
//send event to debugger
|
|
||||||
int breakId = execState.getInteger("break_id"); |
|
||||||
V8Array breakpointsHit = eventData.getArray("break_points_hit_"); |
|
||||||
V8Object event = null; |
|
||||||
|
|
||||||
params = new V8Array(runtime); |
|
||||||
try { |
|
||||||
params.push(breakId); |
|
||||||
params.push(breakpointsHit); |
|
||||||
event = debugObject.executeObjectFunction(MAKE_BREAK_EVENT, params); |
|
||||||
String json = event.executeStringFunction("toJSONProtocol", null); |
|
||||||
if (traceCommunication) { |
|
||||||
System.out.println("Sending event (Break):\n" + json); |
|
||||||
} |
|
||||||
sendJson(json); |
|
||||||
} finally { |
|
||||||
params.close(); |
|
||||||
breakpointsHit.close(); |
|
||||||
if (event != null) { |
|
||||||
event.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
//process requests until one of the resumes execution
|
|
||||||
while (isConnected() && !stoppedStateDcp.executeBooleanFunction("isRunning", null)) { |
|
||||||
try { |
|
||||||
processRequests(10); |
|
||||||
} catch (InterruptedException e) { |
|
||||||
//ignore
|
|
||||||
} |
|
||||||
} |
|
||||||
} finally { |
|
||||||
stoppedStateDcp.close(); |
|
||||||
stoppedStateDcp = null; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void sendCompileEvent(final V8Object eventData) throws IOException { |
|
||||||
if (!isConnected()) { |
|
||||||
return; |
|
||||||
} |
|
||||||
//send event to debugger
|
|
||||||
int type = eventData.getInteger("type_"); |
|
||||||
V8Object script = eventData.getObject("script_"); |
|
||||||
V8Object event = null; |
|
||||||
|
|
||||||
V8Array params = new V8Array(runtime); |
|
||||||
try { |
|
||||||
params.push(script); |
|
||||||
params.push(type); |
|
||||||
event = debugObject.executeObjectFunction(MAKE_COMPILE_EVENT, params); |
|
||||||
String json = event.executeStringFunction("toJSONProtocol", null); |
|
||||||
if (traceCommunication) { |
|
||||||
System.out.println("Sending event (CompileEvent):\n" + json.substring(0, Math.min(json.length(), 1000))); |
|
||||||
} |
|
||||||
if (json.length() > 0) { |
|
||||||
sendJson(json); |
|
||||||
} |
|
||||||
} finally { |
|
||||||
params.close(); |
|
||||||
script.close(); |
|
||||||
if (event != null) { |
|
||||||
event.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private class EventHandler implements JavaVoidCallback { |
|
||||||
|
|
||||||
@Override |
|
||||||
public void invoke(final V8Object receiver, final V8Array parameters) { |
|
||||||
if ((parameters == null) || parameters.isUndefined()) { |
|
||||||
return; |
|
||||||
} |
|
||||||
V8Object execState = null; |
|
||||||
V8Object eventData = null; |
|
||||||
try { |
|
||||||
int event = parameters.getInteger(0); |
|
||||||
execState = parameters.getObject(1); |
|
||||||
eventData = parameters.getObject(2); |
|
||||||
|
|
||||||
if (traceCommunication) { |
|
||||||
String type = "unknown"; |
|
||||||
switch (event) { |
|
||||||
case 1: |
|
||||||
type = "Break"; |
|
||||||
break; |
|
||||||
case 2: |
|
||||||
type = "Exception"; |
|
||||||
break; |
|
||||||
case 3: |
|
||||||
type = "NewFunction"; |
|
||||||
break; |
|
||||||
case 4: |
|
||||||
type = "BeforeCompile"; |
|
||||||
break; |
|
||||||
case 5: |
|
||||||
type = "AfterCompile"; |
|
||||||
break; |
|
||||||
case 6: |
|
||||||
type = "CompileError"; |
|
||||||
break; |
|
||||||
case 7: |
|
||||||
type = "PromiseEvent"; |
|
||||||
break; |
|
||||||
case 8: |
|
||||||
type = "AsyncTaskEvent"; |
|
||||||
break; |
|
||||||
} |
|
||||||
System.out.println("V8 has emmitted an event of type " + type); |
|
||||||
} |
|
||||||
|
|
||||||
if (!isConnected()) { |
|
||||||
return; |
|
||||||
} |
|
||||||
|
|
||||||
switch (event) { |
|
||||||
case 1: //Break
|
|
||||||
enterBreakLoop(execState, eventData); |
|
||||||
break; |
|
||||||
case 5: //afterCompile
|
|
||||||
case 6: //compileError
|
|
||||||
sendCompileEvent(eventData); |
|
||||||
break; |
|
||||||
case 2: //exception
|
|
||||||
default: |
|
||||||
} |
|
||||||
} catch (Exception e) { |
|
||||||
logError(e); |
|
||||||
} finally { |
|
||||||
safeRelease(execState); |
|
||||||
safeRelease(eventData); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void safeRelease(final Releasable object) { |
|
||||||
if ((object != null)) { |
|
||||||
object.release(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
private class ClientLoop implements Runnable { |
|
||||||
|
|
||||||
private int from; |
|
||||||
|
|
||||||
@Override |
|
||||||
public void run() { |
|
||||||
while (true) { |
|
||||||
try { |
|
||||||
Socket socket = server.accept(); |
|
||||||
socket.setTcpNoDelay(true); |
|
||||||
synchronized (clientLock) { |
|
||||||
client = socket; |
|
||||||
waitForConnection = false; |
|
||||||
clientLock.notifyAll(); |
|
||||||
} |
|
||||||
startHandshake(); |
|
||||||
processClientRequests(); |
|
||||||
} catch (Exception e) { |
|
||||||
synchronized (clientLock) { |
|
||||||
if (client != null) { |
|
||||||
try { |
|
||||||
client.close(); |
|
||||||
} catch (IOException ex) { |
|
||||||
//ignore
|
|
||||||
} |
|
||||||
client = null; |
|
||||||
} |
|
||||||
} |
|
||||||
logError(e); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private void startHandshake() throws IOException { |
|
||||||
StringBuilder sb = new StringBuilder(); |
|
||||||
|
|
||||||
sb.append(HEADER_V8_VERSION); |
|
||||||
sb.append(V8_VERSION); |
|
||||||
sb.append(PROTOCOL_EOL); |
|
||||||
|
|
||||||
sb.append(HEADER_PROTOCOL_VERSION); |
|
||||||
sb.append(PROTOCOL_VERSION); |
|
||||||
sb.append(PROTOCOL_EOL); |
|
||||||
|
|
||||||
sb.append(HEADER_EMBEDDING_HOST); |
|
||||||
sb.append("j2v8 "); |
|
||||||
sb.append(J2V8_VERSION); |
|
||||||
sb.append(PROTOCOL_EOL); |
|
||||||
|
|
||||||
sb.append(HEADER_TYPE); |
|
||||||
sb.append("connect"); |
|
||||||
sb.append(PROTOCOL_EOL); |
|
||||||
|
|
||||||
sendMessage(sb.toString(), ""); |
|
||||||
} |
|
||||||
|
|
||||||
private void processClientRequests() throws IOException { |
|
||||||
final byte[] EMPTY_ARR = new byte[] {}; |
|
||||||
|
|
||||||
byte[] buf = new byte[PROTOCOL_BUFFER_SIZE]; |
|
||||||
int bytesRead; |
|
||||||
int offset = 0; |
|
||||||
|
|
||||||
//Message data
|
|
||||||
boolean toolInfoSkipped = false; |
|
||||||
byte[] messageBytes = EMPTY_ARR; |
|
||||||
int contentLength = -1; |
|
||||||
|
|
||||||
InputStream cIn; |
|
||||||
synchronized (clientLock) { |
|
||||||
cIn = client.getInputStream(); |
|
||||||
} |
|
||||||
|
|
||||||
while ((bytesRead = cIn.read(buf, offset, PROTOCOL_BUFFER_SIZE - offset)) > 0) { |
|
||||||
bytesRead += offset; |
|
||||||
from = 0; |
|
||||||
do { |
|
||||||
if (contentLength < 0) { |
|
||||||
contentLength = readContentLength(buf, bytesRead); |
|
||||||
if (contentLength < 0) { |
|
||||||
break; |
|
||||||
} |
|
||||||
} |
|
||||||
if (!toolInfoSkipped) { |
|
||||||
toolInfoSkipped = skipToolInfo(buf, bytesRead); |
|
||||||
if (!toolInfoSkipped) { |
|
||||||
break; |
|
||||||
} |
|
||||||
} |
|
||||||
int length = Math.min(contentLength - messageBytes.length, bytesRead - from); |
|
||||||
messageBytes = join(messageBytes, buf, from, length); |
|
||||||
from += length; |
|
||||||
if (messageBytes.length == contentLength) { |
|
||||||
String message = new String(messageBytes, PROTOCOL_CHARSET); |
|
||||||
synchronized (requests) { |
|
||||||
requests.add(message); |
|
||||||
} |
|
||||||
contentLength = -1; |
|
||||||
toolInfoSkipped = false; |
|
||||||
messageBytes = EMPTY_ARR; |
|
||||||
} |
|
||||||
} while (from < bytesRead); |
|
||||||
if (from < bytesRead) { |
|
||||||
System.arraycopy(buf, from, buf, 0, bytesRead - from); |
|
||||||
offset = bytesRead - from; |
|
||||||
} else { |
|
||||||
offset = 0; |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private int readContentLength(final byte[] bytes, final int to) throws IOException { |
|
||||||
int pos = indexOf(PROTOCOL_CONTENT_LENGTH_BYTES, bytes, from, to); |
|
||||||
if (pos < 0) { |
|
||||||
return -1; |
|
||||||
} |
|
||||||
pos += PROTOCOL_CONTENT_LENGTH_BYTES.length; |
|
||||||
int end = indexOf(PROTOCOL_EOL_BYTES, bytes, pos, to); |
|
||||||
if (end < 0) { |
|
||||||
return -1; |
|
||||||
} |
|
||||||
String str = new String(bytes, pos, end - pos, PROTOCOL_CHARSET); |
|
||||||
int contentLength; |
|
||||||
try { |
|
||||||
contentLength = Integer.parseInt(str.trim()); |
|
||||||
} catch (Exception ex) { |
|
||||||
throw new IOException("Invalid content length header: '" + str + "' in message" + |
|
||||||
new String(bytes, PROTOCOL_CHARSET)); |
|
||||||
} |
|
||||||
from = end + PROTOCOL_EOL_BYTES.length; |
|
||||||
return contentLength; |
|
||||||
} |
|
||||||
|
|
||||||
private boolean skipToolInfo(final byte[] bytes, final int n) { |
|
||||||
int end = indexOf(PROTOCOL_EOL_BYTES, bytes, from, n); |
|
||||||
if (end < 0) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
from = end + PROTOCOL_EOL_BYTES.length; |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
private int indexOf(final byte[] pattern, final byte[] array, final int start, final int end) { |
|
||||||
int len = pattern.length; |
|
||||||
for (int i = start; i < end; i++) { |
|
||||||
for (int j = 0; j <= len; j++) { |
|
||||||
if (j == len) { |
|
||||||
//pattern matches at i
|
|
||||||
return i; |
|
||||||
} |
|
||||||
if (((i + j) >= end) || (array[i + j] != pattern[j])) { |
|
||||||
//pattern does not match at i
|
|
||||||
break; |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
return -1; |
|
||||||
} |
|
||||||
|
|
||||||
private byte[] join(final byte[] arr1, final byte[] arr2, final int startPos, final int length) { |
|
||||||
byte[] res = new byte[arr1.length + length]; |
|
||||||
System.arraycopy(arr1, 0, res, 0, arr1.length); |
|
||||||
System.arraycopy(arr2, startPos, res, arr1.length, length); |
|
||||||
return res; |
|
||||||
} |
|
||||||
|
|
||||||
}; |
|
||||||
} |
|
||||||
@ -1,40 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents 'Array' mirrors. |
|
||||||
*/ |
|
||||||
public class ArrayMirror extends ObjectMirror { |
|
||||||
|
|
||||||
private static final String LENGTH = "length"; |
|
||||||
|
|
||||||
ArrayMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isArray() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the length of the array pointed to by this Array Mirror |
|
||||||
* |
|
||||||
* @return The length of the array. |
|
||||||
*/ |
|
||||||
public int length() { |
|
||||||
return v8Object.executeIntegerFunction(LENGTH, null); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,33 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents JavaScript 'Boolean' Mirrors |
|
||||||
*/ |
|
||||||
public class BooleanMirror extends ValueMirror { |
|
||||||
|
|
||||||
BooleanMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isBoolean() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return v8Object.executeStringFunction("toText", null); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,225 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents a single stack frame accessible from the |
|
||||||
* current execution state. |
|
||||||
*/ |
|
||||||
public class Frame extends Mirror { |
|
||||||
|
|
||||||
private static final String SOURCE_TEXT = "sourceText"; |
|
||||||
private static final String FUNC = "func"; |
|
||||||
private static final String COLUMN = "column"; |
|
||||||
private static final String LINE = "line"; |
|
||||||
private static final String POSITION = "position"; |
|
||||||
private static final String NAME = "name"; |
|
||||||
private static final String SCRIPT = "script"; |
|
||||||
private static final String SCOPE = "scope"; |
|
||||||
private static final String ARGUMENT_VALUE = "argumentValue"; |
|
||||||
private static final String ARGUMENT_NAME = "argumentName"; |
|
||||||
private static final String LOCAL_COUNT = "localCount"; |
|
||||||
private static final String ARGUMENT_COUNT = "argumentCount"; |
|
||||||
private static final String SCOPE_COUNT = "scopeCount"; |
|
||||||
private static final String LOCAL_NAME = "localName"; |
|
||||||
private static final String LOCAL_VALUE = "localValue"; |
|
||||||
private static final String SOURCE_LOCATION = "sourceLocation"; |
|
||||||
|
|
||||||
public Frame(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the number of accessible scopes from this stack frame. |
|
||||||
* |
|
||||||
* @return The number of accessible scopes |
|
||||||
*/ |
|
||||||
public int getScopeCount() { |
|
||||||
return v8Object.executeIntegerFunction(SCOPE_COUNT, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the SourceLocation of this Frame. |
|
||||||
* |
|
||||||
* @return The SourceLocation of this Frame. |
|
||||||
*/ |
|
||||||
public SourceLocation getSourceLocation() { |
|
||||||
V8Object sourceLocation = v8Object.executeObjectFunction(SOURCE_LOCATION, null); |
|
||||||
FunctionMirror function = getFunction(); |
|
||||||
String functionScriptName = function.getScriptName(); |
|
||||||
try { |
|
||||||
String scriptName = null; |
|
||||||
V8Object scriptObject = (V8Object) sourceLocation.get(SCRIPT); |
|
||||||
if (scriptObject != null) { |
|
||||||
scriptName = scriptObject.getString(NAME); |
|
||||||
scriptObject.close(); |
|
||||||
} |
|
||||||
if ((scriptName == null) && (functionScriptName != null)) { |
|
||||||
scriptName = functionScriptName; |
|
||||||
} else { |
|
||||||
scriptName = "undefined"; |
|
||||||
} |
|
||||||
return new SourceLocation(scriptName, |
|
||||||
sourceLocation.getInteger(POSITION), |
|
||||||
sourceLocation.getInteger(LINE), |
|
||||||
sourceLocation.getInteger(COLUMN), |
|
||||||
sourceLocation.getString(SOURCE_TEXT)); |
|
||||||
} finally { |
|
||||||
function.close(); |
|
||||||
sourceLocation.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the number of arguments to this frame. |
|
||||||
* |
|
||||||
* @return The number of arguments passed to this frame. |
|
||||||
*/ |
|
||||||
public int getArgumentCount() { |
|
||||||
return v8Object.executeIntegerFunction(ARGUMENT_COUNT, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name of the argument at the given index. |
|
||||||
* |
|
||||||
* @param index The index of the argument name to return. |
|
||||||
* @return The name of argument at the given index. |
|
||||||
*/ |
|
||||||
public String getArgumentName(final int index) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(index); |
|
||||||
try { |
|
||||||
return v8Object.executeStringFunction(ARGUMENT_NAME, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the value of the argument at the given index. |
|
||||||
* |
|
||||||
* @param index The index of the argument value to return. |
|
||||||
* @return The value of argument at the given index. |
|
||||||
*/ |
|
||||||
public ValueMirror getArgumentValue(final int index) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(index); |
|
||||||
V8Object result = null; |
|
||||||
try { |
|
||||||
result = v8Object.executeObjectFunction(ARGUMENT_VALUE, parameters); |
|
||||||
if (!isValue(result)) { |
|
||||||
throw new IllegalStateException("Argument value is not a ValueMirror"); |
|
||||||
} |
|
||||||
return new ValueMirror(result); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if (result != null) { |
|
||||||
result.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the value of the local variable at the given index. |
|
||||||
* |
|
||||||
* @param index The index of the local to return. |
|
||||||
* @return The value of local at the given index. |
|
||||||
*/ |
|
||||||
public ValueMirror getLocalValue(final int index) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(index); |
|
||||||
V8Object result = null; |
|
||||||
try { |
|
||||||
result = v8Object.executeObjectFunction(LOCAL_VALUE, parameters); |
|
||||||
if (!isValue(result)) { |
|
||||||
throw new IllegalStateException("Local value is not a ValueMirror"); |
|
||||||
} |
|
||||||
return createMirror(result); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if (result != null) { |
|
||||||
result.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the number of local variables in this frame. |
|
||||||
* |
|
||||||
* @return The number of local variables accessible from this stack frame. |
|
||||||
*/ |
|
||||||
public int getLocalCount() { |
|
||||||
return v8Object.executeIntegerFunction(LOCAL_COUNT, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name of the local variable at the given index. |
|
||||||
* |
|
||||||
* @param index The index of the local variable name to return. |
|
||||||
* @return The name of local variable at the given index. |
|
||||||
*/ |
|
||||||
public String getLocalName(final int index) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(index); |
|
||||||
try { |
|
||||||
return v8Object.executeStringFunction(LOCAL_NAME, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the scope at a given index. |
|
||||||
* |
|
||||||
* @param index The index |
|
||||||
* @return The scope |
|
||||||
*/ |
|
||||||
public Scope getScope(final int index) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(index); |
|
||||||
V8Object scope = null; |
|
||||||
try { |
|
||||||
scope = v8Object.executeObjectFunction(SCOPE, parameters); |
|
||||||
return new Scope(scope); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if (scope != null) { |
|
||||||
scope.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the Function associated with this particular debug frame. |
|
||||||
* |
|
||||||
* @return The Function for this debug frame. |
|
||||||
*/ |
|
||||||
public FunctionMirror getFunction() { |
|
||||||
V8Object function = null; |
|
||||||
try { |
|
||||||
function = v8Object.executeObjectFunction(FUNC, null); |
|
||||||
return new FunctionMirror(function); |
|
||||||
} finally { |
|
||||||
if (function != null) { |
|
||||||
function.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isFrame() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,56 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents JavaScript 'Function' Mirrors |
|
||||||
*/ |
|
||||||
public class FunctionMirror extends ObjectMirror { |
|
||||||
|
|
||||||
private static final String NAME = "name"; |
|
||||||
private static final String SCRIPT = "script"; |
|
||||||
|
|
||||||
FunctionMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name of this Function. |
|
||||||
* |
|
||||||
* @return The name of this function |
|
||||||
*/ |
|
||||||
public String getName() { |
|
||||||
return v8Object.executeStringFunction(NAME, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name of the Script associated with |
|
||||||
* this FunctionMirror. |
|
||||||
* |
|
||||||
* @return The name of the script. |
|
||||||
*/ |
|
||||||
public String getScriptName() { |
|
||||||
V8Object script = v8Object.executeObjectFunction(SCRIPT, null); |
|
||||||
try { |
|
||||||
return script.executeStringFunction(NAME, null); |
|
||||||
} finally { |
|
||||||
script.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isFunction() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,294 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
import com.eclipsesource.v8.V8ResultUndefined; |
|
||||||
|
|
||||||
/** |
|
||||||
* A mirror is used to represent a copy (mirror) of a runtime object |
|
||||||
* during a debug session. |
|
||||||
* |
|
||||||
* Mirror hierarchy: |
|
||||||
* - Mirror |
|
||||||
* - ValueMirror |
|
||||||
* - UndefinedMirror |
|
||||||
* - NullMirror |
|
||||||
* - NumberMirror |
|
||||||
* - StringMirror |
|
||||||
* - ObjectMirror |
|
||||||
* - FunctionMirror |
|
||||||
* - UnresolvedFunctionMirror |
|
||||||
* - ArrayMirror |
|
||||||
* - DateMirror |
|
||||||
* - RegExpMirror |
|
||||||
* - ErrorMirror |
|
||||||
* - PromiseMirror |
|
||||||
* - PropertyMirror |
|
||||||
* - InternalPropertyMirror |
|
||||||
* - FrameMirror |
|
||||||
* - ScriptMirror |
|
||||||
*/ |
|
||||||
public class Mirror implements Releasable { |
|
||||||
|
|
||||||
private static final String IS_UNDEFINED = "isUndefined"; |
|
||||||
private static final String IS_NULL = "isNull"; |
|
||||||
private static final String IS_STRING = "isString"; |
|
||||||
private static final String IS_ARRAY = "isArray"; |
|
||||||
private static final String IS_FUNCTION = "isFunction"; |
|
||||||
private static final String IS_BOOLEAN = "isBoolean"; |
|
||||||
private static final String IS_NUMBER = "isNumber"; |
|
||||||
private static final String IS_OBJECT = "isObject"; |
|
||||||
private static final String IS_VALUE = "isValue"; |
|
||||||
|
|
||||||
protected V8Object v8Object; |
|
||||||
|
|
||||||
Mirror(final V8Object v8Object) { |
|
||||||
this.v8Object = v8Object.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to the type 'undefined'. |
|
||||||
* False otherwise. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to an 'undefined' type. |
|
||||||
*/ |
|
||||||
public boolean isUndefined() { |
|
||||||
return v8Object.executeBooleanFunction(IS_UNDEFINED, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'value' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'value' type. |
|
||||||
*/ |
|
||||||
public boolean isValue() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to 'null'. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'null'. |
|
||||||
*/ |
|
||||||
public boolean isNull() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'boolean' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'boolean' type. |
|
||||||
*/ |
|
||||||
public boolean isBoolean() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'number' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'number' type. |
|
||||||
*/ |
|
||||||
public boolean isNumber() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'String' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'String' type. |
|
||||||
*/ |
|
||||||
public boolean isString() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to an 'Object' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to an 'Object' type. |
|
||||||
*/ |
|
||||||
public boolean isObject() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'Function' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'Function' type. |
|
||||||
*/ |
|
||||||
public boolean isFunction() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to an 'Array' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to an 'Array' type. |
|
||||||
*/ |
|
||||||
public boolean isArray() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'Function' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'Function' type. |
|
||||||
*/ |
|
||||||
public boolean isFrame() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if this mirror object points to a 'Property' type. |
|
||||||
* |
|
||||||
* @return True iff this mirror object points to a 'Property' type. |
|
||||||
*/ |
|
||||||
public boolean isProperty() { |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.io.Closeable#close() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
if ((v8Object != null) && !v8Object.isReleased()) { |
|
||||||
v8Object.close(); |
|
||||||
v8Object = null; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see com.eclipsesource.v8.Releasable#release() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
protected static boolean isValue(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_VALUE, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isObject(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_OBJECT, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isNumber(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_NUMBER, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isBoolean(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_BOOLEAN, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isFunction(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_FUNCTION, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isArray(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_ARRAY, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isString(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_STRING, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isUndefined(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_UNDEFINED, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static boolean isNull(final V8Object mirror) { |
|
||||||
try { |
|
||||||
return mirror.executeBooleanFunction(IS_NULL, null); |
|
||||||
} catch (V8ResultUndefined e) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
protected static ValueMirror createMirror(final V8Object mirror) { |
|
||||||
if (isNull(mirror)) { |
|
||||||
return new NullMirror(mirror); |
|
||||||
} else if (isUndefined(mirror)) { |
|
||||||
return new UndefinedMirror(mirror); |
|
||||||
} else if (isFunction(mirror)) { |
|
||||||
return new FunctionMirror(mirror); |
|
||||||
} else if (isArray(mirror)) { |
|
||||||
return new ArrayMirror(mirror); |
|
||||||
} else if (isObject(mirror)) { |
|
||||||
return new ObjectMirror(mirror); |
|
||||||
} else if (isString(mirror)) { |
|
||||||
return new StringMirror(mirror); |
|
||||||
} else if (isNumber(mirror)) { |
|
||||||
return new NumberMirror(mirror); |
|
||||||
} else if (isBoolean(mirror)) { |
|
||||||
return new BooleanMirror(mirror); |
|
||||||
} |
|
||||||
return new ValueMirror(mirror); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return v8Object.toString(); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean equals(final Object obj) { |
|
||||||
if (obj == null) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
if (!(obj instanceof Mirror)) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
return v8Object.equals(((Mirror) obj).v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public int hashCode() { |
|
||||||
return v8Object.hashCode(); |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,35 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents 'Null' Mirrors |
|
||||||
*/ |
|
||||||
public class NullMirror extends ValueMirror { |
|
||||||
|
|
||||||
|
|
||||||
NullMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isNull() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return "null"; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,34 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents JavaScript 'Number' Mirrors |
|
||||||
*/ |
|
||||||
public class NumberMirror extends ValueMirror { |
|
||||||
|
|
||||||
NumberMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isNumber() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return v8Object.executeStringFunction("toText", null); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,98 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents 'Object' mirrors. |
|
||||||
*/ |
|
||||||
public class ObjectMirror extends ValueMirror { |
|
||||||
|
|
||||||
private static final String PROPERTIES = "properties"; |
|
||||||
private static final String PROPERTY_NAMES = "propertyNames"; |
|
||||||
|
|
||||||
public enum PropertyKind { |
|
||||||
Named(1), Indexed(2); |
|
||||||
int index; |
|
||||||
|
|
||||||
private PropertyKind(final int index) { |
|
||||||
this.index = index; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return v8Object.toString(); |
|
||||||
} |
|
||||||
|
|
||||||
ObjectMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isObject() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns all the property names for the given object. |
|
||||||
* |
|
||||||
* @param kind Indicate whether named, indexed or both kinds of properties are requested. |
|
||||||
* @param limit Limit the number of properties returned to the specified value |
|
||||||
* @return All the property names for a given object |
|
||||||
*/ |
|
||||||
public String[] getPropertyNames(final PropertyKind kind, final int limit) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(kind.index); |
|
||||||
parameters.push(limit); |
|
||||||
V8Array propertyNames = null; |
|
||||||
try { |
|
||||||
propertyNames = v8Object.executeArrayFunction(PROPERTY_NAMES, parameters); |
|
||||||
String[] result = new String[propertyNames.length()]; |
|
||||||
for (int i = 0; i < result.length; i++) { |
|
||||||
result[i] = propertyNames.getString(i); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if (propertyNames != null) { |
|
||||||
propertyNames.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Return the properties for this object as an array of PropertyMirror objects. |
|
||||||
* |
|
||||||
* @param kind Indicate whether named, indexed or both kinds of properties are requested |
|
||||||
* @param limit Limit the number of properties returned to the specified value |
|
||||||
* @return {Array} Property mirrors for this object |
|
||||||
*/ |
|
||||||
public PropertiesArray getProperties(final PropertyKind kind, final int limit) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(kind.index); |
|
||||||
parameters.push(limit); |
|
||||||
V8Array result = null; |
|
||||||
try { |
|
||||||
result = v8Object.executeArrayFunction(PROPERTIES, parameters); |
|
||||||
return new PropertiesArray(result); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
if ((result != null) && !result.isReleased()) { |
|
||||||
result.close(); |
|
||||||
result = null; |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,73 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Provides typed access to a set of properties. |
|
||||||
*/ |
|
||||||
public class PropertiesArray implements Releasable { |
|
||||||
|
|
||||||
private V8Array v8Array; |
|
||||||
|
|
||||||
PropertiesArray(final V8Array v8Object) { |
|
||||||
v8Array = v8Object.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the PropertyMiror at a given index. |
|
||||||
* |
|
||||||
* @param index The index of the property |
|
||||||
* @return The property at the given index |
|
||||||
*/ |
|
||||||
public PropertyMirror getProperty(final int index) { |
|
||||||
V8Object result = v8Array.getObject(index); |
|
||||||
try { |
|
||||||
return new PropertyMirror(result); |
|
||||||
} finally { |
|
||||||
result.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.io.Closeable#close() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
if (!v8Array.isReleased()) { |
|
||||||
v8Array.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see com.eclipsesource.v8.Releasable#release() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the number of properties contained in this array. |
|
||||||
* |
|
||||||
* @return The length of this array. |
|
||||||
*/ |
|
||||||
public int length() { |
|
||||||
return v8Array.length(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,52 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents JavaScript 'Property' Mirrors |
|
||||||
*/ |
|
||||||
public class PropertyMirror extends Mirror { |
|
||||||
|
|
||||||
PropertyMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name of this property. |
|
||||||
* |
|
||||||
* @return The name of this property. |
|
||||||
*/ |
|
||||||
public String getName() { |
|
||||||
return v8Object.executeStringFunction("name", null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the value of this property. |
|
||||||
* |
|
||||||
* @return The value of this property. |
|
||||||
*/ |
|
||||||
public Mirror getValue() { |
|
||||||
V8Object mirror = v8Object.executeObjectFunction("value", null); |
|
||||||
try { |
|
||||||
return createMirror(mirror); |
|
||||||
} finally { |
|
||||||
mirror.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isProperty() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,156 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
import com.eclipsesource.v8.V8Value; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents a JavaScope scope accessible from the current stack frame |
|
||||||
* during debug break. |
|
||||||
* |
|
||||||
*/ |
|
||||||
public class Scope extends Mirror { |
|
||||||
|
|
||||||
private static final String SCOPE_OBJECT = "scopeObject"; |
|
||||||
private static final String SCOPE_TYPE = "scopeType"; |
|
||||||
private static final String SET_VARIABLE_VALUE = "setVariableValue"; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents the different types of scopes available. |
|
||||||
*/ |
|
||||||
public static enum ScopeType { |
|
||||||
Global(0), Local(1), With(2), Closure(3), Catch(4), Block(5), Script(6); |
|
||||||
int index; |
|
||||||
|
|
||||||
private ScopeType(final int index) { |
|
||||||
this.index = index; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
Scope(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the type of this scope. |
|
||||||
* |
|
||||||
* @return The type of scope. |
|
||||||
*/ |
|
||||||
public ScopeType getType() { |
|
||||||
return ScopeType.values()[v8Object.executeIntegerFunction(SCOPE_TYPE, null)]; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the value of a variable in this scope. |
|
||||||
* |
|
||||||
* @param name The name of the variable |
|
||||||
* @param value The value |
|
||||||
*/ |
|
||||||
public void setVariableValue(final String name, final int value) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(name); |
|
||||||
parameters.push(value); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(SET_VARIABLE_VALUE, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the value of a variable in this scope. |
|
||||||
* |
|
||||||
* @param name The name of the variable |
|
||||||
* @param value The value |
|
||||||
*/ |
|
||||||
public void setVariableValue(final String name, final V8Value value) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(name); |
|
||||||
parameters.push(value); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(SET_VARIABLE_VALUE, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the value of a variable in this scope. |
|
||||||
* |
|
||||||
* @param name The name of the variable |
|
||||||
* @param value The value |
|
||||||
*/ |
|
||||||
public void setVariableValue(final String name, final boolean value) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(name); |
|
||||||
parameters.push(value); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(SET_VARIABLE_VALUE, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the value of a variable in this scope. |
|
||||||
* |
|
||||||
* @param name The name of the variable |
|
||||||
* @param value The value |
|
||||||
*/ |
|
||||||
public void setVariableValue(final String name, final String value) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(name); |
|
||||||
parameters.push(value); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(SET_VARIABLE_VALUE, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Sets the value of a variable in this scope. |
|
||||||
* |
|
||||||
* @param name The name of the variable |
|
||||||
* @param value The value |
|
||||||
*/ |
|
||||||
public void setVariableValue(final String name, final double value) { |
|
||||||
V8Array parameters = new V8Array(v8Object.getRuntime()); |
|
||||||
parameters.push(name); |
|
||||||
parameters.push(value); |
|
||||||
try { |
|
||||||
v8Object.executeVoidFunction(SET_VARIABLE_VALUE, parameters); |
|
||||||
} finally { |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the underlying V8Object that represents this scope. |
|
||||||
* |
|
||||||
* @return The underlying V8Object that represents this scope. |
|
||||||
*/ |
|
||||||
public ObjectMirror getScopeObject() { |
|
||||||
V8Object mirror = null; |
|
||||||
try { |
|
||||||
mirror = v8Object.executeObjectFunction(SCOPE_OBJECT, null); |
|
||||||
return (ObjectMirror) createMirror(mirror); |
|
||||||
} finally { |
|
||||||
if ( mirror != null ) { |
|
||||||
mirror.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,84 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents a JS Script location. |
|
||||||
*/ |
|
||||||
public class SourceLocation { |
|
||||||
|
|
||||||
private final String scriptName; |
|
||||||
private final int position; |
|
||||||
private final int line; |
|
||||||
private final int column; |
|
||||||
private String sourceText; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents a JS Script Source Location |
|
||||||
* @param scriptName The name of the script |
|
||||||
* @param position The position in the script |
|
||||||
* @param line The line number |
|
||||||
* @param column The column number |
|
||||||
* @param sourceText The sourceCode at this location |
|
||||||
*/ |
|
||||||
public SourceLocation(final String scriptName, final int position, final int line, final int column, final String sourceText) { |
|
||||||
this.scriptName = scriptName; |
|
||||||
this.position = position; |
|
||||||
this.line = line; |
|
||||||
this.column = column; |
|
||||||
this.sourceText = sourceText; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return scriptName + " : " + position + " : " + line + " : " + column + " : " + sourceText; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the name of the script for this SourceLocation. |
|
||||||
* @return The name of the script |
|
||||||
*/ |
|
||||||
public String getScriptName() { |
|
||||||
return scriptName; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the position of this SourceLocation. |
|
||||||
* @return The position of this SourceLocation. |
|
||||||
*/ |
|
||||||
public int getPosition() { |
|
||||||
return position; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the line number of this SourceLocation. |
|
||||||
* @return The line number of this SourceLocation. |
|
||||||
*/ |
|
||||||
public int getLine() { |
|
||||||
return line; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the column number of this SourceLocation. |
|
||||||
* @return The column number of this SourceLocation. |
|
||||||
*/ |
|
||||||
public int getColumn() { |
|
||||||
return column; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the source text for this SourceLocation. |
|
||||||
* @return The source text for this SourceLocation. |
|
||||||
*/ |
|
||||||
public String getSourceText() { |
|
||||||
return sourceText; |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,34 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents JavaScript 'String' Mirrors |
|
||||||
*/ |
|
||||||
public class StringMirror extends ValueMirror { |
|
||||||
|
|
||||||
StringMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isString() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return v8Object.executeStringFunction("toText", null); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,35 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents 'Undefined' Mirrors |
|
||||||
*/ |
|
||||||
public class UndefinedMirror extends ValueMirror { |
|
||||||
|
|
||||||
|
|
||||||
UndefinedMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isUndefined() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public String toString() { |
|
||||||
return "undefined"; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,40 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.debug.mirror; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Represents 'Value' Mirrors (Objects, Numbers, Strings, ...). |
|
||||||
*/ |
|
||||||
public class ValueMirror extends Mirror { |
|
||||||
|
|
||||||
private static final String VALUE = "value"; |
|
||||||
|
|
||||||
ValueMirror(final V8Object v8Object) { |
|
||||||
super(v8Object); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the Object that this mirror represents. |
|
||||||
* |
|
||||||
* @return The object that this mirror represents. |
|
||||||
*/ |
|
||||||
public Object getValue() { |
|
||||||
return v8Object.executeFunction(VALUE, null); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean isValue() { |
|
||||||
return true; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,7 +0,0 @@ |
|||||||
package com.eclipsesource.v8.inspector; |
|
||||||
|
|
||||||
public interface DebuggerConnectionListener { |
|
||||||
public void onDebuggerConnected(); |
|
||||||
|
|
||||||
public void onDebuggerDisconnected(); |
|
||||||
} |
|
||||||
@ -1,67 +0,0 @@ |
|||||||
package com.eclipsesource.v8.inspector; |
|
||||||
|
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.List; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
public class V8Inspector { |
|
||||||
|
|
||||||
private V8 runtime; |
|
||||||
private long inspectorPtr = 0; |
|
||||||
private boolean waitingForConnection = true; |
|
||||||
private List<DebuggerConnectionListener> debuggerConnectionListeners; |
|
||||||
|
|
||||||
protected V8Inspector(final V8 runtime, final V8InspectorDelegate inspectorDelegate, final String contextName) { |
|
||||||
this.runtime = runtime; |
|
||||||
inspectorPtr = runtime.createInspector(inspectorDelegate, contextName); |
|
||||||
debuggerConnectionListeners = new ArrayList<DebuggerConnectionListener>(); |
|
||||||
} |
|
||||||
|
|
||||||
public static V8Inspector createV8Inspector(final V8 runtime, final V8InspectorDelegate inspectorDelegate, final String contextName) { |
|
||||||
return new V8Inspector(runtime, inspectorDelegate, contextName); |
|
||||||
} |
|
||||||
|
|
||||||
public static V8Inspector createV8Inspector(final V8 runtime, final V8InspectorDelegate inspectorDelegate) { |
|
||||||
return new V8Inspector(runtime, inspectorDelegate, null); |
|
||||||
} |
|
||||||
|
|
||||||
public void dispatchProtocolMessage(final String protocolMessage) { |
|
||||||
try { |
|
||||||
runtime.dispatchProtocolMessage(inspectorPtr, protocolMessage); |
|
||||||
if (waitingForConnection) { |
|
||||||
verifyDebuggerConnection(protocolMessage); |
|
||||||
} |
|
||||||
} catch (Exception e) { |
|
||||||
e.printStackTrace(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
public void addDebuggerConnectionListener(final DebuggerConnectionListener listener) { |
|
||||||
debuggerConnectionListeners.add(listener); |
|
||||||
} |
|
||||||
|
|
||||||
public void removeDebuggerConnectionListener(final DebuggerConnectionListener listener) { |
|
||||||
debuggerConnectionListeners.remove(listener); |
|
||||||
} |
|
||||||
|
|
||||||
private void verifyDebuggerConnection(final String protocolMessage) { |
|
||||||
V8Object json = null; |
|
||||||
try { |
|
||||||
json = runtime.executeObjectScript("JSON.parse(JSON.stringify(" + protocolMessage + "))"); |
|
||||||
if (json.getString("method").equals("Runtime.runIfWaitingForDebugger")) { |
|
||||||
waitingForConnection = false; |
|
||||||
runtime.schedulePauseOnNextStatement(inspectorPtr, ""); |
|
||||||
for (DebuggerConnectionListener listener : debuggerConnectionListeners) { |
|
||||||
listener.onDebuggerConnected(); |
|
||||||
} |
|
||||||
} |
|
||||||
} finally { |
|
||||||
if (json != null) { |
|
||||||
json.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,7 +0,0 @@ |
|||||||
package com.eclipsesource.v8.inspector; |
|
||||||
|
|
||||||
public interface V8InspectorDelegate { |
|
||||||
public void onResponse(String message); |
|
||||||
|
|
||||||
public void waitFrontendMessageOnPause(); |
|
||||||
} |
|
||||||
@ -1,69 +0,0 @@ |
|||||||
package com.eclipsesource.v8.utils; |
|
||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2019 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
|
|
||||||
import java.nio.ByteBuffer; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8ArrayBuffer; |
|
||||||
|
|
||||||
/** |
|
||||||
* A lightweight handle to a V8TypedArray. This handle provides |
|
||||||
* access to a V8TypedArray. This handle does not need to be |
|
||||||
* closed, but if the type array is accessed using getV8TypedArray |
|
||||||
* then the result must be closed. |
|
||||||
* |
|
||||||
* The underlying V8TypedArray may be reclaimed by the JavaScript |
|
||||||
* garbage collector. To check if it's still available, use |
|
||||||
* isAvailable. |
|
||||||
*/ |
|
||||||
public class ArrayBuffer { |
|
||||||
|
|
||||||
private V8ArrayBuffer arrayBuffer; |
|
||||||
|
|
||||||
ArrayBuffer(final V8ArrayBuffer arrayBuffer) { |
|
||||||
this.arrayBuffer = (V8ArrayBuffer) arrayBuffer.twin().setWeak(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a new ArrayBuffer from a java.nio.ByteBuffer |
|
||||||
* |
|
||||||
* @param v8 the Runtime on which to create the ArrayBuffer |
|
||||||
* @param byteBuffer the ByteBuffer to use to back the ArrayBuffer |
|
||||||
*/ |
|
||||||
public ArrayBuffer(final V8 v8, final ByteBuffer byteBuffer) { |
|
||||||
V8ArrayBuffer v8ArrayBuffer = new V8ArrayBuffer(v8, byteBuffer); |
|
||||||
try { |
|
||||||
arrayBuffer = (V8ArrayBuffer) v8ArrayBuffer.twin().setWeak(); |
|
||||||
} finally { |
|
||||||
v8ArrayBuffer.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Determine if the underlying V8ArrayBuffer is still available, or if it's been cleaned up by the JavaScript |
|
||||||
* garbage collector. |
|
||||||
* |
|
||||||
* @return true if the underlying V8ArrayBuffer is still available, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isAvailable() { |
|
||||||
return !arrayBuffer.isReleased(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the underlying V8ArrayBuffer. |
|
||||||
* @return the underlying V8ArrayBuffer. |
|
||||||
*/ |
|
||||||
public V8ArrayBuffer getV8ArrayBuffer() { |
|
||||||
return arrayBuffer.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,94 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 Brandon Sanders |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* Brandon Sanders - initial API and implementation and/or initial documentation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
|
|
||||||
/** |
|
||||||
* Wrapper class for an {@link com.eclipsesource.v8.V8} instance that allows |
|
||||||
* a V8 instance to be invoked from across threads without explicitly acquiring |
|
||||||
* or releasing locks. |
|
||||||
* |
|
||||||
* This class does not guarantee the safety of any objects stored in or accessed |
|
||||||
* from the wrapped V8 instance; it only enables callers to interact with a V8 |
|
||||||
* instance from any thread. The V8 instance represented by this class should |
|
||||||
* still be treated with thread safety in mind |
|
||||||
* |
|
||||||
* @author Brandon Sanders [brandon@alicorn.io] |
|
||||||
* @author R. Ian Bull - Additional API |
|
||||||
*/ |
|
||||||
public final class ConcurrentV8 { |
|
||||||
private V8 v8 = null; |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a new ConcurrentV8. A ConcurrentV8 allows multiple |
|
||||||
* threads to work with the same V8 engine by releasing |
|
||||||
* the locks between calls. |
|
||||||
*/ |
|
||||||
public ConcurrentV8() { |
|
||||||
v8 = V8.createV8Runtime(); |
|
||||||
v8.getLocker().release(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the V8 runtime backing by this ConcurrentV8 |
|
||||||
* |
|
||||||
* @return The V8 runtime backing this ConcurrentV8 |
|
||||||
*/ |
|
||||||
public V8 getV8() { |
|
||||||
return v8; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Runs an {@link V8Runnable} on the V8 thread. |
|
||||||
* |
|
||||||
* <b>Note: </b> This method executes synchronously, not asynchronously; |
|
||||||
* it will not return until the passed {@link V8Runnable} is done |
|
||||||
* executing. The method is also synchronized, so it will block until it |
|
||||||
* gets a chance to run. |
|
||||||
* |
|
||||||
* @param runnable {@link V8Runnable} to run. |
|
||||||
*/ |
|
||||||
public synchronized void run(final V8Runnable runnable) { |
|
||||||
try { |
|
||||||
v8.getLocker().acquire(); |
|
||||||
runnable.run(v8); |
|
||||||
} finally { |
|
||||||
if ((v8 != null) && (v8.getLocker() != null) && v8.getLocker().hasLock()) { |
|
||||||
v8.getLocker().release(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Releases the underlying {@link V8} instance. |
|
||||||
* |
|
||||||
* This method should be invoked once you're done using this object, |
|
||||||
* otherwise a large amount of garbage could be left on the JVM due to |
|
||||||
* native resources. |
|
||||||
* |
|
||||||
* <b>Note:</b> If this method has already been called once, it |
|
||||||
* will do nothing. |
|
||||||
*/ |
|
||||||
public void release() { |
|
||||||
if ((v8 != null) && !v8.isReleased()) { |
|
||||||
// Release the V8 instance from the V8 thread context.
|
|
||||||
run(new V8Runnable() { |
|
||||||
@Override |
|
||||||
public void run(final V8 v8) { |
|
||||||
if ((v8 != null) && !v8.isReleased()) { |
|
||||||
v8.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
}); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,138 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2016 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.Iterator; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.ReferenceHandler; |
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8Value; |
|
||||||
|
|
||||||
/** |
|
||||||
* A memory manager that tracks all V8 Handles while the object is registered. |
|
||||||
* Once released, all V8 handles that were created while the memory manager |
|
||||||
* was active, will be released. |
|
||||||
* |
|
||||||
* It is important that no V8 handles (V8Objects, V8Arrays, etc...) that are |
|
||||||
* created while the memory manager is active, are persisted. |
|
||||||
* |
|
||||||
*/ |
|
||||||
public class MemoryManager { |
|
||||||
|
|
||||||
private MemoryManagerReferenceHandler memoryManagerReferenceHandler; |
|
||||||
private V8 v8; |
|
||||||
private ArrayList<V8Value> references = new ArrayList<V8Value>(); |
|
||||||
private boolean releasing = false; |
|
||||||
private boolean released = false; |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates and registered a Memory Manager. After this, all V8 handles will be |
|
||||||
* tracked until release is called. |
|
||||||
* |
|
||||||
* @param v8 The V8 runtime to register this Memory Manager on |
|
||||||
*/ |
|
||||||
public MemoryManager(final V8 v8) { |
|
||||||
this.v8 = v8; |
|
||||||
memoryManagerReferenceHandler = new MemoryManagerReferenceHandler(); |
|
||||||
v8.addReferenceHandler(memoryManagerReferenceHandler); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the number of handles currently being tracked by this |
|
||||||
* memory manager. |
|
||||||
* |
|
||||||
* Throws an IllegalStateException if the memory manager is used after it's |
|
||||||
* been released. |
|
||||||
* |
|
||||||
* @return The object reference count |
|
||||||
*/ |
|
||||||
public int getObjectReferenceCount() { |
|
||||||
checkReleased(); |
|
||||||
return references.size(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Persist an object that is currently being managed by this Manager. |
|
||||||
* |
|
||||||
* Objects that are being managed by a MemoryManager will be released |
|
||||||
* once the MemoryManager is released. If an object is persisted, it will |
|
||||||
* be remove from the MemoryManager's control and therefore will not |
|
||||||
* be released. |
|
||||||
* |
|
||||||
* @param object The object to persist |
|
||||||
*/ |
|
||||||
public void persist(final V8Value object) { |
|
||||||
v8.getLocker().checkThread(); |
|
||||||
checkReleased(); |
|
||||||
references.remove(object); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Checks if the memory manager has been released or not. Released memory |
|
||||||
* managers can no longer be used. |
|
||||||
* |
|
||||||
* @return True if this memory manager has been released, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isReleased() { |
|
||||||
return released; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Releases this Memory Manager and all V8Objects that were created while |
|
||||||
* this memory manager was active. |
|
||||||
*/ |
|
||||||
public void release() { |
|
||||||
v8.getLocker().checkThread(); |
|
||||||
if (released) { |
|
||||||
return; |
|
||||||
} |
|
||||||
releasing = true; |
|
||||||
try { |
|
||||||
for (V8Value reference : references) { |
|
||||||
reference.close(); |
|
||||||
} |
|
||||||
v8.removeReferenceHandler(memoryManagerReferenceHandler); |
|
||||||
references.clear(); |
|
||||||
} finally { |
|
||||||
releasing = false; |
|
||||||
} |
|
||||||
released = true; |
|
||||||
} |
|
||||||
|
|
||||||
private void checkReleased() { |
|
||||||
if (released) { |
|
||||||
throw new IllegalStateException("Memory manager released"); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private class MemoryManagerReferenceHandler implements ReferenceHandler { |
|
||||||
|
|
||||||
@Override |
|
||||||
public void v8HandleCreated(final V8Value object) { |
|
||||||
references.add(object); |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public void v8HandleDisposed(final V8Value object) { |
|
||||||
if (!releasing) { |
|
||||||
Iterator<V8Value> iterator = references.iterator(); |
|
||||||
while (iterator.hasNext()) { |
|
||||||
if (iterator.next() == object) { |
|
||||||
iterator.remove(); |
|
||||||
return; |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,55 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2017 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
/** |
|
||||||
* Adapt all instances of a single type from JavaScript to Java. |
|
||||||
* The TypeAdapter can be used with the V8ObjectUtils to allow users to customize |
|
||||||
* the conversion. |
|
||||||
*/ |
|
||||||
public abstract class SingleTypeAdapter implements TypeAdapter { |
|
||||||
|
|
||||||
private int typeToAdapt; |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a SingleTypeAdapter |
|
||||||
* |
|
||||||
* @param typeToAdapt The V8 Type this TypeAdapter should be applied to. |
|
||||||
*/ |
|
||||||
public SingleTypeAdapter(final int typeToAdapt) { |
|
||||||
this.typeToAdapt = typeToAdapt; |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see com.eclipsesource.v8.utils.TypeAdapter#adapt(int, java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Object adapt(final int type, final Object value) { |
|
||||||
if (type == typeToAdapt) { |
|
||||||
return adapt(value); |
|
||||||
} |
|
||||||
return TypeAdapter.DEFAULT; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Adapt an object from V8 to Java. |
|
||||||
* |
|
||||||
* If the value is a V8Value (V8Object) then it will be released after |
|
||||||
* this method is called. If you wish to retain the object, call |
|
||||||
* ((V8Value)value).twin(); |
|
||||||
* |
|
||||||
* @param value The V8 Object to be converted. |
|
||||||
* @return The adapted Java Object or {@link TypeAdapter#DEFAULT} for the default conversion. |
|
||||||
*/ |
|
||||||
public abstract Object adapt(final Object value); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,39 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2017 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
/** |
|
||||||
* An interface which allows a plug-able conversion from V8Value types to Java objects. |
|
||||||
* The TypeAdapter can be used with the V8ObjectUtils to allow users to customize |
|
||||||
* the conversion. |
|
||||||
*/ |
|
||||||
public interface TypeAdapter { |
|
||||||
|
|
||||||
/** |
|
||||||
* A default adapter that if returned in {@link TypeAdapter#adapt(int, Object)}, will result |
|
||||||
* in the default type adaption. |
|
||||||
*/ |
|
||||||
public static final Object DEFAULT = new Object(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Adapt an object from V8 to Java. |
|
||||||
* |
|
||||||
* If the value is a V8Value (V8Object) then it will be released after |
|
||||||
* this method is called. If you wish to retain the object, call |
|
||||||
* ((V8Value)value).twin(); |
|
||||||
* |
|
||||||
* @param type The Type of the object to be adapted. |
|
||||||
* @param value The V8 Object to be converted. |
|
||||||
* @return The adapted Java Object or {@link TypeAdapter#DEFAULT} for the default conversion. |
|
||||||
*/ |
|
||||||
public Object adapt(int type, Object value); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,73 +0,0 @@ |
|||||||
package com.eclipsesource.v8.utils; |
|
||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2019 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8ArrayBuffer; |
|
||||||
import com.eclipsesource.v8.V8TypedArray; |
|
||||||
|
|
||||||
/** |
|
||||||
* A lightweight handle to a V8TypedArray. This handle provides |
|
||||||
* access to a V8TypedArray. This handle does not need to be |
|
||||||
* closed, but if the type array is accessed using getV8TypedArray |
|
||||||
* then the result must be closed. |
|
||||||
* |
|
||||||
* The underlying V8TypedArray may be reclaimed by the JavaScript |
|
||||||
* garbage collector. To check if it's still available, use |
|
||||||
* isAvailable. |
|
||||||
*/ |
|
||||||
public class TypedArray { |
|
||||||
|
|
||||||
private V8TypedArray typedArray; |
|
||||||
|
|
||||||
TypedArray(final V8TypedArray typedArray) { |
|
||||||
this.typedArray = (V8TypedArray) typedArray.twin().setWeak(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a new TypedArray from an ArrayBuffer. |
|
||||||
* |
|
||||||
* @param v8 the V8Runtime on which to create the TypedArray |
|
||||||
* @param buffer the ArrayBuffer to use to back the TypedArray |
|
||||||
* @param type the Type of Array to create |
|
||||||
* @param offset the Offset into the ArrayBuffer in which to map the TyepdArray |
|
||||||
* @param size the Size of the TypedArray |
|
||||||
*/ |
|
||||||
public TypedArray(final V8 v8, final ArrayBuffer buffer, final int type, final int offset, final int size) { |
|
||||||
V8ArrayBuffer v8ArrayBuffer = buffer.getV8ArrayBuffer(); |
|
||||||
V8TypedArray v8typedArray = new V8TypedArray(v8, v8ArrayBuffer, type, offset, size); |
|
||||||
try { |
|
||||||
typedArray = (V8TypedArray) v8typedArray.twin().setWeak(); |
|
||||||
} finally { |
|
||||||
v8ArrayBuffer.close(); |
|
||||||
v8typedArray.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Determine if the underlying V8TypedArray is still available, or if it's been cleaned up by the JavaScript |
|
||||||
* garbage collector. |
|
||||||
* |
|
||||||
* @return true if the underlying V8TypedArray is still available, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isAvailable() { |
|
||||||
return !typedArray.isReleased(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns the underlying V8TypedArray. |
|
||||||
* @return the underlying V8TypedArray. |
|
||||||
*/ |
|
||||||
public V8TypedArray getV8TypedArray() { |
|
||||||
return (V8TypedArray) typedArray.twin(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,253 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import java.util.LinkedList; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.JavaVoidCallback; |
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
|
|
||||||
/** |
|
||||||
* Executes a JS Script on a new V8 runtime in its own thread, and once finished, |
|
||||||
* will optionally wait on a message queue. If the executor is *not* long running, |
|
||||||
* when the JS Script finishes, the executor will shutdown. If the executor |
|
||||||
* *is* long running, the the script will execute, and when finished, the executor |
|
||||||
* will wait for messages to arrive. When messages arrive, the messageHandler |
|
||||||
* will be invoked with the contents of the message. |
|
||||||
* |
|
||||||
* Executors can be shutdown in two different ways. forceTermination() will |
|
||||||
* stop any executing scripts and immediately terminate the executor. shutdown() |
|
||||||
* will indicate that the executor should shutdown, but this will only happen |
|
||||||
* once any scripts finish executing and the message queue becomes empty. |
|
||||||
*/ |
|
||||||
public class V8Executor extends Thread { |
|
||||||
|
|
||||||
private final String script; |
|
||||||
private V8 runtime; |
|
||||||
private String result; |
|
||||||
private volatile boolean terminated = false; |
|
||||||
private volatile boolean shuttingDown = false; |
|
||||||
private volatile boolean forceTerminating = false; |
|
||||||
private Exception exception = null; |
|
||||||
private LinkedList<String[]> messageQueue = new LinkedList<String[]>(); |
|
||||||
private boolean longRunning; |
|
||||||
private String messageHandler; |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a new executor and execute the given script on it. Once |
|
||||||
* the script has finished executing, the executor can optionally |
|
||||||
* wait on a message queue. |
|
||||||
* |
|
||||||
* @param script The script to execute on this executor. |
|
||||||
* @param longRunning True to indicate that this executor should be longRunning. |
|
||||||
* @param messageHandler The name of the message handler that should be notified |
|
||||||
* when messages are delivered. |
|
||||||
*/ |
|
||||||
public V8Executor(final String script, final boolean longRunning, final String messageHandler) { |
|
||||||
this.script = script; |
|
||||||
this.longRunning = longRunning; |
|
||||||
this.messageHandler = messageHandler; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a new executor and execute the given script on it. |
|
||||||
* |
|
||||||
* @param script The script to execute on this executor. |
|
||||||
*/ |
|
||||||
public V8Executor(final String script) { |
|
||||||
this(script, false, null); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Override to provide a custom setup for this V8 runtime. |
|
||||||
* This method can be overridden to configure the V8 runtime, |
|
||||||
* for example, to add callbacks or to add some additional |
|
||||||
* functionality to the global scope. |
|
||||||
* |
|
||||||
* @param runtime The runtime to configure. |
|
||||||
*/ |
|
||||||
protected void setup(final V8 runtime) { |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the result of the JavaScript that was executed |
|
||||||
* on this executor. |
|
||||||
* |
|
||||||
* @return The result of the JS Script that was executed on |
|
||||||
* this executor. |
|
||||||
*/ |
|
||||||
public String getResult() { |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Posts a message to the receiver to be processed by the executor |
|
||||||
* and sent to the V8 runtime via the messageHandler. |
|
||||||
* |
|
||||||
* @param message The message to send to the messageHandler |
|
||||||
*/ |
|
||||||
public void postMessage(final String... message) { |
|
||||||
synchronized (this) { |
|
||||||
messageQueue.add(message); |
|
||||||
notify(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.lang.Thread#run() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void run() { |
|
||||||
synchronized (this) { |
|
||||||
runtime = V8.createV8Runtime(); |
|
||||||
runtime.registerJavaMethod(new ExecutorTermination(), "__j2v8__checkThreadTerminate"); |
|
||||||
setup(runtime); |
|
||||||
} |
|
||||||
try { |
|
||||||
if (!forceTerminating) { |
|
||||||
Object scriptResult = runtime.executeScript("__j2v8__checkThreadTerminate();\n" + script, getName(), -1); |
|
||||||
if (scriptResult != null) { |
|
||||||
result = scriptResult.toString(); |
|
||||||
} |
|
||||||
if (scriptResult instanceof Releasable) { |
|
||||||
((Releasable) scriptResult).release(); |
|
||||||
} |
|
||||||
} |
|
||||||
while (!forceTerminating && longRunning) { |
|
||||||
synchronized (this) { |
|
||||||
if (messageQueue.isEmpty() && !shuttingDown) { |
|
||||||
wait(); |
|
||||||
} |
|
||||||
if ((messageQueue.isEmpty() && shuttingDown) || forceTerminating) { |
|
||||||
return; |
|
||||||
} |
|
||||||
} |
|
||||||
if (!messageQueue.isEmpty()) { |
|
||||||
String[] message = messageQueue.remove(0); |
|
||||||
V8Array parameters = new V8Array(runtime); |
|
||||||
V8Array strings = new V8Array(runtime); |
|
||||||
try { |
|
||||||
for (String string : message) { |
|
||||||
strings.push(string); |
|
||||||
} |
|
||||||
parameters.push(strings); |
|
||||||
runtime.executeVoidFunction(messageHandler, parameters); |
|
||||||
} finally { |
|
||||||
strings.close(); |
|
||||||
parameters.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
} catch (Exception e) { |
|
||||||
exception = e; |
|
||||||
} finally { |
|
||||||
synchronized (this) { |
|
||||||
if (runtime.getLocker().hasLock()) { |
|
||||||
runtime.close(); |
|
||||||
runtime = null; |
|
||||||
} |
|
||||||
terminated = true; |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Determines if an exception was thrown during the JavaScript execution. |
|
||||||
* |
|
||||||
* @return True if an exception was thrown during the JavaScript execution, |
|
||||||
* false otherwise. |
|
||||||
*/ |
|
||||||
public boolean hasException() { |
|
||||||
return exception != null; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets the exception that was thrown during the JavaScript execution. |
|
||||||
* |
|
||||||
* @return The exception that was thrown during the JavaScript execution, |
|
||||||
* or null if no such exception was thrown. |
|
||||||
*/ |
|
||||||
public Exception getException() { |
|
||||||
return exception; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Determines if the executor has terminated. |
|
||||||
* |
|
||||||
* @return True if the executor has terminated, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean hasTerminated() { |
|
||||||
return terminated; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Forces the executor to shutdown immediately. Any currently executing |
|
||||||
* JavaScript will be interrupted and all outstanding messages will be |
|
||||||
* ignored. |
|
||||||
*/ |
|
||||||
public void forceTermination() { |
|
||||||
synchronized (this) { |
|
||||||
forceTerminating = true; |
|
||||||
shuttingDown = true; |
|
||||||
if (runtime != null) { |
|
||||||
runtime.terminateExecution(); |
|
||||||
} |
|
||||||
notify(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Indicates to the executor that it should shutdown. Any currently |
|
||||||
* executing JavaScript will be allowed to finish, and any outstanding |
|
||||||
* messages will be processed. Only once the message queue is empty, |
|
||||||
* will the executor actually shtutdown. |
|
||||||
*/ |
|
||||||
public void shutdown() { |
|
||||||
synchronized (this) { |
|
||||||
shuttingDown = true; |
|
||||||
notify(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if shutdown() or forceTermination() was called to |
|
||||||
* shutdown this executor. |
|
||||||
* |
|
||||||
* @return True if shutdown() or forceTermination() was called, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isShuttingDown() { |
|
||||||
return shuttingDown; |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns true if forceTermination was called to shutdown |
|
||||||
* this executor. |
|
||||||
* |
|
||||||
* @return True if forceTermination() was called, false otherwise. |
|
||||||
*/ |
|
||||||
public boolean isTerminating() { |
|
||||||
return forceTerminating; |
|
||||||
} |
|
||||||
|
|
||||||
class ExecutorTermination implements JavaVoidCallback { |
|
||||||
@Override |
|
||||||
public void invoke(final V8Object receiver, final V8Array parameters) { |
|
||||||
if (forceTerminating) { |
|
||||||
throw new RuntimeException("V8Thread Termination"); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,185 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import java.util.Collection; |
|
||||||
import java.util.HashMap; |
|
||||||
import java.util.Map; |
|
||||||
import java.util.Set; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8Value; |
|
||||||
|
|
||||||
/** |
|
||||||
* A Map that maps V8Values to arbitrary Java Objects. |
|
||||||
* Once stored in the map, the keys (V8Values) can be released |
|
||||||
* as the map will handle their resource management for you. |
|
||||||
* |
|
||||||
* Once the map is no longer needed, it should be released. To |
|
||||||
* tie a map to the lifecycle of a V8 runtime, it can be registered |
|
||||||
* as a resource with V8.registerResource. |
|
||||||
*/ |
|
||||||
public class V8Map<V> implements Map<V8Value, V>, Releasable { |
|
||||||
|
|
||||||
private Map<V8Value, V> map; |
|
||||||
private Map<V8Value, V8Value> twinMap; |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a V8Map. |
|
||||||
*/ |
|
||||||
public V8Map() { |
|
||||||
map = new HashMap<V8Value, V>(); |
|
||||||
twinMap = new HashMap<V8Value, V8Value>(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.io.Closeable#close() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void close() { |
|
||||||
this.clear(); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Releases all the resources associated with this map. A |
|
||||||
* map can be used again once it's released, although |
|
||||||
* if it's used again it should be released again. |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
@Deprecated |
|
||||||
public void release() { |
|
||||||
close(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#size() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public int size() { |
|
||||||
return map.size(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#isEmpty() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean isEmpty() { |
|
||||||
return map.isEmpty(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#containsKey(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean containsKey(final Object key) { |
|
||||||
return map.containsKey(key); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#containsValue(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean containsValue(final Object value) { |
|
||||||
return map.containsValue(value); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#get(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V get(final Object key) { |
|
||||||
return map.get(key); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#put(java.lang.Object, java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V put(final V8Value key, final V value) { |
|
||||||
this.remove(key); |
|
||||||
V8Value twin = key.twin(); |
|
||||||
twinMap.put(twin, twin); |
|
||||||
return map.put(twin, value); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#remove(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V remove(final Object key) { |
|
||||||
V result = map.remove(key); |
|
||||||
V8Value twin = twinMap.remove(key); |
|
||||||
if (twin != null) { |
|
||||||
twin.close(); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#putAll(java.util.Map) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void putAll(final Map<? extends V8Value, ? extends V> m) { |
|
||||||
for (java.util.Map.Entry<? extends V8Value, ? extends V> entry : m.entrySet()) { |
|
||||||
this.put(entry.getKey(), entry.getValue()); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#clear() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void clear() { |
|
||||||
map.clear(); |
|
||||||
for (V8Value V8Value : twinMap.keySet()) { |
|
||||||
V8Value.close(); |
|
||||||
} |
|
||||||
twinMap.clear(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#keySet() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Set<V8Value> keySet() { |
|
||||||
return map.keySet(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#values() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Collection<V> values() { |
|
||||||
return map.values(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#entrySet() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Set<java.util.Map.Entry<V8Value, V>> entrySet() { |
|
||||||
return map.entrySet(); |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,703 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2014 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.Collections; |
|
||||||
import java.util.Hashtable; |
|
||||||
import java.util.List; |
|
||||||
import java.util.Map; |
|
||||||
import java.util.Map.Entry; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.Releasable; |
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
import com.eclipsesource.v8.V8Array; |
|
||||||
import com.eclipsesource.v8.V8ArrayBuffer; |
|
||||||
import com.eclipsesource.v8.V8Object; |
|
||||||
import com.eclipsesource.v8.V8TypedArray; |
|
||||||
import com.eclipsesource.v8.V8Value; |
|
||||||
|
|
||||||
/** |
|
||||||
* A set of static helper methods to convert V8Objects / V8Arrays to |
|
||||||
* java.util Maps and Lists and back again. These conversions |
|
||||||
* perform a deep copy. |
|
||||||
*/ |
|
||||||
public class V8ObjectUtils { |
|
||||||
|
|
||||||
private static final Object IGNORE = new Object(); |
|
||||||
private static final TypeAdapter DEFAULT_TYPE_ADAPTER = new DefaultTypeAdapter(); |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a Java Object from a result from V8. V8 can return |
|
||||||
* basic Java types, or V8Values (V8Object, V8Array, etc...). This method |
|
||||||
* will attempt to convert the result into a pure Java object using a |
|
||||||
* deep copy. |
|
||||||
* |
|
||||||
* If the input is basic Java type (Integer, Double, Boolean, String) |
|
||||||
* it will be returned. If the input is a V8Value, it will be converted. |
|
||||||
* |
|
||||||
* All elements in the V8Object are released after they are accessed. |
|
||||||
* However, the root object itself is not released. |
|
||||||
* |
|
||||||
* @param v8Object The input to convert. |
|
||||||
* @return A Java object representing the input. |
|
||||||
*/ |
|
||||||
public static Object getValue(final Object v8Object) { |
|
||||||
return getValue(v8Object, DEFAULT_TYPE_ADAPTER); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Create a Java Object from a result from V8 using a {@link TypeAdapter} to convert |
|
||||||
* objects. V8 can return basic Java types or V8Values (V8Object, V8Array, etc...). This |
|
||||||
* method will attempt to convert the result into a pure Java object using |
|
||||||
* a deep copy. |
|
||||||
* |
|
||||||
* If the input is basic Java type (Integer, Double, Boolean, String) |
|
||||||
* it will be returned. If the input is a V8Value, it will be converted. |
|
||||||
* |
|
||||||
* All elements in the V8Object are released after they are accessed. |
|
||||||
* However, the root object itself is not released. |
|
||||||
* |
|
||||||
* @param v8Object The input to convert. |
|
||||||
* @param adapter The {@link TypeAdapter} to use for the object conversions. |
|
||||||
* @return A Java object representing the input. |
|
||||||
*/ |
|
||||||
public static Object getValue(final Object v8Object, final TypeAdapter adapter) { |
|
||||||
V8Map<Object> cache = new V8Map<Object>(); |
|
||||||
try { |
|
||||||
if (v8Object instanceof V8Value) { |
|
||||||
int type = ((V8Value) v8Object).getV8Type(); |
|
||||||
return getValue(v8Object, type, cache, adapter); |
|
||||||
} else { |
|
||||||
return v8Object; |
|
||||||
} |
|
||||||
} finally { |
|
||||||
cache.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a Map from a V8Object using a deep copy. All elements |
|
||||||
* in the V8Object are released after they are accessed. However, the root |
|
||||||
* object itself is not released. |
|
||||||
* |
|
||||||
* @param object The root of the V8Object graph. |
|
||||||
* |
|
||||||
* @return A map representing a deep copy of the V8Object rooted at 'object'. |
|
||||||
*/ |
|
||||||
public static Map<String, ? super Object> toMap(final V8Object object) { |
|
||||||
return toMap(object, DEFAULT_TYPE_ADAPTER); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a Map from a V8Object using a deep copy and a TypeAdapter to handle |
|
||||||
* type conversions. All elements in the V8Object are released after they are accessed. |
|
||||||
* However, the root object itself is not released. |
|
||||||
* |
|
||||||
* @param object The root of the V8Object graph. |
|
||||||
* @param adapter The {@link TypeAdapter} to use for the object conversions. |
|
||||||
* |
|
||||||
* @return A map representing a deep copy of the V8Object rooted at 'object'. |
|
||||||
*/ |
|
||||||
public static Map<String, ? super Object> toMap(final V8Object object, final TypeAdapter adapter) { |
|
||||||
V8Map<Object> cache = new V8Map<Object>(); |
|
||||||
try { |
|
||||||
return toMap(object, cache, adapter); |
|
||||||
} finally { |
|
||||||
cache.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a List from a V8Array using a deep copy. All elements |
|
||||||
* in the V8Array are released after they are accessed. However, the root |
|
||||||
* array itself is not released. |
|
||||||
* |
|
||||||
* @param array The root of the V8Array graph. |
|
||||||
* |
|
||||||
* @return A list representing a deep copy of the V8Array rooted at 'array'. |
|
||||||
*/ |
|
||||||
public static List<? super Object> toList(final V8Array array) { |
|
||||||
return toList(array, DEFAULT_TYPE_ADAPTER); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a List from a V8Array using a deep copy and a TypeAdapter to handle |
|
||||||
* type conversions. All elements in the V8Array are released after they are accessed. |
|
||||||
* However, the root array itself is not released. |
|
||||||
* |
|
||||||
* @param array The root of the V8Array graph. |
|
||||||
* @param adapter The {@link TypeAdapter} to use for the object conversions. |
|
||||||
* |
|
||||||
* @return A list representing a deep copy of the V8Array rooted at 'array'. |
|
||||||
*/ |
|
||||||
public static List<? super Object> toList(final V8Array array, final TypeAdapter adapter) { |
|
||||||
V8Map<Object> cache = new V8Map<Object>(); |
|
||||||
try { |
|
||||||
return toList(array, cache, adapter); |
|
||||||
} finally { |
|
||||||
cache.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Populates a Java array from a V8Array. The type of the array must be specified. |
|
||||||
* Currently, only INTEGER, DOUBLE, BOOLEAN and STRING are supported. |
|
||||||
* The V8Array must only contain elements of type 'arrayType'. The result |
|
||||||
* can be optionally passed in as a parameter. |
|
||||||
* |
|
||||||
* This method will use J2V8's bulk array copy making it faster than iterating over |
|
||||||
* all the elements in the array. |
|
||||||
* |
|
||||||
* @param array The V8Array to convert to a Java Array. |
|
||||||
* @param arrayType The type of the V8Array to convert. |
|
||||||
* @param result The array to use as the result. If null, a new array will be created. |
|
||||||
* |
|
||||||
* @return A Java array representing a V8Array. |
|
||||||
*/ |
|
||||||
public static Object getTypedArray(final V8Array array, final int arrayType, final Object result) { |
|
||||||
int length = array.length(); |
|
||||||
if (arrayType == V8Value.INTEGER) { |
|
||||||
int[] intArray = (int[]) result; |
|
||||||
if ((intArray == null) || (intArray.length < length)) { |
|
||||||
intArray = new int[length]; |
|
||||||
} |
|
||||||
array.getIntegers(0, length, intArray); |
|
||||||
return intArray; |
|
||||||
} else if (arrayType == V8Value.DOUBLE) { |
|
||||||
double[] doubleArray = (double[]) result; |
|
||||||
if ((doubleArray == null) || (doubleArray.length < length)) { |
|
||||||
doubleArray = new double[length]; |
|
||||||
} |
|
||||||
array.getDoubles(0, length, doubleArray); |
|
||||||
return doubleArray; |
|
||||||
} else if (arrayType == V8Value.BOOLEAN) { |
|
||||||
boolean[] booleanArray = (boolean[]) result; |
|
||||||
if ((booleanArray == null) || (booleanArray.length < length)) { |
|
||||||
booleanArray = new boolean[length]; |
|
||||||
} |
|
||||||
array.getBooleans(0, length, booleanArray); |
|
||||||
return booleanArray; |
|
||||||
} else if (arrayType == V8Value.STRING) { |
|
||||||
String[] stringArray = (String[]) result; |
|
||||||
if ((stringArray == null) || (stringArray.length < length)) { |
|
||||||
stringArray = new String[length]; |
|
||||||
} |
|
||||||
array.getStrings(0, length, stringArray); |
|
||||||
return stringArray; |
|
||||||
} else if (arrayType == V8Value.BYTE) { |
|
||||||
byte[] byteArray = (byte[]) result; |
|
||||||
if ((byteArray == null) || (byteArray.length < length)) { |
|
||||||
byteArray = new byte[length]; |
|
||||||
} |
|
||||||
array.getBytes(0, length, byteArray); |
|
||||||
return byteArray; |
|
||||||
} |
|
||||||
throw new RuntimeException("Unsupported bulk load type: " + arrayType); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a Java array from a V8Array. The type of the Array must be specified. |
|
||||||
* Currently, only INTEGER, DOUBLE, BOOLEAN and STRING are supported. |
|
||||||
* The V8Array must only contain elements of type 'arrayType'. |
|
||||||
* |
|
||||||
* This method will use J2V8's bulk array copy making it faster than iterating over |
|
||||||
* all the elements in the array. |
|
||||||
* |
|
||||||
* @param array The V8Array to convert to a Java Array. |
|
||||||
* @param arrayType The type of the V8Array to convert. |
|
||||||
* |
|
||||||
* @return A Java array representing a V8Array. |
|
||||||
*/ |
|
||||||
public static Object getTypedArray(final V8Array array, final int arrayType) { |
|
||||||
int length = array.length(); |
|
||||||
if (arrayType == V8Value.INTEGER) { |
|
||||||
return array.getIntegers(0, length); |
|
||||||
} else if (arrayType == V8Value.DOUBLE) { |
|
||||||
return array.getDoubles(0, length); |
|
||||||
} else if (arrayType == V8Value.BOOLEAN) { |
|
||||||
return array.getBooleans(0, length); |
|
||||||
} else if (arrayType == V8Value.STRING) { |
|
||||||
return array.getStrings(0, length); |
|
||||||
} |
|
||||||
throw new RuntimeException("Unsupported bulk load type: " + arrayType); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a V8Object from a java.util.Map. This is a deep copy, so if the map |
|
||||||
* contains other maps (or lists) they will also be converted. |
|
||||||
* |
|
||||||
* @param v8 The runtime on which to create the result. |
|
||||||
* @param map The map to convert to a V8Object. |
|
||||||
* |
|
||||||
* @return A V8Object representing the map. |
|
||||||
*/ |
|
||||||
public static V8Object toV8Object(final V8 v8, final Map<String, ? extends Object> map) { |
|
||||||
Map<Object, V8Value> cache = new Hashtable<Object, V8Value>(); |
|
||||||
try { |
|
||||||
return toV8Object(v8, map, cache).twin(); |
|
||||||
} finally { |
|
||||||
for (V8Value v8Object : cache.values()) { |
|
||||||
v8Object.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Creates a V8Array from a java.util.List. This is a deep copy, so if the list |
|
||||||
* contains other lists (or maps) they will also be converted. |
|
||||||
* |
|
||||||
* @param v8 The runtime on which to create the result. |
|
||||||
* @param list The list to convert to a V8Array. |
|
||||||
* |
|
||||||
* @return A V8Array representing the list. |
|
||||||
*/ |
|
||||||
public static V8Array toV8Array(final V8 v8, final List<? extends Object> list) { |
|
||||||
Map<Object, V8Value> cache = new Hashtable<Object, V8Value>(); |
|
||||||
try { |
|
||||||
return toV8Array(v8, list, cache).twin(); |
|
||||||
} finally { |
|
||||||
for (V8Value v8Object : cache.values()) { |
|
||||||
v8Object.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Returns an object usable with a V8 Runtime which represents |
|
||||||
* the parameter 'value'. If 'value' is an Integer, Boolean, Double |
|
||||||
* or String, then 'value' is simply returned as these are directly |
|
||||||
* usable on V8. If 'value' is a map / list, then it's converted to |
|
||||||
* a V8Object / V8Array first. |
|
||||||
* |
|
||||||
* If the result is a V8Value, it must be released. |
|
||||||
* |
|
||||||
* @param v8 The runtime on which to create V8Values. |
|
||||||
* @param value The value to convert to an object usable with V8 |
|
||||||
* |
|
||||||
* @return An object which can be used directly with a V8 runtime. |
|
||||||
*/ |
|
||||||
public static Object getV8Result(final V8 v8, final Object value) { |
|
||||||
if (value == null) { |
|
||||||
return null; |
|
||||||
} |
|
||||||
Map<Object, V8Value> cache = new Hashtable<Object, V8Value>(); |
|
||||||
try { |
|
||||||
Object result = getV8Result(v8, value, cache); |
|
||||||
if (result instanceof V8Value) { |
|
||||||
return ((V8Value) result).twin(); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} finally { |
|
||||||
for (V8Value v8Object : cache.values()) { |
|
||||||
v8Object.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Pushes a Java Object to a V8Array by first converting it to a V8Value if needed. |
|
||||||
* If the value is a boxed primitive, then the primitive will be pushed. If the object |
|
||||||
* is a Map / List then a deep copy will be performed, converting the object to a |
|
||||||
* V8Object / V8Array first. |
|
||||||
* |
|
||||||
* @param v8 The runtime on which to create any needed V8Values. |
|
||||||
* @param array The array to push the elements to. |
|
||||||
* @param value The value to push to the array. |
|
||||||
*/ |
|
||||||
public static void pushValue(final V8 v8, final V8Array array, final Object value) { |
|
||||||
Map<Object, V8Value> cache = new Hashtable<Object, V8Value>(); |
|
||||||
try { |
|
||||||
pushValue(v8, array, value, cache); |
|
||||||
} finally { |
|
||||||
for (V8Value v8Object : cache.values()) { |
|
||||||
v8Object.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets a Java Object representing the value at the given index in the V8Array. |
|
||||||
* If the value is a primitive (int, boolean or double) then a boxed instance |
|
||||||
* is returned. If the value is a String, then a String is returned. If |
|
||||||
* the value is a V8Object or V8Array, then a Map or List is returned. |
|
||||||
* |
|
||||||
* @param array The array on which to lookup the value. The array is not |
|
||||||
* released. |
|
||||||
* @param index The index whose element to lookup. |
|
||||||
* |
|
||||||
* @return A Java Object representing the value at a given index. |
|
||||||
*/ |
|
||||||
public static Object getValue(final V8Array array, final int index) { |
|
||||||
V8Map<Object> cache = new V8Map<Object>(); |
|
||||||
Object object = null; |
|
||||||
int type = V8Value.UNDEFINED; |
|
||||||
try { |
|
||||||
object = array.get(index); |
|
||||||
type = array.getType(index); |
|
||||||
Object result = getValue(object, type, cache, DEFAULT_TYPE_ADAPTER); |
|
||||||
if ((result == object) && (result instanceof V8Value)) { |
|
||||||
return ((V8Value) result).twin(); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} finally { |
|
||||||
if (object instanceof Releasable) { |
|
||||||
((Releasable) object).release(); |
|
||||||
} |
|
||||||
cache.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets a Java Object representing the value at the given index in the V8Array. |
|
||||||
* A TypeAdapter is used to convert values from V8Objects to Java Objects. |
|
||||||
* If the value is a primitive (int, boolean or double) then a boxed instance |
|
||||||
* is returned. If the value is a String, then a String is returned. If |
|
||||||
* the value is a V8Object or V8Array, then a Map or List is returned. |
|
||||||
* |
|
||||||
* @param array The array on which to lookup the value. The array is not |
|
||||||
* released. |
|
||||||
* @param index The index whose element to lookup. |
|
||||||
* @param adapter The {@link TypeAdapter} to use for the object conversions. |
|
||||||
* |
|
||||||
* @return A Java Object representing the value at a given index. |
|
||||||
*/ |
|
||||||
public static Object getValue(final V8Array array, final int index, final TypeAdapter adapter) { |
|
||||||
V8Map<Object> cache = new V8Map<Object>(); |
|
||||||
Object object = null; |
|
||||||
int type = V8Value.UNDEFINED; |
|
||||||
try { |
|
||||||
object = array.get(index); |
|
||||||
type = array.getType(index); |
|
||||||
Object result = getValue(object, type, cache, adapter); |
|
||||||
if ((result == object) && (result instanceof V8Value)) { |
|
||||||
return ((V8Value) result).twin(); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} finally { |
|
||||||
if (object instanceof Releasable) { |
|
||||||
((Releasable) object).release(); |
|
||||||
} |
|
||||||
cache.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets a Java Object representing the value with the given key in the V8Object. |
|
||||||
* If the value is a primitive (int, boolean or double) then a boxed instance |
|
||||||
* is returned. If the value is a String, then a String is returned. If |
|
||||||
* the value is a V8Object or V8Array, then a Map or List is returned. |
|
||||||
* |
|
||||||
* @param object The object on which to lookup the value. The object is not |
|
||||||
* released. |
|
||||||
* @param key The key to use to lookup the value. |
|
||||||
* |
|
||||||
* @return A Java Object representing the value at a given key. |
|
||||||
*/ |
|
||||||
public static Object getValue(final V8Object object, final String key) { |
|
||||||
return getValue(object, key, DEFAULT_TYPE_ADAPTER); |
|
||||||
} |
|
||||||
|
|
||||||
/** |
|
||||||
* Gets a Java Object representing the value with the given key in the V8Object. |
|
||||||
* A TypeAdapter is used to convert values from V8Objects to Java Objects. |
|
||||||
* If the value is a primitive (int, boolean or double) then a boxed instance |
|
||||||
* is returned. If the value is a String, then a String is returned. If |
|
||||||
* the value is a V8Object or V8Array, then a Map or List is returned. |
|
||||||
* |
|
||||||
* @param v8Object The object on which to lookup the value. The object is not |
|
||||||
* released. |
|
||||||
* @param key The key to use to lookup the value. |
|
||||||
* @param adapter The {@link TypeAdapter} to use for the object conversions. |
|
||||||
* |
|
||||||
* @return A Java Object representing the value at a given key. |
|
||||||
*/ |
|
||||||
public static Object getValue(final V8Object v8Object, final String key, final TypeAdapter adapter) { |
|
||||||
V8Map<Object> cache = new V8Map<Object>(); |
|
||||||
Object object = null; |
|
||||||
int type = V8Value.UNDEFINED; |
|
||||||
try { |
|
||||||
object = v8Object.get(key); |
|
||||||
type = v8Object.getType(key); |
|
||||||
Object result = getValue(object, type, cache, adapter); |
|
||||||
if ((result == object) && (result instanceof V8Value)) { |
|
||||||
return ((V8Value) result).twin(); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} finally { |
|
||||||
if (object instanceof Releasable) { |
|
||||||
((Releasable) object).release(); |
|
||||||
} |
|
||||||
cache.close(); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@SuppressWarnings("unchecked") |
|
||||||
private static Map<String, ? super Object> toMap(final V8Object v8Object, final V8Map<Object> cache, final TypeAdapter adapter) { |
|
||||||
if (v8Object == null) { |
|
||||||
return Collections.emptyMap(); |
|
||||||
} |
|
||||||
if (cache.containsKey(v8Object)) { |
|
||||||
return (Map<String, ? super Object>) cache.get(v8Object); |
|
||||||
} |
|
||||||
Map<String, ? super Object> result = new V8PropertyMap<Object>(); |
|
||||||
cache.put(v8Object, result); |
|
||||||
String[] keys = v8Object.getKeys(); |
|
||||||
for (String key : keys) { |
|
||||||
Object object = null; |
|
||||||
int type = V8Value.UNDEFINED; |
|
||||||
try { |
|
||||||
object = v8Object.get(key); |
|
||||||
type = v8Object.getType(key); |
|
||||||
Object value = getValue(object, type, cache, adapter); |
|
||||||
if (value != IGNORE) { |
|
||||||
result.put(key, value); |
|
||||||
} |
|
||||||
} finally { |
|
||||||
if (object instanceof Releasable) { |
|
||||||
((Releasable) object).release(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
@SuppressWarnings("unchecked") |
|
||||||
private static List<? super Object> toList(final V8Array array, final V8Map<Object> cache, final TypeAdapter adapter) { |
|
||||||
if (array == null) { |
|
||||||
return Collections.emptyList(); |
|
||||||
} |
|
||||||
if (cache.containsKey(array)) { |
|
||||||
return (List<? super Object>) cache.get(array); |
|
||||||
} |
|
||||||
List<? super Object> result = new ArrayList<Object>(); |
|
||||||
cache.put(array, result); |
|
||||||
for (int i = 0; i < array.length(); i++) { |
|
||||||
Object object = null; |
|
||||||
int type = V8Value.UNDEFINED; |
|
||||||
try { |
|
||||||
object = array.get(i); |
|
||||||
type = array.getType(i); |
|
||||||
Object value = getValue(object, type, cache, adapter); |
|
||||||
if (value != IGNORE) { |
|
||||||
result.add(value); |
|
||||||
} |
|
||||||
} finally { |
|
||||||
if (object instanceof Releasable) { |
|
||||||
((Releasable) object).release(); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
private static V8TypedArray toV8TypedArray(final V8 v8, final TypedArray typeArray, final Map<Object, V8Value> cache) { |
|
||||||
if (cache.containsKey(typeArray)) { |
|
||||||
return (V8TypedArray) cache.get(typeArray); |
|
||||||
} |
|
||||||
V8TypedArray result = typeArray.getV8TypedArray(); |
|
||||||
cache.put(typeArray, result); |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
private static V8ArrayBuffer toV8ArrayBuffer(final V8 v8, final ArrayBuffer arrayBuffer, final Map<Object, V8Value> cache) { |
|
||||||
if (cache.containsKey(arrayBuffer)) { |
|
||||||
return (V8ArrayBuffer) cache.get(arrayBuffer); |
|
||||||
} |
|
||||||
V8ArrayBuffer result = arrayBuffer.getV8ArrayBuffer(); |
|
||||||
cache.put(arrayBuffer, result); |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
private static V8Object toV8Object(final V8 v8, final Map<String, ? extends Object> map, final Map<Object, V8Value> cache) { |
|
||||||
if (cache.containsKey(map)) { |
|
||||||
return (V8Object) cache.get(map); |
|
||||||
} |
|
||||||
V8Object result = new V8Object(v8); |
|
||||||
cache.put(map, result); |
|
||||||
try { |
|
||||||
for (Entry<String, ? extends Object> entry : map.entrySet()) { |
|
||||||
setValue(v8, result, entry.getKey(), entry.getValue(), cache); |
|
||||||
} |
|
||||||
} catch (IllegalStateException e) { |
|
||||||
result.close(); |
|
||||||
throw e; |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
private static V8Array toV8Array(final V8 v8, final List<? extends Object> list, final Map<Object, V8Value> cache) { |
|
||||||
if (cache.containsKey(new ListWrapper(list))) { |
|
||||||
return (V8Array) cache.get(new ListWrapper(list)); |
|
||||||
} |
|
||||||
V8Array result = new V8Array(v8); |
|
||||||
cache.put(new ListWrapper(list), result); |
|
||||||
try { |
|
||||||
for (int i = 0; i < list.size(); i++) { |
|
||||||
Object value = list.get(i); |
|
||||||
pushValue(v8, result, value, cache); |
|
||||||
} |
|
||||||
} catch (IllegalStateException e) { |
|
||||||
result.close(); |
|
||||||
throw e; |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
@SuppressWarnings("unchecked") |
|
||||||
private static Object getV8Result(final V8 v8, final Object value, final Map<Object, V8Value> cache) { |
|
||||||
if (cache.containsKey(value)) { |
|
||||||
return cache.get(value); |
|
||||||
} |
|
||||||
if (value instanceof Map<?, ?>) { |
|
||||||
return toV8Object(v8, (Map<String, ? extends Object>) value, cache); |
|
||||||
} else if (value instanceof List<?>) { |
|
||||||
return toV8Array(v8, (List<? extends Object>) value, cache); |
|
||||||
} else if (value instanceof TypedArray) { |
|
||||||
return toV8TypedArray(v8, (TypedArray) value, cache); |
|
||||||
} else if (value instanceof ArrayBuffer) { |
|
||||||
return toV8ArrayBuffer(v8, (ArrayBuffer) value, cache); |
|
||||||
} |
|
||||||
return value; |
|
||||||
} |
|
||||||
|
|
||||||
@SuppressWarnings({ "unchecked", "rawtypes", "resource" }) |
|
||||||
private static void pushValue(final V8 v8, final V8Array result, final Object value, final Map<Object, V8Value> cache) { |
|
||||||
if (value == null) { |
|
||||||
result.pushUndefined(); |
|
||||||
} else if (value instanceof Integer) { |
|
||||||
result.push(value); |
|
||||||
} else if (value instanceof Long) { |
|
||||||
result.push(new Double((Long) value)); |
|
||||||
} else if (value instanceof Double) { |
|
||||||
result.push(value); |
|
||||||
} else if (value instanceof Float) { |
|
||||||
result.push(value); |
|
||||||
} else if (value instanceof String) { |
|
||||||
result.push((String) value); |
|
||||||
} else if (value instanceof Boolean) { |
|
||||||
result.push(value); |
|
||||||
} else if (value instanceof TypedArray) { |
|
||||||
V8TypedArray v8TypedArray = toV8TypedArray(v8, (TypedArray) value, cache); |
|
||||||
result.push(v8TypedArray); |
|
||||||
} else if (value instanceof ArrayBuffer) { |
|
||||||
V8ArrayBuffer v8ArrayBuffer = toV8ArrayBuffer(v8, (ArrayBuffer) value, cache); |
|
||||||
result.push(v8ArrayBuffer); |
|
||||||
} else if (value instanceof V8Value) { |
|
||||||
result.push((V8Value) value); |
|
||||||
} else if (value instanceof Map) { |
|
||||||
V8Object object = toV8Object(v8, (Map) value, cache); |
|
||||||
result.push(object); |
|
||||||
} else if (value instanceof List) { |
|
||||||
V8Array array = toV8Array(v8, (List) value, cache); |
|
||||||
result.push(array); |
|
||||||
} else { |
|
||||||
throw new IllegalStateException("Unsupported Object of type: " + value.getClass()); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
@SuppressWarnings({ "unchecked", "rawtypes", "resource" }) |
|
||||||
private static void setValue(final V8 v8, final V8Object result, final String key, final Object value, final Map<Object, V8Value> cache) { |
|
||||||
if (value == null) { |
|
||||||
result.addUndefined(key); |
|
||||||
} else if (value instanceof Integer) { |
|
||||||
result.add(key, (Integer) value); |
|
||||||
} else if (value instanceof Long) { |
|
||||||
result.add(key, (Long) value); |
|
||||||
} else if (value instanceof Double) { |
|
||||||
result.add(key, (Double) value); |
|
||||||
} else if (value instanceof Float) { |
|
||||||
result.add(key, (Float) value); |
|
||||||
} else if (value instanceof String) { |
|
||||||
result.add(key, (String) value); |
|
||||||
} else if (value instanceof Boolean) { |
|
||||||
result.add(key, (Boolean) value); |
|
||||||
} else if (value instanceof TypedArray) { |
|
||||||
V8TypedArray v8TypedArray = toV8TypedArray(v8, (TypedArray) value, cache); |
|
||||||
result.add(key, v8TypedArray); |
|
||||||
} else if (value instanceof ArrayBuffer) { |
|
||||||
V8ArrayBuffer v8ArrayBuffer = toV8ArrayBuffer(v8, (ArrayBuffer) value, cache); |
|
||||||
result.add(key, v8ArrayBuffer); |
|
||||||
} else if (value instanceof V8Value) { |
|
||||||
result.add(key, (V8Value) value); |
|
||||||
} else if (value instanceof Map) { |
|
||||||
V8Object object = toV8Object(v8, (Map) value, cache); |
|
||||||
result.add(key, object); |
|
||||||
} else if (value instanceof List) { |
|
||||||
V8Array array = toV8Array(v8, (List) value, cache); |
|
||||||
result.add(key, array); |
|
||||||
} else { |
|
||||||
throw new IllegalStateException("Unsupported Object of type: " + value.getClass()); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private static Object getValue(final Object value, final int valueType, final V8Map<Object> cache, final TypeAdapter adapter) { |
|
||||||
Object adapterResult = adapter.adapt(valueType, value); |
|
||||||
if (TypeAdapter.DEFAULT != adapterResult) { |
|
||||||
return adapterResult; |
|
||||||
} |
|
||||||
switch (valueType) { |
|
||||||
case V8Value.INTEGER: |
|
||||||
case V8Value.DOUBLE: |
|
||||||
case V8Value.BOOLEAN: |
|
||||||
case V8Value.STRING: |
|
||||||
return value; |
|
||||||
case V8Value.V8_FUNCTION: |
|
||||||
return IGNORE; |
|
||||||
case V8Value.V8_ARRAY_BUFFER: |
|
||||||
return new ArrayBuffer((V8ArrayBuffer) value); |
|
||||||
case V8Value.V8_TYPED_ARRAY: |
|
||||||
return new TypedArray((V8TypedArray) value); |
|
||||||
case V8Value.V8_ARRAY: |
|
||||||
return toList((V8Array) value, cache, adapter); |
|
||||||
case V8Value.V8_OBJECT: |
|
||||||
return toMap((V8Object) value, cache, adapter); |
|
||||||
case V8Value.NULL: |
|
||||||
return null; |
|
||||||
case V8Value.UNDEFINED: |
|
||||||
return V8.getUndefined(); |
|
||||||
default: |
|
||||||
throw new IllegalStateException("Cannot convert type " + V8Value.getStringRepresentation(valueType)); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
private V8ObjectUtils() { |
|
||||||
|
|
||||||
} |
|
||||||
|
|
||||||
static class DefaultTypeAdapter implements TypeAdapter { |
|
||||||
@Override |
|
||||||
public Object adapt(final int type, final Object value) { |
|
||||||
return TypeAdapter.DEFAULT; |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
static class ListWrapper { |
|
||||||
private List<? extends Object> list; |
|
||||||
|
|
||||||
public ListWrapper(final List<? extends Object> list) { |
|
||||||
this.list = list; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public boolean equals(final Object obj) { |
|
||||||
if (obj instanceof ListWrapper) { |
|
||||||
return ((ListWrapper) obj).list == list; |
|
||||||
} |
|
||||||
return false; |
|
||||||
} |
|
||||||
|
|
||||||
@Override |
|
||||||
public int hashCode() { |
|
||||||
return System.identityHashCode(list); |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
@ -1,176 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import java.util.AbstractMap.SimpleEntry; |
|
||||||
import java.util.ArrayList; |
|
||||||
import java.util.Collection; |
|
||||||
import java.util.HashSet; |
|
||||||
import java.util.Hashtable; |
|
||||||
import java.util.Map; |
|
||||||
import java.util.Set; |
|
||||||
|
|
||||||
/** |
|
||||||
* A custom map is needed because the existing HashMaps |
|
||||||
* do not allow self containment, and Hashtables do not |
|
||||||
* allow nulls as values. |
|
||||||
* |
|
||||||
* This class is not considered API. |
|
||||||
*/ |
|
||||||
class V8PropertyMap<V> implements Map<String, V> { |
|
||||||
|
|
||||||
private Hashtable<String, V> map = new Hashtable<String, V>(); |
|
||||||
private Set<String> nulls = new HashSet<String>(); |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#size() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public int size() { |
|
||||||
return map.size() + nulls.size(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#isEmpty() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean isEmpty() { |
|
||||||
return map.isEmpty() && nulls.isEmpty(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#containsKey(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean containsKey(final Object key) { |
|
||||||
return map.containsKey(key) || nulls.contains(key); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#containsValue(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public boolean containsValue(final Object value) { |
|
||||||
if ((value == null) && !nulls.isEmpty()) { |
|
||||||
return true; |
|
||||||
} else if (value == null) { |
|
||||||
return false; |
|
||||||
} |
|
||||||
return map.containsValue(value); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#get(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V get(final Object key) { |
|
||||||
if (nulls.contains(key)) { |
|
||||||
return null; |
|
||||||
} |
|
||||||
return map.get(key); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#put(java.lang.Object, java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V put(final String key, final V value) { |
|
||||||
if (value == null) { |
|
||||||
if (map.containsKey(key)) { |
|
||||||
map.remove(key); |
|
||||||
} |
|
||||||
nulls.add(key); |
|
||||||
return null; |
|
||||||
} |
|
||||||
if (nulls.contains(key)) { |
|
||||||
nulls.remove(key); |
|
||||||
} |
|
||||||
return map.put(key, value); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#remove(java.lang.Object) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public V remove(final Object key) { |
|
||||||
if (nulls.contains(key)) { |
|
||||||
nulls.remove(key); |
|
||||||
return null; |
|
||||||
} |
|
||||||
return map.remove(key); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#putAll(java.util.Map) |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void putAll(final Map<? extends String, ? extends V> m) { |
|
||||||
for (Entry<? extends String, ? extends V> entry : m.entrySet()) { |
|
||||||
this.put(entry.getKey(), entry.getValue()); |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#clear() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void clear() { |
|
||||||
map.clear(); |
|
||||||
nulls.clear(); |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#keySet() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Set<String> keySet() { |
|
||||||
HashSet<String> result = new HashSet<String>(map.keySet()); |
|
||||||
result.addAll(nulls); |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#values() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Collection<V> values() { |
|
||||||
ArrayList<V> result = new ArrayList<V>(map.values()); |
|
||||||
for (int i = 0; i < nulls.size(); i++) { |
|
||||||
result.add(null); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.util.Map#entrySet() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public Set<Entry<String, V>> entrySet() { |
|
||||||
HashSet<Entry<String, V>> result = new HashSet<Map.Entry<String, V>>(map.entrySet()); |
|
||||||
for (String nullKey : nulls) { |
|
||||||
result.add(new SimpleEntry<String, V>(nullKey, null)); |
|
||||||
} |
|
||||||
return result; |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,29 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
|
|
||||||
/** |
|
||||||
* Classes can implement this interface to execute arbitrary code on |
|
||||||
* isolated V8 runtime on its own thread. Instances of classes that |
|
||||||
* implement this interface can be passed to V8Thread. |
|
||||||
*/ |
|
||||||
public interface V8Runnable { |
|
||||||
|
|
||||||
/** |
|
||||||
* Execute the code on the provided runtime. |
|
||||||
* |
|
||||||
* @param runtime The V8 runtime assigned to this runnable. |
|
||||||
*/ |
|
||||||
public void run(final V8 runtime); |
|
||||||
|
|
||||||
} |
|
||||||
@ -1,57 +0,0 @@ |
|||||||
/******************************************************************************* |
|
||||||
* Copyright (c) 2015 EclipseSource and others. |
|
||||||
* All rights reserved. This program and the accompanying materials |
|
||||||
* are made available under the terms of the Eclipse Public License v1.0 |
|
||||||
* which accompanies this distribution, and is available at |
|
||||||
* http://www.eclipse.org/legal/epl-v10.html
|
|
||||||
* |
|
||||||
* Contributors: |
|
||||||
* EclipseSource - initial API and implementation |
|
||||||
******************************************************************************/ |
|
||||||
package com.eclipsesource.v8.utils; |
|
||||||
|
|
||||||
import com.eclipsesource.v8.V8; |
|
||||||
|
|
||||||
/** |
|
||||||
* A Thread with its own V8 runtime. The thread will create a runtime, |
|
||||||
* and execute a runnable on that runtime. When the thread ends, |
|
||||||
* the runtime will be released. |
|
||||||
* |
|
||||||
* It's suggested that you *DO NOT* release the lock on the runtime. |
|
||||||
* If the lock is released, you will need to ensure that the runtime |
|
||||||
* is properly released. |
|
||||||
*/ |
|
||||||
public class V8Thread extends Thread { |
|
||||||
|
|
||||||
private final V8Runnable target; |
|
||||||
private V8 runtime; |
|
||||||
|
|
||||||
/** |
|
||||||
* Create as new Thread with its own V8Runtime. |
|
||||||
* |
|
||||||
* @param target The code to execute with the given runtime. |
|
||||||
*/ |
|
||||||
public V8Thread(final V8Runnable target) { |
|
||||||
this.target = target; |
|
||||||
} |
|
||||||
|
|
||||||
/* |
|
||||||
* (non-Javadoc) |
|
||||||
* @see java.lang.Thread#run() |
|
||||||
*/ |
|
||||||
@Override |
|
||||||
public void run() { |
|
||||||
runtime = V8.createV8Runtime(); |
|
||||||
try { |
|
||||||
target.run(runtime); |
|
||||||
} finally { |
|
||||||
synchronized (this) { |
|
||||||
if (runtime.getLocker().hasLock()) { |
|
||||||
runtime.close(); |
|
||||||
runtime = null; |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
} |
|
||||||
|
|
||||||
} |
|
||||||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading…
Reference in new issue