com.portal.web.comp

Class PAccountActivityBeanImpl

java.lang.Object

com.portal.bas.PControllerImpl

com.portal.web.comp.PAccountActivityBeanImpl

All Implemented Interfaces:

PControllerBean, PAccountActivityBean, Serializable, Remote, Unreferenced

public class PAccountActivityBeanImpl
extends PControllerImpl
implements PAccountActivityBean, Serializable

PAccountActivityBeanImpl is a controller that retrieves the events associated with an account's POID and processes the output flist for the events.

Version:

%version: 16 % %date_modified: Mon Jan 21 14:03:31 2002 %

Author:

sujata

See Also:

Serialized Form

Field Summary

Fields inherited from class com.portal.bas.PControllerImpl

mFList, mRemoteListeners, UPDATE_CLIENT, UPDATE_MODEL_CHANGE, UPDATE_NEW_MODEL, UPDATE_PROPERTY

Constructor Summary

Constructors

Constructor and Description
PAccountActivityBeanImpl() Creates an account activity controller.

Method Summary

Modifier and Type	Method and Description
void	accountactivity(PModelHandle mH, ResourceBundle bundle) Deprecated. As of Release 6.2, this method is deprecated and replaced by the searchEvents(Map) method.
Map	getEvent(int index) Returns a key to value map of the event at the given index location.
List	getEvents() Gets a list of the account's activity events.
Activity	getEvents(int index) Gets the event at the specified index.
List	getIPTEvents() Gets a list of the IPT events.
CallActivity	getIPTEvents(int index) Gets the IPT event at the specified index.
boolean	getIsIPT() Determines whether an IPT event is present.
Object	getSelectionDataFor(String dataItem, int index) Used only for BAS Swing clients.
protected List	normalizeEventElementMap(Map elementMap) Normalizes the event element map.
protected Map	processEventElement(PCachedContext ctx, FList out, Map eventInfo) Parses event array elements in the output flist, removing entries that do not have a balance impact.
protected void	processEventFlist(PCachedContext ctx, FList out, Poid accountPoid) Deprecated. As of Release 6.2, this method is deprecated and replaced by the processResultEventFlist(PCachedContext, FList, Poid, Map) method, which is called by the searchEvents(Map) method.
protected void	processResultEventFlist(PCachedContext ctx, FList out, Poid accountPoid, Map eventInfo) Calls processEventElement(PCachedContext, FList, Map) to parse an event's output flist.
void	searchEvents(Map eventInfo) Retrieves the account POID from its cached PModelHandle and searches for an event.
void	setEndTime(Date endDate) Sets the input date and time for "End billing Date."
void	setEvents(Activity sResult) Sets the event indexed property at index.
void	setEvents(Map sResult) Sets the mapped event indexed property at index.
void	setIPTEvents(CallActivity sResult) Sets the IPT event indexed property at index.
void	setModelHandle(PModelHandle mH) Establishes the model handle for this component.
void	setStartTime(Date startDate) Sets the input date and time for "Start billing Date."
void	update(int reason, Object data) Used only for BAS Swing clients.

Methods inherited from class com.portal.bas.PControllerImpl

addRemoteListener, closeSecContext, createClientException, distributeEventToListeners, fireModelChangeEvent, getAppController, getArrayRange, getContext, getField, getField, getField, getFieldWithRestriction, getFieldWithRestriction, getFieldWithRestriction, getModel, getRemoteListenerHandle, getSecContext, handleDistributeToListener, isLight, register, releaseContext, releaseRemoteListener, removeRemoteListener, setField, setField, setModel, unreferenced

Methods inherited from class java.lang.Object

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

Constructor Detail

PAccountActivityBeanImpl

public PAccountActivityBeanImpl()
                         throws RemoteException

Creates an account activity controller.

Throws:

RemoteException - thrown for errors

Method Detail

setStartTime

public void setStartTime(Date startDate)

Sets the input date and time for "Start billing Date."

Specified by:

setStartTime in interface PAccountActivityBean

Parameters:

startDate - the value to use for the field

setEndTime

public void setEndTime(Date endDate)

Sets the input date and time for "End billing Date."

Specified by:

setEndTime in interface PAccountActivityBean

Parameters:

endDate - the value to use for the field

setModelHandle

public void setModelHandle(PModelHandle mH)
                    throws RemoteException

Establishes the model handle for this component.

Specified by:

setModelHandle in interface PAccountActivityBean

Parameters:

mH - the PModelHandle for the account

Throws:

RemoteException - thrown for errors

getEvents

public List getEvents()

Gets a list of the account's activity events.

Specified by:

getEvents in interface PAccountActivityBean

Returns:

A list of events.

getEvents

public Activity getEvents(int index)

Gets the event at the specified index.

Specified by:

getEvents in interface PAccountActivityBean

Parameters:

index - the index for the event to retrieve

Returns:

The Activity event.

getEvent

public Map getEvent(int index)

Returns a key to value map of the event at the given index location.

Parameters:

index - the event location to map

Returns:

A Map for the specified event.

setEvents

public void setEvents(Activity sResult)

Sets the event indexed property at index.

Parameters:

sResult - the Activity event to add

setEvents

public void setEvents(Map sResult)

Sets the mapped event indexed property at index.

Parameters:

sResult - the mapped event to add

getIsIPT

public boolean getIsIPT()

Determines whether an IPT event is present.

Specified by:

getIsIPT in interface PAccountActivityBean

Returns:

True if this is an IPT event; false otherwise.

getIPTEvents

public List getIPTEvents()

Gets a list of the IPT events.

Specified by:

getIPTEvents in interface PAccountActivityBean

Returns:

A list of the IPT events.

getIPTEvents

public CallActivity getIPTEvents(int index)

Gets the IPT event at the specified index.

Specified by:

getIPTEvents in interface PAccountActivityBean

Parameters:

index - the index for the event to retrieve

Returns:

The IPT CallActivity event.

setIPTEvents

public void setIPTEvents(CallActivity sResult)

Sets the IPT event indexed property at index.

Parameters:

sResult - the CallActivity event to add

update

public void update(int reason,
                   Object data)

Used only for BAS Swing clients. Default behavior in this case is to do nothing.

Specified by:

update in class PControllerImpl

Parameters:

reason - an integer constant that indicates the reason for the update (UPDATE_NEW_MODEL, UPDATE_PROPERTY, UPDATE_MODEL_CHANGE, or UPDATE_CLIENT)

data - the data associated with update

getSelectionDataFor

public Object getSelectionDataFor(String dataItem,
                                  int index)

Used only for BAS Swing clients. Default behavior in this case is to do nothing and return null.

Specified by:

getSelectionDataFor in interface PControllerBean

Parameters:

dataItem - the name of a data item. Must match the name of an item changed by sending a PViewDataChangeEvent.

index - an optional index into an array data item

Returns:

Usually, a model handle or array of model handles.

accountactivity

public void accountactivity(PModelHandle mH,
                            ResourceBundle bundle)
                     throws RemoteException

Deprecated. As of Release 6.2, this method is deprecated and replaced by the searchEvents(Map) method.

Retrieves activity information for the account and calls processEventFlist(PCachedContext, FList, Poid) to process the output flist.

Specified by:

accountactivity in interface PAccountActivityBean

Parameters:

mH - the PModelHandle saved in the session, along with its POID

bundle - the resource bundle

Throws:

RemoteException - thrown for a null context or an invalid field description

processEventFlist

protected void processEventFlist(PCachedContext ctx,
                                 FList out,
                                 Poid accountPoid)
                          throws RemoteException

Deprecated. As of Release 6.2, this method is deprecated and replaced by the processResultEventFlist(PCachedContext, FList, Poid, Map) method, which is called by the searchEvents(Map) method.

This method is called by the accountactivity(PModelHandle, ResourceBundle) method to parse the output flist.

Parameters:

ctx - the context to the connection manager (CM)

out - the output flist passed from the opcode

accountPoid - the POID that represents the account

Throws:

RemoteException - thrown if null values are passed for account activity, balance impact, or POID, or if no fields are present. Also thrown if there is no call activity passed in for an IPT account.

searchEvents

public void searchEvents(Map eventInfo)
                  throws RemoteException

Retrieves the account POID from its cached PModelHandle and searches for an event. Calls the processResultEventFlist(PCachedContext, FList, Poid, Map) method to process the event's output flist.

Specified by:

searchEvents in interface PAccountActivityBean

Parameters:

eventInfo - contains details about the event to be searched

Throws:

RemoteException - thrown for a null context or invalid field descriptions

Since:

Release 6.2

processResultEventFlist

protected void processResultEventFlist(PCachedContext ctx,
                                       FList out,
                                       Poid accountPoid,
                                       Map eventInfo)
                                throws RemoteException

Calls processEventElement(PCachedContext, FList, Map) to parse an event's output flist. The parsed results are passed to normalizeEventElementMap(Map) to parse multiple field instances into distinct maps returned in a List. For example, if the output flist for the event contains multiple FldBalImpact arrays, they are parsed and normalized into separate maps, which are returned in a single List object.

Parameters:

ctx - the cached context

out - output from opcode

accountPoid - the account's POID

eventInfo - a map containing information on the event

Throws:

RemoteException - thrown for null POIDs

Since:

Release 6.2

processEventElement

protected Map processEventElement(PCachedContext ctx,
                                  FList out,
                                  Map eventInfo)
                           throws RemoteException

Parses event array elements in the output flist, removing entries that do not have a balance impact.

Parameters:

ctx - the cached context

out - the output flist from the opcode

eventInfo - a Map containing information on the event

Returns:

A Map containing event information retrieved from this element in the output flist. If there are multiple entries for a field in the output flist, for example, more than one FldBalImpacts, this method returns unique Map identifiers for those entries to pass to the normalizeEventElementMap(Map) method for normalization into separate Map entries in a List returned for the event.

Throws:

RemoteException

Since:

Release 6.2

normalizeEventElementMap

protected List normalizeEventElementMap(Map elementMap)

Normalizes the event element map. During this process, if there were multiple entries for a field in the event's output flist, the map will be split into a list of seperate maps representing the distinct entries.

Parameters:

elementMap - a Map containing output flist information retrieved from the event element

Returns:

A List containing the normalized maps.

Since:

Release 6.2

See Also:

processEventElement(PCachedContext, FList, Map)