com.atlassian.confluence.upgrade.upgradetask
Class CrowdUsersUserMappingUpgradeTask

java.lang.Object
  com.atlassian.confluence.upgrade.AbstractUpgradeTask
      com.atlassian.confluence.upgrade.upgradetask.AbstractUserMappingUpgradeTask
          com.atlassian.confluence.upgrade.upgradetask.CrowdUsersUserMappingUpgradeTask

All Implemented Interfaces:

BackupSupport, DatabaseUpgradeTask, UpgradeTask

public class CrowdUsersUserMappingUpgradeTask
extends AbstractUserMappingUpgradeTask
implements DatabaseUpgradeTask

Upgrade task to ensure that for all the users in Confluence a ConfluenceUser object exist. Note that various "post schema" upgrade tasks assume this task has already run and make the assumption that all crowd users (which may not yet have associated content) are populated in the user_mapping table (ConfluenceUser). e.g. UserIndexingUpgradeTask.

Field Summary

Fields inherited from interface com.atlassian.confluence.upgrade.UpgradeTask

log

Constructor Summary

CrowdUsersUserMappingUpgradeTask(ConfluenceUserDao confluenceUserDao, net.sf.hibernate.SessionFactory sessionFactory, BatchOperationManager batchOperationManager)

Method Summary

boolean	breaksBackwardCompatibility() Returns true if a new export can't be imported in an older instance.
java.lang.String	getBuildNumber()
java.lang.String	getShortDescription() A short (<50 chars) description of the upgrade action
protected java.util.Set<java.lang.String>	getUsernamesMissingMapping()
boolean	runOnSpaceImport() Returns true if an older Space can't be imported in a new instance without running this task.

Methods inherited from class com.atlassian.confluence.upgrade.upgradetask.AbstractUserMappingUpgradeTask

doUpgrade

Methods inherited from class com.atlassian.confluence.upgrade.AbstractUpgradeTask

addAllErrors, addError, addError, getConstraint, getErrors, setBuildNumber, validate

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.atlassian.confluence.upgrade.UpgradeTask

doUpgrade, getConstraint, getErrors, validate

Constructor Detail

CrowdUsersUserMappingUpgradeTask

public CrowdUsersUserMappingUpgradeTask(ConfluenceUserDao confluenceUserDao,
                                        net.sf.hibernate.SessionFactory sessionFactory,
                                        BatchOperationManager batchOperationManager)

Method Detail

getUsernamesMissingMapping

protected java.util.Set<java.lang.String> getUsernamesMissingMapping()

Specified by:

getUsernamesMissingMapping in class AbstractUserMappingUpgradeTask

runOnSpaceImport

public boolean runOnSpaceImport()

Description copied from interface: BackupSupport

Returns true if an older Space can't be imported in a new instance without running this task. For example:

• A task updating macro names in the BodyContent table would be blocking.
• Tasks which updates data related to the space would be blocking.
• A task upgrading the user table wouldn't be blocking.
• Adding a mandatory column on space-related content breaks space import

Note that tasks don't run on space import yet, so we just reject the import in this case.

Specified by:

runOnSpaceImport in interface BackupSupport

breaksBackwardCompatibility

public boolean breaksBackwardCompatibility()

Description copied from interface: BackupSupport

Returns true if a new export can't be imported in an older instance. Breaking compatibility means a snapshot of the new version will not work at all with the previous version. For example:

• A destructive operation (Some data is replaced by another) breaks backwards compatibility
• Adding a optional column does NOT break backwards compatibility
• Data is copied to another column doesn't breaks backwards compatibility
• A build number incrementation doesn't breaks backwards compatibility

The best way to test is whether a newer export can be imported (with fully working features) in an older instance.

Specified by:

breaksBackwardCompatibility in interface BackupSupport

getBuildNumber

public java.lang.String getBuildNumber()

Specified by:

getBuildNumber in interface UpgradeTask

Overrides:

getBuildNumber in class AbstractUpgradeTask

Returns:

The build number that this upgrade is applicable to

getShortDescription

public java.lang.String getShortDescription()

Description copied from interface: UpgradeTask

A short (<50 chars) description of the upgrade action

Specified by:

getShortDescription in interface UpgradeTask

Overrides:

getShortDescription in class AbstractUpgradeTask