All Downloads are FREE. Search and download functionalities are using the official Maven repository.

liquibase.integration.spring.SpringLiquibase Maven / Gradle / Ivy

There is a newer version: 3.6.2.5.inovus
Show newest version
package liquibase.integration.spring;

import liquibase.Contexts;
import liquibase.LabelExpression;
import liquibase.Liquibase;
import liquibase.configuration.ConfigurationProperty;
import liquibase.configuration.GlobalConfiguration;
import liquibase.configuration.LiquibaseConfiguration;
import liquibase.database.Database;
import liquibase.database.DatabaseConnection;
import liquibase.database.DatabaseFactory;
import liquibase.database.OfflineConnection;
import liquibase.database.jvm.JdbcConnection;
import liquibase.exception.DatabaseException;
import liquibase.exception.LiquibaseException;
import liquibase.logging.LogService;
import liquibase.logging.LogType;
import liquibase.logging.Logger;
import liquibase.resource.ClassLoaderResourceAccessor;
import liquibase.resource.ResourceAccessor;
import liquibase.util.StringUtils;
import liquibase.util.file.FilenameUtils;
import org.springframework.beans.factory.BeanNameAware;
import org.springframework.beans.factory.InitializingBean;
import org.springframework.context.ResourceLoaderAware;
import org.springframework.core.io.Resource;
import org.springframework.core.io.ResourceLoader;
import org.springframework.core.io.support.ResourcePatternUtils;

import javax.sql.DataSource;
import java.io.*;
import java.net.URLConnection;
import java.sql.Connection;
import java.sql.SQLException;
import java.util.HashSet;
import java.util.Map;
import java.util.Set;
import java.util.jar.Attributes;
import java.util.jar.Manifest;

/**
 * A Spring-ified wrapper for Liquibase.
 * 

* Example Configuration: *

*

* This Spring configuration example will cause liquibase to run automatically when the Spring context is * initialized. It will load db-changelog.xml from the classpath and apply it against * myDataSource. *

*

* *

 * <bean id="myLiquibase"
 *          class="liquibase.spring.SpringLiquibase"
 *          >
 *
 *      <property name="dataSource" ref="myDataSource" />
 *
 *      <property name="changeLog" value="classpath:db-changelog.xml" />
 *
 * </bean>
 *
 * 
* * @author Rob Schoening */ public class SpringLiquibase implements InitializingBean, BeanNameAware, ResourceLoaderAware { protected final Logger log = LogService.getLog(SpringLiquibase.class); protected String beanName; protected ResourceLoader resourceLoader; protected DataSource dataSource; protected String changeLog; protected String contexts; protected String labels; protected String tag; protected Map parameters; protected String defaultSchema; protected String liquibaseSchema; protected String databaseChangeLogTable; protected String databaseChangeLogLockTable; protected String liquibaseTablespace; protected boolean dropFirst; protected boolean clearCheckSums; protected boolean shouldRun = true; protected File rollbackFile; /** * Ignores classpath prefix during changeset comparison. * This is particularly useful if Liquibase is run in different ways. * * For instance, if Maven plugin is used to run changesets, as in: * * <configuration> * ... * <changeLogFile>path/to/changelog</changeLogFile> * </configuration> * * * And {@link SpringLiquibase} is configured like: * * SpringLiquibase springLiquibase = new SpringLiquibase(); * springLiquibase.setChangeLog("classpath:path/to/changelog"); * * * or, in equivalent XML configuration: * * <bean id="springLiquibase" class="liquibase.integration.spring.SpringLiquibase"> * <property name="changeLog" value="path/to/changelog" /> * </bean> * * * {@link Liquibase#listUnrunChangeSets(Contexts, )} will * always, by default, return changesets, regardless of their * execution by Maven. * Maven-executed changeset path name are not be prepended by * "classpath:" whereas the ones parsed via SpringLiquibase are. * * To avoid this issue, just set ignoreClasspathPrefix to true. */ private boolean ignoreClasspathPrefix = true; protected boolean testRollbackOnUpdate = false; public SpringLiquibase() { super(); } public boolean isDropFirst() { return dropFirst; } public void setDropFirst(boolean dropFirst) { this.dropFirst = dropFirst; } public boolean isClearCheckSums() { return clearCheckSums; } public void setClearCheckSums(boolean clearCheckSums) { this.clearCheckSums = clearCheckSums; } public void setShouldRun(boolean shouldRun) { this.shouldRun = shouldRun; } public String getDatabaseProductName() throws DatabaseException { Connection connection = null; Database database = null; String name = "unknown"; try { connection = getDataSource().getConnection(); database = DatabaseFactory.getInstance().findCorrectDatabaseImplementation(new JdbcConnection(connection)); name = database.getDatabaseProductName(); } catch (SQLException e) { throw new DatabaseException(e); } finally { if (database != null) { database.close(); } else if (connection != null) { try { if (!connection.getAutoCommit()) { connection.rollback(); } connection.close(); } catch (SQLException e) { log.warning(LogType.LOG, "problem closing connection", e); } } } return name; } /** * The DataSource that liquibase will use to perform the migration. */ public DataSource getDataSource() { return dataSource; } /** * The DataSource that liquibase will use to perform the migration. */ public void setDataSource(DataSource dataSource) { this.dataSource = dataSource; } /** * Returns a Resource that is able to resolve to a file or classpath resource. */ public String getChangeLog() { return changeLog; } /** * Sets a Spring Resource that is able to resolve to a file or classpath resource. * An example might be classpath:db-changelog.xml. */ public void setChangeLog(String dataModel) { this.changeLog = dataModel; } public String getContexts() { return contexts; } public void setContexts(String contexts) { this.contexts = contexts; } public String getLabels() { return labels; } public void setLabels(String labels) { this.labels = labels; } public String getTag() { return tag; } public void setTag(String tag) { this.tag = tag; } public String getDefaultSchema() { return defaultSchema; } public void setDefaultSchema(String defaultSchema) { this.defaultSchema = defaultSchema; } public String getLiquibaseTablespace() { return liquibaseTablespace; } public void setLiquibaseTablespace(String liquibaseTablespace) { this.liquibaseTablespace = liquibaseTablespace; } public String getLiquibaseSchema() { return liquibaseSchema; } public void setLiquibaseSchema(String liquibaseSchema) { this.liquibaseSchema = liquibaseSchema; } public String getDatabaseChangeLogTable() { return databaseChangeLogTable; } public void setDatabaseChangeLogTable(String databaseChangeLogTable) { this.databaseChangeLogTable = databaseChangeLogTable; } public String getDatabaseChangeLogLockTable() { return databaseChangeLogLockTable; } public void setDatabaseChangeLogLockTable(String databaseChangeLogLockTable) { this.databaseChangeLogLockTable = databaseChangeLogLockTable; } /** * Returns whether a rollback should be tested at update time or not. */ public boolean isTestRollbackOnUpdate() { return testRollbackOnUpdate; } /** * If testRollbackOnUpdate is set to true a rollback will be tested at tupdate time. * For doing so when the update is performed * @param testRollbackOnUpdate */ public void setTestRollbackOnUpdate(boolean testRollbackOnUpdate) { this.testRollbackOnUpdate = testRollbackOnUpdate; } /** * Executed automatically when the bean is initialized. */ @Override public void afterPropertiesSet() throws LiquibaseException { ConfigurationProperty shouldRunProperty = LiquibaseConfiguration.getInstance() .getProperty(GlobalConfiguration.class, GlobalConfiguration.SHOULD_RUN); if (!shouldRunProperty.getValue(Boolean.class)) { LogService.getLog(getClass()).info(LogType.LOG, "Liquibase did not run because " + LiquibaseConfiguration .getInstance().describeValueLookupLogic(shouldRunProperty) + " was set to false"); return; } if (!shouldRun) { LogService.getLog(getClass()).info(LogType.LOG, "Liquibase did not run because 'shouldRun' " + "property was set " + "to false on " + getBeanName() + " Liquibase Spring bean."); return; } Connection c = null; Liquibase liquibase = null; try { c = getDataSource().getConnection(); liquibase = createLiquibase(c); generateRollbackFile(liquibase); performUpdate(liquibase); } catch (SQLException e) { throw new DatabaseException(e); } finally { Database database = null; if (liquibase != null) { database = liquibase.getDatabase(); } if (database != null) { database.close(); } } } private void generateRollbackFile(Liquibase liquibase) throws LiquibaseException { if (rollbackFile != null) { try ( FileOutputStream fileOutputStream = new FileOutputStream(rollbackFile); Writer output = new OutputStreamWriter(fileOutputStream, LiquibaseConfiguration.getInstance() .getConfiguration(GlobalConfiguration.class).getOutputEncoding()) ) { if (tag != null) { liquibase.futureRollbackSQL(tag, new Contexts(getContexts()), new LabelExpression(getLabels()), output); } else { liquibase.futureRollbackSQL(new Contexts(getContexts()), new LabelExpression(getLabels()), output); } } catch (IOException e) { throw new LiquibaseException("Unable to generate rollback file.", e); } } } protected void performUpdate(Liquibase liquibase) throws LiquibaseException { if (isClearCheckSums()) { liquibase.clearCheckSums(); } if (isTestRollbackOnUpdate()) { if (tag != null) { liquibase.updateTestingRollback(tag, new Contexts(getContexts()), new LabelExpression(getLabels())); } else { liquibase.updateTestingRollback(new Contexts(getContexts()), new LabelExpression(getLabels())); } } else { if (tag != null) { liquibase.update(tag, new Contexts(getContexts()), new LabelExpression(getLabels())); } else { liquibase.update(new Contexts(getContexts()), new LabelExpression(getLabels())); } } } protected Liquibase createLiquibase(Connection c) throws LiquibaseException { SpringResourceOpener resourceAccessor = createResourceOpener(); Liquibase liquibase = new Liquibase(getChangeLog(), resourceAccessor, createDatabase(c, resourceAccessor)); liquibase.setIgnoreClasspathPrefix(isIgnoreClasspathPrefix()); if (parameters != null) { for (Map.Entry entry : parameters.entrySet()) { liquibase.setChangeLogParameter(entry.getKey(), entry.getValue()); } } if (isDropFirst()) { liquibase.dropAll(); } return liquibase; } /** * Subclasses may override this method add change some database settings such as * default schema before returning the database object. * * @param c * @return a Database implementation retrieved from the {@link DatabaseFactory}. * @throws DatabaseException */ protected Database createDatabase(Connection c, ResourceAccessor resourceAccessor) throws DatabaseException { DatabaseConnection liquibaseConnection; if (c == null) { log.warning(LogType.LOG, "Null connection returned by liquibase datasource. Using offline unknown database"); liquibaseConnection = new OfflineConnection("offline:unknown", resourceAccessor); } else { liquibaseConnection = new JdbcConnection(c); } Database database = DatabaseFactory.getInstance().findCorrectDatabaseImplementation(liquibaseConnection); if (StringUtils.trimToNull(this.defaultSchema) != null) { if (database.supportsSchemas()) { database.setDefaultSchemaName(this.defaultSchema); } else if (database.supportsCatalogs()) { database.setDefaultCatalogName(this.defaultSchema); } } if (StringUtils.trimToNull(this.liquibaseSchema) != null) { if (database.supportsSchemas()) { database.setLiquibaseSchemaName(this.liquibaseSchema); } else if (database.supportsCatalogs()) { database.setLiquibaseCatalogName(this.liquibaseSchema); } } if (StringUtils.trimToNull(this.liquibaseTablespace) != null && database.supportsTablespaces()) { database.setLiquibaseTablespaceName(this.liquibaseTablespace); } if (StringUtils.trimToNull(this.databaseChangeLogTable) != null) { database.setDatabaseChangeLogTableName(this.databaseChangeLogTable); } if (StringUtils.trimToNull(this.databaseChangeLogLockTable) != null) { database.setDatabaseChangeLogLockTableName(this.databaseChangeLogLockTable); } return database; } public void setChangeLogParameters(Map parameters) { this.parameters = parameters; } /** * Create a new resourceOpener. */ protected SpringResourceOpener createResourceOpener() { return new SpringResourceOpener(getChangeLog()); } /** * Gets the Spring-name of this instance. * * @return */ public String getBeanName() { return beanName; } /** * Spring sets this automatically to the instance's configured bean name. */ @Override public void setBeanName(String name) { this.beanName = name; } public ResourceLoader getResourceLoader() { return resourceLoader; } @Override public void setResourceLoader(ResourceLoader resourceLoader) { this.resourceLoader = resourceLoader; } public void setRollbackFile(File rollbackFile) { this.rollbackFile = rollbackFile; } public boolean isIgnoreClasspathPrefix() { return ignoreClasspathPrefix; } public void setIgnoreClasspathPrefix(boolean ignoreClasspathPrefix) { this.ignoreClasspathPrefix = ignoreClasspathPrefix; } @Override public String toString() { return getClass().getName() + "(" + this.getResourceLoader().toString() + ")"; } public class SpringResourceOpener extends ClassLoaderResourceAccessor { private String parentFile; public SpringResourceOpener(String parentFile) { this.parentFile = parentFile; } @Override protected void init() { super.init(); try { Resource[] resources = getResources(""); if ((resources.length != 0) && ((resources.length != 1) || resources[0].exists())) { for (Resource res : resources) { addRootPath(res.getURL()); } return; } //sometimes not able to look up by empty string, try all the liquibase packages Set liquibasePackages = new HashSet<>(); for (Resource manifest : getResources("META-INF/MANIFEST.MF")) { liquibasePackages.addAll(getPackagesFromManifest(manifest)); } if (liquibasePackages.isEmpty()) { LogService.getLog(getClass()).warning(LogType.LOG, "No Liquibase-Packages entry found in MANIFEST.MF. " + "Using fallback of entire 'liquibase' package"); liquibasePackages.add("liquibase"); } for (String foundPackage : liquibasePackages) { for (Resource res : getResources(foundPackage)) { addRootPath(res.getURL()); } } } catch (IOException e) { LogService.getLog(getClass()).warning(LogType.LOG, "Error initializing SpringLiquibase", e); } } @Override public Set list(String relativeTo, String path, boolean includeFiles, boolean includeDirectories, boolean recursive) throws IOException { if (path == null) { return null; } Set returnSet = new HashSet<>(); String tempFile = FilenameUtils.concat(FilenameUtils.getFullPath(relativeTo), path); Resource[] resources = getResources(adjustClasspath(tempFile)); for (Resource res : resources) { Set list = super.list(null, res.getURL().toExternalForm(), includeFiles, includeDirectories, recursive); if (list != null) { returnSet.addAll(list); } } return returnSet; } @Override public Set getResourcesAsStream(String path) throws IOException { if (path == null) { return null; } Resource[] resources = getResources(adjustClasspath(path)); if ((resources == null) || (resources.length == 0)) { return null; } Set returnSet = new HashSet<>(); for (Resource resource : resources) { LogService.getLog(getClass()).debug(LogType.LOG, "Opening " + resource.getURL().toExternalForm() + " as " + path); URLConnection connection = resource.getURL().openConnection(); connection.setUseCaches(false); returnSet.add(connection.getInputStream()); } return returnSet; } public Resource getResource(String file) { return getResourceLoader().getResource(adjustClasspath(file)); } private String adjustClasspath(String file) { if (file == null) { return null; } return (isPrefixPresent(parentFile) && !isPrefixPresent(file)) ? (ResourceLoader.CLASSPATH_URL_PREFIX + file) : file; } private Resource[] getResources(String foundPackage) throws IOException { return ResourcePatternUtils.getResourcePatternResolver(getResourceLoader()).getResources(foundPackage); } private Set getPackagesFromManifest(Resource manifest) throws IOException { Set manifestPackages = new HashSet<>(); if (!manifest.exists()) { return manifestPackages; } InputStream inputStream = null; try { inputStream = manifest.getInputStream(); Manifest manifestObj = new Manifest(inputStream); Attributes attributes = manifestObj.getAttributes("Liquibase-Package"); if (attributes == null) { return manifestPackages; } for (Object attr : attributes.values()) { String packages = "\\s*,\\s*"; for (String fullPackage : attr.toString().split(packages)) { manifestPackages.add(fullPackage.split("\\.")[0]); } } } finally { if (inputStream != null) { inputStream.close(); } } return manifestPackages; } public boolean isPrefixPresent(String file) { if (file == null) { return false; } return file.startsWith("classpath") || file.startsWith("file:") || file.startsWith("url:"); } @Override public ClassLoader toClassLoader() { return getResourceLoader().getClassLoader(); } } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy