(Quick Reference)

Apache Wicket User Guide - Reference Documentation

Authors: Andrea Del Bene, Carsten Hufe, Christian Kroemer, Daniel Bartl

Version: 1.0.0.BUILD-SNAPSHOT

Table of Contents

1Introduction
2Why should I learn Wicket?
2.1We all like spaghetti :-) ...
2.2Component oriented frameworks - an overview
2.3Benefits of component oriented frameworks for web development
2.4Wicket vs the other component oriented frameworks
3Wicket says “Hello world!”
3.1Wicket distribution and modules
3.2Configuration of Wicket applications
3.3The HomePage class
3.4Wicket Links
3.5Summary
4Wicket as page layout manager
4.1Header, footer, left menu, content, etc...
4.2Here comes the inheritance!
4.3Divide et impera!
4.4Markup inheritance with the <wicket:extend> tag
4.5Summary
5Keeping control over HTML
5.1Hiding or disabling a component
5.2Modifing tag attributes
5.3Generating tag attribute 'id'
5.4Creating in-line panels with WebMarkupContainer
5.5Working with markup fragments
5.6Adding header contents to the final page
5.7Using stub markup in our pages/panels
5.8How to render component body only
5.9Hiding decorating elements with the <wicket:enclosure> tag
5.10Surrounding existing markup with Border
5.11Summary
6Components lifecycle
6.1Lifecycle stages of a component
6.2Hook methods for component lifecycle
6.3Initialization stage
6.4Rendering stage
6.5Removing stage
6.6Summary
7Page versioning and caching
7.1Stateful pages vs stateless
7.2Stateful pages
7.3Stateless pages
7.4Summary
8Under the hood of the request processing
8.1Class Application and request processing
8.2Request and Response classes
8.3The “director” of request processing - RequestCycle
8.4Session Class
8.5Summary
9Wicket Links and URL generation
9.1PageParameters
9.2Bookmarkable links
9.3Automatically creating bookmarkable links with tag <wicket:link>
9.4External links
9.5Stateless links
9.6Generating structured and clear URLs
9.7Summary
10Wicket models and forms
10.1What is a model?
10.2Models and JavaBeans
10.3Wicket forms
10.4Component DropDownChoice
10.5Model chaining
10.6Detachable models
10.7Using more than one model in a component
10.8Use models!
10.9Summary
11Wicket forms in detail
11.1Default form processing
11.2Form validation and feedback messages
11.3Input value conversion
11.4Submit form with an IFormSubmittingComponent
11.5Nested forms
11.6Multi-line text input
11.7File upload
11.8Creating complex form components with FormComponentPanel
11.9Stateless form
11.10Working with radio buttons and checkboxes
11.11Selecting multiple values with ListMultipleChoices and Palette
11.12Summary
12Displaying multiple items with repeaters
12.1Component RepeatingView
12.2Component ListView
12.3Component RefreshingView
12.4Pageable repeaters
12.5Summary
13Internationalization with Wicket
13.1Localization
13.2Localization in Wicket
13.3Bundles lookup algorithm
13.4Localization of component's choices
13.5Internationalization and Models
13.6Summary
14Resource management with Wicket
14.1Static vs dynamic resources
14.2Resource references
14.3Package resources
14.4Adding resources to page header section
14.5Resource dependencies
14.6Custom resources
14.7Mounting resources
14.8Shared resources
14.9Customizing resource loading
14.10Summary
15An example of integration with JavaScript
15.1What we want to do...
15.2...and how we will do it
15.3Summary
16Wicket advanced topics
16.1Enriching components with behaviors
16.2Generating callback URLs with IRequestListener
16.3Initializers
16.4Using JMX with Wicket
16.5Generating HTML markup from code
16.6Summary
17Working with AJAX
17.1How to use AJAX components and behaviors
17.2Build-in AJAX components
17.3Built-in AJAX behaviors
17.4Using an activity indicator
17.5AJAX request attributes and call listeners
17.6Creating custom AJAX call listener
17.7Summary
18Integration with enterprise containers
18.1Integrating Wicket with EJB
18.2Integrating Wicket with Spring
18.3JSR-330 annotations
18.4Summary
19Security with Wicket
19.1Authentication
19.2Authorizations
19.3Using HTTPS protocol
19.4Package Resource Guard
19.5Summary
20Test Driven Development with Wicket
20.1Utility class WicketTester
20.2Testing Wicket forms
20.3Testing markup with TagTester
20.4Summary
21Test Driven Development with Wicket and Spring
21.1Configuration of the runtime environment
21.2Configuration of the JUnit based integration test environment
21.3Summary
22Wicket Best Practices
22.1Encapsulate components correctly
22.2Put models and page data in fields
22.3Correct naming for Wicket IDs
22.4Avoid changes at the component tree
22.5Implement visibilities of components correctly
22.6Always use models
22.7Do not unwrap models within the constructor hierarchy
22.8Pass models extended components
22.9Validators must not change any data or models
22.10Do not pass components to constructors
22.11Use the Wicket session only for global data
22.12Do not use factories for components
22.13Every page and component must be tested
22.14Avoid interactions with other servlet filters
22.15Cut small classes and methods
22.16The argument "Bad documentation"
22.17Summary
23Working with Maven (Appendix)
23.1Switching Wicket to DEPLOYMENT mode
23.2Creating a Wicket project from scratch and importing it into our favourite IDE
24Project WicketStuff (Appendix)
24.1What is project WicketStuff
24.2Module tinymce
24.3Module wicketstuff-gmap3
24.4Module wicketstuff-googlecharts
24.5Module wicketstuff-inmethod-grid
25Lost In Redirection With Apache Wicket (Appendix)
Quick Reference (hide)