A lot of people on the flexcoders yahoo list have asked about creating a tree that uses a custom DataDescriptor to allow lazy loading of the data. In other words, it gets the first level of data when the application loads, but does not call for the children of the branches until each node is open. I had a bit of down time this week, so I thought I'd put one together.
This example actually has two ways to lazy load. The first is the obvious one using a custom DataDescriptor that is designed to work with any class that is written to the LazyLoading Interface. The major things it does are
- Tell the tree that the branch "intends" to have children even when no children have been loaded.
- When a branch is loaded, it tells the LazyLoading to load its children.
This could be slicker, in that I could have extended the Tree to listen for the load to finish, but I chose not to do that.
The second way that the lazy loading can be done is to not use the DefaultDataDescriptor at all, but to instead let the instances of Classification load themselves. This code is in place in the hasChildren setter--you'd just need to uncomment it.
This example is unusual in that it not only uses RemoteObject to retrieve the data, it contains the php files and instructions to recreate the mySQL database, so even if you're mainly looking for an AMFPHP example, you might find it helpful.
The bad part about about this example is that I can't post the working example due to reasons I've already blogged about, so you'll just have to look at this pretty picture and take it on faith that if you follow the instructions below that you've got a really good shot at producing a working lazy loading tree application. (As of 1-14-09, you can click this image to see the working example with View Source enabled. See note at end of post.)
- First, install AMFPHP to your server. I'm going to assume in these steps that you did it to the "flashservices" directory referred to in the installation instructions. I'd suggest that you test the service browser at this point to identify any showstoppers before you get too far.
- Next, download the flex project zip file and import it to your Flex builder workspace.
- Download the rtf translation of the mySQL database table export. This is simply the ".sql" file created from the table export with the extension changed to rtf and some formatting added to make your life easier.
- Download the zip with the php services files. Extract them and place them in the flashservices/services directory. If you didn't install AMFPHP to the flashservices directory, adjust accordingly.
- Create a new mySQL database called 'RemoteServiceTest'.
- Open the classification.rtf file you downloaded earlier.
- Log into phpAdmin or whatever you're using to administer your mySQL databases. Select your new database, and go to the "SQL" panel. In the classification.rtf file, select all of the text that is bold and red and copy it. Paste it into the sql window and run the query. Repeat with the blue, bold text (but only once with each block of text). I got an error with this one about a duplicate key, but it all seemed to come in just fine.
- Adjust your project properties so that your debug and release builds are exported to the right location relative to the flashservices directory. Alternatively, adjust the setChannels() function in the ClassificationGetter to point to where your service actually is.
- Enjoy!
Updated 1-14-09:
Reader David Becarra in Mexico donated a subdomain running PHP 5 so that I could show a running example of this. I don't think that he's accepting new hosting subscribers at the moment, but his website is http://www.misitioweb.net/. BIG THANK YOU, David!!