To help you investigate and debug issues when using the enhanced JavaBean support,
a debug mode is available. To enable debug mode you use FBean.Set_Logging_Mode()
with the name or ID of the item, the item instance, and a logging level. This
causes debugging output to be sent to the Java console . This property can be
set to one of the following values:
FBEAN.NO_LOGGING
No debug information is displayed. This
is the default.FBEAN.LOG_ERRORS
Returns exceptions only.FBEAN.LOG_WARNINGS
Returns inconsistencies
that may not be errors.FBEAN.LOG_INFORMATION
Returns a detailed
log of: methods called on the JavaBean, events from the JavaBean and some
JavaBean state information. FBEAN.LOG_ALL
Combination of WARNING
,
ERROR
and INFORMATION.
For example, to enable logging using the ALL
level:
FBEAN.SET_LOGGING_MODE('MyBeanArea',1,FBEAN.LOG_ALL);
Note: These debugging modes should only be used during development and to diagnose problems. Using these logging modes can slow down the operation of the Form.
You can use debug mode to output all of the JavaBean assets to the Java console.
When running in INFORMATION
or ALL
mode, the enhanced
JavaBean support will output all of the available properties, methods and listeners
that the JavaBean exposes. This can be useful in understanding what the bean
is capable of doing and provides you with the correct property names to use
with the FBean
package.
The list of properties and methods contains all of the public methods and properties exposed by the JavaBean, including those inherited from its superclasses. To help you distinguish between the items that are output, enhanced JavaBean support adds a prefix which indicates their type.
Prefix | Description |
---|---|
m |
method names |
p |
property names |
l |
listeners (for events) |
To use a method or property returned by debug mode in your code, ignore this
first character and use the rest of the name. For example, the method setRate
in the Juggler bean will be displayed as mSetRate
in the Java console.
To actually call this method, drop the m
and lowercase the next
character to get setRate
.