impex:datadtd

Full name:

org.kuali.maven.plugins:maven-impex-plugin:1.0.27:datadtd

Description:

Generates a DTD for the database tables from a schema XML file

Attributes:

  • Requires a Maven project to be executed.
  • Binds by default to the lifecycle phase: generate-sources.

Required Parameters

Name Type Since Description
forceMojoExecution boolean - Setting this parameter to true will force the execution of this mojo, even if it would get skipped usually.
Default value is: false.
schemaDir String - The path to the directory where the schema XML files are located
Default value is: ${basedir}/src/main/impex.
schemaIncludes String - The schema files from that directory which should be included (ant-style notation).
Default value is: ${project.artifactId}.xml.
schemaXMLFile String - The name of the schema.xml file to process
Default value is: ${project.build.directory}/generated-impex/${project.artifactId}.xml.

Optional Parameters

Name Type Since Description
antCompatibilityMode boolean - (no description)
artifactId String - Included here as a simple property to facilitate generating DTD's for other artifacts
Default value is: ${project.artifactId}.
copyToFile String - Only used if antCompatibilityMode is set to true. If so, the dtd that gets generated will be copied to
Default value is: ${basedir}/src/main/impex/data.dtd.
outputDir String - The directory in which the DTD will be generated
Default value is: ${project.build.directory}/generated-impex.
reportFile String - The location where the report file will be generated, relative to outputDir.
Default value is: ../reports/report.${project.artifactId}.datadtd.generation.
contextPropertiesPath String - The location where the context property file for velocity will be generated.
Default value is: ${project.build.directory}/reports/context.datadtd.properties.
encoding String - The encoding to use when reading/writing files. If not specified this defaults to the platform specific encoding of whatever machine the build is running on.
Default value is: ${project.build.sourceEncoding}.
projectName String - The name of the project
Default value is: impex.
runOnlyOnSchemaChange boolean - Determines if this task should run only if the schema has changed
Default value is: true.
skip boolean - When true, skip the execution of this mojo
Default value is: false.
sqlDbMap String - The path to the properties file containing the mapping sql file -> target database.
Default value is: ${project.build.directory}/reports/sqldbmap.properties.
startMavenLogger boolean - When true, redirect logging from Log4j and Jakarta Commons Logging to the Maven logging system
Default value is: true.
targetDatabase String - The type of database we are targeting (eg oracle, mysql). This is optional if url is supplied as the database type will be automatically detected based on the url. If targetDatabase is explicitly supplied it will override the type selected by the automatic detection logic.
targetPackage String - The target package for the generated classes.
Default value is: impex.generated.
templatePath String - The base path where the templates are read from, if they are not read from the classpath.
Default value is: ${basedir}/src/main/impex/templates.
url String - Database URL.
useClasspath boolean - Whether the templates should be loaded from the classpath.
Default value is: true.
userContextProperties Map - A map where all user-defined context properties can be set. Overrides all other mojo configuration settings which are mapped to context properties.

Parameter Details

antCompatibilityMode:

(no description)
  • Type: boolean
  • Required: No
  • Expression: ${antCompatibilityMode}

artifactId:

Included here as a simple property to facilitate generating DTD's for other artifacts
  • Type: java.lang.String
  • Required: No
  • Expression: ${artifactId}
  • Default: ${project.artifactId}

copyToFile:

Only used if antCompatibilityMode is set to true. If so, the dtd that gets generated will be copied to
  • Type: java.lang.String
  • Required: No
  • Expression: ${copyToFile}
  • Default: ${basedir}/src/main/impex/data.dtd

outputDir:

The directory in which the DTD will be generated
  • Type: java.lang.String
  • Required: No
  • Expression: ${outputDir}
  • Default: ${project.build.directory}/generated-impex

reportFile:

The location where the report file will be generated, relative to outputDir.
  • Type: java.lang.String
  • Required: No
  • Expression: ${reportFile}
  • Default: ../reports/report.${project.artifactId}.datadtd.generation

contextPropertiesPath:

The location where the context property file for velocity will be generated.
  • Type: java.lang.String
  • Required: No
  • Expression: ${contextPropertiesPath}
  • Default: ${project.build.directory}/reports/context.datadtd.properties

encoding:

The encoding to use when reading/writing files. If not specified this defaults to the platform specific encoding of whatever machine the build is running on.
  • Type: java.lang.String
  • Required: No
  • Expression: ${encoding}
  • Default: ${project.build.sourceEncoding}

forceMojoExecution:

Setting this parameter to true will force the execution of this mojo, even if it would get skipped usually.
  • Type: boolean
  • Required: Yes
  • Expression: ${forceMojoExecution}
  • Default: false

projectName:

The name of the project
  • Type: java.lang.String
  • Required: No
  • Expression: ${projectName}
  • Default: impex

runOnlyOnSchemaChange:

Determines if this task should run only if the schema has changed
  • Type: boolean
  • Required: No
  • Expression: ${runOnlyOnSchemaChange}
  • Default: true

schemaDir:

The path to the directory where the schema XML files are located
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${schemaDir}
  • Default: ${basedir}/src/main/impex

schemaIncludes:

The schema files from that directory which should be included (ant-style notation).
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${schemaIncludes}
  • Default: ${project.artifactId}.xml

schemaXMLFile:

The name of the schema.xml file to process
  • Type: java.lang.String
  • Required: Yes
  • Expression: ${schemaXMLFile}
  • Default: ${project.build.directory}/generated-impex/${project.artifactId}.xml

skip:

When true, skip the execution of this mojo
  • Type: boolean
  • Required: No
  • Default: false

sqlDbMap:

The path to the properties file containing the mapping sql file -> target database.
  • Type: java.lang.String
  • Required: No
  • Expression: ${sqlDbMap}
  • Default: ${project.build.directory}/reports/sqldbmap.properties

startMavenLogger:

When true, redirect logging from Log4j and Jakarta Commons Logging to the Maven logging system
  • Type: boolean
  • Required: No
  • Expression: ${startMavenLogger}
  • Default: true

targetDatabase:

The type of database we are targeting (eg oracle, mysql). This is optional if url is supplied as the database type will be automatically detected based on the url. If targetDatabase is explicitly supplied it will override the type selected by the automatic detection logic.
  • Type: java.lang.String
  • Required: No
  • Expression: ${targetDatabase}

targetPackage:

The target package for the generated classes.
  • Type: java.lang.String
  • Required: No
  • Expression: ${targetPackage}
  • Default: impex.generated

templatePath:

The base path where the templates are read from, if they are not read from the classpath.
  • Type: java.lang.String
  • Required: No
  • Expression: ${templatePath}
  • Default: ${basedir}/src/main/impex/templates

url:

Database URL.
  • Type: java.lang.String
  • Required: No
  • Expression: ${url}

useClasspath:

Whether the templates should be loaded from the classpath.
  • Type: boolean
  • Required: No
  • Expression: ${useClasspath}
  • Default: true

userContextProperties:

A map where all user-defined context properties can be set. Overrides all other mojo configuration settings which are mapped to context properties.
  • Type: java.util.Map
  • Required: No