DbMigrationConfig (avaje-ebeanorm 7.2.2 API)

java.lang.Object
- com.avaje.ebean.config.DbMigrationConfig

public class DbMigrationConfig
extends Object

Configuration for the DB migration processing.

Field Summary

Fields
Modifier and Type	Field and Description
`protected String`	`applySuffix`
`protected boolean`	`generate` Set to true if the DB migration should be generated on server start.
`protected String`	`generatePendingDrop` The version of a pending drop that should be generated as the next migration.
`protected boolean`	`includeGeneratedFileComment`
`protected static org.slf4j.Logger`	`logger`
`protected String`	`migrationPath` Resource path for the migration xml and sql.
`protected String`	`modelPath` Subdirectory the model xml files go into.
`protected String`	`modelSuffix`
`protected String`	`name` Description text that can be appended to the version to become the ddl script file name.
`protected DbPlatformName`	`platform` The database platform to generate migration DDL for.
`protected String`	`version` The migration version name (typically FlywayDb compatible).

Constructor Summary

Constructors
Constructor and Description

DbMigrationConfig()

Constructors
Constructor and Description
`DbMigrationConfig()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`generateOnStart(EbeanServer server)` Called by EbeanServer on start.
`String`	`getApplySuffix()` Return the apply script suffix (defaults to sql).
`String`	`getGeneratePendingDrop()` Return the migration version (or "next") to generate pending drops for.
`String`	`getMigrationPath()` Return the resource path for db migrations.
`String`	`getModelPath()` Return the relative path for the model files (defaults to model).
`String`	`getModelSuffix()` Return the model suffix (defaults to model.xml)
`String`	`getName()` Return the migration name which is short description text that can be appended to the migration version to become the ddl script file name.
`DbPlatformName`	`getPlatform()` Return the DB platform to generate migration DDL for.
`String`	`getVersion()` Return the migration version (typically FlywayDb compatible).
`protected boolean`	`isEmpty(String val)` Return true if the string is null or empty.
`boolean`	`isGenerateOnStart()` Return true if the migration should be generated.
`boolean`	`isIncludeGeneratedFileComment()` Return true if the generated file comment should be included.
`void`	`loadSettings(PropertiesWrapper properties)` Load the settings from the PropertiesWrapper.
`protected String`	`readEnvironment(String key)` Return the system or environment property.
`void`	`setApplySuffix(String applySuffix)` Set the apply script suffix (defaults to sql).
`void`	`setGeneratePendingDrop(String generatePendingDrop)` Set the migration version (or "next") to generate pending drops for.
`void`	`setIncludeGeneratedFileComment(boolean includeGeneratedFileComment)` Set to true if the generated file comment should be included.
`void`	`setMigrationPath(String migrationPath)` Set the resource path for db migrations.
`void`	`setModelPath(String modelPath)` Set the relative path for the model files.
`void`	`setModelSuffix(String modelSuffix)` Set the model suffix.
`void`	`setName(String name)` Set the migration name.
`void`	`setPlatform(DbPlatformName platform)` Set the DB platform to generate migration DDL for.
`void`	`setVersion(String version)` Set the migration version.
`void`	`singleDirectory()` Set the model, rollback and drop paths to be empty such that all the migration files are generated into a single directory.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - logger
```
protected static final org.slf4j.Logger logger
```
  - platform
```
protected DbPlatformName platform
```
    The database platform to generate migration DDL for.
  - generate
```
protected boolean generate
```
    Set to true if the DB migration should be generated on server start.
  - version
```
protected String version
```
    The migration version name (typically FlywayDb compatible).
    Example: 1.1.1_2
    The version is expected to be the combination of the current pom version plus a 'feature' id. The combined version must be unique and ordered to work with FlywayDb so each developer sets a unique version so that the migration script generated is unique (typically just prior to being submitted as a merge request).
  - name
```
protected String name
```
    Description text that can be appended to the version to become the ddl script file name.
    So if the name is "a foo table" then the ddl script file could be: "1.1.1_2__a-foo-table.sql"
    When the DB migration relates to a git feature (merge request) then this description text is a short description of the feature.
  - migrationPath
```
protected String migrationPath
```
    Resource path for the migration xml and sql.
  - modelPath
```
protected String modelPath
```
    Subdirectory the model xml files go into.
  - applySuffix
```
protected String applySuffix
```
  - modelSuffix
```
protected String modelSuffix
```
  - includeGeneratedFileComment
```
protected boolean includeGeneratedFileComment
```
  - generatePendingDrop
```
protected String generatePendingDrop
```
    The version of a pending drop that should be generated as the next migration.
- Constructor Detail
  - DbMigrationConfig
```
public DbMigrationConfig()
```
- Method Detail
  - getPlatform
```
public DbPlatformName getPlatform()
```
    Return the DB platform to generate migration DDL for. We typically need to explicitly specify this as migration can often be generated when running against H2.
  - setPlatform
```
public void setPlatform(DbPlatformName platform)
```
    Set the DB platform to generate migration DDL for.
  - getMigrationPath
```
public String getMigrationPath()
```
    Return the resource path for db migrations.
  - setMigrationPath
```
public void setMigrationPath(String migrationPath)
```
    Set the resource path for db migrations.
    The default of "dbmigration" is reasonable in most cases. You may look to set this to be something like "dbmigration/myapp" where myapp gives it a unique resource path in the case there are multiple EbeanServer applications in the single classpath.
  - getModelPath
```
public String getModelPath()
```
    Return the relative path for the model files (defaults to model).
  - setModelPath
```
public void setModelPath(String modelPath)
```
    Set the relative path for the model files.
  - getModelSuffix
```
public String getModelSuffix()
```
    Return the model suffix (defaults to model.xml)
  - setModelSuffix
```
public void setModelSuffix(String modelSuffix)
```
    Set the model suffix.
  - getApplySuffix
```
public String getApplySuffix()
```
    Return the apply script suffix (defaults to sql).
  - setApplySuffix
```
public void setApplySuffix(String applySuffix)
```
    Set the apply script suffix (defaults to sql).
  - isIncludeGeneratedFileComment
```
public boolean isIncludeGeneratedFileComment()
```
    Return true if the generated file comment should be included.
  - setIncludeGeneratedFileComment
```
public void setIncludeGeneratedFileComment(boolean includeGeneratedFileComment)
```
    Set to true if the generated file comment should be included.
  - getGeneratePendingDrop
```
public String getGeneratePendingDrop()
```
    Return the migration version (or "next") to generate pending drops for.
  - setGeneratePendingDrop
```
public void setGeneratePendingDrop(String generatePendingDrop)
```
    Set the migration version (or "next") to generate pending drops for.
  - setVersion
```
public void setVersion(String version)
```
    Set the migration version.
    Note that version set via System property or environment variable ddl.migration.version takes precedence.
  - setName
```
public void setName(String name)
```
    Set the migration name.
    Note that name set via System property or environment variable ddl.migration.name takes precedence.
  - singleDirectory
```
public void singleDirectory()
```
    Set the model, rollback and drop paths to be empty such that all the migration files are generated into a single directory.
  - loadSettings
```
public void loadSettings(PropertiesWrapper properties)
```
    Load the settings from the PropertiesWrapper.
  - isGenerateOnStart
```
public boolean isGenerateOnStart()
```
    Return true if the migration should be generated.
    It is expected that when an environment variable ddl.migration.enabled is set to true then the DB migration will generate the migration DDL.
  - generateOnStart
```
public void generateOnStart(EbeanServer server)
```
    Called by EbeanServer on start.
    If enabled this generates the migration xml and DDL scripts.
  - getVersion
```
public String getVersion()
```
    Return the migration version (typically FlywayDb compatible).
    Example: 1.1.1_2
    The version is expected to be the combination of the current pom version plus a 'feature' id. The combined version must be unique and ordered to work with FlywayDb so each developer sets a unique version so that the migration script generated is unique (typically just prior to being submitted as a merge request).
  - getName
```
public String getName()
```
    Return the migration name which is short description text that can be appended to the migration version to become the ddl script file name.
    So if the name is "a foo table" then the ddl script file could be: "1.1.1_2__a-foo-table.sql"
    
    When the DB migration relates to a git feature (merge request) then this description text is a short description of the feature.
  - readEnvironment
```
protected String readEnvironment(String key)
```
    Return the system or environment property.
  - isEmpty
```
protected boolean isEmpty(String val)
```
    Return true if the string is null or empty.

Class DbMigrationConfig

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

logger

platform

generate

version

name

migrationPath

modelPath

applySuffix

modelSuffix

includeGeneratedFileComment

generatePendingDrop

Constructor Detail

DbMigrationConfig

Method Detail

getPlatform

setPlatform

getMigrationPath

setMigrationPath

getModelPath

setModelPath

getModelSuffix

setModelSuffix

getApplySuffix

setApplySuffix

isIncludeGeneratedFileComment

setIncludeGeneratedFileComment

getGeneratePendingDrop

setGeneratePendingDrop

setVersion

setName

singleDirectory

loadSettings

isGenerateOnStart

generateOnStart

getVersion

getName

readEnvironment

isEmpty