Module org.jooq

Package org.jooq

Interface MigrationContext

All Superinterfaces:

Scope

@Experimental
public interface MigrationContext
extends Scope

The context in which a Migration is executed.

This type is a Scope with independent lifecycle and its own Scope.data() map.

This is EXPERIMENTAL functionality and subject to change in future jOOQ versions.

Author:

Lukas Eder

See Also:

• MigrationListener

Method Summary

Modifier and Type	Method	Description
@NotNull Set<Schema>	migratedSchemas()	The set of schemas that are being migrated, as specified in Settings#getMigration().
@NotNull Commit	migrationFrom()	The Commit from which a Migration has started.
@NotNull Queries	migrationQueries()	The complete set of Queries that are executed between migrationFrom() and migrationTo().
@NotNull Commit	migrationTo()	The Commit to which a Migration is headed.
@NotNull Queries	queries()	The complete set of Queries that are executed between queriesFrom() and queriesTo().
@NotNull Commit	queriesFrom()	The Version from which an individual set of Queries has started.
@NotNull Commit	queriesTo()	The Version to which an individual set of Queries is headed.
@NotNull Query	query()	The current Query that is being executed.

Methods inherited from interface org.jooq.Scope

configuration, creationTime, data, data, data, dialect, dsl, family, settings

Method Details

migratedSchemas

@NotNull
@NotNull Set<Schema> migratedSchemas()

The set of schemas that are being migrated, as specified in Settings#getMigration().

This is available on all MigrationListener events.

migrationFrom

@NotNull
@NotNull Commit migrationFrom()

The Commit from which a Migration has started.

migrationFrom() and migrationTo() versions need not be consecutive versions for any given migration. If a migration jumps a few versions, these two methods will only return the endpoints.

This is available on all MigrationListener events.

migrationTo

@NotNull
@NotNull Commit migrationTo()

The Commit to which a Migration is headed.

migrationFrom() and migrationTo() versions need not be consecutive versions for any given migration. If a migration jumps a few versions, these two methods will only return the endpoints.

This is available on all MigrationListener events.

migrationQueries

@NotNull
@NotNull Queries migrationQueries()

The complete set of Queries that are executed between migrationFrom() and migrationTo().

This is available on all MigrationListener events.

queriesFrom

@NotNull
@NotNull Commit queriesFrom()

The Version from which an individual set of Queries has started.

queriesFrom() and queriesTo() versions are consecutive versions in a migration. If a migration jumps a few versions, these two methods might return those intermediate versions on these events:

• MigrationListener.queriesStart(MigrationContext)
• MigrationListener.queriesEnd(MigrationContext)
• MigrationListener.queryStart(MigrationContext)
• MigrationListener.queryEnd(MigrationContext)

queriesTo

@NotNull
@NotNull Commit queriesTo()

The Version to which an individual set of Queries is headed.

queriesFrom() and queriesTo() versions are consecutive versions in a migration. If a migration jumps a few versions, these two methods might return those intermediate versions on these events:

• MigrationListener.queriesStart(MigrationContext)
• MigrationListener.queriesEnd(MigrationContext)
• MigrationListener.queryStart(MigrationContext)
• MigrationListener.queryEnd(MigrationContext)

queries

@NotNull
@NotNull Queries queries()

The complete set of Queries that are executed between queriesFrom() and queriesTo().

This is available on the same MigrationListener events as queriesFrom() and queriesTo().

query

@NotNull
@NotNull Query query()

The current Query that is being executed.

This is available on MigrationListener.queryStart(MigrationContext) and MigrationListener.queryEnd(MigrationContext).