Components View

...

This package contains all configuration entities / items shared between all QMan components.
Those includes both configuration items that are directly under the user control and not-public items used internally to configurate configure (sub) components.
As you can see, the configuration package is a central grouping of components that serve serves the remaining three modules.

Image Added

Configurator

When QMan starts, this component is responsible to build the configuration for that instance. As you can see it uses several built-in builders in order to create and populate the configuration instance.

Configuration

Encapsulates a configuration for a QMan instance. Note that this is a singleton because it must be accessed from everywhere inside QMan sub-modules.

Parser

Active participants of the configuration build process. Basically they are responsible to parse a specific section of the (optional) qman-configuration file that is given at QMan startup. At the moment we have two implementantion of this interface :

• WorkerManagerConfigurationParser : parses the configuration data of the internal worker manager; It creates a WorkerManagerConfigurationData instance.
• BrokerConnectionDataParser : parses the connection data of declared brokers; For each configured broker a corresponding BrokerConnectionData instance is created.

WorkerManagerConfigurationData

A value object encapsulating configuration data for the work manager.

BrokerConfigurationData

A value object encapsulating connection data of a remote broker.

AccessModes

A map associating a code with an access mode. At the moment we have three access modes :

• RO : Read only;
• RW : Read / Write;
• RC : Read create;

Message Handlers

Each time a message is received from a remote broker there will be a specific message handler that is responsible for processing that message.
On top of that, message handlers mapping associates an operation code (a character) with a message handler instance.
As you can see, there are two distinct collections of mappings. The first one contains message handlers associates with management queue, while the second one is referred to message handlers associated with method reply queue.

Package domain

Package jmx

...

Note that this is an additional layer over the previous JMX core so the basically the same considerations apply management resources (in this case we call them WS-Resources).

{toggle-cloak:id=section1}

{cloak:id=section1}

Image Removed

{cloak}

QManLifecycleManager

WsDmAdapter

QMan

QManWsResource

QManWsAdapter

SubscriptionManager

MBeanWSResource

Other WS interfaces

Image Added

QManLifecycleManager

Simply speaking, we could say that the whole WSDM Layer acts as a facade of the JMX Adapter, so it should be able to control the lifecycle of a that adapter. This component is a web component that (as the name suggests) provides a lifecycle management (startup & shutdown) of a JMX adapter instance.

WsDmAdapter

An HTTP Servlet that listens for incoming WS-DM / HTTP requests and dispatches those requests to the appropriate handler.

QMan

A front controller of the JMX instrumentation layer exposed itself for management (as an MBean).

QManWsResource

QMan object representation of a WS-Resource. A WS-Resource is a composition of a management resource and a Web service through which the resource can be accessed.

QManWsAdapter

A static WS-Resource that acts as a controller / facade of QMan WS-DM management domain model. Basically it provides the following features :

• WS-Resource creation : When a new resource is built on JMX layer, it builds the corresponding WS-Resource representation (WS-Resource instance, WSDL, RMD and capabilities)
• WS-Resource deletion : When a resource is deleted on JMX layer (i.e. a connection that has been closed, a session that has been destroyed), it deletes the corresponding WS-Resource
• Notifications : Acting as a notification producer, each time a WS-Resource is created / destroyed a dedicated message is published on a lifecycle topic.

SubscriptionManager

A WS-Resource that enables QMan notifications. It provides operations that allow a requestor to query and manipulate subscription resources that it manages. For example it is possible (on requestor side) to pause and resume a subscription.

MBeanWSResource

This is the interface that all QMan WS-Resources have. Although a concrete implementation of this interface is built at runtime, it indicates that the resources will have a common set of features (attribute retrieveal, operation invocation).

Other WS interfaces

The other interfaces on the diagram simply enumerates all the WS-DM interfaces that will be implemented by the QMan WS-Resources. More information about those interfaces are found More information about WS-DM interface specification are here .