ZK Installation Guide/Quick Start/Create and Run Your First ZK Application with Eclipse and Maven

M2eclipse is the first and most mature of the projects aimed at integrating Apache Maven within the Eclipse IDE.

Prepare Eclipse

Install Eclipse

Please follow the installation guide for your Eclipse:

Install Eclipse

Install M2eclipse

Please follow the installation guide for your M2eclipse:

Install M2eclipse

Add ZK Maven Archetype

• [Window] -> [Preferences] -> [Maven] --> [Archetypes], click Add Remote Catalog and type in the catalog file as illustrated:

  

http://mavensync.zkoss.org/maven2/

• Click Verify and then OK to add the catalog.
  • If the Remote catalog is empty.

---

Create a "Hello World" application with ZK Maven Archetype

Create a Maven Project

• [File] -> [New] -> [Other] --> [Maven Project]

  

• Make sure Create a simple project is unticked in the first screen of the New Maven Project wizard and click Next >.

  

• From the Select an Archetype screen, select ZK Maven Archetype from the catalog dropdown list.

  

• Select zk-archetype-webapp from the list. (At the time of writing this is at version 6.0).
• Next, fill in details for group id, artifact id, version number and package name.

  

  • If the property zk-version-since is missing.
• Click Finish and the Eclipse status bar should say ' Creating zk-archetype-webapp ' and ' Updating Maven Dependencies '. If this is the user's first time dealing with ZK libraries, Maven will download the necessary dependencies to compile and run this example, and would be stored in .m2/repository in the user's home directory.

  

---

---

Run the application

1. Go to Run As > Maven build...

   

2. In the goals textbox enter jetty:stop jetty:run and check Skip Tests then click "Apply" then "Run".

   

3. View the result in your browser.

http://localhost:8080/mywebapp/index.zul

Packaging your porject into a Web Application Archive (WAR)

1. Go to Run As > Maven install

   

2. The project will then be packed into a war file and a zip file with source code.

   

Use the command line version of Maven to create a project

Create a Maven project

• For instructions on how to set up maven, please refer to Maven.
• Go to the folder in Eclipse workspace, then run the following command:
• Calling archetype:generate -DarchetypeCatalog=http://mavensync.zkoss.org/maven2/ - the plugin will first ask 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 and 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 com.foo', artifactId to mywebapp, version to 0.8.0 and package to com.foo'.

$ mvn archetype:generate -DarchetypeCatalog=http://mavensync.zkoss.org/maven2/
[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.
archetypes:maven-archetype-quickstart:1.0)
Choose archetype:
1: http://mavensync.zkoss.org/maven2/ -> zk-archetype-component (An archetype th
at generates a starter ZK component project)
2: http://mavensync.zkoss.org/maven2/ -> zk-archetype-extension (An archetype th
at generates a starter ZK extension project)
3: http://mavensync.zkoss.org/maven2/ -> zk-archetype-webapp (An archetype that
generates a starter ZK CE webapp project)
4: http://mavensync.zkoss.org/maven2/ -> zk-ee-eval-archetype-webapp (An archety
pe that generates a starter ZK EE-eval webapp project)
Choose a number: : 3
Define value for property 'groupId': : com.foo
Define value for property 'artifactId': : mywebapp
Define value for property 'version': 1.0-SNAPSHOT: 0.8.0
Define value for property 'package': com.foo:
[INFO] Using property: zk-version-since = 6.0.1
Confirm properties configuration:
groupId: com.foo
artifactId: mywebapp
version: 0.8.0
package: com.foo
zk-version-since: 6.0.1
Y:
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 29 seconds
[INFO] Finished at: Fri Jun 22 16:55:27 CST 2012
[INFO] Final Memory: 13M/150M
[INFO] ------------------------------------------------------------------------

Import a Maven project into Eclipse

• [File] -> [Import] -> [Maven] --> [Existing Maven Projects]

  

• After this, the user should now get a new project in the Package explorer.

  

Version History

Version	Date	Content