info/CWS jl13 : jvmfwk API changes

Type
info

Title
jvmfwk API changes

Posted by
[email protected]

Affected
[email protected],

Effective from
CWS jl13

Summary

changed default mode, normal mode

-error code JFW_E_DEFAULT_MODE
-error code JFW_E_FORMAT_STORE
-error code JFW_E_CONFIG_READ_WRITE
+error code JFW_E_CONFIGURATION

changed function jfw_plugin_getAllJavaInfos
changed function jfw_jfw_getSelectedJRE

Description

The Java Framework had two modes, a so-called default mode and a
"normal mode". The default mode was basically a hack that allowed to
use regcomp for registering Java components in our environment. In
that mode the environment variables CLASSPATH and JAVA_HOME were used.
Now there is an application mode and a direct mode. The documentation
will be kept in jvmfwk/framework.h.

Error codes:

Most functions returned JFW_E_FORMAT_STORE and/or
JFW_E_CONFIG_READ_WRITE. Because the caller could not conclude any
other sensible information other then something did not work, they
were abolished. No simply JFW_E_ERROR is returned.
JFW_E_DEFAULT mode was replaced by JFW_E_DIRECT_MODE. It can be
returned by all functions which depend on any of the configuration
files for the framework.
JFW_E_CONFIGURATION will be returned if any of the configuration
cannot be accessed, bootrap variables carry wrong values, or there is
a mismatch of bootstrap variables (mixing of variables for both modes
is not allowed).

jfw_getSelectedJRE (jvmfwk/framework.h)
The function also returnes information about the JRE in direct mode.
Then information about the JRE which is determined by the bootstrap
variable UNO_JAVA_JFW_JREHOME is returned.

jfw_plugin_getAllJavaInfos (jvmfwk/vendorplugin.h)
The function shall now also provide information about JRE
installation, even if no vendor is specified. Have a look at the
header for more information.

---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]