org.apache.wicket.version.undo
Class UndoPageVersionManager

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

All Implemented Interfaces:

java.io.Serializable, IClusterable, 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(boolean mergeVersion) 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(boolean mergeVersion) Called when changes to the page have ended.
void	expireOldestVersion() Expires an old version
int	getAjaxVersionNumber()
int	getCurrentVersionNumber()
Page	getVersion(int versionNumber) Retrieves a given Page version.
int	getVersions()
void	ignoreVersionMerge() Call this method when the current (ajax) request shouldn't merge the changes that are happening to the page with the previous version.
Page	rollbackPage(int numberOfVersions) This method rollbacks the page the number of versions specified Including the ajax versions.

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(boolean mergeVersion)

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

Parameters:

mergeVersion - If this is set the version that was created is merged with the previous one.

See Also:

IPageVersionManager.beginVersion(boolean)

ignoreVersionMerge

public void ignoreVersionMerge()

Description copied from interface: IPageVersionManager

Call this method when the current (ajax) request shouldn't merge the changes that are happening to the page with the previous version. This is for example needed when you want to redirect to this page in an ajax request and then you do want to version normally.. This method should only be called if the beginVersion was called with true!

Specified by:

ignoreVersionMerge in interface IPageVersionManager

See Also:

IPageVersionManager.ignoreVersionMerge()

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(org.apache.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(org.apache.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(org.apache.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(org.apache.wicket.version.undo.Change)

endVersion

public void endVersion(boolean mergeVersion)

Description copied from interface: IPageVersionManager

Called when changes to the page have ended.

Specified by:

endVersion in interface IPageVersionManager

Parameters:

mergeVersion - If this is set the version that was created is merged with the previous one.

See Also:

IPageVersionManager.endVersion(boolean)

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()

getAjaxVersionNumber

public int getAjaxVersionNumber()

Specified by:

getAjaxVersionNumber in interface IPageVersionManager

Returns:

Returns the current ajax version number.

See Also:

IPageVersionManager.getAjaxVersionNumber()

getVersion

public Page getVersion(int versionNumber)

Description copied from interface: IPageVersionManager

Retrieves a given Page version. This method does not take use the ajax versions.

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)

rollbackPage

public Page rollbackPage(int numberOfVersions)

Description copied from interface: IPageVersionManager

This method rollbacks the page the number of versions specified Including the ajax versions.

Specified by:

rollbackPage in interface IPageVersionManager

Returns:

See Also:

IPageVersionManager.rollbackPage(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()