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.
+