SalesPoint Framework v3.1

data.ooimpl
Class CatalogImpl

java.lang.Object
  extended bydata.AbstractNameable
      extended bydata.ooimpl.CatalogItemImpl
          extended bydata.ooimpl.CatalogImpl
All Implemented Interfaces:
Catalog, CatalogItem, Cloneable, Comparable, DataBasketEntryDestination, DataBasketEntrySource, DataBasketKeys, ListenableCatalog, Nameable, NameContext, SelfManagingDBEDestination, SelfManagingDBESource, Serializable
Direct Known Subclasses:
AbstractCurrency, CurrencyImpl

public class CatalogImpl
extends CatalogItemImpl
implements Catalog, ListenableCatalog, NameContext, SelfManagingDBESource, SelfManagingDBEDestination

Pure Java implementation of the Catalog interface.

CatalogImpl can only work together with DataBaskets that are descendants of DataBasketImpl.

Since:
v2.0
Author:
Steffen Zschaler
See Also:
Serialized Form

Field Summary
protected  ListenerHelper m_lhListeners
          The listeners that registered to be informed of changes in this Catalog's contents.
protected  int m_nModCount
          Modification counter.
 
Fields inherited from class data.AbstractNameable
m_ncContext, m_pcsPropertyListeners
 
Fields inherited from interface data.CatalogItem
VALUE_PROPERTY
 
Fields inherited from interface data.Nameable
NAME_PROPERTY
 
Fields inherited from interface data.DataBasketKeys
CATALOG_ITEM_MAIN_KEY, STOCK_ITEM_MAIN_KEY
 
Constructor Summary
CatalogImpl(String sName)
          Create a new, initially empty CatalogImpl.
 
Method Summary
 void add(CatalogItem ci, DataBasket db)
          Add the given item to the Catalog.
 void addCatalogChangeListener(CatalogChangeListener ccl)
          Add a listener that listens for changes in this Catalog's contents.
 void checkNameChange(DataBasket db, String sOldName, String sNewName)
          Check a name change of a CatalogItem in this Catalog.
 void commitAdd(DataBasket db, DataBasketEntry dbe)
          Commit the adding of a CatalogItem.
 void commitRemove(DataBasket db, DataBasketEntry dbe)
          Commit the removal of a CatalogItem.
 boolean contains(String sKey, DataBasket db)
          Check whether the Catalog contains a certain CatalogItem.
 CatalogImpl createPeer()
          Create and return an empty CatalogImpl of the same name and class.
protected  void fireCanEditCatalogItem(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCanRemoveCatalogItem(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCatalogItemAddCommit(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCatalogItemAdded(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCatalogItemAddRollback(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCatalogItemRemoveCommit(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCatalogItemRemoved(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCatalogItemRemoveRollback(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireCommitEditCatalogItem(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireEditingCatalogItem(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
protected  void fireRollbackEditCatalogItem(CatalogItem ci, DataBasket db)
          Fire an event to all listeners listening to this Catalog.
 CatalogItem get(String sKey, DataBasket db, boolean fForEdit)
          Get the indicated item from the Catalog.
 CatalogImpl getEditableCopy(DataBasket db)
          Convenience method, which gets an editable ShallowClone of this Catalog from its parent Catalog and returns it.
protected  Map getEditingItemsContainer()
          Get the map of items that are currently being edited.
protected  Map getItemsContainer()
          Get the map of items that are completely contained in this Catalog.
protected  Object getItemsLock()
          Get the monitor synchronizing access to the several items maps.
 Object getNCMonitor()
          Return the monitor used to synchronize access to the Catalog's internal data.
protected  CatalogItemImpl getShallowClone()
          Create a shallow clone of this Catalog.
protected  Map getTemporaryAddedItemsContainer()
          Get the map of items that have been temporaryly added to this Catalog.
protected  Map getTemporaryRemovedItemsContainer()
          Get the map of items that have been temporaryly removed from this Catalog.
 Iterator iterator(DataBasket db, boolean fForEdit)
          Return an iterator of all items in the Catalog.
 Set keySet(DataBasket db)
          Get a set of all keys currently in the Catalog.
 void nameHasChanged(DataBasket db, String sOldName, String sNewName)
          Synchronize the Catalog's internal data with the name change.
 CatalogItem remove(CatalogItem ci, DataBasket db)
          Remove the given item from the Catalog.
 CatalogItem remove(String sKey, DataBasket db)
          Remove the indicated item from the Catalog.
 void removeCatalogChangeListener(CatalogChangeListener ccl)
          Remove a listener that listened for changes in this Catalog's contents.
 void rollbackAdd(DataBasket db, DataBasketEntry dbe)
          Roll back the adding of a CatalogItem.
 void rollbackRemove(DataBasket db, DataBasketEntry dbe)
          Roll back the removal of a CatalogItem.
 int size(DataBasket db)
          Calculate the size of the Catalog.
 String toString()
          Return a String representation of this Catalog.
 
Methods inherited from class data.ooimpl.CatalogItemImpl
addValueListener, compareTo, equals, getCatalog, getValue, isEditable, removeValueListener, setValue
 
Methods inherited from class data.AbstractNameable
addNameListener, addPropertyChangeListener, attach, detachNC, getName, removeNameListener, removePropertyChangeListener, setName
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface data.CatalogItem
addValueListener, getCatalog, getValue, removeValueListener
 
Methods inherited from interface data.Nameable
addNameListener, addPropertyChangeListener, attach, detachNC, getName, removeNameListener, removePropertyChangeListener, setName
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Field Detail

m_lhListeners

protected ListenerHelper m_lhListeners
The listeners that registered to be informed of changes in this Catalog's contents.


m_nModCount

protected int m_nModCount
Modification counter. Will be increased by one for each structural modification.

Constructor Detail

CatalogImpl

public CatalogImpl(String sName)
Create a new, initially empty CatalogImpl.

Parameters:
sName - the name of the Catalog.
Method Detail

getItemsLock

protected final Object getItemsLock()
Get the monitor synchronizing access to the several items maps.

Override:
Never

getItemsContainer

protected Map getItemsContainer()
Get the map of items that are completely contained in this Catalog.

Override:
Never

getTemporaryRemovedItemsContainer

protected Map getTemporaryRemovedItemsContainer()
Get the map of items that have been temporaryly removed from this Catalog.

Override:
Never

getTemporaryAddedItemsContainer

protected Map getTemporaryAddedItemsContainer()
Get the map of items that have been temporaryly added to this Catalog.

Override:
Never

getEditingItemsContainer

protected Map getEditingItemsContainer()
Get the map of items that are currently being edited.

Override:
Never

add

public void add(CatalogItem ci,
                DataBasket db)
Add the given item to the Catalog.

Specified by:
add in interface Catalog
Parameters:
ci - the CatalogItem to be added.
db - the DataBasket relative to which to perform the operation. Must be null or a descendant of DataBasketImpl.
Throws:
NotEditableException - if the Catalog is currently not editable.
DuplicateKeyException - if a CatalogItem of the same name does already exist in the Catalog.
DataBasketConflictException - if the CatalogItem cannot be added because an item of the same name has already been added/removed using another DataBasket.
Override:
Never

remove

public CatalogItem remove(CatalogItem ci,
                          DataBasket db)
                   throws VetoException
Remove the given item from the Catalog.

Specified by:
remove in interface Catalog
Parameters:
ci - the CatalogItem to be removed.
db - the DataBasket relative to which to perform the operation. Must be null or a descendant of DataBasketImpl.
Returns:
the item that was actually removed.
Throws:
NotEditableException - if the Catalog is currently not editable.
VetoException - if one of the listeners vetos the removal.
DataBasketConflictException - if the CatalogItem cannot be removed because an item of the same name has already been added using another DataBasket.
Override:
Never

remove

public CatalogItem remove(String sKey,
                          DataBasket db)
                   throws VetoException
Remove the indicated item from the Catalog.

Specified by:
remove in interface Catalog
Parameters:
sKey - the key of the CatalogItem to be removed.
db - the DataBasket relative to which to perform the operation. Must be null or a descendant of DataBasketImpl.
Returns:
the item that was actually removed.
Throws:
NotEditableException - if the Catalog is currently not editable.
VetoException - if one of the listeners vetos the removal.
DataBasketConflictException - if the CatalogItem cannot be removed because an item of the same name has already been added using another DataBasket.
Override:
Never

get

public CatalogItem get(String sKey,
                       DataBasket db,
                       boolean fForEdit)
                throws VetoException
Get the indicated item from the Catalog.

Specified by:
get in interface Catalog
Parameters:
sKey - the key for which to retrieve the item.
db - the DataBasket relative to which to perform the operation. Must be null or a descendant of DataBasketImpl.
fForEdit - if true, the item will be retrieved for editing. Only in this case changes made to the CatalogItem can be undone via a rollback of the DataBasket. Therefore the DataBasket must not be null if a CatalogItem is desired to be editable! A number of events is fired if fForEdit is true:
  1. canEditCatalogItem with the original item.
  2. a shallow clone of the item is created.
  3. editingCatalogItem with the newly created clone.
  4. addCatalogItem with the newly created clone and removeCatalogItem with the original item.
  5. The newly created clone is returned for editing.
Returns:
the item that is associated with the given key.
Throws:
NotEditableException - if the Catalog is not currently editable, but an attempt is made to edit one of its items.
VetoException - if one of the listeners vetos the editing.
DataBasketConflictException - if the CatalogItem cannot be retrieved because it is not visible to users of the given DataBasket.
Override:
Never

getEditableCopy

public CatalogImpl getEditableCopy(DataBasket db)
                            throws VetoException
Convenience method, which gets an editable ShallowClone of this Catalog from its parent Catalog and returns it. If the Catalog is already editable or there is no parent Catalog, no copy will be created and the original Catalog is returned.

Parameters:
db - the DataBasket which is passed to get method. Must not be null!
Returns:
this Catalog, if editable, otherwise a clone of this Catalog.
Throws:
VetoException

contains

public boolean contains(String sKey,
                        DataBasket db)
Check whether the Catalog contains a certain CatalogItem.

Will return true only if an item of the given key is contained in the Catalog and if that item is visible to users of the given DataBasket.

Specified by:
contains in interface Catalog
Parameters:
sKey - the key for which to check containment.
db - the DataBasket that defines visibility of items. Must be null or a descendant of DataBasketImpl.
Override:
Never

iterator

public Iterator iterator(DataBasket db,
                         boolean fForEdit)
Return an iterator of all items in the Catalog.

The iterator will conceptually call get(java.lang.String, data.DataBasket, boolean) for each CatalogItem, using the given parameters.

Specified by:
iterator in interface Catalog
Parameters:
db - the DataBasket that defines visibility.
fForEdit - if true, the items are retrieved for editing. VetoException will be converted into UnsupportedOperationExceptions.
Override:
Never

keySet

public Set keySet(DataBasket db)
Get a set of all keys currently in the Catalog.

This will retrieve a static set that gives the state of the Catalog at the time of the call.

Specified by:
keySet in interface Catalog
Parameters:
db - the DataBasket used to determine visibility of elements. Must be null or a descendant of DataBasketImpl.
Override:
Never

size

public int size(DataBasket db)
Calculate the size of the Catalog. I.e. count the CatalogItems that are visible to users of the given DataBasket.

Specified by:
size in interface Catalog
Parameters:
db - the DataBasket used to determine visibility. Must be null or a descendant of DataBasketImpl.
Override:
Never

getShallowClone

protected CatalogItemImpl getShallowClone()
Create a shallow clone of this Catalog. A shallow clone means that the individual items themselves will not be cloned.

Specified by:
getShallowClone in class CatalogItemImpl
Override:
Never Instead override createPeer().

createPeer

public CatalogImpl createPeer()
Create and return an empty CatalogImpl of the same name and class.

Override:
Always

toString

public String toString()
Return a String representation of this Catalog.

Overrides:
toString in class CatalogItemImpl
Override:
Sometimes

commitRemove

public void commitRemove(DataBasket db,
                         DataBasketEntry dbe)
Commit the removal of a CatalogItem.

Specified by:
commitRemove in interface SelfManagingDBESource
Parameters:
db - the DataBasket that issued the rollback request
dbe - the DataBasketEntry describing the operation to rollback.

rollbackRemove

public void rollbackRemove(DataBasket db,
                           DataBasketEntry dbe)
Roll back the removal of a CatalogItem.

Specified by:
rollbackRemove in interface SelfManagingDBESource
Parameters:
db - the DataBasket that issued the commit request
dbe - the DataBasketEntry describing the operation to commit.

commitAdd

public void commitAdd(DataBasket db,
                      DataBasketEntry dbe)
Commit the adding of a CatalogItem. In addition to the addedCatalogItemCommit event this may trigger an editingCatalogItemCommit event with the CatalogItem that has been edited.

Specified by:
commitAdd in interface SelfManagingDBEDestination
Parameters:
db - the DataBasket that issued the commit request
dbe - the DataBasketEntry describing the operation to commit.

rollbackAdd

public void rollbackAdd(DataBasket db,
                        DataBasketEntry dbe)
Roll back the adding of a CatalogItem. In addition to the addedCatalogItemRollback event this may trigger an editingCatalogItemRollback event with the CatalogItem that has been edited.

Specified by:
rollbackAdd in interface SelfManagingDBEDestination
Parameters:
db - the DataBasket that issued the rollback request
dbe - the DataBasketEntry describing the operation to rollback.

checkNameChange

public void checkNameChange(DataBasket db,
                            String sOldName,
                            String sNewName)
                     throws NameContextException
Check a name change of a CatalogItem in this Catalog.

The name change will be allowed if the item is editable and the new name can be guaranteed to be unique.

Specified by:
checkNameChange in interface NameContext
Parameters:
db - the DataBasket relative to which the name change is to take place.
sOldName - the name to be changed.
sNewName - the new name.
Throws:
NameContextException - if the name change would not be valid.
Override:
Sometimes Override to enforce stricter naming conventions.

nameHasChanged

public void nameHasChanged(DataBasket db,
                           String sOldName,
                           String sNewName)
Synchronize the Catalog's internal data with the name change.

Specified by:
nameHasChanged in interface NameContext
Parameters:
db - the DataBasket relative to which the name change has taken place.
sOldName - the old name of the object whose name was changed.
sNewName - the new name of the object.
Override:
Never

getNCMonitor

public final Object getNCMonitor()
Return the monitor used to synchronize access to the Catalog's internal data.

Specified by:
getNCMonitor in interface NameContext
Override:
Never

addCatalogChangeListener

public void addCatalogChangeListener(CatalogChangeListener ccl)
Add a listener that listens for changes in this Catalog's contents.

Specified by:
addCatalogChangeListener in interface ListenableCatalog
Parameters:
ccl - the listener
Override:
Never

removeCatalogChangeListener

public void removeCatalogChangeListener(CatalogChangeListener ccl)
Remove a listener that listened for changes in this Catalog's contents.

Specified by:
removeCatalogChangeListener in interface ListenableCatalog
Parameters:
ccl - the listener
Override:
Never

fireCatalogItemAdded

protected void fireCatalogItemAdded(CatalogItem ci,
                                    DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCatalogItemAddCommit

protected void fireCatalogItemAddCommit(CatalogItem ci,
                                        DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCatalogItemAddRollback

protected void fireCatalogItemAddRollback(CatalogItem ci,
                                          DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCatalogItemRemoved

protected void fireCatalogItemRemoved(CatalogItem ci,
                                      DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCatalogItemRemoveCommit

protected void fireCatalogItemRemoveCommit(CatalogItem ci,
                                           DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCatalogItemRemoveRollback

protected void fireCatalogItemRemoveRollback(CatalogItem ci,
                                             DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCanRemoveCatalogItem

protected void fireCanRemoveCatalogItem(CatalogItem ci,
                                        DataBasket db)
                                 throws VetoException
Fire an event to all listeners listening to this Catalog.

Throws:
VetoException
Override:
Never

fireCanEditCatalogItem

protected void fireCanEditCatalogItem(CatalogItem ci,
                                      DataBasket db)
                               throws VetoException
Fire an event to all listeners listening to this Catalog.

Throws:
VetoException
Override:
Never

fireEditingCatalogItem

protected void fireEditingCatalogItem(CatalogItem ci,
                                      DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireCommitEditCatalogItem

protected void fireCommitEditCatalogItem(CatalogItem ci,
                                         DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

fireRollbackEditCatalogItem

protected void fireRollbackEditCatalogItem(CatalogItem ci,
                                           DataBasket db)
Fire an event to all listeners listening to this Catalog.

Override:
Never

SalesPoint Framework v3.1