com.linar.jintegra
Class Jvm

java.lang.Object
  com.linar.jintegra.Jvm

All Implemented Interfaces:

com.linar.jintegra.IJintegraJvm2, Instanciator

public final class Jvm
extends java.lang.Object
implements com.linar.jintegra.IJintegraJvm2, Instanciator

The JVM class is used to register the JVM id. This is a logical registration within the J-Integra® runtime. Registering the JVM id enables access to Java objects from DCOM.

The regjvm (or regjvmcmd) utility must also be used to register the JVM id with COM. It achieves this by creating the required registry entries for COM to work correctly.

Clients wishing to connect to an instance of this JVM must use the id for the JVM as passed to the register method.

instanciate

public java.lang.Object instanciate(java.lang.String javaClass)
                             throws AutomationException

For internal use only - never call this method.

Specified by:

instanciate in interface Instanciator

Parameters:

javaClass - The name of the Java class to be instanciated

Returns:

return value. A reference to the instanciated object

Throws:

AutomationException - If any other exception occurs.

getDllHandle

public static int getDllHandle()

For internal use only - never call this method.

getRef

public com.linar.jintegra.IJintegraJvm2 getRef(java.lang.String jvmId,
                                               java.lang.String dllPath,
                                               java.lang.String versionStr,
                                               int dllHandle)

For internal use only - never call this method.

Specified by:

getRef in interface com.linar.jintegra.IJintegraJvm2

get

public java.lang.Object get(java.lang.String className)
                     throws java.lang.Exception

For internal use only - never call this method.

Throws:

java.lang.Exception

newInstance

public java.lang.Object newInstance(java.lang.String jvmId,
                                    java.lang.String javaClass)
                             throws AutomationException

For internal use only - never call this method.

Specified by:

newInstance in interface com.linar.jintegra.IJintegraJvm2

Throws:

AutomationException

init

public static void init()

For internal use only - never call this method.

init

public static void init(int dcomPort)

For internal use only - never call this method.

getMoniker

public static java.lang.String getMoniker()
                                   throws java.io.IOException

For internal use only - never call this method.

Throws:

java.io.IOException

register

public static void register(java.lang.String id)

Registers a JVM id with the J-Integra® runtime.

Parameters:

id - this is the JVM id as configured using the regjvm utility.

register

public static void register(java.lang.String id,
                            int dcomPort)

Registers a JVM id with the J-Integra® runtime.

Parameters:

id - this is the JVM id as configured using the regjvm utility.

dcomPort - this is the tcp/ip port number that J-Integra® should use for DCOM communications. It must match the port number used in the regjvm utility.

register

public static void register(java.lang.String id,
                            Instanciator instanciator)

Registers a JVM id with the J-Integra® runtime.

Parameters:

id - this is the JVM id as configured using the regjvm utility.

instanciator - a custom instanciator allowing you to control how objects are created.

register

public static void register(java.lang.String id,
                            Instanciator instanciator,
                            int dcomPort)

Registers a JVM id with the J-Integra® runtime.

Parameters:

id - this is the JVM id as configured using the regjvm utility.

instanciator - a custom instanciator allowing you to control how objects are created.

dcomPort - this is the tcp/ip port number that J-Integra® should use for DCOM communications. It must match the port number used in the regjvm utility.