Introduction
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!
Creating the project
To create your project, copy and paste the command line generated after typing in the groupId, artifactId and version.
| HTML | ||
|---|---|---|
| ||
<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>
|
Results
This will produce the following project structure/files
| Code Block |
|---|
.\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
|
Use
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.
Using the Jetty Plugin
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.
Using with a specific IDE
- Eclipse
- To create an Eclipse project, perform the
"mvn eclipse:eclipse -DdownloadSources=true"command inside the project directory.
- To create an Eclipse project, perform the
- IDEA
- To create an IDEA project perform the
"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.
- To create an IDEA project perform the
- NetBeans
- To create a NetBeans 6 project, just open the pom.xml directly.
More examples
Many more information and examples can be found on our Wiki or here