Saturday, November 10, 2007

Dojo Grid + Jester + Rails = RESTful grid goodness



I've been experimenting with Javascript component frameworks lately, and that let me to look at Dojo. With their 1.0 release, they have added what looks to be a very powerful Grid component. I thought it would be fun to see how easy it is to get it talking with Rails. It proved to be not much code at all, and I think, kind of nifty. Here's how to do it.

Create a Rails app with a RESTful service


Not gonna go thru how to make a rails app, I'll assume you know that already. I created a little RESTful service with the scaffold generator something like this:

script/generate scaffold_resource Car make:string year:integer


Install Jester

When I found Jester it was one of those Open Source Moments for me. You know, the ones where you think: "Hey, wouldn't it be cool if you could..." and then Google and find out someone has already done it. Jester is basically ActiveResource in Javascript. The result makes so ridiculously easy to talk to RESTful services it's not even funny. I installed by unzipping the script and dropping jester.js in public/javascripts in my Rails app.

Install Dojo 1.0

Go get it, unzip it, drop it into public/javascripts. Nuff said

Write the code

And now for the fun part :) We'll start with a simple grid that pulls in data by making a RESTful call to our Rails app using Jester. Later on we'll enhance it to make it editable. First thing you need to know about Dojo is that it is CSS driven. This is definitely a good thing IMO, but it does mean you have to include the right CSS or it won't work at all, trust me ;) So make you sure you include the Dojo Grid CSS like so:


5 <style type="text/css">
6 @import "/javascripts/dojo-release-1.0.0/dijit/themes/tundra/tundra.css";
7 @import "/javascripts/dojo-release-1.0.0/dojox/grid/_grid/Grid.css";
8 @import "/javascripts/dojo-release-1.0.0/dojox/grid/_grid/tundraGrid.css";
9
10 </style>


Next, we'll need to include Jester and Dojo:


12 <%= javascript_include_tag :defaults %>
13 <%= javascript_include_tag "jester" %>
14 <script type="text/javascript"
15 src="/javascripts/dojo-release-1.0.0/dojo/dojo.js"
16 djConfig="parseOnLoad: true"></script>

Including Jester is just a matter of including using the standard javascript_include_tag helper, but dojo is a little wierd. You'll notice the djConfig attribute for starters. How does this even work? djConfig is not even a valid attribute for a script tag, right? As best I understand it, and someone please jump in if I'm wrong, dojo has a parser of it's own that comes along after your page load sand does things to it. This let's you add dojo components to your page "declaratively", or in html, instead of have to use so much javascript. Kind of interesting.

Now let's look at the script block that sets up the objects our grid will need:


18 <script type="text/javascript">
19 dojo.require("dojo.parser");
20 dojo.require("dojox.grid.Grid");
21 dojo.require("dojox.grid._data.model");
22
23 Resource.model("Car");
24 cars = Car.find("all");
25
26 var model = new dojox.grid.data.Objects([{key: "make"}, {key: "year"}], cars);
27
28 var structure = [ {
29 rows: [[
30 {name: 'Make'},
31 {name: 'Year'}
32 ]]
33 } ];
34
35
36 </script>
The first thing you'll notice is those dojo.require statements. These are how you tell dojo to go get all of the pieces it needs. Dojo is broken down into lots of individual javascript files, and while you could just include them all in script tags, that would be kind of a pain. dojo.require basically says "go get this piece and all of it's dependencies". It makes it easier to use some of dojo and not all of dojo as well.

Next we see Jester in action. Kind of puts dojo to shame from an ease of use standpoint, doesn't it? You tell Jester which model you want, and it makes a javascript class for you. We then call find all and it gives us back an array javascript proxy objects with the fields and methods you would expect. Like I said, ridiculously easy. There are options to have it do find (and save) asynchronously as well, which you would probably want to use for a real application.

Next we setup some objects our dojo grid needs. The first is a model, it tells dojo where to get it's data from. We're able to use of the built in types of models, dojo.grid.data.Objects. This kind of model will display an array of Javascript objects, which, conveniently enough, is exactly what we got back from the call to find. We have to give it a little more information, though, namely what properties to display in which columns of our grid. This is what we're doing in the first argument to the constructor. The second argument is our array of cars we got back from the call to Car.find("all").

Finally, we have an object that tells how we want our grid organized. I have to say this seems a lot more complicated than I'd like. It seems to me sometimes dojo is more focused on making the hard things possible than making the simple things simple. So I'm not even going to try to cover all the details of the structure object here, but briefly dojo grid structures consist of an array of views which have an array of rows which have an array of subrows. Phew. I think it would be possible to come up with a simpler structure object for simpler cases, but that would require more dojo-fu than I have yet.

At last, we're ready to put in the html for our grid. Here it is:


42 <div id="grid" dojoType="dojox.Grid"

43 model="model" structure="structure"
44 autoWidth="true" autoHeight="true">

45 </div>


Not much to it is there. Notice how we can set properties of our grid with html attributes. This is what the dojo parser does for us, as I understand it. Here we're passing in the model and structure we created in our script block.

So this is all that's required to use the dojo grid component and have it pull data from a REST service implemented in Rails. In my next post I'll show you how to have it be editable and save it's data using thru REST as well. It's easier than you might think.

11 comments:

Dat Chu said...

Wow, I have to say. Wow, how come nobody came across your post before. I have always been wondering what else can REST service do and you have just answered that.

Dojo Grid is super nice as well and Jester is just like the catalyst to it all. Thanks for a really good post.

nullobject said...

This is very cool, I'm trying to integrate Ext + Jester + Rails myself. Have you managed to resolve how to do paging in the grid using only Jester to do the RESTful requests? This is what I'm still scratching my head about...

Songa said...

Thanks for great post!

I am trying to implement your solution but i am getting a stack overflow error at line 403, I presume this is in the jester.js file but I am not sure why it is happening.

please advise whenever you have the time.

Thanks

Songa said...

I figured it out, I was not addressing my model properly!

soolo said...

However, sumptuous texture and exquisite craftsmanship will not be covered by this simple dressing. It will be dazzling to accent your high-end taste.cambridge satchel|cambridge satchels|cambridge satchel|cambridge satchels|cambridge satchel companycambridge satchel co|the cambridge satchel company|cambridge satchel bag|cambridge satchel company briefcase bag|the cambridge satchel|cambridge satchel company review|cambridge satchel company 11 satchel|cambridge leather satchel|cambridge satchel company bag|satchel cambridge|cambridge satchel company discount|cambridge satchel bags|cambridge satchel company discount code

Unknown said...

The visual Diablo III itemsappeal of gentle yellow, pale pink and gentle blue will make the complete assortment diffuse the inhale of youthful lady Buy RS Goldand pleasant mood; she appears like really graceful

rscredits said...

buy runescape gold with 5% discount code:CHRISTMAS.

Details: http://www.rsorder.com/profile/news/read/id/443

Free 200M runescape gold Giveaway on RSorder Flash Sale! Time: 03:00 AM on December 21, 2012 GMT

To know more: http://www.rsorder.com/profile/news/read/id/441

Like RSorder Facebook to Get 200M Free rs gold! If our facebook fans reach to 10,000, we will send out totally 200M free RS gold.

Rsorder facebook : http://www.facebook.com/RSorderSite?ref=tn_tnmn

Detailed info at: http://www.rsorder.com/profile/news/read/id/435

Fast delivery can be assured if you buy rs gold pay by Western Union at Rsorder!

Unknown said...

Worry is the fear we manufacture; it is a choice. Conversely, true fear is involuntary; it will come and get our attention if necessary. But if a parent or a child feels fear constantly, there is no signal left for when it’s really needed. Thus, the parent who chooses to worry all the time or […]

pacetransportationinc |

http://www.family-estate.org |

http://www.v-travelled.com |

www.huntsfa.co.uk |

auction-expert.co.uk |

meiji-ehome.com |

businessmerch |

practical-computersinc |

http://www.lifeinsport.co.uk |

www.oxicoa-health.com |

Unknown said...

I think the way you write feels like having so much passion and you have put it in a way that everyone can understand. Must appreciate the great posts you have written here
http://www.apron2apronsisters.com |

dehollisterco |

http://www.biketowork2013.com |

wirelessronin.net |

http://www.midwestmarketingtesting.com |

Unknown said...

Ik spreek niet over scheurtjes in oude banden, maar in tamelijk nieuwe banden. En dan bedoel ik 1-2 jaar. De cracks waar Sheldon over spreekt is iets heel anders. Die zijn het gevolg van contact met rommel op de weg. De scheurtjes waar ik het over heb, zitten in de flanken en het zijn er honderden. De oorzaak is slechte hechting van de rubbercompound aan de koordlagen, of krimp in de rubbercompound. Dat heet gebrekkige kwaliteit.
wirelessronin.net |

experiencetheserenity |

http://www.servewell.us |

connectserviceswest.com |

jabuconsulting |

manisha said...

Thank you for providing such an awesome article and it is very useful blog for others to read.
Javascript Training in Delhi
Javascript Course in Delhi