add to documentation on how to use gorm service with multiple dbs

docs/src/docs/asciidoc/multipleDataSources/dataServices.adoc

@@ -0,0 +1,19 @@
+
+GORM Data Services can operate on multiple data sources.
+
+The `@Transactional` annotation can specify the `DataSource` where `ZipCode` domains exists.
+
+When no annotation is used, then the service goes to the default `DataSource`, as in `deleteByCode(String code)`.
+
+[source,groovy]
+----
+@CompileStatic
+@Service(ZipCode)
+interface ZipCodeService {
+
+    @Transactional('lookup')
+    ZipCode findByCode(String code)
+
+    void deleteByCode(String code)
+}
+----

docs/src/docs/asciidoc/multipleDataSources/index.adoc

@@ -30,3 +30,11 @@ for(ConnectionSource<SessionFactory, HibernateConnectionSourceSettings> connecti
 	SessionFactory sessionFactory = connectionSource.source
 }
 ----
+
+=== Data Services with Multiple Data Sources
+
+include::dataServices.adoc[]
+
+=== Queries with Multiple Data Sources
+
+include::queries.adoc[]

docs/src/docs/asciidoc/multipleDataSources/queries.adoc

@@ -0,0 +1,23 @@
+
+Queries can be written for mulitiple data sources with a dynamic finder, where query, or criteria query as well.
+
+Where Query:
+
+[source,groovy]
+----
+ZipCode.where {}.withConnection('lookup').list()
+----
+
+Dynamic Finder:
+
+[source,groovy]
+----
+ZipCode.lookup.findAll()
+----
+
+Criteria:
+
+[source,groovy]
+----
+ZipCode.lookup.createCriteria.list {}
+----