Package io.ebeaninternal.dbmigration.ddlgeneration.platform

Class PlatformDdl

java.lang.Object

io.ebeaninternal.dbmigration.ddlgeneration.platform.PlatformDdl

Direct Known Subclasses:

AbstractHanaDdl, ClickHouseDdl, CockroachDdl, DB2Ddl, H2Ddl, HsqldbDdl, MySqlDdl, NuoDbDdl, OracleDdl, PostgresDdl, SQLiteDdl, SqlServerDdl

public class PlatformDdl
extends Object

Controls the DDL generation for a specific database platform.

Constructor Summary

Constructors

Constructor	Description
PlatformDdl(io.ebean.config.dbplatform.DatabasePlatform platform)

Method Summary

Modifier and Type	Method	Description
void	addColumnComment(DdlBuffer apply, String table, String column, String comment)	Add column comment as a separate statement.
void	addHistoryTable(DdlWrite writer, AddHistoryTable addHistoryTable)	Add history support to an existing table.
void	addTableComment(DdlBuffer apply, String tableName, String tableComment)	Add table comment as a separate statement (from the create table statement).
void	addTablePartition(DdlBuffer apply, String partitionMode, String partitionColumn)
void	addTablespace(DdlBuffer apply, String tablespaceName, String indexTablespace, String lobTablespace)	Adds tablespace declaration.
void	alterColumn(DdlWrite writer, AlterColumn alter)	Alter column setting (type, default value and not null constraint).
String	alterTableAddCheckConstraint(String tableName, String checkConstraintName, String checkConstraint)	Alter table adding the check constraint.
void	alterTableAddColumn(DdlWrite writer, String tableName, Column column, boolean onHistoryTable, String defaultValue)
void	alterTableAddColumn(DdlWrite writer, String tableName, String columnName, String columnType, String defaultValue)	This method is used from DbTriggerBasedHistoryDdl to add the sysPeriodColumns.
String	alterTableAddForeignKey(DdlOptions options, io.ebeaninternal.dbmigration.ddlgeneration.platform.WriteForeignKey request)	Add foreign key.
String	alterTableAddUniqueConstraint(String tableName, String uqName, String[] columns, String[] nullableColumns)	Add a unique constraint to the table.
void	alterTableDropColumn(DdlWrite writer, String tableName, String columnName)
String	alterTableDropConstraint(String tableName, String constraintName)	Drop a unique constraint from the table.
String	alterTableDropForeignKey(String tableName, String fkName)	Return the drop foreign key clause.
String	alterTableDropUniqueConstraint(String tableName, String uniqueConstraintName)	Drop a unique constraint from the table (Sometimes this is an index).
String	alterTableTablespace(String tablename, String tableSpace, String indexSpace, String lobSpace)	Moves the table to an other tablespace.
String	asIdentityColumn(String columnDefn, DdlIdentity identity)	Modify and return the column definition for autoincrement or identity definition.
void	configure(io.ebean.config.DatabaseConfig config)	Set configuration options.
String	convert(String type)	Convert the standard type to the platform specific type.
String	convertDefaultValue(String dbDefault)	Convert the DB column default literal to platform specific.
String	createCheckConstraint(String ckName, String checkConstraint)	Returns the check constraint.
DdlHandler	createDdlHandler(io.ebean.config.DatabaseConfig config)	Create a DdlHandler for the specific database platform.
String	createIndex(io.ebeaninternal.dbmigration.ddlgeneration.platform.WriteCreateIndex create)
String	createSequence(String sequenceName, DdlIdentity identity)	Generate and return the create sequence DDL.
void	createWithHistory(DdlWrite writer, MTable table)	Add history support to this table using the platform specific mechanism.
void	dropHistoryTable(DdlWrite writer, DropHistoryTable dropHistoryTable)	Drop history support for a given table.
String	dropIndex(String indexName, String tableName)	Return the drop index statement for known non concurrent index.
String	dropIndex(String indexName, String tableName, boolean concurrent)	Return the drop index statement.
String	dropSequence(String sequenceName)	Return the drop sequence statement (potentially with if exists clause).
String	dropTable(String tableName)	Return the drop table statement (potentially with if exists clause).
void	generateEpilog(DdlWrite writer)	Use this to generate an epilog.
void	generateProlog(DdlWrite writer)	Use this to generate a prolog for each script (stored procedures)
String	getCreateTableCommandPrefix()	Returns the database-specific "create table" command prefix.
io.ebean.config.dbplatform.DatabasePlatform	getPlatform()
String	getUpdateNullWithDefault()
void	inlineTableComment(DdlBuffer apply, String tableComment)	Add an inline table comment to the create table statement.
boolean	isIncludeStorageEngine()	Return true if the platform includes storage engine clause.
boolean	isInlineComments()	Return true if the table and column comments are included inline.
boolean	isInlineForeignKeys()	Return true if foreign key reference constraints need to inlined with create table.
boolean	isInlineUniqueWhenNullable()	Return true if unique constraints for nullable columns can be inlined as normal.
void	regenerateHistoryTriggers(DdlWrite writer, String tableName)	Regenerate the history triggers (or function) due to a column being added/dropped/excluded or included.
String	setLockTimeout(int lockTimeoutSeconds)	By default this does nothing returning null / no lock timeout.
boolean	suppressPrimaryKeyOnPartition()
String	tableInlineForeignKey(io.ebeaninternal.dbmigration.ddlgeneration.platform.WriteForeignKey request)	Return the foreign key constraint when used inline with create table.
void	tableStorageEngine(DdlBuffer apply, String storageEngine)	Add an table storage engine to the create table statement.
io.ebean.config.dbplatform.IdType	useIdentityType(io.ebean.config.dbplatform.IdType modelIdentity)	Return the identity type to use given the support in the underlying database platform for sequences and identity/autoincrement.
void	writeTableColumns(DdlBuffer apply, List<Column> columns, DdlIdentity identity)	Write all the table columns converting to platform types as necessary.

Methods inherited from class java.lang.Object

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

Constructor Details

PlatformDdl

public PlatformDdl(io.ebean.config.dbplatform.DatabasePlatform platform)

Method Details

configure

public void configure(io.ebean.config.DatabaseConfig config)

Set configuration options.

createDdlHandler

public DdlHandler createDdlHandler(io.ebean.config.DatabaseConfig config)

Create a DdlHandler for the specific database platform.

useIdentityType

public io.ebean.config.dbplatform.IdType useIdentityType(io.ebean.config.dbplatform.IdType modelIdentity)

Return the identity type to use given the support in the underlying database platform for sequences and identity/autoincrement.

asIdentityColumn

public String asIdentityColumn(String columnDefn,
 DdlIdentity identity)

Modify and return the column definition for autoincrement or identity definition.

isInlineComments

public boolean isInlineComments()

Return true if the table and column comments are included inline.

isIncludeStorageEngine

public boolean isIncludeStorageEngine()

Return true if the platform includes storage engine clause.

isInlineForeignKeys

public boolean isInlineForeignKeys()

Return true if foreign key reference constraints need to inlined with create table. Ideally we don't do this as then the constraints are not named. Do this for SQLite.

setLockTimeout

public String setLockTimeout(int lockTimeoutSeconds)

By default this does nothing returning null / no lock timeout.

writeTableColumns

public void writeTableColumns(DdlBuffer apply,
 List<Column> columns,
 DdlIdentity identity)

Write all the table columns converting to platform types as necessary.

createCheckConstraint

public String createCheckConstraint(String ckName,
 String checkConstraint)

Returns the check constraint.

convertDefaultValue

public String convertDefaultValue(String dbDefault)

Convert the DB column default literal to platform specific.

alterTableDropForeignKey

public String alterTableDropForeignKey(String tableName,
 String fkName)

Return the drop foreign key clause.

convert

public String convert(String type)

Convert the standard type to the platform specific type.

createWithHistory

public void createWithHistory(DdlWrite writer,
 MTable table)

Add history support to this table using the platform specific mechanism.

dropHistoryTable

public void dropHistoryTable(DdlWrite writer,
 DropHistoryTable dropHistoryTable)

Drop history support for a given table.

addHistoryTable

public void addHistoryTable(DdlWrite writer,
 AddHistoryTable addHistoryTable)

Add history support to an existing table.

regenerateHistoryTriggers

public void regenerateHistoryTriggers(DdlWrite writer,
 String tableName)

Regenerate the history triggers (or function) due to a column being added/dropped/excluded or included.

createSequence

public String createSequence(String sequenceName,
 DdlIdentity identity)

Generate and return the create sequence DDL.

dropSequence

public String dropSequence(String sequenceName)

Return the drop sequence statement (potentially with if exists clause).

dropTable

public String dropTable(String tableName)

Return the drop table statement (potentially with if exists clause).

dropIndex

public String dropIndex(String indexName,
 String tableName)

Return the drop index statement for known non concurrent index.

dropIndex

public String dropIndex(String indexName,
 String tableName,
 boolean concurrent)

Return the drop index statement.

createIndex

public String createIndex(io.ebeaninternal.dbmigration.ddlgeneration.platform.WriteCreateIndex create)

tableInlineForeignKey

public String tableInlineForeignKey(io.ebeaninternal.dbmigration.ddlgeneration.platform.WriteForeignKey request)

Return the foreign key constraint when used inline with create table.

alterTableAddForeignKey

public String alterTableAddForeignKey(DdlOptions options,
 io.ebeaninternal.dbmigration.ddlgeneration.platform.WriteForeignKey request)

Add foreign key.

alterTableDropUniqueConstraint

public String alterTableDropUniqueConstraint(String tableName,
 String uniqueConstraintName)

Drop a unique constraint from the table (Sometimes this is an index).

alterTableDropConstraint

public String alterTableDropConstraint(String tableName,
 String constraintName)

Drop a unique constraint from the table.

alterTableAddUniqueConstraint

public String alterTableAddUniqueConstraint(String tableName,
 String uqName,
 String[] columns,
 String[] nullableColumns)

Add a unique constraint to the table.

Overridden by MsSqlServer for specific null handling on unique constraints.

alterTableAddColumn

public void alterTableAddColumn(DdlWrite writer,
 String tableName,
 Column column,
 boolean onHistoryTable,
 String defaultValue)

alterTableAddColumn

public void alterTableAddColumn(DdlWrite writer,
 String tableName,
 String columnName,
 String columnType,
 String defaultValue)

This method is used from DbTriggerBasedHistoryDdl to add the sysPeriodColumns.

alterTableDropColumn

public void alterTableDropColumn(DdlWrite writer,
 String tableName,
 String columnName)

isInlineUniqueWhenNullable

public boolean isInlineUniqueWhenNullable()

Return true if unique constraints for nullable columns can be inlined as normal. Returns false for MsSqlServer and DB2 due to it's not possible to to put a constraint on a nullable column

alterTableAddCheckConstraint

public String alterTableAddCheckConstraint(String tableName,
 String checkConstraintName,
 String checkConstraint)

Alter table adding the check constraint.

alterColumn

public void alterColumn(DdlWrite writer,
 AlterColumn alter)

Alter column setting (type, default value and not null constraint).

Used by MySql, SQL Server, and HANA as these require all column attributes to be set together.

getPlatform

public io.ebean.config.dbplatform.DatabasePlatform getPlatform()

getUpdateNullWithDefault

public String getUpdateNullWithDefault()

inlineTableComment

public void inlineTableComment(DdlBuffer apply,
 String tableComment)

Add an inline table comment to the create table statement.

tableStorageEngine

public void tableStorageEngine(DdlBuffer apply,
 String storageEngine)

Add an table storage engine to the create table statement.

addTableComment

public void addTableComment(DdlBuffer apply,
 String tableName,
 String tableComment)

Add table comment as a separate statement (from the create table statement).

addColumnComment

public void addColumnComment(DdlBuffer apply,
 String table,
 String column,
 String comment)

Add column comment as a separate statement.

generateProlog

public void generateProlog(DdlWrite writer)

Use this to generate a prolog for each script (stored procedures)

generateEpilog

public void generateEpilog(DdlWrite writer)

Use this to generate an epilog. Will be added at the end of script

getCreateTableCommandPrefix

public String getCreateTableCommandPrefix()

Returns the database-specific "create table" command prefix. For HANA this is either "create column table" or "create row table", for all other databases it is "create table".

Returns:

The "create table" command prefix

suppressPrimaryKeyOnPartition

public boolean suppressPrimaryKeyOnPartition()

addTablePartition

public void addTablePartition(DdlBuffer apply,
 String partitionMode,
 String partitionColumn)

addTablespace

public void addTablespace(DdlBuffer apply,
 String tablespaceName,
 String indexTablespace,
 String lobTablespace)

Adds tablespace declaration. Now only supported for db2.

alterTableTablespace

public String alterTableTablespace(String tablename,
 String tableSpace,
 String indexSpace,
 String lobSpace)

Moves the table to an other tablespace.