at.spardat.xma
Class RuntimeDefaults
java.lang.Object
at.spardat.xma.RuntimeDefaults
- public class RuntimeDefaults
- extends java.lang.Object
default properties for the runtime
|
Field Summary |
static java.lang.String |
activateGlobalEvents
To activate the GlobalEvent mechanism this property has be set to a value ! |
static boolean |
autoExit
Should the client side application automatically be terminated by the runtime if
the server side session is no longer valid or the server is unreachable?
|
static java.lang.String |
clientPraefix
the properties with praefix (i.e., in the node) xma.runtime
are also available at the xma-client and accessible via the
session class |
static int |
compressionThreshold
defines that tables to be downloaded should be gzip compressed
if their byte stream exceeds compressionThreshold bytes. |
static java.lang.String |
datasourcePraefix
XMA's datasource plugin |
static boolean |
doKeepAlive
Determines if the session should be kept alive as long as the client is open.
|
static boolean |
hashIntegrityProtection
defines if tabular tables downloaded to the xma client should be
integrity-protected by hash-values. |
static int |
RpcCompressionThreshold
This parameter applies to RPCs and determines the minimum size of
data to trigger gzip-compression. |
static java.lang.String |
Serializer
Determines the serializer used in RPCs:
binary: Most efficient and must be set in production environment; the default;
ascii: Data sent in RPCs is coded US-ASCII, without metainformation
tascii: Data sent is US-ASCII, every value is preceded a descriptive tag
(tagged ascii).
|
static boolean |
showExceptionClassName
Messages shown by NotificationBox.show() (used by PageClient.showException())
show first the class name of the Exception or of the nested Exception and then the Exception text
if the argument is a SysException (like "SysException: internal Error...[100001]").
|
static boolean |
sloppyModelSetters
With the XMA Runtime Version 1.7.0 the ISimpleWM.set(xxxx) method changed the implementation of behaviour on type conflicts. |
static java.lang.String |
SSLPort
xma.runtime.SSLPort defines the TCP port used for login and logout
requests protected by HTTPS. |
static boolean |
useOutOfDomainKey
To customize the handling of outdated and invalid domain keys.
|
static boolean |
verboseNotificationBox
Per default, message boxes at the XMA client include the stacktrace if environment is local or development. |
|
Method Summary |
static java.lang.String |
getProperty(java.lang.String name)
Get the default value for the named property. |
static java.lang.String |
getProperty(java.lang.String name,
java.lang.String defaultValue)
Get the default value for the named property. |
static java.util.Set |
keySet()
Get a set of the property names known to this class. |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
clientPraefix
public static final java.lang.String clientPraefix
- the properties with praefix (i.e., in the node) xma.runtime
are also available at the xma-client and accessible via the
session class
- See Also:
- Constant Field Values
RpcCompressionThreshold
public static final int RpcCompressionThreshold
- This parameter applies to RPCs and determines the minimum size of
data to trigger gzip-compression. This works in both directions,
i.e., applies to data sent from the XMA-client to the server
and vice versa. A value of -1 disables compression for all
RPCs in the application.
- See Also:
- Constant Field Values
Serializer
public static final java.lang.String Serializer
- Determines the serializer used in RPCs:
binary: Most efficient and must be set in production environment; the default;
ascii: Data sent in RPCs is coded US-ASCII, without metainformation
tascii: Data sent is US-ASCII, every value is preceded a descriptive tag
(tagged ascii).
The ascii settings may be used for loadtests to force a readable HTTP-stream.
This property must not be changed in a running server.
- See Also:
- Constant Field Values
doKeepAlive
public static final boolean doKeepAlive
- Determines if the session should be kept alive as long as the client is open.
Default is true.
- See Also:
- Constant Field Values
activateGlobalEvents
public static final java.lang.String activateGlobalEvents
- To activate the GlobalEvent mechanism this property has be set to a value != "false".
GlobalEvents enable the server to send events within a RPC to the client, which has to register a GlobalEventListener.
As this means a slight overhead for every RPC this feature has to be turned on explicitly.
The name given for this property (e.g. activateGlobalEvents="samplespar") serves as a scope for GlobalEvents.
GlobalEvents are only written and read in the scope set by xma.runtime.activateGlobalEvents.
This mechanism prevents that GlobalEvents of different applications are mixed.
Usually each application will define its own scope and is therfore only able to read its own GlobalEvents.
It is suggested to use the application's name in small letters (to avoid Windows/Unix issues):
e.g. xma.runtime.activateGlobalEvents=samplespar
Do not use a package like name as "at.spardat.samplespar" as dots are interpreted as jndi nodes!
xma.runtime.activateGlobalEvents=true is now a scope name as any other name (Of course this name is recommended).
In some cases the GlobalEvent scope might be shared between different applications. For example one application maintains
domains and sends a GlobalEvent that a certain domain was changed. Another application will receive this
GlobalEvent and refresh the domain at its clients.
- See Also:
- Constant Field Values
sloppyModelSetters
public static final boolean sloppyModelSetters
- With the XMA Runtime Version 1.7.0 the ISimpleWM.set(xxxx) method changed the implementation of behaviour on type conflicts.
The old behaviour was to do nothing on type conflicts, for example if you set a String and the
model is a numeric one. The new implementation is to throw an IllegalStateException.
If you do not want to switch to the new implementation, you can set this property to 'true'.
It is recommended that you do not set this property and instead use the new behaviour.
- See Also:
- Constant Field Values
verboseNotificationBox
public static final boolean verboseNotificationBox
- Per default, message boxes at the XMA client include the stacktrace if environment is local or development.
Now, this property may be set to 'false' to suppress display of the stack trace even in development environments.
- See Also:
- Constant Field Values
autoExit
public static final boolean autoExit
- Should the client side application automatically be terminated by the runtime if
the server side session is no longer valid or the server is unreachable?
If true and the server is unreachable, the user is asked if he wants to exit,
if true and the session is invalid, he is only notified.
Default is false.
- See Also:
- Constant Field Values
useOutOfDomainKey
public static final boolean useOutOfDomainKey
- To customize the handling of outdated and invalid domain keys.
If xma.runtime.useOutOfDomainKey=true, which is the default, the behaviour is unchanged:
The drop down box of domaincombos normaly contains only valid domain values.
If an invalid key is selected programatically (e.g. read from the database) it is added to this list.
So it is possible for the user to reselect this key if he started changing the selection of the combo.
It is showed as its shortvalue followed by (unknown).
If xma.runtime.useOutOfDomainKey=false, a new behaviour applies:
The drop down box of domaincombos allways contains only valid domain values.
If an invalid key is selected programatically (e.g. read from the database) it is only showed in the text
field of the combo box. It is showed in the same style as the valid values.
It is not possible for the user to reselect this key, once he started changing the selection of the combo.
- See Also:
- Constant Field Values
SSLPort
public static final java.lang.String SSLPort
- xma.runtime.SSLPort defines the TCP port used for login and logout
requests protected by HTTPS.
An XMA application requested via an HTTP URL always protects its login
and logout requests by HTTPS. This property defines the HTTPS port to
use. Make sure the the application server is similary configured.
For XMA applications which are loaded by an HTTPS URL this property is
ignored, as the whole application is already protected by HTTPS anyway.
Since Version 1.7.8
The property xma.runtime.SSLPort may contain a list of ports seperated by
',' (';' and '|' are possible, too). If this property contains more than
one port number, these ports are tried in sequence whenever an encryted
connection is needed during the login process. Make sure, the normaly
used port is the first in the list, because it is allways tried first!
- See Also:
- Constant Field Values
datasourcePraefix
public static final java.lang.String datasourcePraefix
- XMA's datasource plugin
- See Also:
- Constant Field Values
showExceptionClassName
public static final boolean showExceptionClassName
- Messages shown by NotificationBox.show() (used by PageClient.showException())
show first the class name of the Exception or of the nested Exception and then the Exception text
if the argument is a SysException (like "SysException: internal Error...[100001]").
If this property is set to 'false' then the Exception class name is suppressed.
Defaults to 'true'.
- See Also:
- Constant Field Values
hashIntegrityProtection
public static final boolean hashIntegrityProtection
- defines if tabular tables downloaded to the xma client should be
integrity-protected by hash-values. This enables that corrupted
files at the client may be cleaned up after detection.
This property is set to false per default. It may be set to
true if the boot-runtime version is greater than or equal to 1.3.0!!!
- See Also:
- Constant Field Values
compressionThreshold
public static final int compressionThreshold
- defines that tables to be downloaded should be gzip compressed
if their byte stream exceeds compressionThreshold bytes. If
set to -1, compression is disabled.
May only be set to values not equal to -1 with bootruntime versions
greater than or equal to 1.3.0!!!!
- See Also:
- Constant Field Values
RuntimeDefaults
public RuntimeDefaults()
getProperty
public static final java.lang.String getProperty(java.lang.String name)
- Get the default value for the named property.
- Parameters:
name - one of the field names of this class.
- Returns:
- the value of the field with the given name.
getProperty
public static final java.lang.String getProperty(java.lang.String name,
java.lang.String defaultValue)
- Get the default value for the named property.
- Parameters:
name - one of the field names of this class.defaultValue - to return if this class has no such field.
- Returns:
- the value of the field with the given name.
keySet
public static final java.util.Set keySet()
- Get a set of the property names known to this class.
- Returns:
- the field names of this class.