com.caoccao.javet.interop

Class V8Host

java.lang.Object

com.caoccao.javet.interop.V8Host

All Implemented Interfaces:

java.lang.AutoCloseable

public final class V8Host
extends java.lang.Object
implements java.lang.AutoCloseable

The type V8 host.

Since:

0.7.0

Method Summary

Modifier and Type	Method and Description
void	clearInternalStatistic() Clear internal statistic for internal test purpose.
void	close()
void	closeV8Runtime(V8Runtime v8Runtime) Close V8 runtime.
<R extends V8Runtime> R	createV8Runtime() Create V8 runtime.
<R extends V8Runtime> R	createV8Runtime(boolean pooled, RuntimeOptions<?> runtimeOptions) Create V8 runtime by pooled flag and custom global name.
<R extends V8Runtime> R	createV8Runtime(RuntimeOptions<?> runtimeOptions) Create V8 runtime by custom global name.
V8Host	disableGCNotification() Disable GC notification.
V8Host	enableGCNotification() Enable GC notification.
static V8Host	getInstance(JSRuntimeType jsRuntimeType) Gets instance by JS runtime type.
long[]	getInternalStatistic() Get internal statistic for test purpose.
java.lang.String	getJavetVersion() Gets javet version.
JSRuntimeType	getJSRuntimeType() Gets JS runtime type.
JavetException	getLastException() Gets last exception.
IJavetLogger	getLogger() Gets logger.
static double	getMemoryUsageThresholdRatio() Gets memory usage threshold ratio.
static V8Host	getNodeInstance() Gets Node instance.
static V8Host	getV8Instance() Gets V8 instance.
int	getV8RuntimeCount() Gets V8 runtime count.
V8SharedMemoryStatistics	getV8SharedMemoryStatistics() Gets V8 shared memory statistics.
boolean	isIsolateCreated() Is isolate created.
boolean	isLibraryLoaded() Is library loaded.
static boolean	isLibraryReloadable() Determines whether the JNI library is reloadable or not.
boolean	loadLibrary() Load library.
static void	setLibraryReloadable(boolean libraryReloadable) Sets whether the JNI library is reloadable or not.
static void	setMemoryUsageThresholdRatio(double memoryUsageThresholdRatio) Sets memory usage threshold ratio.
boolean	unloadLibrary() Unload library.

Methods inherited from class java.lang.Object

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

Method Detail

getInstance

public static V8Host getInstance(JSRuntimeType jsRuntimeType)

Gets instance by JS runtime type.

Parameters:

jsRuntimeType - the JS runtime type

Returns:

the instance

Since:

0.7.0

getMemoryUsageThresholdRatio

public static double getMemoryUsageThresholdRatio()

Gets memory usage threshold ratio.

Returns:

the memory usage threshold ratio

Since:

0.8.3

getNodeInstance

public static V8Host getNodeInstance()

Gets Node instance.

Note: Node runtime library is loaded by a custom class loader.

Returns:

the Node instance

Since:

0.8.0

getV8Instance

public static V8Host getV8Instance()

Gets V8 instance.

Note: V8 runtime library is loaded by a custom class loader.

Returns:

the V8 instance

Since:

0.8.0

isLibraryReloadable

public static boolean isLibraryReloadable()

Determines whether the JNI library is reloadable or not.

Returns:

true : reloadable, false: not reloadable, default: false

Since:

0.9.1

setLibraryReloadable

public static void setLibraryReloadable(boolean libraryReloadable)

Sets whether the JNI library is reloadable or not.

Parameters:

libraryReloadable - true: reloadable, false: not reloadable

Since:

0.9.1

setMemoryUsageThresholdRatio

public static void setMemoryUsageThresholdRatio(double memoryUsageThresholdRatio)

Sets memory usage threshold ratio.

This manageable usage threshold attribute is designed for monitoring the increasing trend of memory usage with low overhead.

Parameters:

memoryUsageThresholdRatio - the memory usage threshold ratio

Since:

0.8.3

clearInternalStatistic

public void clearInternalStatistic()

Clear internal statistic for internal test purpose.

Since:

0.8.3

close

public void close()
           throws JavetException

Specified by:

close in interface java.lang.AutoCloseable

Throws:

JavetException

closeV8Runtime

public void closeV8Runtime(V8Runtime v8Runtime)

Close V8 runtime.

Parameters:

v8Runtime - the V8 runtime

Since:

0.7.0

createV8Runtime

public <R extends V8Runtime> R createV8Runtime()
                                        throws JavetException

Create V8 runtime.

Type Parameters:

R - the type parameter

Returns:

the V8 runtime

Throws:

JavetException - the javet exception

Since:

0.7.0

createV8Runtime

public <R extends V8Runtime> R createV8Runtime(RuntimeOptions<?> runtimeOptions)
                                        throws JavetException

Create V8 runtime by custom global name.

Type Parameters:

R - the type parameter

Parameters:

runtimeOptions - the runtime options

Returns:

the V8 runtime

Throws:

JavetException - the javet exception

Since:

0.7.0

createV8Runtime

public <R extends V8Runtime> R createV8Runtime(boolean pooled,
                                               RuntimeOptions<?> runtimeOptions)
                                        throws JavetException

Create V8 runtime by pooled flag and custom global name.

Type Parameters:

R - the type parameter

Parameters:

pooled - the pooled

runtimeOptions - the runtime options

Returns:

the V8 runtime

Throws:

JavetException - the javet exception

Since:

0.7.0

disableGCNotification

public V8Host disableGCNotification()

Disable GC notification.

Returns:

the self

Since:

0.8.3

enableGCNotification

public V8Host enableGCNotification()

Enable GC notification.

Returns:

the self

Since:

0.8.3

getInternalStatistic

public long[] getInternalStatistic()

Get internal statistic for test purpose.

Returns:

the internal statistic

Since:

0.8.3

getJSRuntimeType

public JSRuntimeType getJSRuntimeType()

Gets JS runtime type.

Returns:

the JS runtime type

Since:

0.8.0

getJavetVersion

public java.lang.String getJavetVersion()

Gets javet version.

Returns:

the javet version

Since:

0.7.1

getLastException

public JavetException getLastException()

Gets last exception.

Returns:

the last exception

Since:

0.7.0

getLogger

public IJavetLogger getLogger()

Gets logger.

Returns:

the logger

Since:

0.7.3

getV8RuntimeCount

public int getV8RuntimeCount()

Gets V8 runtime count.

Returns:

the V8 runtime count

Since:

0.8.0

getV8SharedMemoryStatistics

public V8SharedMemoryStatistics getV8SharedMemoryStatistics()

Gets V8 shared memory statistics.

Returns:

the V8 shared memory statistics

Since:

1.0.6

isIsolateCreated

public boolean isIsolateCreated()

Is isolate created.

Returns:

true : created, false: not created

Since:

0.8.0

isLibraryLoaded

public boolean isLibraryLoaded()

Is library loaded.

Returns:

true : loaded, false: not loaded

Since:

0.8.0

loadLibrary

public boolean loadLibrary()

Load library.

Note: setLibraryReloadable(true) must be called, otherwise, JVM will crash.

Returns:

true : library is loaded, false: library is not loaded

Since:

0.9.1

unloadLibrary

public boolean unloadLibrary()

Unload library.

Note: setLibraryReloadable(true) must be called, otherwise, JVM will crash.

Returns:

true : library is unloaded, false: library is loaded

Since:

0.9.1