Runtimeconfig

Runtimeconfig 1.18.3

Description

The administration plugin adds the capability to dynamically maintain the Geomajas Spring application context. Prior to this plugin, the application context was loaded once and for all at startup and any changes to the context would necessarily involve a restart of the complete web application. While this is standard practice for Spring-configured systems, it prevents common GIS administrative tasks like:

  • dynamically configuring layers: vector layers, raster layers, styling, attributes, caching, security, ...
  • dynamically configuring fysical datastores: geodatabases, shapefiles

or more specific Geomajas-related tasks like:

  • dynamically configuring applications: maps, layers, tools, etc...
  • dynamically configuring services and commands

There are various technical roads that could be pursued to reach this goal, some of them involving a complete rehaul of the existing service infrastructure. For this plugin we have tried to follow the least intrusive, yet most generic option, which is to directly perform application context changes on a runtime system. Initial testing has shown that this is a viable road, although some limitations have to be taken into account:

Spring Dependency Injection, and more particularly autowiring, will need to be reapplied to reestablish bean dependencies within the context. This is not part of the standard bean definition registration mechanism, although it can be achieved partially by manually rewiring certain bean types.

Application context persistence is a separate issue that comes into play when the context becomes dynamic. It will be handled by a separate persistence service.

Concurrency issues may pop up as a consequence of dynamic configuration. As Geomajas is a stateless system, this should have limited consequences in most cases, although some glitches may appear during the configuration stage. The overall approach here should be to avoid locks by only sharing immutable objects. In the end it is up to the service implementors to ensure proper behavior after reconfiguration.

Community & Docs

- All related documentation and configuration.
- All related documentation and configuration.
- Visit the Java API docs for this plug-in.

Using this project in maven

In order to use this plug-in in your Maven-project, add the following dependency to the pom.xml:
<dependency>
    <groupId>org.geomajas</groupId>
    <artifactId>geomajas-server-plugin-runtimeconfig-parent</artifactId>
    <version>1.18.3</version>
</dependency>