Deprecated API

Contents

• Deprecated Interfaces
• Deprecated Classes
• Deprecated Exceptions
• Deprecated Fields
• Deprecated Methods
• Deprecated Constructors
• Deprecated Enum Constants

Deprecated Interfaces

Interface and Description
liquibase.configuration.ConfigurationContainer interface from old style configuration code. Use ConfigurationDefinition and AutoloadedConfigurations now.
liquibase.configuration.ConfigurationValueHandler
liquibase.command.LiquibaseCommand Define command with the new CommandStep interface
liquibase.logging.LogMessageFilter No longer used for filtering log messages. Log messages should be filtered for sensitive information before sending them to the log.

Deprecated Classes

Class and Description
liquibase.command.AbstractCliWrapperCommandStep
liquibase.command.AbstractCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.configuration.AbstractConfigurationContainer Use new ConfigurationDefinition style
liquibase.configuration.AbstractConfigurationContainer.ConfigurationContainer
liquibase.util.BooleanParser use BooleanUtil
liquibase.util.BooleanUtils use BooleanUtil
liquibase.parser.ChangeLogParserCofiguration Use correctly spelled version
liquibase.command.CommandArgument Used by the old LiquibaseCommand style of command setup.
liquibase.command.CommandResult Used by the old LiquibaseCommand style of command setup.
liquibase.command.CommandValidationErrors Used by the old LiquibaseCommand style of command setup.
liquibase.configuration.ConfigurationProperty
liquibase.logging.core.DefaultLoggerConfiguration not in use anywhere in Liquibase code and has been superseded by log-level and its associated command line parameters
liquibase.configuration.core.DeprecatedConfigurationValueProvider
liquibase.command.core.DiffCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.command.core.DiffToChangeLogCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.command.core.DropAllCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.command.core.ExecuteSqlCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.util.file.FilenameUtils use FilenameUtil
liquibase.resource.FileSystemResourceAccessor Use DirectoryResourceAccessor or ZipResourceAccessor
liquibase.command.core.GenerateChangeLogCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.configuration.GlobalConfiguration use GlobalConfiguration
liquibase.command.core.HistoryCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.util.JdbcUtils use JdbcUtil
liquibase.lockservice.LockServiceImpl use StandardLockService instead
liquibase.integration.commandline.Main use liquibase.integration.commandline.LiquibaseCommandLine.
liquibase.util.NumberUtils use NumberUtil
liquibase.command.core.SnapshotCommand Implement commands with CommandStep and call them with CommandFactory.getCommandDefinition(String...).
liquibase.extension.testing.testsystem.wrapper.UnimplementedWrapper will remove when all TestSystems are created.

Deprecated Exceptions

Exceptions and Description
liquibase.command.CommandExecutionException Used by the old LiquibaseCommand style of command setup.
liquibase.exception.CommandLineParsingException

Deprecated Fields

Field and Description
liquibase.configuration.GlobalConfiguration.ALWAYS_OVERRIDE_STORED_LOGIC_SCHEMA
liquibase.configuration.GlobalConfiguration.AUTO_REORG
liquibase.configuration.GlobalConfiguration.CHANGELOGLOCK_POLL_RATE
liquibase.configuration.GlobalConfiguration.CHANGELOGLOCK_WAIT_TIME
liquibase.configuration.GlobalConfiguration.CONVERT_DATA_TYPES
liquibase.configuration.GlobalConfiguration.DATABASECHANGELOG_TABLE_NAME
liquibase.configuration.GlobalConfiguration.DATABASECHANGELOGLOCK_TABLE_NAME
liquibase.command.core.UpdateCommandStep.DEFAULT_SCHEMA_NAME
liquibase.command.core.UpdateTestingRollbackCommandStep.DEFAULT_SCHEMA_NAME
liquibase.configuration.GlobalConfiguration.DIFF_COLUMN_ORDER
org.liquibase.maven.plugins.AbstractLiquibaseMojo.emptyPassword Use an empty or null value for the password instead.
liquibase.GlobalConfiguration.FILTER_LOG_MESSAGES No longer used
liquibase.configuration.GlobalConfiguration.FILTER_LOG_MESSAGES
liquibase.configuration.GlobalConfiguration.GENERATE_CHANGESET_CREATED_VALUES
liquibase.configuration.GlobalConfiguration.GENERATED_CHANGESET_IDS_INCLUDE_DESCRIPTION
liquibase.configuration.GlobalConfiguration.HEADLESS
liquibase.configuration.GlobalConfiguration.INCLUDE_CATALOG_IN_SPECIFICATION
org.liquibase.maven.plugins.AbstractLiquibaseChangeLogMojo.labels
liquibase.configuration.GlobalConfiguration.LIQUIBASE_CATALOG_NAME
liquibase.configuration.GlobalConfiguration.LIQUIBASE_SCHEMA_NAME
liquibase.configuration.GlobalConfiguration.LIQUIBASE_TABLESPACE_NAME
liquibase.logging.core.DefaultLoggerConfiguration.LOG_LEVEL
org.liquibase.maven.plugins.AbstractLiquibaseMojo.logging Logging managed by maven
liquibase.command.CommandStep.ORDER_DEFAULT
liquibase.command.CommandStep.ORDER_NOT_APPLICABLE
liquibase.configuration.GlobalConfiguration.OUTPUT_ENCODING
liquibase.configuration.GlobalConfiguration.OUTPUT_LINE_SEPARATOR
org.liquibase.maven.plugins.AbstractLiquibaseMojo.promptOnNonLocalDatabase No longer prompts
liquibase.configuration.GlobalConfiguration.SHOULD_RUN
liquibase.configuration.GlobalConfiguration.SHOULD_SNAPSHOT_DATA
liquibase.command.core.helpers.DbUrlConnectionCommandStep.SKIP_DATABASE_STEP_ARG

Deprecated Methods

Method and Description
liquibase.configuration.ConfigurationProperty.addAlias(String...)
liquibase.configuration.AbstractConfigurationContainer.ConfigurationContainer.addProperty(String, Class)
liquibase.Liquibase.calculateCheckSum(String) Use {link CommandScope(String).
liquibase.Liquibase.calculateCheckSum(String, String, String) Use {link CommandScope(String).
liquibase.Liquibase.changeLogSync(Contexts) use version with LabelExpression
liquibase.configuration.core.DeprecatedConfigurationValueProvider.clearData()
liquibase.executor.ExecutorService.clearExecutor(Database) Please use clearExecutor(name, database)
liquibase.util.NumberUtil.convertNumberToTargetClass(Number, Class) use ObjectUtil.convert(Object, Class)
liquibase.database.Database.correctSchema(CatalogAndSchema) use CatalogAndSchema.standardize(Database)
liquibase.database.AbstractJdbcDatabase.correctSchema(CatalogAndSchema)
liquibase.database.AbstractJdbcDatabase.correctSchema(String, String)
liquibase.integration.commandline.CommandLineUtils.createDatabaseObject(ClassLoader, String, String, String, String, String, String, boolean, boolean, String, String, String, String, String, String, String) Use ResourceAccessor version
liquibase.integration.commandline.CommandLineUtils.createDatabaseObject(ResourceAccessor, String, String, String, String, String, String, boolean, boolean, String, String, String, String, String, String, String)
liquibase.logging.Logger.debug(String) use Logger.fine(String)
liquibase.logging.Logger.debug(String, Throwable) use Logger.fine(String, Throwable)
liquibase.Liquibase.diff(Database, Database, CompareControl) Use {link CommandScope(String) to generate diff instead of this method.
liquibase.database.Database.doesTagExist(String) Use ChangeLogHistoryService.tagExists(String) instead
liquibase.database.Database.escapeColumnName(String, String, String, String, boolean) Know if you should quote the name or not, and use Database.escapeColumnName(String, String, String, String) which will quote things that look like functions, or leave it along as you see fit. Don't rely on this function guessing.
liquibase.command.CommandFactory.execute(LiquibaseCommand<T>) Use CommandScope.execute()
liquibase.logging.core.AbstractLogger.filterMessage(String) now just returns the message
liquibase.Liquibase.generateChangeLog(CatalogAndSchema, DiffToChangeLog, PrintStream, ChangeLogSerializer, Class<? extends DatabaseObject>...) Use {link CommandScope(String) to generateChangelog instead of this method.
liquibase.Liquibase.generateChangeLog(CatalogAndSchema, DiffToChangeLog, PrintStream, Class<? extends DatabaseObject>...) Use {link CommandScope(String) to generateChangelog instead of this method.
liquibase.configuration.GlobalConfiguration.getAlwaysOverrideStoredLogicSchema()
liquibase.Liquibase.getChangeSetStatuses(Contexts) use version with LabelExpression
liquibase.util.grammar.SimpleCharStream.getColumn()
liquibase.command.CommandFactory.getCommand(String) use CommandFactory.getCommandDefinition(String...)
liquibase.configuration.LiquibaseConfiguration.getConfiguration(Class<T>) use ConfigurationDefinition instances directly
liquibase.configuration.AbstractConfigurationContainer.getContainer()
liquibase.changelog.ChangeLogProperty.getContext() alias for ChangeLogProperty.getContextFilter()
liquibase.changelog.ChangeSet.getContexts() use ChangeSet.getContextFilter()
liquibase.changelog.DatabaseChangeLog.getContexts() use DatabaseChangeLog.getContextFilter()
liquibase.sql.visitor.AbstractSqlVisitor.getContexts() use AbstractSqlVisitor.getContextFilter()
liquibase.configuration.GlobalConfiguration.getDatabaseChangeLogLockPollRate()
liquibase.configuration.GlobalConfiguration.getDatabaseChangeLogLockTableName()
liquibase.configuration.GlobalConfiguration.getDatabaseChangeLogLockWaitTime()
liquibase.configuration.GlobalConfiguration.getDatabaseChangeLogTableName()
liquibase.database.ConnectionServiceFactory.getDatabaseConnection() use ConnectionServiceFactory.getDatabaseConnection(String)
liquibase.configuration.ConfigurationProperty.getDefaultValue()
liquibase.change.core.AddForeignKeyConstraintChange.getDeleteCascade() Use AddForeignKeyConstraintChange.getOnDelete(). This always returns null so it doesn't impact checksums when settings onDelete vs. deleteCascade
liquibase.configuration.ConfigurationProperty.getDescription()
liquibase.configuration.GlobalConfiguration.getDiffColumnOrder()
liquibase.executor.ExecutorService.getExecutor(Database) Please use getExecutor(name, database) instead
liquibase.Scope.getFileEncoding() use GlobalConfiguration.FILE_ENCODING
liquibase.logging.core.AbstractLogService.getFilter() always returns null
liquibase.util.file.FilenameUtils.getFullPath(String) use FilenameUtil.getDirectory(String)
liquibase.configuration.GlobalConfiguration.getGeneratedChangeSetIdsContainDescription()
liquibase.configuration.GlobalConfiguration.getHeadless()
liquibase.configuration.LiquibaseConfiguration.getInstance() use Scope.getSingleton(Class)
liquibase.logging.LogFactory.getInstance() Use Scope.getSingleton(Class)
liquibase.change.ChangeFactory.getInstance() Use Scope.getSingleton(Class)
liquibase.integration.spring.MultiTenantSpringLiquibase.getLabels() use MultiTenantSpringLiquibase.getLabelFilter()
liquibase.integration.spring.SpringLiquibase.getLabels() use SpringLiquibase.getLabelFilter()
liquibase.integration.ant.AbstractChangeLogBasedTask.getLabels() use AbstractChangeLogBasedTask.getLabelFilter()
liquibase.util.grammar.SimpleCharStream.getLine()
liquibase.configuration.GlobalConfiguration.getLiquibaseTablespaceName()
liquibase.logging.LogFactory.getLogger() Use Scope.getLog(Class)
liquibase.logging.LogFactory.getLogger(String) Use Scope.getLog(Class)
liquibase.configuration.ConfigurationProperty.getName()
liquibase.configuration.AbstractConfigurationContainer.getNamespace()
liquibase.configuration.ConfigurationProperty.getNamespace()
liquibase.configuration.ConfigurationContainer.getNamespace()
liquibase.command.CommandStep.getOrder(CommandDefinition)
liquibase.configuration.GlobalConfiguration.getOutputEncoding()
liquibase.configuration.GlobalConfiguration.getOutputLineSeparator()
liquibase.configuration.AbstractConfigurationContainer.getProperties()
liquibase.configuration.ConfigurationContainer.getProperties()
liquibase.configuration.AbstractConfigurationContainer.getProperty(String)
liquibase.configuration.ConfigurationContainer.getProperty(String)
liquibase.change.core.AddForeignKeyConstraintChange.getReferencesUniqueColumn() No longer supported in 3.0
liquibase.change.AbstractChange.getResourceAccessor() Should get from Scope
liquibase.snapshot.DatabaseSnapshot.getScratchData(String) Will be removed with 4.0
liquibase.statement.SequenceNextValueFunction.getSequenceSchemaName() use DatabaseFunction.getSchemaName()
liquibase.statement.SequenceCurrentValueFunction.getSequenceSchemaName() use DatabaseFunction.getSchemaName()
liquibase.configuration.GlobalConfiguration.getShouldFilterLogMessages() always returns "false"
liquibase.configuration.GlobalConfiguration.getShouldRun()
liquibase.configuration.GlobalConfiguration.getShouldSnapshotData()
liquibase.structure.core.Index.getTable() Use Index.getRelation()
liquibase.structure.core.UniqueConstraint.getTable() Use UniqueConstraint.getRelation()
liquibase.configuration.ConfigurationProperty.getType()
liquibase.configuration.ConfigurationProperty.getValue()
liquibase.configuration.ConfigurationProperty.getValue(Class<T>)
liquibase.configuration.AbstractConfigurationContainer.getValue(String, Class<T>)
liquibase.configuration.ConfigurationContainer.getValue(String, Class<T>)
liquibase.configuration.ConfigurationProperty.getWasOverridden()
liquibase.change.core.AbstractModifyDataChange.getWhereClause() use getWhere().
liquibase.statement.core.DeleteStatement.getWhereClause() use DeleteStatement.getWhere()
liquibase.changelog.DatabaseChangeLog.include(String, boolean, ResourceAccessor, ContextExpression, LabelExpression, Boolean, boolean) Incorrect LabelExpression parameter. Kept for backwards compatibility
liquibase.changelog.DatabaseChangeLog.include(String, boolean, ResourceAccessor, ContextExpression, Labels, Boolean, boolean)
liquibase.changelog.DatabaseChangeLog.includeAll(String, boolean, IncludeAllFilter, boolean, Comparator<String>, ResourceAccessor, ContextExpression, LabelExpression, boolean) Incorrect LabelExpression parameter. Kept for backwards compatibility
liquibase.integration.ant.BaseLiquibaseTask.isPromptOnNonLocalDatabase() no longer prompts
org.liquibase.maven.plugins.AbstractLiquibaseMojo.isPromptOnNonLocalDatabase() no longer prompts
liquibase.change.AbstractSQLChange.isSplitStatementsSet() To be removed when splitStatements is changed to be Boolean type
liquibase.resource.ResourceAccessor.list(String, String, boolean, boolean, boolean) use ResourceAccessor.search(String, boolean)
liquibase.Liquibase.listUnrunChangeSets(Contexts) use version with LabelExpression
liquibase.resource.Resource.openOutputStream(boolean) use Resource.openOutputStream(OpenOptions)
liquibase.resource.PathHandlerFactory.openResourceOutputStream(String, boolean) use PathHandlerFactory.openResourceOutputStream(String, OpenOptions)
liquibase.util.StreamUtil.openStream(String, Boolean, ChangeSet, ResourceAccessor) use ResourceAccessor.openStream(String, String)
liquibase.resource.ResourceAccessor.openStream(String, String) Use ResourceAccessor.search(String, boolean) or ResourceAccessor.getAll(String)
liquibase.resource.ResourceAccessor.openStreams(String, String) Use ResourceAccessor.search(String, boolean) or ResourceAccessor.getAll(String)
liquibase.util.StringUtil.processMutliLineSQL(String, boolean, boolean, String) The new method is StringUtil.processMultiLineSQL(String, boolean, boolean, String) (String)}
liquibase.configuration.GlobalConfiguration.setAlwaysOverrideStoredLogicSchema(boolean)
liquibase.changelog.ChangeLogProperty.setContext(String) alias for ChangeLogProperty.setContextFilter(String)
liquibase.changelog.ChangeSet.setContexts(ContextExpression) use ChangeSet.setContextFilter(ContextExpression)
liquibase.changelog.DatabaseChangeLog.setContexts(ContextExpression) use DatabaseChangeLog.setContextFilter(ContextExpression)
liquibase.sql.visitor.AbstractSqlVisitor.setContexts(ContextExpression) use AbstractSqlVisitor.setContextFilter(ContextExpression)
liquibase.configuration.core.DeprecatedConfigurationValueProvider.setData(ConfigurationDefinition<T>, T)
liquibase.configuration.core.DeprecatedConfigurationValueProvider.setData(String, Object)
liquibase.configuration.GlobalConfiguration.setDatabaseChangeLogLockPollRate(Long)
liquibase.configuration.GlobalConfiguration.setDatabaseChangeLogLockTableName(String)
liquibase.configuration.GlobalConfiguration.setDatabaseChangeLogLockWaitTime(Long)
liquibase.configuration.GlobalConfiguration.setDatabaseChangeLogTableName(String)
liquibase.configuration.ConfigurationProperty.setDefaultValue(Object)
liquibase.configuration.ConfigurationProperty.setDescription(String)
liquibase.configuration.GlobalConfiguration.setDiffColumnOrder(boolean)
liquibase.executor.ExecutorService.setExecutor(Database, Executor) Please use setExecutor(name, database, executor)
liquibase.logging.core.AbstractLogService.setFilter(LogMessageFilter) does not save the filter
liquibase.configuration.GlobalConfiguration.setGeneratedChangeSetIdsContainDescription(boolean)
liquibase.configuration.GlobalConfiguration.setHeadless(boolean)
liquibase.integration.spring.SpringLiquibase.setIgnoreClasspathPrefix(boolean) Always ignoring classpath prefix
liquibase.changelog.DatabaseChangeLog.setIncludeContexts(ContextExpression) use DatabaseChangeLog.setIncludeContextFilter(ContextExpression)
liquibase.changelog.DatabaseChangeLog.setIncludeLabels(LabelExpression) Correct version is DatabaseChangeLog.setIncludeLabels(Labels). Kept for backwards compatibility.
liquibase.integration.spring.MultiTenantSpringLiquibase.setLabels(String) use MultiTenantSpringLiquibase.setLabelFilter(String)
liquibase.integration.spring.SpringLiquibase.setLabels(String) use SpringLiquibase.setLabelFilter(String)
liquibase.integration.ant.AbstractChangeLogBasedTask.setLabels(String) use AbstractChangeLogBasedTask.setLabelFilter(String)
liquibase.configuration.GlobalConfiguration.setLiquibaseSchemaName(String)
liquibase.configuration.GlobalConfiguration.setLiquibaseTablespaceName(String)
liquibase.configuration.GlobalConfiguration.setOutputEncoding(String)
liquibase.configuration.GlobalConfiguration.setOutputLineSeparator(String)
liquibase.change.core.CreateProcedureChange.setProcedureBody(String) Use setProcedureText() instead
liquibase.integration.ant.BaseLiquibaseTask.setPromptOnNonLocalDatabase(boolean) no longer prompts
liquibase.change.Change.setResourceAccessor(ResourceAccessor) this is now set via Scope
liquibase.statement.SequenceNextValueFunction.setSequenceSchemaName(String) use DatabaseFunction.getSchemaName()
liquibase.statement.SequenceCurrentValueFunction.setSequenceSchemaName(String) use DatabaseFunction.getSchemaName()
liquibase.configuration.GlobalConfiguration.setShouldFilterLogMessages(boolean) ignores value
liquibase.configuration.GlobalConfiguration.setShouldRun(boolean)
liquibase.configuration.GlobalConfiguration.setShouldSnapshotData(boolean)
liquibase.structure.core.Index.setTable(Table) Use Index.setRelation(Relation)
liquibase.structure.core.UniqueConstraint.setTable(Table) Use UniqueConstraint.setRelation(Relation)
liquibase.configuration.ConfigurationProperty.setValue(Object)
liquibase.configuration.AbstractConfigurationContainer.setValue(String, Object)
liquibase.configuration.ConfigurationContainer.setValue(String, Object)
liquibase.configuration.ConfigurationProperty.setValueHandler(ConfigurationValueHandler)
liquibase.change.core.AbstractModifyDataChange.setWhereClause(String) use setWhere()
liquibase.statement.core.DeleteStatement.setWhereClause(String) use DeleteStatement.setWhere(String)
liquibase.Liquibase.tag(String) Use {link CommandScope(String) to tag instead of this method.
liquibase.database.Database.tag(String) Use ChangeLogHistoryService.tag(String) instead
liquibase.Liquibase.tagExists(String) Use {link CommandScope(String) to verify tag exist instead of this method.
liquibase.configuration.ConfigurationProperty.valueOf(Object)

Deprecated Constructors

Constructor and Description
liquibase.logging.core.AbstractLogger(LogMessageFilter) use {@link AbstractLogger(). Passed filter is not used.
liquibase.statement.core.AddPrimaryKeyStatement(String, String, String, String, String)
liquibase.integration.ant.AntTaskLogger(Task, LogMessageFilter) use AntTaskLogger(Task) instead
liquibase.logging.core.BufferedLogger(Class, BufferedLogService, LogMessageFilter) use BufferedLogger(Class, BufferedLogService)
liquibase.logging.core.CompositeLogger(List<Logger>, LogMessageFilter) use CompositeLogger(List)
liquibase.resource.FileSystemResourceAccessor(String) use FileSystemResourceAccessor(File...)
liquibase.logging.core.JavaLogger(Logger, LogMessageFilter) use JavaLogger(java.util.logging.Logger)
liquibase.changelog.visitor.RollbackVisitor(Database) - please use the constructor with ChangeExecListener, which can be null.
liquibase.changelog.visitor.UpdateVisitor(Database) - please use the constructor with ChangeExecListener, which can be null.

Deprecated Enum Constants

Enum Constant and Description
liquibase.Scope.Attr.fileEncoding use GlobalConfiguration.FILE_ENCODING