ESBVisitor interface for Actional Looking Glass
integration.
An ESB Container can be instrumented through the {@link com.sonicsw.esb.visitor.ESBVisitor ESBVisitor} interface to provide NGSO information to a Looking Glass agent running on the same machine.
By default, Looking Glass instrumentation is disabled. Typically, instrumentation is enabled through a checkbox in the configuration for the ESB container, although it can be "forced" on through the use of a JVM startup switch (see below). Instrumentation is further conditionalized by the presence of the Looking Glass agent on the machine. When the {@link com.sonicsw.xqimpl.actional.lg.visitor.ActionalVisitorFactory} is initialized, it checks to see if the agent is running; if it isn't, the visitor factory is not added to the {@linkplain com.sonicsw.esb.visitor.ESBVisitorChain visitor chain} for that container.
This package also provides an implementation of the {@link com.sonicsw.xqimpl.actional.lg.visitor.StabilizerHelper MitigationContextFactory} interface for providing mitigation information to XQ processes. This factory is enabled only if Looking Glass instrumentation is enabled.
Both of the visitor and mitigation context factories are customizable through the use of deployment parameters (see below), but default implementations are provided.
The following JVM startup ("-D") options can be used for the ESB container JVM:
When true, the ESB Explorer checkbox is ignored and Looking Glass
instrumentation is enabled (pending, of course, the Agent actually running).
When true, tracing information (particularly for NGSO computation) is
emitted at the MF "INFORMATION" level. If false (or if not set), such tracing is only emitted
at the "DEBUG" level, and then only if debug level logging is enabled.
The following deployment parameters can be specified to control visitor configuration:
LOOKING_GLASS_VISITOR
If set, this parameter is the fully-qualified classname of the {@link com.sonicsw.esb.visitor.ESBVisitorFactory ESBVisitorFactory} implementation used to provide Looking Glass integration. If this parameter is not set, the default is {@link com.sonicsw.xqimpl.actional.lg.visitor.ActionalVisitorFactory ActionalVisitorFactory}.
VISITOR_FACTORIES
If set, this parameter is a comma-separated list of classnames indicating additional visitor factories to install. Entries in this list are appended to any LG visitor; the visitors are invoked in the order specified. There is no default.
STABILIZER_FACTORY
If set, this parameter is the fully qualified classname of an implementation of {@link com.sonicsw.xqimpl.common.MitigationContextFactory MitigationContextFactory} used to create instances of {@link com.sonicsw.xq.XQMitigationContext XQMitigationContext}. In this release, if Looking Glass is not enabled, this feature is ignored.