org.nuiton.topia.migration

Class AbstractTopiaMigrationCallback<PersistenceContext extends TopiaPersistenceContext>

java.lang.Object

org.nuiton.topia.migration.AbstractTopiaMigrationCallback<PersistenceContext>

Direct Known Subclasses:

TopiaMigrationCallbackByClass, TopiaMigrationCallbackByClassNG, TopiaMigrationCallbackByMethod

public abstract class AbstractTopiaMigrationCallback<PersistenceContext extends TopiaPersistenceContext>
extends Object

Abstract migration callback.

Since:

2.5

Author:

tchemit

Constructor Summary

Constructors

Constructor and Description
AbstractTopiaMigrationCallback()

Method Summary

Methods

Modifier and Type	Method and Description
abstract boolean	askUser(org.nuiton.util.Version dbVersion, List<org.nuiton.util.Version> versions) Hook to ask user if migration can be performed.
boolean	doMigration(TopiaApplicationContext<PersistenceContext> applicationContext, org.nuiton.util.Version dbVersion, boolean showSql, boolean showProgression, List<org.nuiton.util.Version> versions) Tentative de migration depuis la version de la base version la version souhaitee.
void	executeSQL(PersistenceContext tx, boolean showSql, boolean showProgression, String... sqls) Executes the given sqls requests.
void	executeSQL(PersistenceContext tx, String... sqls)
abstract org.nuiton.util.Version[]	getAvailableVersions()
protected abstract TopiaSqlSupport	getSqlSupport(PersistenceContext persistenceContext) Get the sql support used to execute sql queries.
protected abstract void	migrateForVersion(org.nuiton.util.Version version, PersistenceContext tx, boolean showSql, boolean showProgression)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractTopiaMigrationCallback

public AbstractTopiaMigrationCallback()

Method Detail

getAvailableVersions

public abstract org.nuiton.util.Version[] getAvailableVersions()

Returns:

the available versions from the call back

askUser

public abstract boolean askUser(org.nuiton.util.Version dbVersion,
              List<org.nuiton.util.Version> versions)

Hook to ask user if migration can be performed.

Parameters:

dbVersion - the actual db version

versions - the versions to update

Returns:

false if migration is canceled, true otherwise.

getSqlSupport

protected abstract TopiaSqlSupport getSqlSupport(PersistenceContext persistenceContext)

Get the sql support used to execute sql queries.

Parameters:

persistenceContext - persistence context

Returns:

the sql support

Since:

3.0

migrateForVersion

protected abstract void migrateForVersion(org.nuiton.util.Version version,
                     PersistenceContext tx,
                     boolean showSql,
                     boolean showProgression)
                                   throws Exception

Throws:

Exception

doMigration

public boolean doMigration(TopiaApplicationContext<PersistenceContext> applicationContext,
                  org.nuiton.util.Version dbVersion,
                  boolean showSql,
                  boolean showProgression,
                  List<org.nuiton.util.Version> versions)

Tentative de migration depuis la version de la base version la version souhaitee.

On applique toutes les migrations de version indiquee dans le parametre version.

Pour chaque version, on cherche la methode migrateTo_XXX ou XXX est la version transforme en identifiant java via la methode Version.getValidName() et on l'execute.

Note: pour chaque version a appliquer, on ouvre une nouvelle transaction.

Parameters:

applicationContext - topia context de la transaction en cours

dbVersion - database version

showSql - drapeau pour afficher les requete sql

showProgression - drapeau pour afficher la progression

versions - all versions knwon by service @return migration a ggrement

Returns:

true si la migration est accepté, false autrement.

executeSQL

public void executeSQL(PersistenceContext tx,
              String... sqls)
                throws TopiaException

Throws:

TopiaException

executeSQL

public void executeSQL(PersistenceContext tx,
              boolean showSql,
              boolean showProgression,
              String... sqls)
                throws TopiaException

Executes the given sqls requests.

Parameters:

showSql - flag to see sql requests

showProgression - flag to see progession on console

sqls - requests to execute

Throws:

TopiaException - if any pb

Since:

2.3.0