Class ModelValueHistory
- java.lang.Object
-
- de.hybris.platform.servicelayer.internal.model.impl.ModelValueHistory
-
- All Implemented Interfaces:
java.io.Serializable
public class ModelValueHistory extends java.lang.Object implements java.io.SerializableKeeps track of original (loaded) values of a item model. It also stores which fields have been set explicitly even if the value had been null.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interfaceModelValueHistory.HistoryListener
-
Constructor Summary
Constructors Constructor Description ModelValueHistory()ModelValueHistory(AttributeProvider attributeProvider)
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidclearOriginalValue(java.lang.String qualifier)Clears originally loaded value for a given attribute.voidclearOriginalValue(java.lang.String qualifier, java.util.Locale locale)Clears localized original value.java.util.Map<java.lang.String,java.util.Set<java.util.Locale>>getAllDirtyAttributes()java.util.Set<java.lang.String>getDirtyAttributes()Returns all dirty unlocalized attributes.java.util.Map<java.util.Locale,java.util.Set<java.lang.String>>getDirtyLocalizedAttributes()Returns all localized dirty attributes.ModelValueHistory.HistoryListenergetListener()java.util.Set<java.lang.String>getLoadedAttributes()java.util.Set<Key<java.util.Locale,java.lang.String>>getLoadedLocAttributes()java.lang.ObjectgetOriginalValue(java.lang.String qualifier)Returns original unlocalized value for specified attribute qualifier.java.lang.ObjectgetOriginalValue(java.lang.String qualifier, java.util.Locale locale)Returns original localized value for specified attribute qualifier and language qualifier (iso code).longgetPersistenceVersion()booleanisDirty()booleanisDirty(java.lang.String qualifier)Tells if a unlocalized attribute has been marked as dirty.booleanisDirty(java.lang.String qualifier, java.util.Locale locale)Tells if a localized attribute has been marked as dirty.booleanisValueLoaded(java.lang.String qualifier)Tells if this history contains a unlocalized original value for the specified attribute.booleanisValueLoaded(java.lang.String qualifier, java.util.Locale locale)Tells if this history contains a localized original value for the specified attribute.voidloadOriginalValue(java.lang.String qualifier, java.lang.Object value)Loads unlocalized original value.voidloadOriginalValue(java.lang.String qualifier, java.lang.Object value, boolean resetDirtyFlag)voidloadOriginalValue(java.lang.String qualifier, java.util.Locale locale, java.lang.Object value)Loads localized original value.voidloadOriginalValue(java.lang.String qualifier, java.util.Locale locale, java.lang.Object value, boolean resetDirtyFlag)voidmarkDirty(java.lang.String qualifier)Marks unlocalized attribute as 'dirty' which means that it has been set by model user.voidmarkDirty(java.lang.String qualifier, java.util.Locale locale)Marks localized attribute as 'dirty' which means that it has been set by model user.voidmarkUnchanged(java.lang.String qualifier)Signals that a 'dirty' attribute finally has been tested and found unchanged.voidmarkUnchanged(java.lang.String qualifier, java.util.Locale locale)Signals that a 'dirty' attribute finally has been tested and found unchanged.voidmergeDirty(java.util.Map<java.util.Locale,java.util.Set<java.util.Locale>> data2nonDataLocales)voidresetAttributeLoadingError(java.lang.String qualifier)voidresetLocAttributeLoadingError(java.lang.String qualifier, java.util.Locale loc)voidsetAttributeLoadingError(java.lang.String qualifier, ModelLoadingException e)voidsetAttributeProvider(AttributeProvider attributeProvider)voidsetListener(ModelValueHistory.HistoryListener givenListener)voidsetLocAttributeLoadingError(java.lang.String qualifier, java.util.Locale loc, ModelLoadingException e)voidsetPersistenceVersion(long persistenceVersion)voidthrowAttributeError(java.lang.String qualifier)voidthrowLocAttributeError(java.lang.String qualifier, java.util.Locale loc)
-
-
-
Constructor Detail
-
ModelValueHistory
public ModelValueHistory()
-
ModelValueHistory
public ModelValueHistory(AttributeProvider attributeProvider)
-
-
Method Detail
-
setAttributeLoadingError
public void setAttributeLoadingError(java.lang.String qualifier, ModelLoadingException e)
-
resetAttributeLoadingError
public void resetAttributeLoadingError(java.lang.String qualifier)
-
throwAttributeError
public void throwAttributeError(java.lang.String qualifier) throws ModelLoadingException- Throws:
ModelLoadingException
-
setLocAttributeLoadingError
public void setLocAttributeLoadingError(java.lang.String qualifier, java.util.Locale loc, ModelLoadingException e)
-
resetLocAttributeLoadingError
public void resetLocAttributeLoadingError(java.lang.String qualifier, java.util.Locale loc)
-
throwLocAttributeError
public void throwLocAttributeError(java.lang.String qualifier, java.util.Locale loc) throws ModelLoadingException- Throws:
ModelLoadingException
-
getListener
public ModelValueHistory.HistoryListener getListener()
-
setListener
public void setListener(ModelValueHistory.HistoryListener givenListener)
-
getOriginalValue
public java.lang.Object getOriginalValue(java.lang.String qualifier)
Returns original unlocalized value for specified attribute qualifier. This operation can throw anIllegalStateExceptionif original value is not loaded yet . Usually should be guardedisValueLoaded(String).- Parameters:
qualifier- the attribute qualifier- Throws:
java.lang.IllegalStateException- if no value has been loaded for this attribute
-
getOriginalValue
public java.lang.Object getOriginalValue(java.lang.String qualifier, java.util.Locale locale)Returns original localized value for specified attribute qualifier and language qualifier (iso code). This operation can throw anIllegalStateExceptionif original value is not loaded yet . Usually should be guardedisValueLoaded(String, java.util.Locale).- Parameters:
qualifier- the attribute qualifierlocale- the locale- Throws:
java.lang.IllegalStateException- if no value has been loaded for this attribute
-
loadOriginalValue
public void loadOriginalValue(java.lang.String qualifier, java.lang.Object value)Loads unlocalized original value.- Parameters:
qualifier- the attribute qualifiervalue- the original value
-
loadOriginalValue
public void loadOriginalValue(java.lang.String qualifier, java.lang.Object value, boolean resetDirtyFlag)
-
clearOriginalValue
public void clearOriginalValue(java.lang.String qualifier)
Clears originally loaded value for a given attribute. The attribute appears to be not loaded afterwards.
-
markUnchanged
public void markUnchanged(java.lang.String qualifier)
Signals that a 'dirty' attribute finally has been tested and found unchanged. So this is a shortcut toloadOriginalValue(String, Object)!
-
loadOriginalValue
public void loadOriginalValue(java.lang.String qualifier, java.util.Locale locale, java.lang.Object value)Loads localized original value.- Parameters:
qualifier- the attribute qualifierlocale- the localevalue- the original value
-
loadOriginalValue
public void loadOriginalValue(java.lang.String qualifier, java.util.Locale locale, java.lang.Object value, boolean resetDirtyFlag)
-
clearOriginalValue
public void clearOriginalValue(java.lang.String qualifier, java.util.Locale locale)Clears localized original value.- Parameters:
qualifier- the attribute qualifierlocale- the locale
-
markUnchanged
public void markUnchanged(java.lang.String qualifier, java.util.Locale locale)Signals that a 'dirty' attribute finally has been tested and found unchanged. So this is a shortcut toloadOriginalValue(String, Object)!
-
isValueLoaded
public boolean isValueLoaded(java.lang.String qualifier)
Tells if this history contains a unlocalized original value for the specified attribute.- Parameters:
qualifier- the attribute qualifier.
-
isValueLoaded
public boolean isValueLoaded(java.lang.String qualifier, java.util.Locale locale)Tells if this history contains a localized original value for the specified attribute.- Parameters:
qualifier- the attribute qualifier.locale- the locale
-
markDirty
public void markDirty(java.lang.String qualifier)
Marks unlocalized attribute as 'dirty' which means that it has been set by model user.- Parameters:
qualifier- the attribute qualifier
-
markDirty
public void markDirty(java.lang.String qualifier, java.util.Locale locale)Marks localized attribute as 'dirty' which means that it has been set by model user.- Parameters:
qualifier- the attribute qualifierlocale- the language qualifier
-
mergeDirty
public void mergeDirty(java.util.Map<java.util.Locale,java.util.Set<java.util.Locale>> data2nonDataLocales)
-
isDirty
public boolean isDirty(java.lang.String qualifier)
Tells if a unlocalized attribute has been marked as dirty.- Parameters:
qualifier- the attribute qualifier
-
isDirty
public boolean isDirty()
-
isDirty
public boolean isDirty(java.lang.String qualifier, java.util.Locale locale)Tells if a localized attribute has been marked as dirty. If the given Locale isnullthis method checks in all Locales for modifications for the given attribute (qualifier).- Parameters:
qualifier- the attribute qualifierlocale- the locale
-
getDirtyAttributes
public java.util.Set<java.lang.String> getDirtyAttributes()
Returns all dirty unlocalized attributes.
-
getDirtyLocalizedAttributes
public java.util.Map<java.util.Locale,java.util.Set<java.lang.String>> getDirtyLocalizedAttributes()
Returns all localized dirty attributes.- Returns:
- a map <attribute qualifier>->( <language qualifier> )
-
getAllDirtyAttributes
public java.util.Map<java.lang.String,java.util.Set<java.util.Locale>> getAllDirtyAttributes()
-
getLoadedAttributes
public java.util.Set<java.lang.String> getLoadedAttributes()
-
getLoadedLocAttributes
public java.util.Set<Key<java.util.Locale,java.lang.String>> getLoadedLocAttributes()
-
getPersistenceVersion
public long getPersistenceVersion()
- Returns:
- the persistenceVersion
-
setPersistenceVersion
public void setPersistenceVersion(long persistenceVersion)
- Parameters:
persistenceVersion- the persistenceVersion to set
-
setAttributeProvider
public void setAttributeProvider(AttributeProvider attributeProvider)
-
-