Create and Run ZK Application with Maven Artifacts

From Documentation


DocumentationZK Installation GuideSetting up IDEMavenUse ZK Maven ArtifactsCreate and Run ZK Application with Maven Artifacts
Create and Run ZK Application with Maven Artifacts



Stop.png This article is out of date, please refer to ZK Installation Guide/Quick Start/Create and Run Your First ZK Application with Eclipse and Maven for more up to date information.


If you are first to Maven, please refer to Create and Run ZK Application with Maven Archetype because it is easy to follow. This article is more helpful for users who already have a Maven project and/or want to handle some of the configuration files manually.

How to create ZK Maven web project

ZK Maven Project Hierarchy

Create Project of Maven

  • [File] -> [New] -> [Other] --> [Maven Project]
    ZK Installation Guide Maven step1.png
  • Check Create a simple Project
    ZK Installation Guide Maven step2.png
  • Fill the first 4 field (you can change them later) --> Click [Finish]
    Group Id is usually the package name but it could be anything you prefer. Here we use org.zkoss, but it is better to use your own.
    Arifact Id is your project's ID.
    Version is your project's version.
    ZK Installation Guide Maven step3.png

Add WTP Support (Project Facet)

  1. Create new folder under /src/main/ named webapp
  2. Right Click on your Maven Project -> Choose Properties -> Choose Project Facets -> Check Dynamic Web Module
    Note: if it showing Covert facet from..., simply click it to enable facet.
    ZK Installation Guide Maven web1.png
  3. Click Further configuration available' --> input the Context Root and Content Directory --> Check Generate web.xml deployment descriptor
    ZK Installation Guide Maven web2.png

Enable Dependency and Web Project configuration

web.xml

pom.xml

How to run Maven project on Run-Jetty-Run (Optional)

Notice that Run-Jetty-Run is optional. The speed of deployment is much faster, but the server is Jetty embedded in Run-Jetty-Run. If you prefer to use your own server, you could skip this step.

  1. Create new zul file index.zul [1] under /src/main/webapp
  2. Goto Run Configurations
    ZK Installation Guide maven run1.png
  3. Double click on Jetty Webapp
    • It will auto fill Project / Port / Context / WebApp Dir
    ZK Installation Guide maven run2.png
  4. Click Run and browse http://127.0.0.1:8080/TestMavenWebProject/
  1. ↑ ZK Installation Guide/Quick Start/Create and Run Your First ZK Application with Eclipse and ZK Studio#Create_a_new_ZUL_file
Retrieved from "https://www.zkoss.org/_w/index.php?title=ZK_Installation_Guide/Setting_up_IDE/Maven/Use_ZK_Maven_Artifacts/Create_and_Run_ZK_Application_with_Maven_Artifacts&oldid=27869"