com.portal.app.cc.event

Class CCEventMulticaster

java.lang.Object

com.portal.app.cc.event.CCEventMulticaster

All Implemented Interfaces:

BalanceImpactListener, BillInfoChangeListener, ContactChangeListener, CreditLimitListener, DeferralChangeListener, HierarchyChangeListener, HoldingsChangeListener, PaymentChangeListener, ServiceChangeListener, StatusChangeListener, EventListener

public class CCEventMulticaster
extends Object
implements ContactChangeListener, BalanceImpactListener, StatusChangeListener, PaymentChangeListener, ServiceChangeListener, CreditLimitListener, DeferralChangeListener, HierarchyChangeListener, HoldingsChangeListener, BillInfoChangeListener

A class which implements efficient and thread-safe multi-cast event dispatching for the customer care events defined in the com.portal.app.cc.event package. This class will manage an immutable structure consisting of a chain of event listeners and will dispatch events to those listeners. Because the structure is immutable, it is safe to use this API to add/remove listeners during the process of an event dispatch operation.

Version:

%version: 9 % %date_modified: Thu Jun 07 17:32:00 2001 %

Author:

kapono

Field Summary

Fields

Modifier and Type	Field and Description
protected EventListener	a
protected EventListener	b

Constructor Summary

Constructors

Constructor and Description
CCEventMulticaster() Creates an event multicaster instance which chains listener-a with listener-b.
CCEventMulticaster(EventListener a, EventListener b) Creates an event multicaster instance which chains listener-a with listener-b.

Method Summary

Modifier and Type	Method and Description
BalanceImpactListener	add(BalanceImpactListener a, BalanceImpactListener b) Adds balance impact-listener-a with balance impact-listener-b and returns the resulting multicast listener.
BillInfoChangeListener	add(BillInfoChangeListener a, BillInfoChangeListener b) Adds credit limit change-listener-a with credit limit change-listener-b and returns the resulting multicast listener.
ContactChangeListener	add(ContactChangeListener a, ContactChangeListener b) Adds contact change-listener-a with contact change-listener-b and returns the resulting multicast listener.
CreditLimitListener	add(CreditLimitListener a, CreditLimitListener b) Adds credit limit change-listener-a with credit limit change-listener-b and returns the resulting multicast listener.
DeferralChangeListener	add(DeferralChangeListener a, DeferralChangeListener b) Adds deferral change-listener-a with deferral change-listener-b and returns the resulting multicast listener.
HierarchyChangeListener	add(HierarchyChangeListener a, HierarchyChangeListener b) Adds hierarchy change-listener-a with hierarchy change-listener-b and returns the resulting multicast listener.
HoldingsChangeListener	add(HoldingsChangeListener a, HoldingsChangeListener b) Adds holdings change-listener-a with holdings change-listener-b and returns the resulting multicast listener.
PaymentChangeListener	add(PaymentChangeListener a, PaymentChangeListener b) Adds payment change-listener-a with payment change-listener-b and returns the resulting multicast listener.
ServiceChangeListener	add(ServiceChangeListener a, ServiceChangeListener b) Adds service change-listener-a with service change-listener-b and returns the resulting multicast listener.
StatusChangeListener	add(StatusChangeListener a, StatusChangeListener b) Adds status change-listener-a with status change-listener-b and returns the resulting multicast listener.
protected EventListener	addInternal(EventListener a, EventListener b) Returns the resulting multicast listener from adding listener-a and listener-b together.
void	balanceImpact(BalanceImpactEvent e) Handles the BalanceImpact event by invoking the balanceImpact methods on listener-a and listener-b
void	billInfoChange(BillInfoChangeEvent e) Called when an event is sent out that impacts a service
void	contactChange(ContactChangeEvent e) Handles the ContactChange event by invoking the contactChange methods on listener-a and listener-b
void	creditLimitChange(CreditLimitEvent e) Handles the CreditLimitEvent by invoking the creditLimitChange methods on listener-a and listener-b
void	deferralChange(DeferralChangeEvent e) Handles the DeferralChange event by invoking the deferralChange methods on listener-a and listener-b
void	hierarchyChange(HierarchyChangeEvent e) Handles the HierarchyChange event by invoking the hierarchyChange methods on listener-a and listener-b
void	holdingsChange(HoldingsChangeEvent e) Handles the HoldingsChangeEvent by invoking the holdingsChange methods on listener-a and listener-b
void	paymentChange(PaymentChangeEvent e) Handles the PaymentChangeEvent by invoking the paymentChange methods on listener-a and listener-b
BalanceImpactListener	remove(BalanceImpactListener l, BalanceImpactListener oldl) Removes the old balance impact-listener from balance impact-listener-l and returns the resulting multicast listener.
BillInfoChangeListener	remove(BillInfoChangeListener l, BillInfoChangeListener oldl) Removes the old credit limit change-listener from credit limit change-listener-l and returns the resulting multicast listener.
ContactChangeListener	remove(ContactChangeListener l, ContactChangeListener oldl) Removes the old contact change-listener from contact change-listener-l and returns the resulting multicast listener.
CreditLimitListener	remove(CreditLimitListener l, CreditLimitListener oldl) Removes the old credit limit change-listener from credit limit change-listener-l and returns the resulting multicast listener.
DeferralChangeListener	remove(DeferralChangeListener l, DeferralChangeListener oldl) Removes the old deferral change-listener from deferral change-listener-l and returns the resulting multicast listener.
protected EventListener	remove(EventListener oldl) Removes a listener from this multicaster and returns the resulting multicast listener.
HierarchyChangeListener	remove(HierarchyChangeListener l, HierarchyChangeListener oldl) Removes the old hierarchy change-listener from hierarchy change-listener-l and returns the resulting multicast listener.
HoldingsChangeListener	remove(HoldingsChangeListener l, HoldingsChangeListener oldl) Removes the old holdings change-listener from holdings change-listener-l and returns the resulting multicast listener.
PaymentChangeListener	remove(PaymentChangeListener l, PaymentChangeListener oldl) Removes the old payment change-listener from payment change-listener-l and returns the resulting multicast listener.
ServiceChangeListener	remove(ServiceChangeListener l, ServiceChangeListener oldl) Removes the old service change-listener from service change-listener-l and returns the resulting multicast listener.
StatusChangeListener	remove(StatusChangeListener l, StatusChangeListener oldl) Removes the old status change-listener from status change-listener-l and returns the resulting multicast listener.
protected EventListener	removeInternal(EventListener l, EventListener oldl) Returns the resulting multicast listener after removing the old listener from listener-l.
protected void	save(ObjectOutputStream s, String k, EventListener l)
protected void	saveInternal(ObjectOutputStream s, String k)
void	serviceChange(ServiceChangeEvent e) Handles the ServiceChangeEvent by invoking the serviceChange methods on listener-a and listener-b
void	statusChange(StatusChangeEvent e) Handles the StatusChange event by invoking the statusChange methods on listener-a and listener-b

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

a

protected EventListener a

b

protected EventListener b

Constructor Detail

CCEventMulticaster

public CCEventMulticaster()

Creates an event multicaster instance which chains listener-a with listener-b. Input parameters a and b should not be null, though implementations may vary in choosing whether or not to throw NullPointerException in that case.

CCEventMulticaster

public CCEventMulticaster(EventListener a,
                          EventListener b)

Creates an event multicaster instance which chains listener-a with listener-b. Input parameters a and b should not be null, though implementations may vary in choosing whether or not to throw NullPointerException in that case.

Parameters:

a - listener-a

b - listener-b

Method Detail

hierarchyChange

public void hierarchyChange(HierarchyChangeEvent e)

Handles the HierarchyChange event by invoking the hierarchyChange methods on listener-a and listener-b

Specified by:

hierarchyChange in interface HierarchyChangeListener

Parameters:

The - hierarchy change event

add

public HierarchyChangeListener add(HierarchyChangeListener a,
                                   HierarchyChangeListener b)

Adds hierarchy change-listener-a with hierarchy change-listener-b and returns the resulting multicast listener.

Parameters:

a - hierarchy change-listener-a

b - hierarchy change-listener-b

remove

public HierarchyChangeListener remove(HierarchyChangeListener l,
                                      HierarchyChangeListener oldl)

Removes the old hierarchy change-listener from hierarchy change-listener-l and returns the resulting multicast listener.

Parameters:

l - hierarchy change-listener-l

oldl - the hierarchy change-listener being removed

holdingsChange

public void holdingsChange(HoldingsChangeEvent e)

Handles the HoldingsChangeEvent by invoking the holdingsChange methods on listener-a and listener-b

Specified by:

holdingsChange in interface HoldingsChangeListener

Parameters:

The - holdings change event

add

public HoldingsChangeListener add(HoldingsChangeListener a,
                                  HoldingsChangeListener b)

Adds holdings change-listener-a with holdings change-listener-b and returns the resulting multicast listener.

Parameters:

a - holdings change-listener-a

b - holdings change-listener-b

remove

public HoldingsChangeListener remove(HoldingsChangeListener l,
                                     HoldingsChangeListener oldl)

Removes the old holdings change-listener from holdings change-listener-l and returns the resulting multicast listener.

Parameters:

l - holdings change-listener-l

oldl - the holdings change-listener being removed

deferralChange

public void deferralChange(DeferralChangeEvent e)

Handles the DeferralChange event by invoking the deferralChange methods on listener-a and listener-b

Specified by:

deferralChange in interface DeferralChangeListener

Parameters:

The - deferral change event

add

public DeferralChangeListener add(DeferralChangeListener a,
                                  DeferralChangeListener b)

Adds deferral change-listener-a with deferral change-listener-b and returns the resulting multicast listener.

Parameters:

a - deferral change-listener-a

b - deferral change-listener-b

remove

public DeferralChangeListener remove(DeferralChangeListener l,
                                     DeferralChangeListener oldl)

Removes the old deferral change-listener from deferral change-listener-l and returns the resulting multicast listener.

Parameters:

l - deferral change-listener-l

oldl - the deferral change-listener being removed

statusChange

public void statusChange(StatusChangeEvent e)

Handles the StatusChange event by invoking the statusChange methods on listener-a and listener-b

Specified by:

statusChange in interface StatusChangeListener

Parameters:

The - status change event

add

public StatusChangeListener add(StatusChangeListener a,
                                StatusChangeListener b)

Adds status change-listener-a with status change-listener-b and returns the resulting multicast listener.

Parameters:

a - status change-listener-a

b - status change-listener-b

remove

public StatusChangeListener remove(StatusChangeListener l,
                                   StatusChangeListener oldl)

Removes the old status change-listener from status change-listener-l and returns the resulting multicast listener.

Parameters:

l - deferral change-listener-l

oldl - the status change-listener being removed

balanceImpact

public void balanceImpact(BalanceImpactEvent e)

Handles the BalanceImpact event by invoking the balanceImpact methods on listener-a and listener-b

Specified by:

balanceImpact in interface BalanceImpactListener

Parameters:

The - balance impact event

add

public BalanceImpactListener add(BalanceImpactListener a,
                                 BalanceImpactListener b)

Adds balance impact-listener-a with balance impact-listener-b and returns the resulting multicast listener.

Parameters:

a - balance impact-listener-a

b - balance impact-listener-b

remove

public BalanceImpactListener remove(BalanceImpactListener l,
                                    BalanceImpactListener oldl)

Removes the old balance impact-listener from balance impact-listener-l and returns the resulting multicast listener.

Parameters:

l - balance impact-listener-l

oldl - the balance impact-listener being removed

contactChange

public void contactChange(ContactChangeEvent e)

Handles the ContactChange event by invoking the contactChange methods on listener-a and listener-b

Specified by:

contactChange in interface ContactChangeListener

Parameters:

The - contact change event

add

public ContactChangeListener add(ContactChangeListener a,
                                 ContactChangeListener b)

Adds contact change-listener-a with contact change-listener-b and returns the resulting multicast listener.

Parameters:

a - contact change-listener-a

b - contact change-listener-b

remove

public ContactChangeListener remove(ContactChangeListener l,
                                    ContactChangeListener oldl)

Removes the old contact change-listener from contact change-listener-l and returns the resulting multicast listener.

Parameters:

l - contact change-listener-l

oldl - the contact change-listener being removed

serviceChange

public void serviceChange(ServiceChangeEvent e)

Handles the ServiceChangeEvent by invoking the serviceChange methods on listener-a and listener-b

Specified by:

serviceChange in interface ServiceChangeListener

Parameters:

The - event encapsulating the service change

add

public ServiceChangeListener add(ServiceChangeListener a,
                                 ServiceChangeListener b)

Adds service change-listener-a with service change-listener-b and returns the resulting multicast listener.

Parameters:

a - service change-listener-a

b - service change-listener-b

remove

public ServiceChangeListener remove(ServiceChangeListener l,
                                    ServiceChangeListener oldl)

Removes the old service change-listener from service change-listener-l and returns the resulting multicast listener.

Parameters:

l - service change-listener-l

oldl - the service change-listener being removed

paymentChange

public void paymentChange(PaymentChangeEvent e)

Handles the PaymentChangeEvent by invoking the paymentChange methods on listener-a and listener-b

Specified by:

paymentChange in interface PaymentChangeListener

Parameters:

The - contact change event

add

public PaymentChangeListener add(PaymentChangeListener a,
                                 PaymentChangeListener b)

Adds payment change-listener-a with payment change-listener-b and returns the resulting multicast listener.

Parameters:

a - payment change-listener-a

b - payment change-listener-b

remove

public PaymentChangeListener remove(PaymentChangeListener l,
                                    PaymentChangeListener oldl)

Removes the old payment change-listener from payment change-listener-l and returns the resulting multicast listener.

Parameters:

l - payment change-listener-l

oldl - the payment change-listener being removed

creditLimitChange

public void creditLimitChange(CreditLimitEvent e)

Handles the CreditLimitEvent by invoking the creditLimitChange methods on listener-a and listener-b

Specified by:

creditLimitChange in interface CreditLimitListener

Parameters:

The - contact change event

add

public CreditLimitListener add(CreditLimitListener a,
                               CreditLimitListener b)

Adds credit limit change-listener-a with credit limit change-listener-b and returns the resulting multicast listener.

Parameters:

a - credit limit change-listener-a

b - credit limit change-listener-b

remove

public CreditLimitListener remove(CreditLimitListener l,
                                  CreditLimitListener oldl)

Removes the old credit limit change-listener from credit limit change-listener-l and returns the resulting multicast listener.

Parameters:

l - credit limit change-listener-l

oldl - the credit limit change-listener being removed

billInfoChange

public void billInfoChange(BillInfoChangeEvent e)

Description copied from interface: BillInfoChangeListener

Called when an event is sent out that impacts a service

Specified by:

billInfoChange in interface BillInfoChangeListener

Parameters:

e - a ServiceChangeEvent encapsulating the event information

add

public BillInfoChangeListener add(BillInfoChangeListener a,
                                  BillInfoChangeListener b)

Adds credit limit change-listener-a with credit limit change-listener-b and returns the resulting multicast listener.

Parameters:

a - credit limit change-listener-a

b - credit limit change-listener-b

remove

public BillInfoChangeListener remove(BillInfoChangeListener l,
                                     BillInfoChangeListener oldl)

Removes the old credit limit change-listener from credit limit change-listener-l and returns the resulting multicast listener.

Parameters:

l - credit limit change-listener-l

oldl - the credit limit change-listener being removed

remove

protected EventListener remove(EventListener oldl)

Removes a listener from this multicaster and returns the resulting multicast listener.

Parameters:

oldl - the listener to be removed

addInternal

protected EventListener addInternal(EventListener a,
                                    EventListener b)

Returns the resulting multicast listener from adding listener-a and listener-b together. If listener-a is null, it returns listener-b; If listener-b is null, it returns listener-a If neither are null, then it creates and returns a new CCEventMulticaster instance which chains a with b.

Parameters:

a - event listener-a

b - event listener-b

removeInternal

protected EventListener removeInternal(EventListener l,
                                       EventListener oldl)

Returns the resulting multicast listener after removing the old listener from listener-l. If listener-l equals the old listener OR listener-l is null, returns null. Else if listener-l is an instance of CCEventMulticaster, then it removes the old listener from it. Else, returns listener l.

Parameters:

l - the listener being removed from

oldl - the listener being removed

saveInternal

protected void saveInternal(ObjectOutputStream s,
                            String k)
                     throws IOException

Throws:

IOException

save

protected void save(ObjectOutputStream s,
                    String k,
                    EventListener l)
             throws IOException

Throws:

IOException