iPOJO Arch command

Architecture introspection is required when the system doesn't work as expected. In this case, having a quick access to instances states and interconnection is a stringent requirement. The arch command allows getting these data from the Felix Shell and from the Equinox shell.

Download

The Felix command is available from the Download page and in the arch folder of the iPOJO trunk http://svn.apache.org/repos/asf/felix/trunk/ipojo/arch/.
The Equinox command sources are available http://svn.apache.org/repos/asf/felix/sandbox/clement/ipojo-utils/arch-equinox/. To compile sources, just launch the mvn clean install.

Usage

Once you get the bundle, just install and start it in the OSGi Framework shell:

Then, you can use it to introspect the system by launching the arch command.

Reading instance architecture

When you launch the arch command, the list of created instances (enabling architecture introspection) is displayed.

To get more information on an instance, launch arch -instance the_instance_name

Instance architecture is organized as follows:
On the first line, are displayed the component type (i.e. factory), the instance state (valid or invalid), the bundle from which the instance is created, and the instance name.
Then, the information is organized handler by handler (a piece of container). For each handler plugged on the instance can participate to the instance architecture. For each handler its name (such as {{ org.apache.felix.ipojo.handlers.dependency.DependencyHandler}} for iPOJO service dependencies, {{ org.apache.felix.ipojo.handlers.providedservice.ProvidedServiceHandler}} for iPOJO service providing...) and the state (either valid or invalid are displayed. Remember that an instance is valid only and only if all plugged handlers are valid.
The org.apache.felix.ipojo.handlers.dependency.DependencyHandler provides data on service dependencies and more precisely on the state of service dependencies. In the previous example, the dependency on {{ spell.services.DictionaryService}} was resolved. On the following example, the same dependency is no more resolved:

Notes that, the instance also becomes invalid and that the provided service is unregistered.
If the provider comes back, the dependency becomes resolved and the instance becomes valid
If an instance begins to use a service, the bound providers are described in the instance architecture:

In the previous case, the dependency on {{ spell.services.DictionaryService}} use the service 41 from the iPOJO instance named {{ spell.english.EnglishDictionary-0}}
You can also check created POJO objects (implementation class objet). Here, only one object was created (spell.checker.SpellCheck@e222eb).

List available factories

To list available factories (i.e. component types), launch the arch -factories command:

For each available (public) factories,the name and the sate are displayed. A factory is valid if and only if all required handlers are available. To get more information on a factory launch the arch -factory factory_name command:

On the first line, you get the implementation class of the type, the state of the factory, the bundle declaring the type and the name of the type. Then you get the list of required and missing handlers.

List available handlers

You can also list available handlers with the arch -handlers command.

Handlers with the org.apache.felix.ipojo namespace (section before :) are core handlers (provided by the iPOJO bundle). Others are external handlers (provided by others bundles).