Package org.ametys.cms.data.holder.group.impl

Class DefaultModifiableModelAwareRepeater

java.lang.Object

org.ametys.cms.data.holder.group.impl.DefaultModelAwareRepeater

org.ametys.cms.data.holder.group.impl.DefaultModifiableModelAwareRepeater

All Implemented Interfaces:

IndexableRepeater, ModifiableIndexableRepeater, ModelAwareRepeater, ModifiableModelAwareRepeater, ModifiableRepeater, Repeater

public class DefaultModifiableModelAwareRepeater
extends DefaultModelAwareRepeater
implements ModifiableIndexableRepeater

CLass for modifiable model aware repeaters

Field Summary

Fields

Modifier and Type	Field	Description
protected ModifiableIndexableDataHolder	_modifiableParent	Parent of the current Repeater
protected ModifiableRepositoryData	_modifiableRepositoryData	Modifiable repository data to use to store entries in the repository
protected ModifiableIndexableDataHolder	_modifiableRoot	Root DataHolder

Fields inherited from class org.ametys.cms.data.holder.group.impl.DefaultModelAwareRepeater

_definition, _parent, _repositoryData, _root

Constructor Summary

Constructors

Constructor	Description
DefaultModifiableModelAwareRepeater(ModifiableRepositoryData repositoryData, ModifiableIndexableDataHolder parent, ModifiableIndexableDataHolder root, RepeaterDefinition definition)	Creates a modifiable model aware repeater

Method Summary

Modifier and Type	Method	Description
ModifiableIndexableRepeaterEntry	addEntry()	Creates a Repeater entry at the last position.
ModifiableIndexableRepeaterEntry	addEntry(int position)	Creates a Repeater entry at the given position.
List<? extends ModifiableIndexableRepeaterEntry>	getEntries()	Retrieves the repeater entries, sorted by position
ModifiableIndexableRepeaterEntry	getEntry(int position)	Retrieves the repeater entry at the given position.
ModifiableIndexableDataHolder	getParentDataHolder()	Retrieves the parent of the current Repeater
ModifiableRepositoryData	getRepositoryData()	Retrieves the repository data used by this Repeater
ModifiableIndexableDataHolder	getRootDataHolder()	Retrieves the root DataHolder of the current repeater
boolean	moveEntries(Map<Integer,Integer> positionsMapping, int targetSize)	Moves the entries according to the given position mapping.
void	removeEntries(Set<Integer> positions)	Removes the repeater entries at the given positions.
void	removeEntry(int position)	Removes the repeater entry at the given position.
<T extends SynchronizationResult> T	synchronizeValues(ViewItemContainer viewItemContainer, SynchronizableRepeater repeaterValues)	Synchronizes the given values with each repeater's entry
<T extends SynchronizationResult> T	synchronizeValues(ViewItemContainer viewItemContainer, SynchronizableRepeater repeaterValues, SynchronizationContext context)	Synchronizes the given values with each repeater's entry

Methods inherited from class org.ametys.cms.data.holder.group.impl.DefaultModelAwareRepeater

commentsToSAX, copyTo, dataToJSON, dataToJSON, dataToJSON, dataToSAX, dataToSAX, dataToSAX, getModel, getSize, hasEntry, indexData

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ametys.cms.data.holder.group.IndexableRepeater

indexData, indexData

Methods inherited from interface org.ametys.plugins.repository.data.holder.group.ModelAwareRepeater

dataToJSON, dataToJSON, dataToJSON, dataToJSON, dataToSAX, dataToSAX, dataToSAX, dataToSAX, getModel

Methods inherited from interface org.ametys.plugins.repository.data.holder.group.Repeater

copyTo, dataToJSON, dataToJSON, dataToSAX, dataToSAX, getSize, hasEntry

Field Details

_modifiableRepositoryData

protected ModifiableRepositoryData _modifiableRepositoryData

Modifiable repository data to use to store entries in the repository

_modifiableParent

protected ModifiableIndexableDataHolder _modifiableParent

Parent of the current Repeater

_modifiableRoot

protected ModifiableIndexableDataHolder _modifiableRoot

Root DataHolder

Constructor Details

DefaultModifiableModelAwareRepeater

public DefaultModifiableModelAwareRepeater(ModifiableRepositoryData repositoryData,
 ModifiableIndexableDataHolder parent,
 ModifiableIndexableDataHolder root,
 RepeaterDefinition definition)

Creates a modifiable model aware repeater

Parameters:

repositoryData - the repository data of the repeater

parent - the parent of the created Repeater

root - the root DataHolder

definition - the definition of the repeater

Method Details

getEntries

public List<? extends ModifiableIndexableRepeaterEntry> getEntries()

Description copied from interface: Repeater

Retrieves the repeater entries, sorted by position

Specified by:

getEntries in interface IndexableRepeater

Specified by:

getEntries in interface ModelAwareRepeater

Specified by:

getEntries in interface ModifiableIndexableRepeater

Specified by:

getEntries in interface ModifiableModelAwareRepeater

Specified by:

getEntries in interface Repeater

Overrides:

getEntries in class DefaultModelAwareRepeater

Returns:

the repeater entries

getEntry

public ModifiableIndexableRepeaterEntry getEntry(int position)

Description copied from interface: Repeater

Retrieves the repeater entry at the given position. The position starts at index 1. The position can be an integer between 1 and the repeater size to get an entry from the beginning Or the position can an integer between 0 and - the repeater size to get an entry from the end (0 means at the end, -1 means before the last one and so on)

Specified by:

getEntry in interface IndexableRepeater

Specified by:

getEntry in interface ModelAwareRepeater

Specified by:

getEntry in interface ModifiableIndexableRepeater

Specified by:

getEntry in interface ModifiableModelAwareRepeater

Specified by:

getEntry in interface ModifiableRepeater

Specified by:

getEntry in interface Repeater

Overrides:

getEntry in class DefaultModelAwareRepeater

Parameters:

position - the position of the entry to retrieve

Returns:

the repeater entry, null if there is no entry at this position

addEntry

public ModifiableIndexableRepeaterEntry addEntry()

Description copied from interface: ModifiableRepeater

Creates a Repeater entry at the last position.

Specified by:

addEntry in interface ModifiableIndexableRepeater

Specified by:

addEntry in interface ModifiableModelAwareRepeater

Specified by:

addEntry in interface ModifiableRepeater

Returns:

the created entry

addEntry

public ModifiableIndexableRepeaterEntry addEntry(int position)
                                          throws IllegalArgumentException

Description copied from interface: ModifiableRepeater

Creates a Repeater entry at the given position. The position starts at index 1. The position can be an integer between 1 and the repeater size + 1 to insert an entry from the beginning Or the position can an integer between 0 and - the repeater size to insert an entry from the end (0 means at the end, -1 means before the last one and so on)

Specified by:

addEntry in interface ModifiableIndexableRepeater

Specified by:

addEntry in interface ModifiableModelAwareRepeater

Specified by:

addEntry in interface ModifiableRepeater

Parameters:

position - The position of the new entry

Returns:

the created entry

Throws:

IllegalArgumentException - if the position is not between the negative and positive repeater size

synchronizeValues

public <T extends SynchronizationResult> T synchronizeValues(ViewItemContainer viewItemContainer,
 SynchronizableRepeater repeaterValues)
                                                      throws UndefinedItemPathException,
BadItemTypeException

Synchronizes the given values with each repeater's entry

Specified by:

synchronizeValues in interface ModifiableModelAwareRepeater

Type Parameters:

T - the type of the SynchronizationResult

Parameters:

viewItemContainer - The ViewItemContainer containing all items to synchronize

repeaterValues - the values of the repeater to synchronize

Returns:

the SynchronizationResult

Throws:

UndefinedItemPathException - if an entry's key refers to a data that is not defined by the model

BadItemTypeException - if the type defined by the model of one entry's key doesn't match the corresponding value

synchronizeValues

public <T extends SynchronizationResult> T synchronizeValues(ViewItemContainer viewItemContainer,
 SynchronizableRepeater repeaterValues,
 SynchronizationContext context)
                                                      throws UndefinedItemPathException,
BadItemTypeException

Synchronizes the given values with each repeater's entry

Specified by:

synchronizeValues in interface ModifiableModelAwareRepeater

Type Parameters:

T - the type of the SynchronizationResult

Parameters:

viewItemContainer - The ViewItemContainer containing all items to synchronize

repeaterValues - the values of the repeater to synchronize

context - the context of the synchronization

Returns:

the SynchronizationResult

Throws:

UndefinedItemPathException - if an entry's key refers to a data that is not defined by the model

BadItemTypeException - if the type defined by the model of one entry's key doesn't match the corresponding value

moveEntries

public boolean moveEntries(Map<Integer,Integer> positionsMapping,
 int targetSize)

Description copied from interface: ModifiableRepeater

Moves the entries according to the given position mapping. The given position mapping's key is the previous position and the value is the new one The existent entries with no corresponding entry in the position mapping will be removed the given size is taken into account to create new empty entries if needed

Specified by:

moveEntries in interface ModifiableRepeater

Parameters:

positionsMapping - the position mapping

targetSize - the target size of the repeater

Returns:

true if some entries have moved, false otherwise

removeEntries

public void removeEntries(Set<Integer> positions)
                   throws UnknownDataException

Description copied from interface: ModifiableRepeater

Removes the repeater entries at the given positions. The position starts at index 1. The positions can be integers between 1 and the repeater size to remove an entry from the beginning Or the positions can integers between 0 and - the repeater size to remove an entry from the end (0 means the last entry, -1 means before the last one and so on)

Specified by:

removeEntries in interface ModifiableRepeater

Parameters:

positions - The positions of the entries to remove

Throws:

UnknownDataException - if there is no entry for one of the given positions

removeEntry

public void removeEntry(int position)
                 throws UnknownDataException

Description copied from interface: ModifiableRepeater

Removes the repeater entry at the given position. The position starts at index 1. The position can be an integer between 1 and the repeater size to remove an entry from the beginning Or the position can an integer between 0 and - the repeater size to remove an entry from the end (0 means the last entry, -1 means before the last one and so on)

Specified by:

removeEntry in interface ModifiableRepeater

Parameters:

position - The position of the entry to remove

Throws:

UnknownDataException - if there is no entry at the given position

getRepositoryData

public ModifiableRepositoryData getRepositoryData()

Description copied from interface: Repeater

Retrieves the repository data used by this Repeater

Specified by:

getRepositoryData in interface ModifiableRepeater

Specified by:

getRepositoryData in interface Repeater

Overrides:

getRepositoryData in class DefaultModelAwareRepeater

Returns:

the repository data used by this Repeater

getParentDataHolder

public ModifiableIndexableDataHolder getParentDataHolder()

Description copied from interface: Repeater

Retrieves the parent of the current Repeater

Specified by:

getParentDataHolder in interface IndexableRepeater

Specified by:

getParentDataHolder in interface ModelAwareRepeater

Specified by:

getParentDataHolder in interface ModifiableIndexableRepeater

Specified by:

getParentDataHolder in interface ModifiableModelAwareRepeater

Specified by:

getParentDataHolder in interface ModifiableRepeater

Specified by:

getParentDataHolder in interface Repeater

Overrides:

getParentDataHolder in class DefaultModelAwareRepeater

Returns:

the parent of the current Repeater

getRootDataHolder

public ModifiableIndexableDataHolder getRootDataHolder()

Description copied from interface: Repeater

Retrieves the root DataHolder of the current repeater

Specified by:

getRootDataHolder in interface IndexableRepeater

Specified by:

getRootDataHolder in interface ModelAwareRepeater

Specified by:

getRootDataHolder in interface ModifiableIndexableRepeater

Specified by:

getRootDataHolder in interface ModifiableModelAwareRepeater

Specified by:

getRootDataHolder in interface ModifiableRepeater

Specified by:

getRootDataHolder in interface Repeater

Overrides:

getRootDataHolder in class DefaultModelAwareRepeater

Returns:

the root DataHolder