wicket.version.undo
Class UndoPageVersionManager

java.lang.Object
  wicket.version.undo.UndoPageVersionManager

All Implemented Interfaces:

java.io.Serializable, IPageVersionManager

public class UndoPageVersionManager
extends java.lang.Object
implements IPageVersionManager

A version manager implemented by recording component changes as undo records which can later be reversed to get back to a given version of the page being managed.

Author:

Jonathan Locke

See Also:

Serialized Form

Constructor Summary

UndoPageVersionManager(Page page, int maxVersions)
Constructor

Method Summary

void	beginVersion() Called when changes are immediately impending to the Page being managed.
void	componentAdded(Component component) Indicates that the given component was added.
void	componentModelChanging(Component component) Indicates that the model for the given component is about to change.
void	componentRemoved(Component component) Indicates that the given component was removed.
void	componentStateChanging(Change change) Indicates an internal state for the given component is about to change.
void	endVersion() Called when changes to the page have ended.
void	expireOldestVersion() Expires an old version
int	getCurrentVersionNumber()
Page	getVersion(int versionNumber) Retrieves a given Page version.
int	getVersions()

Methods inherited from class java.lang.Object

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

Constructor Detail

UndoPageVersionManager

public UndoPageVersionManager(Page page,
                              int maxVersions)

Constructor

Parameters:

page - The page that we're tracking changes to

maxVersions - The maximum number of versions to maintain before expiring the old versions

Method Detail

beginVersion

public void beginVersion()

Description copied from interface: IPageVersionManager

Called when changes are immediately impending to the Page being managed. The changes to the page between the call to this method and the call to endVersion() create a new version of the page.

In requests where a Page is not changed at all, beginVersion will never be called, nor will any of the other methods in this interface.

Specified by:

beginVersion in interface IPageVersionManager

See Also:

IPageVersionManager.beginVersion()

componentAdded

public void componentAdded(Component component)

Description copied from interface: IPageVersionManager

Indicates that the given component was added.

Specified by:

componentAdded in interface IPageVersionManager

Parameters:

component - The component that was added.

See Also:

IPageVersionManager.componentAdded(wicket.Component)

componentModelChanging

public void componentModelChanging(Component component)

Description copied from interface: IPageVersionManager

Indicates that the model for the given component is about to change.

Specified by:

componentModelChanging in interface IPageVersionManager

Parameters:

component - The component whose model is about to change

See Also:

IPageVersionManager.componentModelChanging(wicket.Component)

componentRemoved

public void componentRemoved(Component component)

Description copied from interface: IPageVersionManager

Indicates that the given component was removed.

Specified by:

componentRemoved in interface IPageVersionManager

Parameters:

component - The component that was removed.

See Also:

IPageVersionManager.componentRemoved(wicket.Component)

componentStateChanging

public void componentStateChanging(Change change)

Description copied from interface: IPageVersionManager

Indicates an internal state for the given component is about to change.

Specified by:

componentStateChanging in interface IPageVersionManager

Parameters:

change - The change which represents the internal state

See Also:

IPageVersionManager.componentStateChanging(wicket.version.undo.Change)

endVersion

public void endVersion()

Description copied from interface: IPageVersionManager

Called when changes to the page have ended.

Specified by:

endVersion in interface IPageVersionManager

See Also:

IPageVersionManager.endVersion()

expireOldestVersion

public void expireOldestVersion()

Expires an old version

Specified by:

expireOldestVersion in interface IPageVersionManager

getCurrentVersionNumber

public int getCurrentVersionNumber()

Specified by:

getCurrentVersionNumber in interface IPageVersionManager

Returns:

Returns the current (newest) version number available through this version manager.

See Also:

IPageVersionManager.getCurrentVersionNumber()

getVersion

public Page getVersion(int versionNumber)

Description copied from interface: IPageVersionManager

Retrieves a given Page version.

Specified by:

getVersion in interface IPageVersionManager

Parameters:

versionNumber - The version of the page to get

Returns:

The page or null if the version requested is not available

See Also:

IPageVersionManager.getVersion(int)

getVersions

public int getVersions()

Specified by:

getVersions in interface IPageVersionManager

Returns:

The number of versions stored in this version manager

See Also:

IPageVersionManager.getVersions()