Creates an archetype project from the current project.

This goal reads your source and resource files, the values ofits parameters, and properties you specify in a.property file, and uses them to create a Mavenarchetype project using the maven-archetype packaging. If you buildthe resulting project, it will create the archetype. You can thenuse this archetype to create new projects that resemble theoriginal.

The maven-archetype-plugin uses Velocity to expand templatefiles, and this documentation talks about 'Velocity Properties',which are values substituted into Velocity templates. SeeTheVelocity User's Guide for more information.

This goal modifies the text of the files of the current projectto form the Velocity template files that make up the archetype.

GAV

The GAV values for the current project are replaced byproperties: groupId, artifactId, and version. The user chooses newvalues for these when generating a project from the archetype.

package

All the files under one specified Java (or cognate) package arerelocated to a project that the user chooses when generating aproject. References to the class name are replaced by a propertyreference. For example, if the current project's sources are in thepackage org.apache.saltedpeanuts, then any example ofthe string org.apache.saltedpeanuts is replaced withthe Velocity property reference ${packageName}. Whenthe user generates a project, this is in turn replaced by his orher choice of a package.

custom properties

You may identify additional strings that should be replaced byparameters. To add custom properties, you must use thepropertyFile parameter to specify a property file. Seethe documentation forpropertyFile for thedetails.

Note that you may need to edit the results of this goal. Thisgoal has no way to exclude unwanted files, or add copyright noticesto the Velocity templates, or add more complex elements to thearchetype metadata file.

This goal also generates a simple integration-test thatexercises the generated archetype.

Execute the archetype integration tests, consisting ingenerating projects from the current archetype and optionallycomparing generated projects with reference copy.

Each IT consists of a sub-directory insrc/test/resources/projects containing:

• a goal.txt file, containing a list of goals to runagainst the generated project (can be empty, content ignored beforemaven-archetype-plugin 2.1),
• an archetype.properties file, containingproperties for project generation,
• an optional reference/ directory containing areference copy of the expected project created from the IT.