Programmatically publishing Contextual Events

ADF task flows provide modularity to the web applications. Bounded task flows are really useful while realizing business use cases, which may repeats across application(s). Please refer Fusion Developer's Guide if you want to know more about this topic. Bounded task flows are added to the page as regions. It is very common that one region may need to communicate with other regions. This is accomplished by Contextual Events. To know more about Contextual Events, please refer Creating Contextual Events.

There are scenarios where task flows may need to raise the Contextual Events based on complex business conditions. Declarative event handling mechanism might not be sufficient in this case. Now the question is how to raise 'Contextual Events' programmatically from backing bean? Let me try summarizing the steps below. Please refer the Fusion Developer's Guide for detailed explanation on creation of Contextual Event.

1. Create the Producer (Payload) Method
2. Bind the Producer Method with task flow, which raises the event
3. Create the Consumer (Handler) Method
4. Map the Contextual Event i.e.: tell the system to use above defined Consumer for a specific event Producer

Once the above infrastructure is in place job is pretty simple. The below code snippet will help you to publish Contextual Event programmatically from the backing (managed) beans. Typically the below code may goes to the action handler methods defined in the backing bean.

DCBindingContainer bc = (DCBindingContainer)BindingContext.getCurrent).getCurrentBindingsEntry();
JUCtrlActionBinding actionBnd =
(JUCtrlActionBinding)bc.getControlBinding("producerMethod");
((DCBindingContainer)bc).getEventDispatcher().queueEvent(actionBnd.getEventProducer(), parameter)
((DCBindingContainer)bc).getEventDispatcher().processContextualEvents();

You can download the sample workspace from here.