Page History

...

Books

• Pro Wicket - "Pro Wicket" by Karthik Gurumurthy is now available as e-Book and hardcopy both.
  • This covers 1.2, and has some information about what (the abandoned) 2.0 will add/change.
• Wicket in Action - "Wicket In Action" by Martijn Dashorst and Eelco Hillenius is currently available via Manning's early access programavailable as e-Book and hardcopy.
  • It covers 1.3. Sample chapters available.
• Enjoying Web Development with Wicket - "Enjoying Web Development with Wicket" by Kent Tong is now available as e-Book.
  • It covers 1.3. Wicket v7 and v6. The first three two chapters are freely available.

Traditional Documentation

While there are a couple of books in the pipeline, at the moment the best places to look are the following...

1. Javadocs
   • 1.2-SNAPSHOT: http://wicketframework.org/apidocs/Image Removed
   • 1.3-SNAPSHOT: http://wicketstuff.org/wicket13doc/Image Removed/
   • 1.3.2: http://wicket.apache.org/docs/wicket-1.3.2/wicket/apidocs/index.html
   • 1.4: http://wicket.apache.org/docs/1.4
   • As well as the standard Javadoc descripions descriptions of constructer constructor & method signatures, etc, these contain usages notes, descriptions, etc on the various Wicket elements.
2. Quick Tour & Examples - http://wicketframeworkwicket.apache.org/Examplesexamples.html, http://wicketstuff.org/wicket12/ and http://wicketstuff.org/wicket13/
   • These describe show how various common things may be done in Wicket, with the Quick Tour focussing on particular key elements, with a descriptive narative while the Wicket-Examples attempts to provide much more coverage of the range of components on offer.
   • Note the "Source Code" popup on the Wicket-Examples, to see exactly how things may be done.
   • Be sure to check the various sub-pages, particularly the Component Reference, the Repeater View Examples & the DisplayTag pages.
3. Wiki - http://wicketframeworkcwiki.apache.org/WICKET/wiki
   • I'd particularly suggest the Reference library
4. Tutorials
   • Tutorials by Kent Tong
   • IBM DeveloperWorks tutorial on Wicket
   • A series of tutorials on Wicket on JavaLobby by R.J. Lorimer

...

1. The Wicket-User mailing list - http://www.nabble.com/Wicket-f13974.htmlImage Removed
2. The IRC channel - ##wicket #wicket on FreeNode (irc://irc.freenode.net/##wicketImage Removed#wicket)
3. Wicket Support is a company that provides Wicket training.

Code as documentation

Along these lines, the main options for 'JumpStart' or 'Working Examples' are as follows:

1. Wicket-Archetype-Quickstart as a Maven 2 archetype - You need Maven2 installed
   • Create a QuickStart project
     • mvn archetype:create -DarchetypeGroupId=org.apache.wicket
-DarchetypeArtifactId=wicket-archetype-quickstart
-DarchetypeVersion=1.3.0-beta3
-DgroupId=com.mycompany
-DartifactId=myproject
   • That's all there is to it - just cd into the new myproject folder, build & run it via "mvn jetty:run" and browse it via http://localhost:8080/myproject
   • To create an Eclipse project perform the mvn eclipse:eclipse -DdownloadSources=true command inside the myproject folder
   • To create an IDEA project perform the mvn idea:idea command inside the myproject folder or if using one of the Early Access Project (EAP) releases, just import the generated pom.xml directly into IDEA.
   - http://wicket.apache.org/quickstart.html
   • Uses a Maven2 archetype in order to create a basic ('QuickStart') project to get you up & running quickly. Also useful for creating a small project in order to investigate/demonstrate particular issues or problems.
2. Wicket-Iolite - http http://wicketstuff.org/confluence/display/STUFFWIKI/Wicket-Iolite
   • A Maven2 archetype which creates a two-module Wicket project (core & web) setup to use Spring & Hibernate/JPA for persistence
   Wicket-Phonebook - http://wicket-stuff.sourceforge.net/wicket-phonebook/Image Removed
   • A Spring & Hibernate/iBATIS application showing an example of displaying a list of tabular data along with the typical CrUD opertations on it.
3. QWicket - http://www.antwerkz.com/qwicket/app/homeImage Removed
   • Qwicket is a quickstart application for the wicket framework. Its intent is to provide a rapid method for creating a new wicket project with the basic infrastructure in place. Currently, it only supports Spring and Hibernate built with Ant but plans include such things as support for Maven 2 and other persistence layers such as iBATIS
4. Databinder - http://databinder.net/examples.htmlImage Removed
   • Databinder is a simple bridge from Wicket to Hibernate. Its site hosts five example database-driven webapps, each running live and with source for browsing (and one screencast). A Maven 2 archetype is available for generating Databinder projects from scratch.
5. Wicket-QuickStartPhonebook - http://wicketframework.org/wicket-quickstart/index.htmlImage Removed
   • V1.2 - Intended to be a batteries-included way of getting started.
   Wicket-Template - http://stuff.sourceforge.net/project/showfiles.php?group_id=134391&package_id=197274Image Removedwicket-phonebook/
   • A Spring & Hibernate/iBATIS application showing an example of displaying a list of tabular data along with the typical CrUD opertations on it
   • V1.2 The equivalent of QuickStart for those developers with Maven2 and an internet connection.
   • Small (22KB), Maven2-based project which can be used to get started quickly.

"Use the Source, Luke"

1. The latest code's in Wicket's SVN repository - See the Wicket SVN page to find out more about the alternative branches and tags.