(Quick Reference)

Apache Wicket User Guide - Reference Documentation

Authors: Andrea Del Bene, Martin Grigorov, Carsten Hufe, Christian Kroemer, Daniel Bartl, Paul Borș, Tobias Soloschenko

Version: 6.x

Table of Contents

1Introduction
2How to use the example code
3Why should I learn Wicket?
3.1We all like spaghetti :-) ...
3.2Component oriented frameworks - an overview
3.3Benefits of component oriented frameworks for web development
3.4Wicket vs the other component oriented frameworks
4Wicket says “Hello world!”
4.1Wicket distribution and modules
4.2Configuration of Wicket applications
4.3The HomePage class
4.4Wicket Links
4.5Summary
5Wicket as page layout manager
5.1Header, footer, left menu, content, etc...
5.2Here comes the inheritance!
5.3Divide et impera!
5.4Markup inheritance with the wicket:extend tag
5.5Summary
6Keeping control over HTML
6.1Hiding or disabling a component
6.2Modifing tag attributes
6.3Generating tag attribute 'id'
6.4Creating in-line panels with WebMarkupContainer
6.5Working with markup fragments
6.6Adding header contents to the final page
6.7Using stub markup in our pages/panels
6.8How to render component body only
6.9Hiding decorating elements with the wicket:enclosure tag
6.10Surrounding existing markup with Border
6.11Summary
7Components lifecycle
7.1Lifecycle stages of a component
7.2Hook methods for component lifecycle
7.3Initialization stage
7.4Rendering stage
7.5Removing stage
7.6Summary
8Page versioning and caching
8.1Stateful pages vs stateless
8.2Stateful pages
8.3Stateless pages
8.4Summary
9Under the hood of the request processing
9.1Class Application and request processing
9.2Request and Response classes
9.3The “director” of request processing - RequestCycle
9.4Session Class
9.5Exception handling
9.6Summary
10Wicket Links and URL generation
10.1PageParameters
10.2Bookmarkable links
10.3Automatically creating bookmarkable links with tag wicket:link
10.4External links
10.5Stateless links
10.6Generating structured and clear URLs
10.7Summary
11Wicket models and forms
11.1What is a model?
11.2Models and JavaBeans
11.3Wicket forms
11.4Component DropDownChoice
11.5Model chaining
11.6Detachable models
11.7Using more than one model in a component
11.8Use models!
11.9Summary
12Wicket forms in detail
12.1Default form processing
12.2Form validation and feedback messages
12.3Input value conversion
12.4Validation with JSR 303
12.5Submit form with an IFormSubmittingComponent
12.6Nested forms
12.7Multi-line text input
12.8File upload
12.9Creating complex form components with FormComponentPanel
12.10Stateless form
12.11Working with radio buttons and checkboxes
12.12Selecting multiple values with ListMultipleChoices and Palette
12.13Summary
13Displaying multiple items with repeaters
13.1The RepeatingView Component
13.2The ListView Component
13.3The RefreshingView Component
13.4Pageable repeaters
13.5Summary
14Internationalization with Wicket
14.1Localization
14.2Localization in Wicket
14.3Bundles lookup algorithm
14.4Localization of component's choices
14.5Internationalization and Models
14.6Summary
15Resource management with Wicket
15.1Static vs dynamic resources
15.2Resource references
15.3Package resources
15.4Adding resources to page header section
15.5Context-relative resources
15.6Resource dependencies
15.7Aggregate multiple resources with resource bundles
15.8Put JavaScript inside page body
15.9Header contributors positioning
15.10Custom resources
15.11Mounting resources
15.12Shared resources
15.13Customizing resource loading
15.14CssHeaderItem and JavaScriptHeaderItem compression
15.15Summary
16An example of integration with JavaScript
16.1What we want to do...
16.2...and how we will do it
16.3Summary
17Wicket advanced topics
17.1Enriching components with behaviors
17.2Generating callback URLs with IRequestListener
17.3Initializers
17.4Using JMX with Wicket
17.5Generating HTML markup from code
17.6Summary
18Working with AJAX
18.1How to use AJAX components and behaviors
18.2Build-in AJAX components
18.3Built-in AJAX behaviors
18.4Using an activity indicator
18.5AJAX request attributes and call listeners
18.6Creating custom AJAX call listener
18.7Summary
19Integration with enterprise containers
19.1Integrating Wicket with EJB
19.2Integrating Wicket with Spring
19.3JSR-330 annotations
19.4Summary
20Native WebSockets
20.1How does it work ?
20.2How to use
20.3Client-side APIs
20.4Testing
20.5Differences with Wicket-Atmosphere module.
20.6FAQ
21Security with Wicket
21.1Authentication
21.2Authorizations
21.3Using HTTPS protocol
21.4URLs encryption in detail
21.5Package Resource Guard
21.6Summary
22Test Driven Development with Wicket
22.1Utility class WicketTester
22.2Testing Wicket forms
22.3Testing markup with TagTester
22.4Summary
23Test Driven Development with Wicket and Spring
23.1Configuration of the runtime environment
23.2Configuration of the JUnit based integration test environment
23.3Summary
24Wicket Best Practices
24.1Encapsulate components correctly
24.2Put models and page data in fields
24.3Correct naming for Wicket IDs
24.4Avoid changes at the component tree
24.5Implement visibilities of components correctly
24.6Always use models
24.7Do not unwrap models within the constructor hierarchy
24.8Pass models extended components
24.9Validators must not change any data or models
24.10Do not pass components to constructors
24.11Use the Wicket session only for global data
24.12Do not use factories for components
24.13Every page and component must be tested
24.14Avoid interactions with other servlet filters
24.15Cut small classes and methods
24.16The argument "Bad documentation"
24.17Summary
25Wicket Internals
25.1Page storing
26Working with Maven (Appendix)
26.1Switching Wicket to DEPLOYMENT mode
26.2Creating a Wicket project from scratch and importing it into our favourite IDE
27Project WicketStuff (Appendix)
27.1What is project WicketStuff
27.2Module tinymce
27.3Module wicketstuff-gmap3
27.4Module wicketstuff-googlecharts
27.5Module wicketstuff-inmethod-grid
27.6Module wicketstuff-rest-annotations
27.7Module stateless
28Lost In Redirection With Apache Wicket (Appendix)
29Contributing to this guide (Appendix)
Quick Reference (hide)