This guide is intended to get you up and running & using Wicket within minutes.
It uses a Maven Archetype to create a Wicket QuickStart project, so requires that Maven 2 be installed & configured beforehand.
This project provides a starting point for your Wicket project. If you are looking for examples, please refer to the wicket-example projects instead!
To create your project, copy and paste the command line generated after typing in the groupId, artifactId and version.
<style> #mvncmd label { text-align: right; font-weight: bold; width: 100px; float: left; margin: 0px 5px; } #mvncmd input, #mvncmd select, #mvncm span { width: 180px; margin-bottom: 5px; float: left;} #mvncmd textarea { width: 400px; height: 100px; } #mvncmd br { clear: left; } #mvncmd div { float: left; } </style> <script type="text/javascript"> function changeIt() { var groupId = document.getElementById("groupId").value; var artifactId = document.getElementById("artifactId").value; var version = document.getElementById("version").value; var cmd = 'mvn archetype:create -DarchetypeGroupId=org.apache.wicket -DarchetypeArtifactId=wicket-archetype-quickstart -DarchetypeVersion=' + version + ' -DgroupId=' + groupId + ' -DartifactId=' + artifactId; if (version.match(/.*SNAPSHOT/)) cmd += ' -DremoteRepositories=http://wicketstuff.org/maven/repository/'; document.getElementById("cmdLine").value = cmd; } </script> <div id="mvncmd"> <div> <label for="groupId" title="Base Package">GroupId:</label> <input type="text" id="groupId" value="com.mycompany" onkeyup="changeIt();"/><span title="Base Package"> (?)</span><br/> <label for="artifactId" title="Project Name"> ArtifactId:</label> <input type="text" id="artifactId" value="myproject" onkeyup="changeIt();"><span title="Project Name"> (?)</span><br/> <label for="version" title="Wicket Version">Version:</label> <select id="version" onchange="changeIt();"> <option value="1.4-SNAPSHOT">1.4-SNAPSHOT</option> <option value="1.4.9" selected="selected">1.4.9</option> <option value="1.4.8">1.4.8</option> <option value="1.3-SNAPSHOT">1.3-SNAPSHOT</option> <option value="1.3.7">1.3.7</option> <option value="1.3.6">1.3.6</option> </select><span title="Wicket Version"> (?)</span> </div> <div> <label for="cmdLine" id="cmdLabel">Command Line:</label> <textarea id="cmdLine" onfocus="this.select();"> </textarea> <script>changeIt();</script> </div> <br/> </div> |
This will produce the following project structure/files
.\myproject | pom.xml | \---src +---main | +---java | | \---com | | \---mycompany | | HomePage.html | | HomePage.java | | WicketApplication.java | | | +---resources | | log4j.properties | | | \---webapp | \---WEB-INF | web.xml | \---test \---java \---com \---mycompany Start.java |
Change into the project directory, then create a WAR file via mvn package
or build the project and run it under Jetty via mvn jetty:run
.
This will compile the project then deploy it to an embeded instance of the Jetty servlet engine, which will be use on port 8080, by default. As a result, once running, your application will be available at http:localhost:8080/myproject
.
See the Jetty plugin documentation for configuration options, etc.
"mvn eclipse:eclipse -DdownloadSources=true"
command inside the project directory."mvn idea:idea"
command inside the project directory, or if using IDEA 7, from within IDEA, just use "File/New Project/Import from external model/Maven", choose the project directory and select the generated pom.xml.Many more information and examples can be found on our Wiki or here