*** Update: 8.14.2007: The code in this article is out of date. Please refer to the new entry instead. ***
This example utilizes Amazon’s search webservice in the Cairngorm 2 application framework. You can go to Amazon.com and register for a free API key. Once you do, you just plug into this example’s constant file, and she’ll work for you too if you when you compile. This example application allows you to search for books on Amazon.com by keywords.
The events are debatable in their place in the package structure. They extend CairngormEvent, thus implying they fire commands, but you could reuse events. Also, I am not very good at E4X so please do not use that as an example of E4X usage.
Here’s basically how she works:
- App boots up, shows first state
- user types in some keywords, clicks the Search button
- this fires the doSearch event handler
- the doSearch handler creates a CairngormEvent, and dispatches it
- the Controller has mapped that type of event to a Command, and thus it runs the command, passing it the event
- the Command looks at the event type in the execute function and decides what to run, in this case, searchBooks, passing the event’s data to the function
- search books creates the Business Delegate, and calls its method
- the Delegate gets the WebService from the ServiceLocator, fires off the WebService, and waits for a response
- if the response is successful, it parses the E4X XML via a Factory to a list of Book ValueObjects
- finally, it calls the responder’s onResult function
- Since the Command is the Responder, he gets the data, and sets it to the ModelLocator and updates the applications state
- The View’s are bound to the state variable and book list in the ModelLocator, so they immediately have their bindings fire
- This causes the main app to change state, and show the results DataGrid
- The results DataGrid is bound to the books list in the ModelLocator, and shows the results.
* Note: I haven’t got my serial for Flex Builder 2 yet, so the App & View Source will time out after a day. The source, however, is good forever.
Flex 2 WebService & Cairngorm 2 Example – App | View Source | Source ZIP
BTW, I fixed my Atom feeds, thanks to those who let me know they were busted. If I don’t know it’s broke, I can’t fix it.
Comments
27 responses to “Flex 2 WebService & Cairngorm 2 Example”
That’s an interesting note regarding expriration of SWF files after 1 day compiled by the help of Flex Builder 2.
What will happen if we will compile SWF file using Flex 2 command-line compiler ( via Ant script, for example)
In my understanding, because Flex 2 SDK is free, those SWF compiled from command line should last for ever w/o time bomb put inside.
Commandline compiler SWF’s do not timeout.
I think SWF’s created with a trial version of Flex Builder 2 do, though.
Thanks so much for this example implementation. An elegant, straightforward example.
Doesn’t seem to work anymore.
the app doesn’t load at all
Others have reported this problem. It has been suggested that perhaps I’m compiling for an earlier build of the player. I haven’t had time to check this yet, but if you compile yourself, she should work just fine.
b
jo
I’m getting the following error when submiting the search term. Any idea what may be happning?
TypeError: Error #1009: Cannot access a property or method of a null object reference.
at com.jxl.amazon.factories::AmazonFactory/buildArrayOfBooksFromXML()
at com.jxl.amazon.business::SearchDelegate/com.jxl.amazon.business:SearchDelegate::searchBooks_onResult()
at flash.events::EventDispatcher/flash.events:EventDispatcher::dispatchEventFunction()
at flash.events::EventDispatcher/dispatchEvent()
at mx.rpc::AbstractService/dispatchEvent()
at mx.rpc.soap.mxml::WebService/dispatchEvent()
at mx.rpc::AbstractOperation/http://www.adobe.com/2006/flex/mx/internal::dispatchRpcEvent()
at mx.rpc::AbstractInvoker/http://www.adobe.com/2006/flex/mx/internal::resultHandler()
at mx.rpc::Responder/result()
at mx.rpc::AsyncRequest/acknowledge()
at ::DirectHTTPMessageResponder/completeHandler()
at flash.events::EventDispatcher/flash.events:EventDispatcher::dispatchEventFunction()
at flash.events::EventDispatcher/dispatchEvent()
at flash.net::URLLoader/flash.net:URLLoader::onComplete()
Hrm… did you input an Amazon API key?
Great resource Jess!
Just a small note that caused me a little grief to help those new on the learning track to avoid. If you’re converting this to a HTTPService app, make sure to call
ServiceLocator.getInstance().getHTTPService(‘ServiceNameGoesHere’) as HTTPService
instead of
ServiceLocator.getInstance().getService(‘ServiceNameGoesHere’) as WebService
in your SearchDelegate.as file after adding the HTTPService in the Services.as file. Otherwise it will give you a result event type casting error.
yes..Jester! That was it. Shame on me for not reading that at the top. Usually when I see an example, I like to quickly compile and test if it works before analyzing it. Works like a charm. Look forward to breaking it down. BTW, how do you use the DebugWindow with it??
Jeremy
First, uncomment line 42:
debug_win = PopUpManager.createPopUp(this, DebugWindow, false) as DebugWindow;
Second, type something like:
DebugWindow.debug(‘Hola, que tal!’);
An absolutely beautiful job! Many, many thanks for this contribution.
Every time I run I get the same error as boybles was getting. I made sure that I have my amazon key which seemed to resolve boybles problem, but I still get the same error (see below)… any ideas?
TypeError: Error #1009: Cannot access a property or method of a null object reference.
at com.jxl.amazon.factories::AmazonFactory/buildArrayOfBooksFromXML()
at com.jxl.amazon.business::SearchDelegate/com.jxl.amazon.business:SearchDelegate::searchBooks_onResult()
at flash.events::EventDispatcher/flash.events:EventDispatcher::dispatchEventFunction()
at flash.events::EventDispatcher/dispatchEvent()
at mx.rpc::AbstractService/dispatchEvent()
at mx.rpc.soap.mxml::WebService/dispatchEvent()
at mx.rpc::AbstractOperation/http://www.adobe.com/2006/flex/mx/internal::dispatchRpcEvent()
at mx.rpc::AbstractInvoker/http://www.adobe.com/2006/flex/mx/internal::resultHandler()
at mx.rpc::Responder/result()
at mx.rpc::AsyncRequest/acknowledge()
hi jester,
Thanks for the sample… one question, why it only retrieves 10 items?
regards “)
I think that’s Amazon’s API, bro. They encourage you to page the results. I’m sure there is a way to get more, though.
When I try to run the app it gets to the service.ItemSearch() call in the searchDelegate and then gets a fault. But when I look at the fault event I can’t seem to figure out what the error is. The message text and message id are both null. I got a key from amazon and put that in so I don’t believe that is the issue. The faultString says something about Actor not supplied but is required. Actor seems to be required for some other method not the one being called by this example. If I let it continue nothing happens.
Any help would be appreciated.
Thanks!
I can duplicate this error in my Flex 2.01. So far, no documentation nor Google results can be found about this specific error. Still digging…
Thanks. I thought I was losing my mind.
I have an Urgent need for a Perm. Sr. Applications Developer/Flex Architect in the Dallas Texas area, would you happen to know of anyone with that experience that would be interested? If so please let me know.
Kim Dobson
Placement Manager
214-277-2097
I’m getting the same fault that John G. has reported above, with the same faultString Has anyone had any luck in figuring it out? Google still doesn’t show any relevant info.
Thanks.
Thanks for posting the sample, its very helpful for me. I am getting the same error reported by John G in Flex Builder 2.0.1
Fantastic, thank you so much for the example! I’m all new to Cairngorm, and couldn’t find the Delegate class anywhere, nor could I figure out how to transfer the example in the tutorial (which uses a RemoteObject) to a HTTPService, so I got stuck on the business classes. Your example saved the day! :-)
Same fault event Apparently something has changed in the 2.01 framework. It is not a sandbox issue as I get the same fault event in an Apollo test. Apollo has signifigantly less sandbox restrictions.
Flex Example: HTTPService & Cairngorm 2.2
Preface Cairngorm 2.2 was released on labs today. Upon reading Eric’s blog entry, I noticed they fixed a WebService bug. Hoping it was the one that sabotaged my original example, I downloaded and implemented. It did fix it, but Amazon…
The application link looks broken.. So is the link to the source..
Entry is old, Uday. Go here:
https://jessewarden.com/2007/04/flex-example-httpservice-cairngorm-22.html