10.12.2 Atom Support

Atom is another standard interchange format used to implement REST APIs. An example of Atom output can be seen below:

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <feed xmlns="http://www.w3.org/2005/Atom">
  3. <title>Example Feed</title>
  4. <link href="http://example.org/"/>
  5. <updated>2003-12-13T18:30:02Z</updated>
  6. <author>
  7. <name>John Doe</name>
  8. </author>
  9. <id>urn:uuid:60a76c80-d399-11d9-b93C-0003939e0af6</id>
  10. <entry>
  11. <title>Atom-Powered Robots Run Amok</title>
  12. <link href="http://example.org/2003/12/13/atom03"/>
  13. <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id>
  14. <updated>2003-12-13T18:30:02Z</updated>
  15. <summary>Some text.</summary>
  16. </entry>
  17. </feed>

To use Atom rendering again simply define a custom renderer:

  1. import grails.rest.render.atom.*
  2. beans = {
  3. halBookRenderer(AtomRenderer, rest.test.Book)
  4. halBookListRenderer(AtomCollectionRenderer, rest.test.Book)
  5. }