Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

Creating a Maven Archetype

DZone's Guide to

Creating a Maven Archetype

Read this tutorial in order to learn how to create a Maven archetype from an existing project. This person uses Eclipse IDE to create the Maven project.

· Integration Zone ·
Free Resource

The State of API Integration 2018: Get Cloud Elements’ report for the most comprehensive breakdown of the API integration industry’s past, present, and future.

Introduction

Many times we need to create a Maven archetype to distribute the project template. Here in this article, I am going to describe how easy it is to create a Maven archetype from an existing project.

Create a Maven Project

First of all, let's create a very simple Maven project. I am using Eclipse IDE to create the Maven project. Here is the pom.xml file of the project:

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.porua</groupId>
    <artifactId>archetype-porua</artifactId>
    <version>1.0.0</version>
    <dependencies>
        <dependency>
            <groupId>com.porua</groupId>
            <artifactId>porua-container</artifactId>
            <version>1.0.0</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <version>1.4.196</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-assembly-plugin</artifactId>
                <version>3.1.0</version>
                <executions>
                    <execution>
                        <id>make-fat-jar</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <descriptorRefs>
                                <descriptorRef>jar-with-dependencies</descriptorRef>
                            </descriptorRefs>
                            <finalName>${project.artifactId}-${project.version}</finalName>
                            <appendAssemblyId>false</appendAssemblyId>
                        </configuration>
                    </execution>
                    <execution>
                        <id>zip-all</id>
                        <phase>package</phase>
                        <goals>
                            <goal>single</goal>
                        </goals>
                        <configuration>
                            <descriptors>
                                <descriptor>src/assembly/assembly.xml</descriptor>
                            </descriptors>
                            <finalName>${project.artifactId}-${project.version}</finalName>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
        </plugins>
    </build>
    <repositories>
        <repository>
            <id>porua-repo</id>
            <name>Porua Repository</name>
            <url>https://github.com/anupamgogoi0907/porua-docs/raw/repo</url>
            <snapshots>
                <enabled>true</enabled>
                <updatePolicy>always</updatePolicy>
            </snapshots>
            <releases>
                <enabled>true</enabled>
            </releases>
        </repository>
    </repositories>
</project>

Now go to the root directory of the project and execute the following commands in sequence:

  • mvn archetype:create-from-project

This command will generate the archetype from the existing Maven project. You can check the generated files at the following location:

target/generated-sources/archetype

Image title

Now at this point, you can do two more important things:

  • Modify the target/generated-sources/archetype/pom.xml to add extra things if you need
  • Modify target/generated-sources/archetype/src/main/resources/META-INF/maven/archetype-metadata.xml to include/exclude files etc in the archetype. (Please read Maven's official documents for more information)

mvn clean install

Execute this command on target/generated-sources/archetype/pom.xml. It will install the plugin in your local repository.

mvn archetype:generate -DarchetypeCalalog=local

Execute this command to check your archetype available in the local repository.

Using The Archetype

At this point, our archetype is installed successfully in our local Maven repository. Let's try to make use of it. Use this command to make a project from the archetype:

mvn -B archetype:generate \
-DarchetypeGroupId=com.porua \
-DarchetypeArtifactId=archetype-porua-archetype
-DgroupId=com.mycompany.app \
-DartifactId=my-app

Conclusion

That's it. It's very simple to create a Maven archetype from an existing project.

Your API is not enough. Learn why (and how) leading SaaS providers are turning their products into platforms with API integration in the ebook, Build Platforms, Not Products from Cloud Elements.

Topics:
maven 3.5.0 ,integration ,maven archetype ,maven

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}