JavaConfig (NetPhantom® 8.0 Java API Specification)

java.lang.Object
- se.entra.phantom.server.VirtualPanelAdapter
- - se.entra.phantom.server.VirtualComponentAdapter
  - - se.entra.phantom.server.phed.JavaConfig

All Implemented Interfaces:
VirtualComponentListener, VirtualPanelListener
```
public class JavaConfig
extends VirtualComponentAdapter
```
This class handles the Java configuration dialog box.
Author:
Christopher Mindus

Nested Class Summary
Nested Classes
Modifier and Type Class and Description
static class JavaConfig.JavaInfo
Class used to get the information of the Java running process and it's environment.

Nested Classes
Modifier and Type	Class and Description
`static class`	`JavaConfig.JavaInfo` Class used to get the information of the Java running process and it's environment.

Field Summary
- Fields inherited from interface se.entra.phantom.server.VirtualPanelListener
  ICON_CRITICAL, ICON_INFORMATION, ICON_NOICON, ICON_QUERY, ICON_QUESTION, ICON_WARNING, MB_ABORTRETRYIGNORE, MB_CANCEL, MB_ENTER, MB_ENTERCANCEL, MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_YESNO, MB_YESNOCANCEL, MBID_CANCEL, MBID_DEFAULT, MBID_ENTER, MBID_IGNORE, MBID_NO, MBID_OK, MBID_RETRY, MBID_YES

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static String`	`addJavaVersionSpecificOptions(String params, int ver)` Adds "-Xss1m" if none is specified for Java 16 or better to workaround for bug in Java 16-17.0.2 (or perhaps higher).
`static int`	`getClientJavaVersion()` Gets the configured Java version of the Client.
`static PhantomRuntime`	`getEditorParallelRuntime(ClientSession cs)` Called when the client session attempts to connect to the Editor with a Parallel Run session.
`static int`	`getJVMDebuggingPort()` Gets the JVM debugging port.
`static int`	`getTargetServerJavaVersion()` Gets the configured target Java version of the Server.
`static void`	`initJavaCombo(VirtualPanel vp, int ver)` Fills the "JAVA" combobox with versions MIN to MAX.
`void`	`onAction(VirtualPanel vp, String controlID)` Push buttons and menu items generates this event when selected.
`void`	`onCheckedChange(VirtualPanel vp, VirtualControl control, String controlID, int state)` Checkbox changes.
`void`	`onContentChanged(VirtualPanel vp, VirtualControl control, String controlID, String text)` Entry fields and multiple line entry fields generates this message.
`void`	`onContentChanged(VirtualPanel panelvp, VirtualControl control, String controlID, String text, int line)` Combination boxes and spin buttons generates this message.
`static String`	`onEclipseLaunchClient(EclipseProject project, String mode)` Eclipse will launch the client in Parallel Run and this method is called to begin loading the application.
`void`	`onPanelCreate(VirtualPanel vp)` Upon panel creation, the INI file initializes the dialog box.
`static String`	`saveBuildBeforeRun(boolean doSignClientJarFiles, Consumer<String> callback)` Eclipse will launch the client in Parallel Run and this method is called to begin loading the application.
`static String`	`validateJavaDirectory(String dir)` Validates a Java 8/9/...

Methods inherited from class se.entra.phantom.server.VirtualComponentAdapter
onAction, onAction, onControlEvent, onFocusGained, onFocusLost, onMenuAction, onPropertyChange, onSelectionChanged

Methods inherited from class se.entra.phantom.server.VirtualPanelAdapter
onModalPanelCreate, onModalPanelProcessing, onPageActivated, onPanelClose, onPanelClosing, onPanelDestroy

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface se.entra.phantom.server.VirtualPanelListener
onPageActivated, onPanelClose, onPanelClosing, onPanelDestroy

- Method Detail
  - addJavaVersionSpecificOptions
```
public static String addJavaVersionSpecificOptions(String params,
                                                   int ver)
```
    Adds "-Xss1m" if none is specified for Java 16 or better to workaround for bug in Java 16-17.0.2 (or perhaps higher). This bug has been reported to the Java team.
    For Java 25, add another option: "--enable-native-access=ALL-UNNAMED".
    Parameters:
    params - The parameters.
    ver - The version.
    Returns:
    String if modified, otherwise the original string.
  - onEclipseLaunchClient
```
public static String onEclipseLaunchClient(EclipseProject project,
                                           String mode)
```
    Eclipse will launch the client in Parallel Run and this method is called to begin loading the application.
  - saveBuildBeforeRun
```
public static String saveBuildBeforeRun(boolean doSignClientJarFiles,
                                        Consumer<String> callback)
```
    Eclipse will launch the client in Parallel Run and this method is called to begin loading the application.
  - getEditorParallelRuntime
```
public static PhantomRuntime getEditorParallelRuntime(ClientSession cs)
```
    Called when the client session attempts to connect to the Editor with a Parallel Run session.
    Returns:
    true to accept, false to disconnect client without message.
  - initJavaCombo
```
public static void initJavaCombo(VirtualPanel vp,
                                 int ver)
```
    Fills the "JAVA" combobox with versions MIN to MAX.
  - onPanelCreate
```
public void onPanelCreate(VirtualPanel vp)
```
    Upon panel creation, the INI file initializes the dialog box.
    Specified by:
    onPanelCreate in interface VirtualPanelListener
    Overrides:
    onPanelCreate in class VirtualPanelAdapter
    Parameters:
    vp - The panel issuing the event.
  - onContentChanged
```
public void onContentChanged(VirtualPanel panelvp,
                             VirtualControl control,
                             String controlID,
                             String text,
                             int line)
```
    Combination boxes and spin buttons generates this message. The line parameter is set to -1 if no line is selected.
    The default implementation in this adapter calls onContentChanged(panel,control,controlID,text).
    Specified by:
    onContentChanged in interface VirtualComponentListener
    Overrides:
    onContentChanged in class VirtualComponentAdapter
    Parameters:
    panelvp - The panel issuing the event, parent of the control.
    control - The control issuing the event.
    controlID - The control ID issuing the event.
    text - The control text contents.
    line - The selected line, or -1 for none.
  - onContentChanged
```
public void onContentChanged(VirtualPanel vp,
                             VirtualControl control,
                             String controlID,
                             String text)
```
    Entry fields and multiple line entry fields generates this message.
    Specified by:
    onContentChanged in interface VirtualComponentListener
    Overrides:
    onContentChanged in class VirtualComponentAdapter
    Parameters:
    vp - The panel issuing the event, parent of the control.
    control - The control issuing the event.
    controlID - The control ID issuing the event.
    text - The control text contents.
  - onCheckedChange
```
public void onCheckedChange(VirtualPanel vp,
                            VirtualControl control,
                            String controlID,
                            int state)
```
    Checkbox changes.
    Specified by:
    onCheckedChange in interface VirtualComponentListener
    Overrides:
    onCheckedChange in class VirtualComponentAdapter
    Parameters:
    vp - The panel issuing the event, parent of the control.
    control - The control issuing the event.
    controlID - The control ID issuing the event.
    state - State (0=unchecked, 1=checked and 2=third state [only for check boxes]).
  - onAction
```
public void onAction(VirtualPanel vp,
                     String controlID)
```
    Push buttons and menu items generates this event when selected.
    Overrides:
    onAction in class VirtualComponentAdapter
    Parameters:
    vp - The panel issuing the event, parent of the control.
    controlID - The control ID issuing the event.
  - getJVMDebuggingPort
```
public static int getJVMDebuggingPort()
```
    Gets the JVM debugging port.
    Returns:
    -1 If no debugging is enabled.
  - getTargetServerJavaVersion
```
public static int getTargetServerJavaVersion()
```
    Gets the configured target Java version of the Server.
    Returns:
    The configured Java version in "PHANTOM.INI" [Java]" section, entry "java.version", but not less than {@link Plaf#MIN_JAVA_VERSION} or the smallest number of {@link Plaf#MAX_JAVA_VERSION} and the current Java version in {@link Plaf.javaVer}.
  - getClientJavaVersion
```
public static int getClientJavaVersion()
```
    Gets the configured Java version of the Client.
    Returns:
    The configured Java version in "PHANTOM.INI" [Java]" section, entry "client.java.version", but not less than {@link Plaf#MIN_JAVA_VERSION} or the smallest number of {@link Plaf#MAX_JAVA_VERSION} and the current Java version in {@link Plaf.javaVer}. If not valid, the return value is zero.
  - validateJavaDirectory
```
public static String validateJavaDirectory(String dir)
```
    Validates a Java 8/9/... runtime installation.
    Parameters:
    dir - The directory root of the installation.
    Returns:
    null for OK, otherwise an error message.

Class JavaConfig

Nested Class Summary

Field Summary

Fields inherited from interface se.entra.phantom.server.VirtualPanelListener

Method Summary

Methods inherited from class se.entra.phantom.server.VirtualComponentAdapter

Methods inherited from class se.entra.phantom.server.VirtualPanelAdapter

Methods inherited from class java.lang.Object

Methods inherited from interface se.entra.phantom.server.VirtualPanelListener

Method Detail

addJavaVersionSpecificOptions

onEclipseLaunchClient

saveBuildBeforeRun

getEditorParallelRuntime

initJavaCombo

onPanelCreate

onContentChanged

onContentChanged

onCheckedChange

onAction

getJVMDebuggingPort

getTargetServerJavaVersion

getClientJavaVersion

validateJavaDirectory