{"id":380,"date":"2009-05-10T19:16:38","date_gmt":"2009-05-11T04:16:38","guid":{"rendered":"https:\/\/www.kellyrob99.com\/blog\/?p=380"},"modified":"2009-05-10T20:54:38","modified_gmt":"2009-05-11T05:54:38","slug":"gracelets-and-seam-a-dsl-for-facelets-with-easy-integration","status":"publish","type":"post","link":"https:\/\/www.kellyrob99.com\/blog\/2009\/05\/10\/gracelets-and-seam-a-dsl-for-facelets-with-easy-integration\/","title":{"rendered":"Gracelets and Seam – a DSL for Facelets and Groovy with easy integration"},"content":{"rendered":"

Over the last year I’ve done a lot of work with JBoss Seam<\/a>, and while it’s not Grails<\/a> it’s also not that bad for a web framework. Facelets is the view technology of choice, and it’s certainly better than many alternatives, but at the heart it is still xml and all those brackets make me dizzy after awhile. Along comes Gracelets<\/a> to provide a nice builder DSL<\/a> and Groovy integration as a replacement for my xml woes. Yay! It also brings some great simplification to the creation of component libraries – including hot deployment. But enough of the sales pitch, let’s see if it works.<\/p>\n

In order to test drive Gracelets, I took an existing Seam web-app and configured the web.xml with the GraceletsViewHandler in place of the standard SeamListener. I generally use Maven<\/a> for dependency management, and I couldn’t find a repository hosting Gracelets so I installed the downloaded jars into my local repository and adding them to the web-app. The JBoss Seam Extension is also required.<\/p>\n

\r\nmvn install:install-file -Dfile=gracelets-api-2.0.0.jar -DgroupId=gracelets -DartifactId=gracelets-api -Dversion=2.0.0 -Dpackaging=jar -DgeneratePom=true\r\nmvn install:install-file -Dfile=gracelets-impl-2.0.0.RC2.jar -DgroupId=gracelets -DartifactId=gracelets-impl -Dversion=2.0.0.RC2 -Dpackaging=jar -DgeneratePom=true\r\nmvn install:install-file -Dfile=jboss_seam_2.0.0_all-1.0.11.jar -DgroupId=gracelets -DartifactId=jboss-seam-extension -Dversion=1.0.11 -Dpackaging=jar -DgeneratePom=true\r\n<\/pre>\n
\r\n<dependency>\r\n        <groupid>gracelets<\/groupid>\r\n        <artifactid>jboss-seam-extension<\/artifactid>\r\n        <version>1.0.11<\/version>\r\n<\/dependency>\r\n<dependency>\r\n        <groupid>gracelets<\/groupid>\r\n        <artifactid>gracelets-api<\/artifactid>\r\n        <version>2.0.0<\/version>\r\n <\/dependency>\r\n <dependency>\r\n        <groupid>gracelets<\/groupid>\r\n        <artifactid>gracelets-impl<\/artifactid>\r\n        <version>2.0.0.RC2<\/version>\r\n <\/dependency>\r\n<\/pre>\n
The application was deployed as usual and fired up without a problem. For a test page I just created an index.groovy file in the root directory. According to the docs, a .groovy extension trumps .xhtml so that effectively replaced the front page of the app. Here’s the standard first page of a new web-app(straight from the Gracelets examples), with the xhtml builder.<\/p>\n
\r\nxh.html { \r\n     head { title("Hello World Example") }\r\n\r\n     body {\r\n         print { "Hello World @ " + new Date() }\r\n     }\r\n}\r\n<\/pre>\n
Not bad, let’s compare to the standard Facelets version, using a file based on the standard seam-gen created index.xhtml file. I’ve bound the instantiation of the Date object to a backing bean, since you can’t make an inline call to do it a standard Facelets view. I seem to recall seeing that Seam kept a component available to provide the present Date\/Time, but I couldn’t find it offhand today.<\/p>\n
\r\n<!DOCTYPE html PUBLIC "-\/\/W3C\/\/DTD XHTML 1.0 Transitional\/\/EN"\r\n        "http:\/\/www.w3.org\/TR\/xhtml1\/DTD\/xhtml1-transitional.dtd">\r\n<f:view contentType="text\/html"\r\n        xmlns="http:\/\/www.w3.org\/1999\/xhtml"\r\n        xmlns:ui="http:\/\/java.sun.com\/jsf\/facelets"\r\n        xmlns:h="http:\/\/java.sun.com\/jsf\/html"\r\n        xmlns:f="http:\/\/java.sun.com\/jsf\/core"\r\n        xmlns:a="http:\/\/richfaces.org\/a4j"\r\n        xmlns:s="http:\/\/jboss.com\/products\/seam\/taglib">\r\n    <html>\r\n    <head>\r\n        <meta http-equiv="Content-Type" content="text\/html; charset=UTF-8"\/>\r\n        <title>Hello World Example<\/title>\r\n        <ui:insert name="head"\/>\r\n    <\/head>\r\n    <body>\r\n    Hello World @ #{backingBean.date}\r\n    <\/body>\r\n    <\/html>\r\n<\/f:view>\r\n<\/pre>\n
Notice I’ve also left the Seam and RichFaces<\/a> tab library namespaces in the xml declaration. Although the Gracelets docs didn’t seem to easily confirm this, inclusion of the JBoss Seam extension also makes those libraries and their associated builders available by default for Gracelets views. Here’s a final example to leave you with that incorporates a couple of elements from those libraries and a quick and dirty use of .each for rendering, and even a couple of screenshots to show off the progression.<\/p>\n
\r\ndef loremIpsum = '''\r\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Proin tempor, mauris sed volutpat consequat, risus tellus ultrices\r\ntortor, at sollicitudin felis erat vitae augue. Pellentesque habitant morbi tristique senectus et netus et malesuada fames\r\nac turpis egestas. Vestibulum tincidunt egestas viverra. Integer ullamcorper, ipsum id malesuada sollicitudin, nisl velit\r\nultricies purus, eu aliquet diam mi sit amet eros. Quisque arcu orci, consequat dictum vehicula a, pellentesque eu nisl.\r\n'''\r\nxh.html {\r\n     head { title("Hello World Example") }\r\n     body {\r\n         s.div(id:'aSeamDiv', rendered:'true') {\r\n            r.panel(header:'A RichFaces Panel') {\r\n                println { "Hello World @ " + new Date() }\r\n                a('MyBlogLink', href: 'https:\/\/www.kellyrob99.com\/blog')\r\n            }\r\n         }\r\n         r.separator()\r\n         r.spacer()\r\n         r.simpleTogglePanel(header:'A RichFaces TogglePanel'){\r\n            println loremIpsum\r\n         }\r\n\r\n         def tableModel = loremIpsum.tokenize()[0..10]\r\n         def tableModel2 = loremIpsum.tokenize()[11..20]\r\n         table {\r\n            tr {\r\n                td {\r\n                    tableModel.each { println it }\r\n                }\r\n                td {\r\n                    tableModel2.each { println it }\r\n                }\r\n            }\r\n         }\r\n     }\r\n}\r\n<\/pre>\n
Not bad at all. I won’t bore you with the equivalent xml version – suffice it to say it takes up a lot more space.  I haven’t even touched on the easy component\/library features Gracelets provides yet, but I am already quite impressed simply by the replacement of xml with an equivalent but sparser syntax. And I don’t miss the need for closing tags much either. The documentation for the project is quite complete, rich with examples, at least for the standard jsf components(hint hint – more examples using Seam and RichFaces would be appreciated!)  Give it a try and decide for yourself, but if it keeps going this way, it might become a reasonable alternative for Grails.<\/p>\n
\ud83d\ude42<\/p>\nngg_shortcode_0_placeholder\n
\"Reblog<\/a>