Apache Wicket 1.3 ================= This is the readme file for the Apache Wicket project. Apache Wicket is an open source, java, component based, web application framework. With proper mark-up/logic separation, a POJO data model, and a refreshing lack of XML, Apache Wicket makes developing web-apps simple and enjoyable again. Swap the boilerplate, complex debugging and brittle code for powerful, reusable components written with plain Java and HTML. Apache Wicket can be found at: http://wicket.apache.org and is licensed under the Apache Software Foundation license, version 2.0. Contents -------- - License - Java/Application server requirements - Getting started - Building Wicket from source - Migrating from 1.2 - Getting help - This release License ------- Wicket is distributed under the terms of the Apache Software Foundation license, version 2.0. The text is included in the file LICENSE.txt in the root of the project. Java/Application server requirements ------------------------------------ Wicket requires at least Java 1.4. The application server for running your web application should adhere to the servlet specification version 2.3 or newer. Getting started --------------- The Wicket project has several projects where you can learn from, and get started quickly: - wicket-examples: shows all components in short usage examples, also available live on: http://www.wicketstuff.org/wicket13 - wicket-quickstart: provides a skeleton project for use in NetBeans, Eclipse, IntelliJ IDEA and other major IDE's, without having to configure anything yourself. You can copy'n'paste the examples from the website into your pages and see them running on your own box. - qwicket (http://www.antwerkz.com/qwicket): 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 so that you can quickly get to the meat of your application rather than mucking with the plumbing of a wicket application. Currently, the system only supports spring and hibernate built with ant. - AppFuse light - Wicket edition (https://appfuse-light.dev.java.net/) AppFuse Light is a can all do it all quickstart setup for almost all possible permutations for building Java web applications and ORM technologies. It features over 60 downloads and combines each available web application framework with Hibernate, iBatis, JDO (JPOX), OJB and Spring JDBC. Building Wicket from source --------------------------- The Wicket distribution contains the final Wicket jar. You can use this directly in your applications. The Wicket project also uploads the source-jars and JavaDoc jars together with the final jar to the Maven repository used by the Maven build tool. So there is actually no specific need to build Wicket yourself from the distribution. Building using maven 2, change the working directory to src and either do: - mvn package creates wicket-x.y.z.jar in target/ subdirectory. - mvn install creates wicket-x.y.z.jar in target/ subdirectory and installs the file into your local repository for use in other projects. Migrating from 1.2 ------------------ There is a migration guide available on our Wiki: http://cwiki.apache.org/WICKET/migrate-13.html Getting help ------------ - Read the online documentation available on our website (http://wicket.apache.org) - Read the migration guide (http://cwiki.apache.org/WICKET/migrate-13.html) - Read the mailing archives available on Nabble, GMane and Apache - Send a complete message containing your problem, stacktrace and problem you're trying to solve to the user list (users@wicket.apache.org) - Ask a question on IRC at freenode.net, channel ##wicket This release ------------ This release has the following improvements over the previous one: Release Notes - Wicket - Version 1.3.0-beta3 ** Bug * [WICKET-322] - Odd behvavior with PasswordTextField evaluation * [WICKET-447] - Password field gets reset on setResetPassword == false even after successful validation * [WICKET-492] - Website Developer SVN still references the branches/ directory and results in not found * [WICKET-494] - id attribute is not preserved * [WICKET-500] - org.apache.wicket.extensions.yui.calendar.DateField; throws NPE upon validation. * [WICKET-525] - Component.getConverter is ignored by PropertyConverter * [WICKET-555] - WicketTester.assertComponentOnAjaxResponse fails if AJAX response contains line breaks * [WICKET-564] - Problem with Autolinks inside panel preview code * [WICKET-570] - MarkupCache does not load markup if it did not exist before * [WICKET-601] - RadioGroup and CheckGroup cause XHTML validation errors because of name attribute * [WICKET-627] - Can't visit components in a ListView before they're rendered. * [WICKET-641] - wicket thread handling is not fully servlet container aware * [WICKET-668] - PropertyResolver.getPropertySetter() depends on calling PropertyResolver.setValue() first for it to work. * [WICKET-686] - Allow validators to process null value * [WICKET-695] - Border.resolve() should not attempt to render contents if bodyVisible is false * [WICKET-697] - FormTester crashes with NullPointerException, if FormComponent is not found * [WICKET-698] - If the model is List, PropertyResolver doesn't try to find fields. * [WICKET-700] - Palette, Recorder Issue - Compound Property Model does not work. * [WICKET-703] - AjaxEditableChoiceLabel doesn't work * [WICKET-710] - Radio/Check/Box cleared on validation error * [WICKET-712] - IConverter refers to nonexistent "class c" * [WICKET-714] - PagingNavigation examples in javadoc are out of date (patch enclosed) * [WICKET-718] - authentication example on wicketstuff.org/wicket13/authentication throws exception * [WICKET-719] - [WICKET-673] breaks AbstractPageableView with AjaxPagingNavigator * [WICKET-720] - Image does not regenerate its LocalizedImageResource resource/resourceReference when you call setModel() * [WICKET-721] - MarkupException using tags in a fragment * [WICKET-723] - A 'recorder' subcomponent of Palette is used as property expression in the CompoundPropertyModel * [WICKET-724] - WicketFilter doesn't handle filter mapping parameter from FilterConfig properly * [WICKET-729] - OnChangeAjaxBehavior does not work with