chrriis.dj.nativeswing.swtimpl
Enum NSSystemPropertySWT

java.lang.Object
  java.lang.Enum<NSSystemPropertySWT>
      chrriis.dj.nativeswing.swtimpl.NSSystemPropertySWT

All Implemented Interfaces:

Serializable, Comparable<NSSystemPropertySWT>

public enum NSSystemPropertySWT
extends Enum<NSSystemPropertySWT>

A class that exposes all the system properties used by the DJ Native Swing SWT implementation.

Author:

Christopher Deckers, Stefan Fussenegger

Enum Constant Summary

COMPONENTS_DEBUG_PRINTCREATION
nativeswing.components.debug.printCreation = true/false (default: false)
Set whether the creation of a native component should be printed.

COMPONENTS_DEBUG_PRINTDISPOSAL
nativeswing.components.debug.printDisposal = true/false (default: false)
Set whether the disposal of a native component should be printed.

COMPONENTS_DEBUG_PRINTFAILEDMESSAGES
nativeswing.components.debug.printFailedMessages = true/false (default: false)
Set whether the messages that did not reach the native component should be printed.

COMPONENTS_DEBUG_PRINTOPTIONS
nativeswing.components.debug.printOptions = true/false (default: false)
Set whether the options used to create a component should be printed.

COMPONENTS_DEBUG_PRINTSHAPECOMPUTING
nativeswing.components.debug.printShapeComputing = true/false (default: false)
Set whether the computation of the shape applied to the native component (when the visibility constraint option is active) should be printed.

COMPONENTS_SWALLOWRUNTIMEEXCEPTIONS
nativeswing.components.swallowRuntimeExceptions = true/false (default: false)
Set whether synchronous component methods should swallow runtime exceptions and return dummy results.

DEPENDENCIES_CHECKVERSIONS
nativeswing.dependencies.checkVersions = true/false (default: true)
Set whether the versions of the dependencies should be checked when possible.

INTEGRATION_ACTIVE
nativeswing.integration.active = true/false (default: true)
Set whether native integration should be active.

INTERFACE_DEBUG_PRINTMESSAGES
nativeswing.interface.debug.printMessages = true/false (default: false)
Set whether to print the messages that are exchanged.

INTERFACE_INPROCESS
nativeswing.interface.inProcess = true/false (default: platform-dependant)
Set whether the interface should be in-process or out-process.

INTERFACE_INPROCESS_PRINTNONSERIALIZABLEMESSAGES
nativeswing.interface.inProcess.printNonSerializableMessages = true/false (default: false)
When in-process, set whether messages should be artificially serialized to check whether they would be compatible with the out-process mode.

INTERFACE_OUTPROCESS_COMMUNICATION
nativeswing.interface.outProcess.communication = sockets/processio (default: sockets)
Set whether the communication interface should use sockets or the process IO.

INTERFACE_PORT
nativeswing.interface.port = <integer> (default: -1)
Force the port to use to communicate with the spawned VM.

INTERFACE_STREAMRESETTHRESHOLD
nativeswing.interface.streamResetThreshold = <integer> (default: 500000)
Set the number of bytes that need to be exchanged to trigger a reset of the Object communication stream.

INTERFACE_SYNCMESSAGES
nativeswing.interface.syncMessages = true/false (default: false)
Set whether all asynchronous messages should be sent synchronously.

LOCALHOSTADDRESS
nativeswing.localhostAddress = <String> or "_localhost_" (default: auto-detect, usually 127.0.0.1)
Set the address that is used as the local host address for all the internal communication channels that require a socket (local web server, etc.).

LOCALHOSTADDRESS_DEBUG_PRINT
nativeswing.localhostAddress.debug.print = true/false (default: false)
Set whether the address found as the local host address should be printed.

LOCALHOSTADDRESS_DEBUG_PRINTDETECTION
nativeswing.localhostAddress.debug.printDetection = true/false (default: false)
Set whether to print the steps of local host address detection.

PEERVM_CREATE
nativeswing.peervm.create = true/false (default: true)
Set whether the peer VM should be created.

PEERVM_DEBUG_PRINTCOMMANDLINE
nativeswing.peervm.debug.printCommandLine = true/false (default: false)
Set whether the command line that is used to spawn the peer VM should be printed.

PEERVM_DEBUG_PRINTSTARTMESSAGE
nativeswing.peervm.debug.printStartMessage = true/false (default: false)
Set whether a message should be printed when the peer VM is launched, in order to check that the peer VM could be created.

PEERVM_DEBUG_PRINTSTOPMESSAGE
nativeswing.peervm.debug.printStopMessage = true/false (default: false)
Set whether a message should be printed when the peer VM stops, in order to know that it stopped on purpose and not because of a crash.

PEERVM_FORCEPROXYCLASSLOADER
nativeswing.peervm.forceProxyClassLoader = true/false (default: false)
Force the use of the proxy class loader.

PEERVM_KEEPALIVE
nativeswing.peervm.keepAlive = true/false (default: false)
Set whether the peer VM should die after a timeout.

SWT_DEVICE_DEBUG
nativeswing.swt.device.debug = true/false (default: false)
Set whether the SWT Device debugging is active.

VLCPLAYER_FIXPLAYLISTAUTOPLAYNEXT
nativeswing.vlcplayer.fixPlaylistAutoPlayNext = true/false (default: true)
VLC seems to have a bug: it does not automatically play the next queued item.

WEBBROWSER_RUNTIME
nativeswing.webbrowser.runtime = xulrunner/webkit (default: none)
Set the runtime of the web browser.

WEBBROWSER_XULRUNNER_HOME
nativeswing.webbrowser.xulrunner.home = <path to XULRunner>
Set which XULRunner installation is used.

WEBSERVER_DEBUG_PRINTPORT
nativeswing.webserver.debug.printPort = true/false (default: false)
Set whether the port that is used by the embedded web server should be printed.

WEBSERVER_DEBUG_PRINTREQUESTS
nativeswing.webserver.debug.printRequests = true/false (default: false)
Set whether the web server should print the requests it receives, along with the result (200 or 404).

Method Summary

String	get()
String	get(String defaultValue)
String	getName()
boolean	isReadOnly() whether this property should not be modified (i.e.
String	set(String value)
String	toDebugString()
String	toString()
static NSSystemPropertySWT	valueOf(String name) Returns the enum constant of this type with the specified name.
static NSSystemPropertySWT[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

LOCALHOSTADDRESS

public static final NSSystemPropertySWT LOCALHOSTADDRESS

nativeswing.localhostAddress = <String> or "_localhost_" (default: auto-detect, usually 127.0.0.1)
Set the address that is used as the local host address for all the internal communication channels that require a socket (local web server, etc.).

LOCALHOSTADDRESS_DEBUG_PRINTDETECTION

public static final NSSystemPropertySWT LOCALHOSTADDRESS_DEBUG_PRINTDETECTION

nativeswing.localhostAddress.debug.printDetection = true/false (default: false)
Set whether to print the steps of local host address detection.

LOCALHOSTADDRESS_DEBUG_PRINT

public static final NSSystemPropertySWT LOCALHOSTADDRESS_DEBUG_PRINT

nativeswing.localhostAddress.debug.print = true/false (default: false)
Set whether the address found as the local host address should be printed.

WEBSERVER_DEBUG_PRINTPORT

public static final NSSystemPropertySWT WEBSERVER_DEBUG_PRINTPORT

nativeswing.webserver.debug.printPort = true/false (default: false)
Set whether the port that is used by the embedded web server should be printed.

WEBSERVER_DEBUG_PRINTREQUESTS

public static final NSSystemPropertySWT WEBSERVER_DEBUG_PRINTREQUESTS

nativeswing.webserver.debug.printRequests = true/false (default: false)
Set whether the web server should print the requests it receives, along with the result (200 or 404).

COMPONENTS_DEBUG_PRINTOPTIONS

public static final NSSystemPropertySWT COMPONENTS_DEBUG_PRINTOPTIONS

nativeswing.components.debug.printOptions = true/false (default: false)
Set whether the options used to create a component should be printed.

COMPONENTS_DEBUG_PRINTSHAPECOMPUTING

public static final NSSystemPropertySWT COMPONENTS_DEBUG_PRINTSHAPECOMPUTING

nativeswing.components.debug.printShapeComputing = true/false (default: false)
Set whether the computation of the shape applied to the native component (when the visibility constraint option is active) should be printed.

INTEGRATION_ACTIVE

public static final NSSystemPropertySWT INTEGRATION_ACTIVE

nativeswing.integration.active = true/false (default: true)
Set whether native integration should be active.

DEPENDENCIES_CHECKVERSIONS

public static final NSSystemPropertySWT DEPENDENCIES_CHECKVERSIONS

nativeswing.dependencies.checkVersions = true/false (default: true)
Set whether the versions of the dependencies should be checked when possible.

INTERFACE_PORT

public static final NSSystemPropertySWT INTERFACE_PORT

nativeswing.interface.port = <integer> (default: -1)
Force the port to use to communicate with the spawned VM.

INTERFACE_STREAMRESETTHRESHOLD

public static final NSSystemPropertySWT INTERFACE_STREAMRESETTHRESHOLD

nativeswing.interface.streamResetThreshold = <integer> (default: 500000)
Set the number of bytes that need to be exchanged to trigger a reset of the Object communication stream.

INTERFACE_SYNCMESSAGES

public static final NSSystemPropertySWT INTERFACE_SYNCMESSAGES

nativeswing.interface.syncMessages = true/false (default: false)
Set whether all asynchronous messages should be sent synchronously.

INTERFACE_DEBUG_PRINTMESSAGES

public static final NSSystemPropertySWT INTERFACE_DEBUG_PRINTMESSAGES

nativeswing.interface.debug.printMessages = true/false (default: false)
Set whether to print the messages that are exchanged.

INTERFACE_INPROCESS

public static final NSSystemPropertySWT INTERFACE_INPROCESS

nativeswing.interface.inProcess = true/false (default: platform-dependant)
Set whether the interface should be in-process or out-process. Platforms which use out-process may be switched to in-process, but this may affect stability. Change this setting only when you need to debug sequences in a single VM.

INTERFACE_OUTPROCESS_COMMUNICATION

public static final NSSystemPropertySWT INTERFACE_OUTPROCESS_COMMUNICATION

nativeswing.interface.outProcess.communication = sockets/processio (default: sockets)
Set whether the communication interface should use sockets or the process IO.

INTERFACE_INPROCESS_PRINTNONSERIALIZABLEMESSAGES

public static final NSSystemPropertySWT INTERFACE_INPROCESS_PRINTNONSERIALIZABLEMESSAGES

nativeswing.interface.inProcess.printNonSerializableMessages = true/false (default: false)
When in-process, set whether messages should be artificially serialized to check whether they would be compatible with the out-process mode.

PEERVM_CREATE

public static final NSSystemPropertySWT PEERVM_CREATE

nativeswing.peervm.create = true/false (default: true)
Set whether the peer VM should be created. Setting it to false and forcing the port allows to connect to a separately launched peer VM.

PEERVM_KEEPALIVE

public static final NSSystemPropertySWT PEERVM_KEEPALIVE

nativeswing.peervm.keepAlive = true/false (default: false)
Set whether the peer VM should die after a timeout. This is useful when launching the peer VM separately.

PEERVM_FORCEPROXYCLASSLOADER

public static final NSSystemPropertySWT PEERVM_FORCEPROXYCLASSLOADER

nativeswing.peervm.forceProxyClassLoader = true/false (default: false)
Force the use of the proxy class loader. This specific class loader is automatically used in the peer VM when some resources cannot be located when spawning the VM.

PEERVM_DEBUG_PRINTSTARTMESSAGE

public static final NSSystemPropertySWT PEERVM_DEBUG_PRINTSTARTMESSAGE

nativeswing.peervm.debug.printStartMessage = true/false (default: false)
Set whether a message should be printed when the peer VM is launched, in order to check that the peer VM could be created.

PEERVM_DEBUG_PRINTSTOPMESSAGE

public static final NSSystemPropertySWT PEERVM_DEBUG_PRINTSTOPMESSAGE

nativeswing.peervm.debug.printStopMessage = true/false (default: false)
Set whether a message should be printed when the peer VM stops, in order to know that it stopped on purpose and not because of a crash.

PEERVM_DEBUG_PRINTCOMMANDLINE

public static final NSSystemPropertySWT PEERVM_DEBUG_PRINTCOMMANDLINE

nativeswing.peervm.debug.printCommandLine = true/false (default: false)
Set whether the command line that is used to spawn the peer VM should be printed.

COMPONENTS_DEBUG_PRINTFAILEDMESSAGES

public static final NSSystemPropertySWT COMPONENTS_DEBUG_PRINTFAILEDMESSAGES

nativeswing.components.debug.printFailedMessages = true/false (default: false)
Set whether the messages that did not reach the native component should be printed.

COMPONENTS_DEBUG_PRINTCREATION

public static final NSSystemPropertySWT COMPONENTS_DEBUG_PRINTCREATION

nativeswing.components.debug.printCreation = true/false (default: false)
Set whether the creation of a native component should be printed.

COMPONENTS_DEBUG_PRINTDISPOSAL

public static final NSSystemPropertySWT COMPONENTS_DEBUG_PRINTDISPOSAL

nativeswing.components.debug.printDisposal = true/false (default: false)
Set whether the disposal of a native component should be printed.

COMPONENTS_SWALLOWRUNTIMEEXCEPTIONS

public static final NSSystemPropertySWT COMPONENTS_SWALLOWRUNTIMEEXCEPTIONS

nativeswing.components.swallowRuntimeExceptions = true/false (default: false)
Set whether synchronous component methods should swallow runtime exceptions and return dummy results. This is a sort of paranoid mode since such exceptions are not supposed to happen. Moreover, there is no guarantee that user code can recover from all dummy results.

WEBBROWSER_RUNTIME

public static final NSSystemPropertySWT WEBBROWSER_RUNTIME

nativeswing.webbrowser.runtime = xulrunner/webkit (default: none)
Set the runtime of the web browser.

WEBBROWSER_XULRUNNER_HOME

public static final NSSystemPropertySWT WEBBROWSER_XULRUNNER_HOME

nativeswing.webbrowser.xulrunner.home = <path to XULRunner>
Set which XULRunner installation is used. This property is taken into account when using the XULRunner runtime.

VLCPLAYER_FIXPLAYLISTAUTOPLAYNEXT

public static final NSSystemPropertySWT VLCPLAYER_FIXPLAYLISTAUTOPLAYNEXT

nativeswing.vlcplayer.fixPlaylistAutoPlayNext = true/false (default: true)
VLC seems to have a bug: it does not automatically play the next queued item. The fix that was added can be deactivated with this system property.

SWT_DEVICE_DEBUG

public static final NSSystemPropertySWT SWT_DEVICE_DEBUG

nativeswing.swt.device.debug = true/false (default: false)
Set whether the SWT Device debugging is active. This property can be useful because it outputs the web browser runtime effectively detected for the OS.

Method Detail

values

public static NSSystemPropertySWT[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (NSSystemPropertySWT c : NSSystemPropertySWT.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static NSSystemPropertySWT valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

get

public String get()

Returns:

the string value of the system property, or null if there is no property with that key.

See Also:

System.getProperty(String), AccessController.doPrivileged(PrivilegedAction)

get

public String get(String defaultValue)

Parameters:

defaultValue - the default value to return if the property is not defined.

Returns:

the string value of the system property, or the default value if there is no property with that key.

See Also:

System.getProperty(String), AccessController.doPrivileged(PrivilegedAction)

set

public String set(String value)

Parameters:

value - the new value

Throws:

UnsupportedOperationException - if this property is read-only

See Also:

System.setProperty(String, String), AccessController.doPrivileged(PrivilegedAction), isReadOnly()

getName

public String getName()

Returns:

name of this property

isReadOnly

public boolean isReadOnly()

whether this property should not be modified (i.e. "read-only"). Note that it is possible to use System.setProperty(String, String) directly. It's use is discouraged though (as it might not have the desired effect)

Returns:

true if this property should not be modified

toString

public String toString()

Overrides:

toString in class Enum<NSSystemPropertySWT>

Returns:

property value (same as get()

See Also:

get()

toDebugString

public String toDebugString()

Returns:

a string representation of this object (e.g. "OS_NAME: os.name=Linux (read-only)")