org.salespointframework.core.data
Class DataBasketEntryImpl<T>

java.lang.Object
  org.salespointframework.core.data.DataBasketEntryImpl<T>

All Implemented Interfaces:

DataBasketEntry<T>, DataBasketKeys, SpItem, Loggable

Direct Known Subclasses:

CatalogItemDataBasketEntry, StockItemDBEntry

public class DataBasketEntryImpl<T>
extends java.lang.Object
implements DataBasketEntry<T>, Loggable

Basic simple implementation of the DataBasketEntry interface. DataBasketEntries may be coalesced, meaning that two separate operations may be expressed by one DataBasketEntry, if this is possible. Applications that inspect DataBasketEntries directly should not make assumptions about whether or not they have been coalesced.

Since:

v2.0

Version:

14/06/1999

Author:

Steffen Zschaler

Field Summary

protected DataBasketEntryDestination	m_dbedDest The destination of the operation.
protected DataBasketEntrySource	m_dbesSource The source of the operation.
protected DataBasketImpl	m_dbiOwner The DataBasket owning this entry..
protected boolean	m_fHandled true if the entry was commited or rolled back completely.
protected T	m_oValue The object moved by the operation.
protected java.lang.String	m_sMainKey The entry's main key.
protected java.lang.String	m_sSecondaryKey The entry's secondary key.

Fields inherited from interface org.salespointframework.core.data.interfaces.DataBasketKeys

CATALOG_ITEM_MAIN_KEY, STOCK_ITEM_MAIN_KEY

Constructor Summary

DataBasketEntryImpl(java.lang.String sMainKey, java.lang.String sSecondaryKey, DataBasketEntrySource dbesSource, DataBasketEntryDestination dbedDest, T oValue)
Create a new DataBasketEntryImpl.

Method Summary

void	commit() Commit the operation.
static CatalogItem	DBEtoCatalogItem(DataBasketEntry dbe) Extracts the catalog item out of a data basket entry
DataBasketEntryDestination	getDestination() Get the entry's destination.
LogEntry	getLogData() Return a LogEntry that describes this DataBasketEntry.
java.lang.String	getMainKey() Get the entry's main key.
java.lang.String	getName()
DataBasket	getOwner() Return the DataBasket containing this DataBasketEntry.
java.lang.String	getSecondaryKey() Get the entry's secondary key.
DataBasketEntrySource	getSource() Get the entry's source.
T	getValue() Get the entry's value, i.e.
boolean	isHandled() Return true, if the entry has been either completely commited or rolled back.
void	rollback() Rollback the operation.
void	setOwner(DataBasket dbOwner) Set the DataBasket owning this DataBasketEntry.
void	setSecondaryKey(java.lang.String key) Set the entry's secondary key.
void	setValue(T value) set the entry's value

Methods inherited from class java.lang.Object

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

Field Detail

m_dbesSource

protected DataBasketEntrySource m_dbesSource

The source of the operation.

m_dbedDest

protected DataBasketEntryDestination m_dbedDest

The destination of the operation.

m_oValue

protected T m_oValue

The object moved by the operation.

m_sMainKey

protected java.lang.String m_sMainKey

The entry's main key.

m_sSecondaryKey

protected java.lang.String m_sSecondaryKey

The entry's secondary key.

m_fHandled

protected boolean m_fHandled

true if the entry was commited or rolled back completely.

m_dbiOwner

protected DataBasketImpl m_dbiOwner

The DataBasket owning this entry..

Constructor Detail

DataBasketEntryImpl

public DataBasketEntryImpl(java.lang.String sMainKey,
                           java.lang.String sSecondaryKey,
                           DataBasketEntrySource dbesSource,
                           DataBasketEntryDestination dbedDest,
                           T oValue)

Create a new DataBasketEntryImpl.

Parameters:

sMainKey - the entry's main key.

sSecondaryKey - the entry's secondary key.

dbesSource - the operation's source. Assumed to be a SelfManagingDBESource.

dbedDest - the operation's destination. Assumed to be a SelfManagingDBEDestination.

oValue - the object moved by the operation.

Method Detail

rollback

public void rollback()

Rollback the operation. This is done by first calling SelfManagingDBEDestination.rollbackAdd(org.salespointframework.core.data.interfaces.DataBasket, org.salespointframework.core.data.interfaces.DataBasketEntry) in the destination and then SelfManagingDBESource.rollbackRemove(org.salespointframework.core.data.interfaces.DataBasket, org.salespointframework.core.data.interfaces.DataBasketEntry) in the source of the entry.

Specified by:

rollback in interface DataBasketEntry<T>

commit

public void commit()

Commit the operation. This is done by first calling SelfManagingDBESource.commitRemove(org.salespointframework.core.data.interfaces.DataBasket, org.salespointframework.core.data.interfaces.DataBasketEntry) in the source and then SelfManagingDBEDestination.commitAdd(org.salespointframework.core.data.interfaces.DataBasket, org.salespointframework.core.data.interfaces.DataBasketEntry) in the destination of the entry.

Specified by:

commit in interface DataBasketEntry<T>

setOwner

public void setOwner(DataBasket dbOwner)

Set the DataBasket owning this DataBasketEntry.

This method is public as an implementation detail and must not be called directly.

Specified by:

setOwner in interface DataBasketEntry<T>

Parameters:

dbOwner - the DataBasket that owns this DataBasketEntry. Can be null.

getOwner

public DataBasket getOwner()

Return the DataBasket containing this DataBasketEntry. Initially null. Once setOwner(org.salespointframework.core.data.interfaces.DataBasket) has been called, always returns the last value of the dbOwner parameter passed to setOwner.

Specified by:

getOwner in interface DataBasketEntry<T>

Returns:

the DataBasket containing this DataBasketEntry.

getSource

public DataBasketEntrySource getSource()

Get the entry's source.

Specified by:

getSource in interface DataBasketEntry<T>

getDestination

public DataBasketEntryDestination getDestination()

Get the entry's destination.

Specified by:

getDestination in interface DataBasketEntry<T>

getValue

public T getValue()

Get the entry's value, i.e. the object that was moved by the operation.

Specified by:

getValue in interface DataBasketEntry<T>

setValue

public void setValue(T value)

set the entry's value

Parameters:

value -

getMainKey

public java.lang.String getMainKey()

Get the entry's main key.

Specified by:

getMainKey in interface DataBasketEntry<T>

getSecondaryKey

public java.lang.String getSecondaryKey()

Get the entry's secondary key.

Specified by:

getSecondaryKey in interface DataBasketEntry<T>

setSecondaryKey

public void setSecondaryKey(java.lang.String key)

Set the entry's secondary key.

Parameters:

key - new secondary key

isHandled

public boolean isHandled()

Return true, if the entry has been either completely commited or rolled back.

Specified by:

isHandled in interface DataBasketEntry<T>

getLogData

public LogEntry getLogData()

Return a LogEntry that describes this DataBasketEntry.

Specified by:

getLogData in interface Loggable

Returns:

the data to be stored in the log file.

DBEtoCatalogItem

public static CatalogItem DBEtoCatalogItem(DataBasketEntry dbe)

Extracts the catalog item out of a data basket entry

Parameters:

dbe - container

Returns:

extracted catalog item

getName

public java.lang.String getName()

Specified by:

getName in interface SpItem