JBoss Community Archive (Read Only)

WildFly 8


This guide is work in progress


What are transformers

Transformers are mechanism used in domain mode, to support scenarios where you have host controllers (HC) joined to domain controller (DC) running different version of subsystem (server).

When HC registers itself against DC and it is running different version of some subsystem that is present on DC, DC performs transformation of model (ModelTransformer) and sends it back to HC as configuration it has too run.

Also when operations are performed on DC, for example call ADD for some resource, DC also transforms that operation (OperationTransformer) into target version of HC.

Transformers are primarily used for upgrade migration paths. General idea behind this migration period is that there are numerous HC and one DC deployed. First, DC is upgraded. Afterwards, HC are upgraded in steps as needed without breaking configuration.

When are they invoked

When Host controller registers to Domain Controller. HC does not know about conversions, they are done on DC as follows:

  1. HC -> connect -> DC

  2. HC <- list of subsystems to sent supported versions for <- DC

  3. HC -> list of supported versions for requested subsystems -> DC

  4. transformations happen on DC

  5. HC <- complete model in supported model versions <- DC

When should they be implemented

When model in your subsystem has changed in incompatible way.

Rule of thumb would be if current model is applied to previous version of subsystem model would it work? If not, model version must be increased and transformers implemented.

Model Transformer

Model transformer, works on top of current model and transforms its model to target version.

Operation Transformer

Operation transformer works on top of operations instead of model.

Testing transformers

There is testing framework in place for testing proper behavior of transformers

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-13 13:50:38 UTC, last content change 2012-10-26 13:55:04 UTC.