com.esri.arcgis.interop
Class Jvm

java.lang.Object
  com.esri.arcgis.interop.Jvm

All Implemented Interfaces:

IJintegraJvm2, Instanciator

public final class Jvm

extends java.lang.Object

implements 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.

Field Summary

Fields inherited from interface com.esri.arcgis.interop.IJintegraJvm2

DISPID_1_NAME, DISPID_2_NAME, IID, IID652f3880_2c14_11d4_b75f_204c4f4f5020, xxDummy

Method Summary

java.lang.Object	get(java.lang.String className) For internal use only - never call this method.
static int	getDllHandle() For internal use only - never call this method.
static java.lang.String	getMoniker() For internal use only - never call this method.
IJintegraJvm2	getRef(java.lang.String jvmId, java.lang.String dllPath, java.lang.String versionStr, int dllHandle) For internal use only - never call this method.
static void	init() For internal use only - never call this method.
static void	init(int dcomPort) For internal use only - never call this method.
java.lang.Object	instanciate(java.lang.String javaClass) For internal use only - never call this method.
java.lang.Object	newInstance(java.lang.String jvmId, java.lang.String javaClass) For internal use only - never call this method.
static void	register(java.lang.String id) Registers a JVM id with the J-Integra runtime.
static void	register(java.lang.String id, Instanciator instanciator) Registers a JVM id with the J-Integra runtime.
static void	register(java.lang.String id, Instanciator instanciator, int dcomPort) Registers a JVM id with the J-Integra runtime.
static void	register(java.lang.String id, int dcomPort) Registers a JVM id with the J-Integra runtime.

Methods inherited from class java.lang.Object

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

Method Detail

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 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 IJintegraJvm2

Parameters:

jvmId - The jvmId (in)

dllPath - The dllPath (in)

versionStr - The versionStr (in)

dllHandle - The dllHandle (in)

Returns:

return value. An reference to a 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 IJintegraJvm2

Parameters:

jvmId - The jvmId (in)

javaClass - The javaClass (in)

Returns:

return value. A reference to another Automation Object (IDispatch)

Throws:

AutomationException - If the remote server throws an exception.

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.