Create and Run Your First ZK Application with Maven Archetype

From Documentation
Revision as of 09:12, 13 January 2023 by Hawk (talk | contribs) (→‎What is Archetype)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

DocumentationZK Installation GuideQuick StartCreate and Run Your First ZK Application with Maven Archetype
Create and Run Your First ZK Application with Maven Archetype

What is Archetype

Maven archetype serves as a pom.xml template. So you can start from a predefined template without writing everything from the scratch. It can help you quickly set up a Maven project with some predefined dependencies and settings.

Create a Project based on Archetype

Before starting, you need to install maven and set up first.

  • Go to your new project folder, then run the following command:
 mvn archetype:generate -DarchetypeCatalog=

Then just answer the questions the plugin asks you to create a project.

  • The plugin will first ask you to choose the archetype from the zk catalog, please just enter the number of the archetype
  • It will then ask users to enter the values for groupId, the artifactId and the version of the project to create the base package for the sources.
  • It will then ask for confirmation of the configuration and perform the creation of the project.
  • In the following example, webapp archetype (number 3) is selected, and groupId is set to, artifactId to mywebapp, version to 0.8.0 and package to

NOTE: in case your maven installation uses the latest maven-archetype-plugin version 3.0.1 you'll have to use the following command (using 2.4 as a fallback - ARCHETYPE-519):

 $ mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -DarchetypeCatalog=

 $ mvn archetype:generate -DarchetypeCatalog=
 [INFO] Scanning for projects...
 [INFO] Searching repository for plugin with prefix: 'archetype'.
 [INFO] ------------------------------------------------------------------------
 [INFO] Building Maven Default Project
 [INFO]    task-segment: [archetype:generate] (aggregator-style)
 [INFO] ------------------------------------------------------------------------
 [INFO] Preparing archetype:generate
 [INFO] No goals needed for project - skipping
 [INFO] [archetype:generate {execution: default-cli}]
 [INFO] Generating project in Interactive mode
 [INFO] No archetype defined. Using maven-archetype-quickstart (org.apache.maven.
 Choose archetype:
 1: -> zk-archetype-component (An archetype 
 that generates a starter ZK component project)
 2: -> zk-archetype-extension (An archetype 
 that generates a starter ZK extension project)
 3: -> zk-archetype-webapp (An archetype that
 generates a starter ZK CE webapp project)
 4: -> zk-ee-eval-archetype-webapp (An 
 archetype that generates a starter ZK EE-eval webapp project)
 Choose a number: : 3
 Define value for property 'groupId': :
 Define value for property 'artifactId': : mywebapp
 Define value for property 'version': 1.0-SNAPSHOT: 0.8.0
 Define value for property 'package':
 [INFO] Using property: zk-version-since = 6.0.1
 Confirm properties configuration:
 artifactId: mywebapp
 version: 0.8.0
 zk-version-since: 6.0.1
 [INFO] ------------------------------------------------------------------------
 [INFO] ------------------------------------------------------------------------
 [INFO] Total time: 29 seconds
 [INFO] Finished at: Fri Jun 22 16:55:27 CST 2012
 [INFO] Final Memory: 13M/150M
 [INFO] ------------------------------------------------------------------------

Run the Project

The project created by archetypes above should have a maven jetty plugin configured, you can just run the project with the command below:

mvn jetty:run

Last Update : 2023/01/13

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.