Entity Object Publish/Subscribe Events Wizard

Question

Hi,
I'm interested in knowing how exactly works the Entity Objects Publish/Subscribe Events, anybody could help me? Redirecting me to any doc web page, pdf, .... or maybe telling me a little bit more that I can imagine about how it works.
Thanks in advanced.

Answer 1

Repost for a better format, sorry...
I did a quick test on Departments and Employees tables in HR schema.
1, Added CommissionChangeEvent as published event for Employees entity. Set the new commission value (Number) as parameter. These are the generated methods:
* Adds <code>l</code> as an event listener for the event CommissionChangeEvent
public void addCommissionChangeEventListener(JboEventListener l)
((EmployeesDefImpl)getDefinitionObject()).addCommissionChangeEventListener(l);
* Removes <code>l</code> as an event listener for event CommissionChangeEvent
public void removeCommissionChangeEventListener(JboEventListener l)
((EmployeesDefImpl)getDefinitionObject()).removeCommissionChangeEventListener(l);
* Publishes the event named CommissionChangeEvent
public void CommissionChangeEvent()
((EmployeesDefImpl)getDefinitionObject()).publishCommissionChangeEventEvent(createCommissionChangeEventEventData());
* Creates event data method for event CommissionChangeEvent
public JboEventObject createCommissionChangeEventEventData()
JboEventObject eo = new JboEventObject(this, "CommissionChangeEvent");
try
eo.put(new String("CommissionPct"), getAttribute("CommissionPct"));
catch(Exception ex)
ex.printStackTrace();
return eo;
2, Change setCommissionPct method as this:
* Sets <code>value</code> as the attribute value for CommissionPct
public void setCommissionPct(Number value)
setAttributeInternal(COMMISSIONPCT, value);
System.out.println("From EmplyeesImpl.java, Commission Pct is being changed. Firing the event...");
//fire event
CommissionChangeEvent();
System.out.println("Event fired from EmplyeesImpl.java on department ID: " + this.getDepartmentId());
3, Created a method in DepartmentsImpl.java like this:
public void eventFired(Number theNewPct)
System.out.println("In departmentsImpl: event fired with param: " + theNewPct + " on department id: " + this.getDepartmentId());
4, In Entity editor, set enentFired method as to be invoked on event.
Here's the output when change commission:
From EmplyeesImpl.java, Commission Pct is being changed. Firing the event...
In departmentsImpl: event fired with param: 0.5 on department id: 100
Event fired from EmplyeesImpl.java on department ID: 100
Looks like this is a nice inter-entity communication mechanism. It can pass paramter and recognize FK link correctly. Not sure whether it can be used to interact with external message queue, though...
Charles