Package org.craftercms.studio.impl.v2.upgrade

Class StudioUpgradeManagerImpl

java.lang.Object

org.craftercms.commons.upgrade.impl.AbstractUpgradeManager<String>

org.craftercms.studio.impl.v2.upgrade.StudioUpgradeManagerImpl

All Implemented Interfaces:

org.craftercms.commons.upgrade.UpgradeManager<String>, StudioUpgradeManager, org.springframework.beans.factory.Aware, org.springframework.context.ApplicationContextAware

public class StudioUpgradeManagerImpl
extends org.craftercms.commons.upgrade.impl.AbstractUpgradeManager<String>
implements StudioUpgradeManager

Default implementation for StudioUpgradeManager.

Author:

joseross

Field Summary

Fields

Modifier and Type	Field	Description
protected org.craftercms.commons.upgrade.UpgradePipelineFactory<String>	bpPipelineFactory
protected org.craftercms.commons.upgrade.impl.configuration.YamlConfigurationProvider	configurationProvider
protected ContentRepository	contentRepository
protected DataSource	dataSource
protected org.craftercms.commons.upgrade.UpgradePipelineFactory<String>	dbPipelineFactory
protected org.craftercms.commons.upgrade.VersionProvider	dbVersionProvider
protected InstanceService	instanceService
protected org.craftercms.commons.entitlements.validator.DbIntegrityValidator	integrityValidator
protected RetryingRepositoryOperationFacade	retryingRepositoryOperationFacade
static final String	SQL_QUERY_SITES
static final String	SQL_QUERY_SITES_3_0_0
protected StudioConfiguration	studioConfiguration

Fields inherited from class org.craftercms.commons.upgrade.impl.AbstractUpgradeManager

applicationContext, continueOnFailure

Constructor Summary

Constructors

Constructor

Description

StudioUpgradeManagerImpl(org.craftercms.commons.upgrade.VersionProvider dbVersionProvider, org.craftercms.commons.upgrade.UpgradePipelineFactory<String> dbPipelineFactory, org.craftercms.commons.upgrade.UpgradePipelineFactory<String> bpPipelineFactory, org.craftercms.commons.upgrade.impl.configuration.YamlConfigurationProvider configurationProvider, DataSource dataSource, org.craftercms.commons.entitlements.validator.DbIntegrityValidator integrityValidator, ContentRepository contentRepository, StudioConfiguration studioConfiguration, InstanceService instanceService, RetryingRepositoryOperationFacade retryingRepositoryOperationFacade)

Method Summary

Modifier and Type	Method	Description
protected boolean	checkIfSiteRepoExists(String site)
protected org.craftercms.commons.upgrade.impl.UpgradeContext<String>	createUpgradeContext(String site)
protected List<String>	doGetTargets()
void	doUpgrade(org.craftercms.commons.upgrade.impl.UpgradeContext<String> context)
List<String>	getExistingEnvironments(String site)	Returns all existing environments for the given site
protected org.craftercms.commons.upgrade.UpgradePipelineFactory<String>	getPipelineFactory(String factoryName)
void	startUpgrade()	Obtains the current version and starts the upgrade process.
void	upgradeBlueprints()	Executes all required upgrades for the blueprints.
void	upgradeDatabaseAndConfiguration()	Executes all required upgrades for the system.
void	upgradeExistingSites()	Executes the upgrades for all existing sites.
void	upgradeSiteConfiguration(StudioUpgradeContext context)	Executes the upgrades for all managed configurations in the given site.

Methods inherited from class org.craftercms.commons.upgrade.impl.AbstractUpgradeManager

executePipeline, getTargets, setApplicationContext, setContinueOnFailure, upgrade, upgrade

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.craftercms.commons.upgrade.UpgradeManager

getTargets, upgrade, upgrade

Field Details

SQL_QUERY_SITES_3_0_0

public static final String SQL_QUERY_SITES_3_0_0

See Also:

• Constant Field Values

SQL_QUERY_SITES

public static final String SQL_QUERY_SITES

See Also:

• Constant Field Values

dbVersionProvider

protected org.craftercms.commons.upgrade.VersionProvider dbVersionProvider

dbPipelineFactory

protected org.craftercms.commons.upgrade.UpgradePipelineFactory<String> dbPipelineFactory

bpPipelineFactory

protected org.craftercms.commons.upgrade.UpgradePipelineFactory<String> bpPipelineFactory

configurationProvider

protected org.craftercms.commons.upgrade.impl.configuration.YamlConfigurationProvider configurationProvider

dataSource

protected DataSource dataSource

integrityValidator

protected org.craftercms.commons.entitlements.validator.DbIntegrityValidator integrityValidator

contentRepository

protected ContentRepository contentRepository

studioConfiguration

protected StudioConfiguration studioConfiguration

instanceService

protected InstanceService instanceService

retryingRepositoryOperationFacade

protected RetryingRepositoryOperationFacade retryingRepositoryOperationFacade

Constructor Details

StudioUpgradeManagerImpl

@ConstructorProperties({"dbVersionProvider","dbPipelineFactory","bpPipelineFactory","configurationProvider","dataSource","integrityValidator","contentRepository","studioConfiguration","instanceService","retryingRepositoryOperationFacade"})
public StudioUpgradeManagerImpl(org.craftercms.commons.upgrade.VersionProvider dbVersionProvider,
 org.craftercms.commons.upgrade.UpgradePipelineFactory<String> dbPipelineFactory,
 org.craftercms.commons.upgrade.UpgradePipelineFactory<String> bpPipelineFactory,
 org.craftercms.commons.upgrade.impl.configuration.YamlConfigurationProvider configurationProvider,
 DataSource dataSource,
 org.craftercms.commons.entitlements.validator.DbIntegrityValidator integrityValidator,
 ContentRepository contentRepository,
 StudioConfiguration studioConfiguration,
 InstanceService instanceService,
 RetryingRepositoryOperationFacade retryingRepositoryOperationFacade)

Method Details

upgradeDatabaseAndConfiguration

public void upgradeDatabaseAndConfiguration()
                                     throws org.craftercms.commons.upgrade.exception.UpgradeException,
org.craftercms.commons.config.ConfigurationException

Executes all required upgrades for the system.

Specified by:

upgradeDatabaseAndConfiguration in interface StudioUpgradeManager

Throws:

org.craftercms.commons.upgrade.exception.UpgradeException - if any of the upgrades fails

org.craftercms.commons.config.ConfigurationException

getPipelineFactory

protected org.craftercms.commons.upgrade.UpgradePipelineFactory<String> getPipelineFactory(String factoryName)

doUpgrade

public void doUpgrade(org.craftercms.commons.upgrade.impl.UpgradeContext<String> context)
               throws org.craftercms.commons.upgrade.exception.UpgradeException,
org.craftercms.commons.config.ConfigurationException

Specified by:

doUpgrade in class org.craftercms.commons.upgrade.impl.AbstractUpgradeManager<String>

Throws:

org.craftercms.commons.upgrade.exception.UpgradeException

org.craftercms.commons.config.ConfigurationException

doGetTargets

protected List<String> doGetTargets()
                             throws Exception

Specified by:

doGetTargets in class org.craftercms.commons.upgrade.impl.AbstractUpgradeManager<String>

Throws:

Exception

createUpgradeContext

protected org.craftercms.commons.upgrade.impl.UpgradeContext<String> createUpgradeContext(String site)

Specified by:

createUpgradeContext in class org.craftercms.commons.upgrade.impl.AbstractUpgradeManager<String>

upgradeSiteConfiguration

public void upgradeSiteConfiguration(StudioUpgradeContext context)
                              throws org.craftercms.commons.upgrade.exception.UpgradeException

Executes the upgrades for all managed configurations in the given site.

Specified by:

upgradeSiteConfiguration in interface StudioUpgradeManager

Parameters:

context - the context for the upgrades

Throws:

org.craftercms.commons.upgrade.exception.UpgradeException - if any of the upgrades fails

upgradeExistingSites

public void upgradeExistingSites()
                          throws org.craftercms.commons.upgrade.exception.UpgradeException

Executes the upgrades for all existing sites.

Specified by:

upgradeExistingSites in interface StudioUpgradeManager

Throws:

org.craftercms.commons.upgrade.exception.UpgradeException - if any of the upgrades fails

checkIfSiteRepoExists

protected boolean checkIfSiteRepoExists(String site)

upgradeBlueprints

public void upgradeBlueprints()
                       throws org.craftercms.commons.upgrade.exception.UpgradeException,
org.craftercms.commons.config.ConfigurationException

Executes all required upgrades for the blueprints.

Specified by:

upgradeBlueprints in interface StudioUpgradeManager

Throws:

org.craftercms.commons.upgrade.exception.UpgradeException - if any of the upgrades fails

org.craftercms.commons.config.ConfigurationException

getExistingEnvironments

public List<String> getExistingEnvironments(String site)

Returns all existing environments for the given site

Specified by:

getExistingEnvironments in interface StudioUpgradeManager

Parameters:

site - the id of the site

Returns:

the list of environments

startUpgrade

@EventListener(StartUpgradeEvent.class)
public void startUpgrade()
                  throws org.craftercms.commons.upgrade.exception.UpgradeException,
org.craftercms.commons.entitlements.exception.EntitlementException,
org.craftercms.commons.config.ConfigurationException

Obtains the current version and starts the upgrade process.

Throws:

org.craftercms.commons.upgrade.exception.UpgradeException - if there is any error in the upgrade process

org.craftercms.commons.entitlements.exception.EntitlementException - if there is any validation error after the upgrade process

org.craftercms.commons.config.ConfigurationException