The Figurate Guide provides documentation to assist with getting the most out of the Figurate framework.
The following instructions will help you to get a Figurate project up and running as quickly as possible.
The simplest way to use Figurate is to apply the Figurate plugin in a Gradle build script. Some example applications are provided that demonstrate usage of this plugin.
The Figurate Launcher is a convenient way to configure the bootstrap of the underlying OSGi platform.
Figurate provides configuration via the OSGi standard Configuration Admin support.
A Figurate Constellation is a collection of bundles that are designed to work together to provide a specific feature. The available Figurate constellations are as follows:
|felix||All||Felix OSGi runtime|
|http||All||HTTP server/Servlet container (Jetty)|
|scr||All||Service Component Runtime|
|webconsole||All||Felix OSGi dashboard|
Figurate provides a gradle plugin to make it simple to add constellations to your application, without needing to worry about compatibility issues between bundles across different constellations. You apply the constellation plugin as follows:
apply plugin: 'constellations'
The Gradle Constellation Plugin uses Gradle configurations to define constellations. As such, to add a constellation to your application you just include the configuration in Figurate’s custom bundle configuration, like so:
You can also make use of Gradle’s dependency tools to query the actual bundles included in a given constellation:
gradle dependencies --configuration constellation\$felix
Note that as Figurate constellations are defined using a dollar ($) symbol, some shells may try to apply variable substitution, which is why we need to escape the dollar.
The output should look something like this: