22 Dec 2012 7:24 AM #1
Message Driven Framework for decoupling Portlets / Modules
Consider dashboard environment. The portlets that are loaded in dashboard may be based on ACL data. Lets go by a scenario to understand this problem better.
Scenario: We need to create a dashboard where we have a button in tool bar of dashboard. On click of that we need to reload data of portlets. In that case, what we shall do is this,
Optimal Solution: I hope we all are aware about Producer and Consumer problem. Where consumer will be subscribing to an interested topic and producer will be producing messages to that topic. Yes, its a JMS kind of implementation we have to do to decouple the portlets / any system. This strategy can be used widely for any of your systems based on its demands. I used this methodology for alteast 2 of the products I designed so far.
Example of Implementation: For our example I used ExtJS 4.1 based portlets. I picked the portlets example of ExtJS library and then implemented a Message Driven Framework for UI (MDF-UI) and solved the question I put in above block. This implementation totally decoupled the portlets and even my other modules where all my events are published as topics and interested subscriber portlets will respond based on the topic and message.
Note: You need to know few things about ExtJS to understand this example easily
Above is the representation of components used to create MDF-UI in ExtJS.
Logger: is used to printing any messages in to browser console.
Constants: is a directory used to maintain all TOPICS
Manager: is a Lookup Index where we can use it for storing any components object to it. It is not used in this framework directly, but still thought of sharing it. You can use this to register all UI components loaded in the system.
NotifierMap: is extension of Ext.util.MixedCollection where I have implementation for how to use it to easily manage all registered Producers and Subscriber informations.
NotificationManager: is the brain of this framework where we use this to register / de-register producers and subscribers along with the topic.
IPublishedMessage: can be used as Mixin where it is used to fetch messages for specified topic
INotifier: is a Mixin where it is abstract implementation of Notifier.
INotificationLsnr: is a Mixin where it is abstract implementation of Notification Listener.
AbstractMessenger: is a sample implementation of MDA-UI
How it works:
Once the UI / Portlet compoent is loaded the initComponent method will be called Ext. There, I am subscribing the same object by calling NotificationManger via INotificationLsnr mixin with the relevant topic. Like wise, any notifier buttons or components will have INotifier mixin with the topics. So, whenever there is an event, the notifiers will send a message to the NotificationManger which in turn will iteratively call the notified methods of all Subscribers with the message.
Download Source: You can download the sample code here or you can visit here to look at the working demo. Codes are very simple and self explanatory. You can look at them and then post me if you need any clarity on that. To set up your environment, simply download the source code and extract to your htdocs / webapp folder of your server and call http://localhost/works/extjs/mda/index.html. You should see the app in action.
Learning Framework: You should open /works/extjs/mda/ux/messaging folder to see Ext.ux.messaging.* components.
(Warning: If your browser is not loading the app, please try refreshing it once. I am still working to solve the Ext.Loader issues. )
Feel free to download and use this framework. I would be more than glad to explain this more if you someone is looking for
Software Architect, Sphata Systems.