Allow clients to use include query params to include related entities in response

Author: Chris Latimer

grails-app/controllers/org/gmobile/v2/PhoneController.groovy

@@ -17,7 +17,7 @@ class PhoneController extends RestfulController<Phone> {
         def detail = params.detail ?: "complete"
         withFormat {
             json {
-                respond(phone, [detail:detail])
+                respond(phone, [detail:detail, include:params?.list('include')])
             }
             xml {
                 XML.use(params?.detail?.toLowerCase() ?: "complete") {

src/groovy/org/gmobile/renderers/ApiRendererJson.groovy

@@ -38,6 +38,24 @@ class ApiRendererJson<T> extends AbstractRenderer<T> {
             converter = context.arguments.paging as ApiJSON
             converter.renderPartial(writer)
         }
+
+        if(context.arguments?.include) {
+            writer.key("include")
+            writer.array()
+            context.arguments?.include.each { includeProp ->
+                JSON.use("compact") {
+                    converter = object.properties.get(includeProp) as ApiJSON
+                }
+
+                writer.object()
+                writer.key(includeProp)
+                converter.renderPartial(writer)
+                writer.endObject()
+
+            }
+            writer.endArray()
+        }
+
         writer.endObject()
 
         out.flush()