diff --git a/src/docbkx/transformer.xml b/src/docbkx/transformer.xml index 14b31baa85..1d29b54b3a 100644 --- a/src/docbkx/transformer.xml +++ b/src/docbkx/transformer.xml @@ -97,6 +97,68 @@
]]> + + As added convenience, Spring Integration also provides Object-to-Map and Map-to-Object transformers which + utilize Spring Expression Language (SpEL) to serialize and de-serialize the object graphs to the most primitive + types (e.g., String, byte, int etc...). Object-to-Map transformer transforms Object graph to a Map where key is SpEL expression + and value is primitive or String: + + + For example: + nickNames; +   // setters and getters are omitted +}]]> +... will be transformed to a Map which looks like this: +{person.name=George, person.child.name=Jenna, person.child.nickNames[0]=Bimbo . . . etc} + + + SpEL-based Map allows you to describe the object structure without sharing the actual types allowing + you to restore/rebuild the object graph into a different types if you maintain the convention. + + + For example: + The above structure could be easily restored back to the following Object graph via Map-to-Object transformer: + nickNames; +   // setters and getters are omitted +}]]> + + + To configure these transformers, Spring Integration provides namespace support + Object-to-Map: +]]> + Map-to-Object +]]> + or + + +]]> + + + + NOTE: 'ref' and 'type' attributes are mutually exclusive. You can only use either one. + Also, if using 'ref' attribute you must point to a 'prototype' scoped bean, otherwise + BeanCreationException will be thrown.  +