Package org.somda.sdc.biceps.provider.preprocessing

Class VersionHandler

java.lang.Object

org.somda.sdc.biceps.provider.preprocessing.VersionHandler

All Implemented Interfaces:

DescriptionPreprocessingSegment, StatePreprocessingSegment

public class VersionHandler
extends Object
implements DescriptionPreprocessingSegment, StatePreprocessingSegment

Preprocessing segment that manages BICEPS versioning.

The segment takes care of incrementing descriptor and state versions. It maintains a map of latest versions independent of the data that is stored in the MdibStorage. This facilitates the alignment of versions without prematurely storing them in the MdibStorage.

If an error is thrown during processing, the versions stored internally in the version handler are not going to be tainted.

Method Summary

Modifier and Type	Method	Description
void	afterLastModification(MdibDescriptionModifications modifications, MdibStorage storage)	Function that is invoked after the last modification in the processing chain has been applied.
void	afterLastModification(MdibStateModifications modifications, MdibStorage storage)	Function that is invoked after the last modification in the processing chain has been applied.
void	beforeFirstModification(MdibDescriptionModifications modifications, MdibStorage storage)	Function that is invoked before the first modification in the processing chain is applied.
void	beforeFirstModification(MdibStateModifications modifications, MdibStorage storage)	Function that is invoked before the first modification in the processing chain is applied.
void	process(MdibDescriptionModifications modifications, MdibDescriptionModification modification, MdibStorage storage)	In a sequence of modifications this function processes one modification.
void	process(MdibStateModifications modifications, AbstractState state, MdibStorage storage)	In a sequence of modifications this function processes one modification.
String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

beforeFirstModification

public void beforeFirstModification(MdibDescriptionModifications modifications,
                                    MdibStorage storage)

Description copied from interface: DescriptionPreprocessingSegment

Function that is invoked before the first modification in the processing chain is applied.

Default behavior is do nothing.

Specified by:

beforeFirstModification in interface DescriptionPreprocessingSegment

Parameters:

modifications - all modifications for preprocessing.

storage - the MDIB storage to be used by the callback.

afterLastModification

public void afterLastModification(MdibDescriptionModifications modifications,
                                  MdibStorage storage)

Description copied from interface: DescriptionPreprocessingSegment

Function that is invoked after the last modification in the processing chain has been applied.

Default behavior is do nothing.

Specified by:

afterLastModification in interface DescriptionPreprocessingSegment

Parameters:

modifications - all modifications for preprocessing.

storage - the MDIB storage to be used by the callback.

beforeFirstModification

public void beforeFirstModification(MdibStateModifications modifications,
                                    MdibStorage storage)

Description copied from interface: StatePreprocessingSegment

Function that is invoked before the first modification in the processing chain is applied.

Default behavior is do nothing.

Specified by:

beforeFirstModification in interface StatePreprocessingSegment

Parameters:

modifications - all modifications for preprocessing.

storage - the MDIB storage to be used by the callback.

afterLastModification

public void afterLastModification(MdibStateModifications modifications,
                                  MdibStorage storage)

Description copied from interface: StatePreprocessingSegment

Function that is invoked after the last modification in the processing chain has been applied.

Default behavior is do nothing.

Specified by:

afterLastModification in interface StatePreprocessingSegment

Parameters:

modifications - all modifications for preprocessing.

storage - the MDIB storage to be used by the callback.

process

public void process(MdibDescriptionModifications modifications,
                    MdibDescriptionModification modification,
                    MdibStorage storage)
             throws VersioningException

Description copied from interface: DescriptionPreprocessingSegment

In a sequence of modifications this function processes one modification.

Specified by:

process in interface DescriptionPreprocessingSegment

Parameters:

modifications - all modifications.

modification - the current modification to be processed.

storage - the MDIB storage for access.

Throws:

VersioningException

process

public void process(MdibStateModifications modifications,
                    AbstractState state,
                    MdibStorage storage)
             throws VersioningException

Description copied from interface: StatePreprocessingSegment

In a sequence of modifications this function processes one modification.

Specified by:

process in interface StatePreprocessingSegment

Parameters:

modifications - all modifications that are being processed.

state - the current modification to be processed.

storage - the MDIB storage for access.

Throws:

VersioningException

toString

public String toString()

Overrides:

toString in class Object