This is an automated email from the ASF dual-hosted git repository.
dashorst pushed a commit to branch archive/wicket-7.x
in repository https://gitbox.apache.org/repos/asf/wicket.git
The following commit(s) were added to refs/heads/archive/wicket-7.x by this
push:
new 88f4725a3b Add the Wicket 7 migration guide from the wiki
88f4725a3b is described below
commit 88f4725a3b2951a25ac7beb2f79cfa227b97fe71
Author: Martijn Dashorst <[email protected]>
AuthorDate: Wed Nov 4 08:21:54 2026 +0100
Add the Wicket 7 migration guide from the wiki
The migration guides move from the wiki into the source tree of their
release line. This adds migration-to-7.md, converted from the wiki page
"Migration to Wicket 7.0" (version 105, last edited 2017-01-09):
https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=31819945
The content is unchanged. Confluence macros became Markdown: code
blocks, notes and warnings as GitHub alerts, Jira macros as links to
the issue; the table of contents was dropped, as GitHub generates one.
Links to the other migration guides on the wiki now point to their
files on the branch of their release line.
Generated-by: Claude Code (Claude Opus 5.5)
---
migration-to-7.md | 503 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 503 insertions(+)
diff --git a/migration-to-7.md b/migration-to-7.md
new file mode 100644
index 0000000000..e137765577
--- /dev/null
+++ b/migration-to-7.md
@@ -0,0 +1,503 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+# Migration to Wicket 7
+
+## Migrating to Wicket 7.0
+
+#### Environment
+
+##### Wicket 7.0 requires at least Java 7
+
+##### Wicket 7.0 requires Servlet 3.0
+
+###### The HTTP response is not flushed automatically when the request is
started in asynchronous mode.
[WICKET-5152](https://issues.apache.org/jira/browse/WICKET-5152)
+
+This is an improvement in Wicket 7.0 which should not affect any application
migrating from Wicket 6.x. But if you use Servlet 3.0's AsyncContext in
IResource in Wicket 7 then make sure that your code flushes the http response
after completing the request.
+
+#### API changes
+
+###### Changes to org.apache.wicket.ajax.json.\*
[WICKET-6287](https://issues.apache.org/jira/browse/WICKET-6287) - Switch from
[json.org](http://json.org) to open-json RESOLVED
+
+Because of license issues all classes in the mentioned package have been
replaced by classes of open-json (<https://github.com/tdunning/open-json>)
which means that the basic functionality is nearly the same. Some classes
however (example: org.json.HTTP) are throwing WicketRuntimeExceptions because
there is no corresponding implementation in open-json, yet. json.org can be
used in this case (can be found in the central maven repository) if the license
conditions are accepted.
+
+###### DecimalConverters' number format
[WICKET-5853](https://issues.apache.org/jira/browse/WICKET-5853)
[WICKET-5861](https://issues.apache.org/jira/browse/WICKET-5861)
+
+org.apache.wicket.util.convert.converter.AbstractDecimalConverter's
#getNumberFormat() and #setNumberFormat() has been removed in favour of
#newNumberFormat(). Applications using the old methods should override the new
one, where they configure specifics or preserve a reference to the created
NumberFormat.
+
+###### org/apache/wicket/core/util/io/SerializableChecker is replaced with
org.apache.wicket.core.util.objects.checker.CheckingObjectOutputStream
[WICKET-4817](https://issues.apache.org/jira/browse/WICKET-4817)
+
+CheckingObjectOutputStream accepts a list of
org.apache.wicket.core.util.objects.checker.IObjectChecker objects which are
used to check for different kind of problems during object serialization.
Commit diff:
[d0441059e0](https://git-wip-us.apache.org/repos/asf/wicket/repo?p=wicket.git;a=commitdiff;h=d0441059e0bba325f3f68a5db00282cc3901dc5a)
+
+Use org.apache.wicket.core.util.objects.checker.ObjectSerializationChecker as
a replacement.
+
+###### org/apache/wicket/markup/html/border/BoxBorder is removed with no
replacement [WICKET-4966](https://issues.apache.org/jira/browse/WICKET-4966).
+
+BoxBorder class has been deprecated in Wicket 6.x series
+
+###### org.apache.wicket.Component#renderHead(HtmlHeaderContainer) is renamed
to Component#internalRenderHead(HtmlHeaderContainer)
[WICKET-4964](https://issues.apache.org/jira/browse/WICKET-4964)
+
+Component#renderHead(HtmlHeaderContainer) was very similar to the usually used
Component#renderHead(IHeaderResponse). So it has been renamed to avoid any
confusions.
+
+###### org.apache.wicket.request.resource.ResourceReference#getDependencies()
now returns a mutable List\<HeaderItem\>
[WICKET-5124](https://issues.apache.org/jira/browse/WICKET-5124)
+
+The old API returned Iterable\<? extends HeaderItem\> and was inconvenient to
override and add additional dependencies.\
+With the new API it is as easy as:
+
+*MyResourceReference.java*
+
+```java
+@Override
+public List<HeaderItem> getDependencies() {
+ List<HeaderItem> dependencies = super.getDependencies();
+ dependencies.add(dep1);
+ dependencies.add(dep2);
+ return dependencies;
+}
+```
+
+The same is done for
org.apache.wicket.markup.head.HeaderItem#getDependencies() too.
+
+###### org.apache.wicket.model.StringResourceModel interpolation of null in
resourceKey [WICKET-5820](https://issues.apache.org/jira/browse/WICKET-5820)
+
+If a null value is interpolated into the resourceKey, it will now be
represented as 'null' instead of the variableName. Thus if you had
"weather.${status}=..." in your resource file, you now should use
"weather.null=..." instead.
+
+###### org.apache.wicket.model.StringResourceModel constructor accepts
IModel\<String\> for its default value
[WICKET-4972](https://issues.apache.org/jira/browse/WICKET-4972)
+
+There were two problems with the old way:
+
+- since the *parameters* argument type is Object..., i.e. varargs, it was hard
for the compiler and runtime to differentiate the "defaultValue" from the
"parameters"
+- it wasn't possible to use lazy evaluation of the default value
+- the amount of parameters for StringResourceModel resulted in rather cryptic
code indecipherable for mere mortals.
+
+So we opted to remove most of the constructors of StringResourceModel and use
a fluent API instead. For ease of migration you can use the
StringResourceModelMigration class to alleviate the pain of figuring out the
right way to construct your instance using the new fluent API.
+
+Change the `new StringResourceModel(...)` constructor call to an invocation of
`StringResourceModelMigration.of(...)`, and then perform the *Inline Method*
refactoring of your IDE.
+
+######
org.apache.wicket.extensions.validation.validator.+Xyz+Validator#decorate() now
works with *IValidationError*
[WICKET-5174](https://issues.apache.org/jira/browse/WICKET-5174)
+
+This method now accepts IValidationError as an argument and returns
IValidationError. This way it can be used with other IValidationError
implementations like RawValidationError for example.
+
+######
org.apache.wicket.ajax.attributes.AjaxRequestAttributes#setAllowDefault() is
deprecated in favour of #setPreventDefault()
[WICKET-5197](https://issues.apache.org/jira/browse/WICKET-5197)
+
+This is done to make it more consistent with JavaScript API.
+
+Same for #isAllowDefault() - use #isPreventDefault() instead.
+
+######
org.apache.wicket.ajax.attributes.AjaxRequestAttributes#eventPropagation is now
BUBBLE by default
[WICKET-5198](https://issues.apache.org/jira/browse/WICKET-5198)
+
+This is done to make it more consistent with JavaScript API.
+
+###### org.apache.wicket.ajax.form.AjaxFormValidatingBehavior doesn't use
static methods anymore
[WICKET-5196](https://issues.apache.org/jira/browse/WICKET-5196)
+
+To use AjaxFormValidatingBehavior in Wicket 6.x the application code should do
something like:
+
+*MyComponent.java*
+
+```java
+AjaxFormValidatingBehavior.addToAllFormComponents(form, "keydown",
Duration.ONE_SECOND);
+```
+
+Due to the usage of static method it wasn't possible to extend this behavior
and override for example #updateAjaxAttributes(AjaxRequestAttributes).
+
+The behavior has been reworked a bit to allow this. The new usage is:
+
+*MyComponent.java*
+
+```java
+form.add(new AjaxFormValidatingBehavior("keydown", Duration.ONE_SECOND);
+```
+
+or
+
+*MyComponent.java*
+
+```java
+formComponent.add(new AjaxFormValidatingBehavior("keydown",
Duration.ONE_SECOND);
+```
+
+in this case the formComponent's owning Form will be used.
+
+######
org.apache.wicket.ajax.AjaxRequestTarget.IListener#updateAjaxAttributes() is
introduced [WICKET-5212](https://issues.apache.org/jira/browse/WICKET-5212)
+
+With [WICKET-4958](https://issues.apache.org/jira/browse/WICKET-4958) has been
introduced org.apache.wicket.ajax.AjaxRequestTarget.AbstractListener which is
an empty implementation of AjaxRequestTarget.IListener to be able to introduce
AbstractListener#updateAjaxAttributes() method - a place where an application
can configure globally the Ajax attributes. With
[WICKET-5212](https://issues.apache.org/jira/browse/WICKET-5212) this new
method is moved to the interface as well.\
+From now on it is recommended all implementations of
AjaxRequestTarget.IListener to extend from AjaxRequestTarget.AbstractListener.
This way they won't need to a implement another method when a new one is added
in a major release.
+
+###### org.apache.wicket.ISessionListener#onUnbound(String) is added
[WICKET-5213](https://issues.apache.org/jira/browse/WICKET-5213)
+
+This way all registered ISessionListeners will be notified when a Session is
unbound.
+
+###### (Base)WicketTester uses org.junit.Assert instead of
junit.framework.Assert
+
+junit.framework.Assert is deprecated. Due to this change
org.junit.Assert#fail() throws now java.lang.AssertionError instead of
junit.framework.AseertionFailedError
+
+###### (Base)WicketTester can be reused after thrown exception
+
+If an exception is thrown during processing in BaseWicketTester or the request
was not processed by Wicket, you have to use #getLastRequest() to access this
request (was #getRequest() previously).\
+[WICKET-5389](https://issues.apache.org/jira/browse/WICKET-5389).
+
+###### WicketTester assert feedback message methods work with
java.io.Serializable
[WICKET-5128](https://issues.apache.org/jira/browse/WICKET-5128)
+
+org.apache.wicket.util.tester.WicketTester#assertErrorMessages and
org.apache.wicket.util.tester.WicketTester#assertInfoMessages now accept a
list/varargs of java.io.Serializable as argument, instead of list of Strings.
+
+This makes these methods consistent with org.apache.wicket.Component#error and
other feedback message related methods.
+
+Whatever type of message you pass to Component#error() the same message type
can be asserted on.
+
+###### org.apache.wicket.Component#setMetaData() value could be only a
Serializable [WICKET-5227](https://issues.apache.org/jira/browse/WICKET-5227)
+
+Component and Session's meta data must be serializable.
+
+###### org.apache.wicket.Application#getHeaderContributorListenerCollection()
is renamed to #getHeaderContributorListeners()
+
+This way it is consistent with the other #getXyzListeners() methods in
Application class
+
+######
org.apache.wicket.authorization.IAuthorizationStrategy#isResourceAuthorized(IResource,
PageParameters) is introduced
[WICKET-5012](https://issues.apache.org/jira/browse/WICKET-5012)
+
+Wicket 7.x supports authorization for requests to resources (IResource)
additionally to authorization for components.
+
+###### org.apache.wicket.Component#setResponsePage() now accepts
org.apache.wicket.request.component.IRequestablePage instead of
org.apache.wicket.Page
+
+org.apache.wicket.Component#setResponsePage(page) just delegates to
org.apache.wicket.request.cycle.RequestCycle#setResponsePage() that required
just IRequestablePage.
+
+###### AutoCompleteTextField doesn't support *useHideShowCoveredIEFix* setting
[WICKET-5130](https://issues.apache.org/jira/browse/WICKET-5130)
+
+*useHideShowCoveredIEFix* setting was needed for IE7 support. This version of
IE is not supported officially anymore and this setting has been removed.
+
+###### org.apache.wicket.markup.html.form.TextField#getInputType() returns
String array [WICKET-5286](https://issues.apache.org/jira/browse/WICKET-5286)
+
+org.apache.wicket.extensions.markup.html.form.DateTextField can be used with
several date-like types: date, datetime, datetime-local, month, time, week.\
+To be able to support this the return type of TextField#getInputType() has
been changed from String to String\[\], and the method itself has been renamed
to #getInputTypes().
+
+To migrate it you should do something like:
+
+*OldMyTextField.java*
+
+```java
+...
+@Override
+protected String getInputType()
+{
+ return "sometype";
+}
+...
+```
+
+to
+
+*NewMyTextField.java*
+
+```java
+...
+@Override
+protected String[] getInputTypes()
+{
+ return new String[] { "sometype" };
+}
+...
+```
+
+###### AuthenticatedWebSession#authenticate is now protected instead of
public. [WICKET-5308](https://issues.apache.org/jira/browse/WICKET-5308)
+
+No change in user code is required, but the authenticate method can now be
made protected to avoid confusion with the signIn method.
+
+###### AbstractResource.ResourceResponse API became more fluent.
[WICKET-5330](https://issues.apache.org/jira/browse/WICKET-5330)
+
+All setter methods in AbstractResource.ResourceResponse class now will return
*this* instance for method chaining.
+
+###### org.apache.wicket.markup.head.IHeaderItemWrapper is merged to
IWrappedHeaderItem.
[WICKET-5366](https://issues.apache.org/jira/browse/WICKET-5366)
+
+IHeaderItemWrapper was a temporary class used to add a new method
(#wrap(HeaderItem)) without breaking the APIs in Wicket 6.x.\
+The new method is moved its proper class - IWrappedHeaderItem.
+
+###### All 'QuirkXyz' properties has been removed from
org.apache.wicket.protocol.http.ClientProperties
[WICKET-5370](https://issues.apache.org/jira/browse/WICKET-5370)
+
+The 'quirk' properties were mostly related to IE6/7 and old versions of
Firefox browsers.
+
+######
org.apache.wicket.request.resource.AbstractResource#flushResponseAfterHeaders()
is removed [WICKET-5392](https://issues.apache.org/jira/browse/WICKET-5392)
+
+This method was needed as a workaround for some old version of Firefox that
had an issue with rendering images.The flush of the headers caused problems
with proper buffering of the response, e.g. when the response needs to be
compressed.
+
+######
org.apache.wicket.markup.html.IPackageResourceGuard#acceptAbsolutePath(Class,
String) now without scope parameter
+
+The scope parameter was no longer used already, so it is now removed from the
method signature. The method is renamed to IPackageResourceGuard#accept(String)
+
+###### All IXyzSettings are removed
[WICKET-5410](https://issues.apache.org/jira/browse/WICKET-5410)
+
+Keywords: IApplicationSettings, IDebugSettings, IExceptionSettings,
IFrameworkSettings, IJavaScriptLibrarySettings, IMarkupSettings, IPageSettings,
IRequestCycleSettings, IRequestLoggerSettings, IResourceSettings,
ISecuritySettings, IStoreSettings, IWebSocketSettings
+
+All interfaces related to configuration settings have been removed because the
user application usually call setter methods like
*application.getXyzSettings().setAbc(abc)* and don't provide their own
implementations of these interfaces.\
+Additionally by using interfaces it is not possible to add new settings in a
minor release of Wicket because it is considered as an API break.
+
+To fix any compilation issues just remove the leading **I** from the class
name, e.g. IMarkupSettings -\> MarkupSettings, and optimize the imports in your
IDE.
+
+######
org.apache.wicket.request.resource.caching.version.IResourceVersion#getVersionPattern()
is added [WICKET-5446](https://issues.apache.org/jira/browse/WICKET-5446)
+
+This method makes the API more flexible when extracting the version from the
url.
+
+The pattern is used to check whether a candidate String could be a version.
+
+To allow any pattern this method can return null or Pattern.compile(".\*" )
+
+###### add org.apache.wicket.markup.html.form.IChoiceRenderer#getObject(String
idValue, IModel\<? extends List\<? extends T\>\> choices) method
[WICKET-663](https://issues.apache.org/jira/browse/WICKET-663)
+
+This method should return the object that produces *idValue* when
org.apache.wicket.markup.html.form.IChoiceRenderer#getIdValue(T object, int
index) is called.
+
+###### remove org.apache.wicket.request.mapper.mount.MountMapper
[WICKET-4686](https://issues.apache.org/jira/browse/WICKET-4686)
+
+MountMapper and its related classes (IMountedRequestMapper, Mount,
MountParameters, UnmountedMapperAdapter and UnmountedRequestHandlerAdapter)
have been introduced with Wicket 1.5.0.
+
+Its main task was to deal with the mounting of a delegate IRequestMapper at a
given path. Unfortunately it has been used only for wrapping PackageMapper and
at some point the most used mapper - MountedMapper, used to mount page class -
has been improved to deal with mandatory and optional parameters. To fix
WICKET-4686 (support mandatory and optional parameters in PackageMapper) we
needed to extract the related logic to a place where it can be reused. We
decided this place to be Abstract [...]
+
+If you have used MountMapper for your custom mappers in Wicket 1.5/6.x then
now your custom mapper has to extend from AbstractBookmarkableMapper.
+
+**Note**: MountMapper and its related classes are still available in 7.x but
deprecated and not used by Wicket itself. They will be completely removed in
Wicket 8.0.0
+
+**Renamed all \*AjaxResponse classes to \*PartialPageUpdate WICKET-5929**
+
+XmlAjaxResponse was renamed to XmlPartialPageUpdate (see git commit
7c40e4dafa75973bf99b34567d977f310a5f02d0)
+
+###### AuthenticatedWebApplication#onUnauthorizedPage
[WICKET-5490](https://issues.apache.org/jira/browse/WICKET-5490)
+
+The type of the parameter passed to
AuthenticatedWebApplication#onUnauthorizedPage() has changed from
org.apache.wicket.Page to org.apache.wicket.Component because this is an
instance of a page that is partially constructed. Only the constructor of
org.apache.wicket.Component is fully executed. All super constructors are not
executed and the instance is not really a Page.
+
+###### PropertyColumn#createLabelModel has been renamed to getDataModel
[WICKET-4802](https://issues.apache.org/jira/browse/WICKET-4802)
[WICKET-5201](https://issues.apache.org/jira/browse/WICKET-5201)
+
+The property column from wicket-extensions has some methods renamed to better
reflect their meaning.
+
+###### #onSelectionChanged() use generic type as argument
+
+RadioGroup and RadioChoice use their generic type for the argument of
#onSelectionChanged() now.
+
+###### Palette and Wizard use \<div\>s instead of \<table\> markup
[WICKET-5349](https://issues.apache.org/jira/browse/WICKET-5349)
+
+For these components markup is changed from \<table\> to nested \<div\>s.
Wizard's previous "default" CSS styling is no longer supported, Palette offers
an optional styling via
org.apache.wicket.extensions.markup.html.form.palette.theme.DefaultTheme.
+
+###### Use i18n property files for CSS class names
[WICKET-5257](https://issues.apache.org/jira/browse/WICKET-5257)
+
+Until Wicket 7.0.0 some components have been setting hardcoded CSS class names
(e.g. FeedbackPanel), other were using a overridable Behavior to set the needed
class names (e.g. OrderByLink's ICssProvider).
+
+Since Wicket 7.0.0 this is simplified and now the applications can provide
their own CSS class names when needed by overriding some keys in their i18n
properties files (e.g. in MyApplication.properties).
+
+Here is a list of the default keys and their values:
+
+FeedbackMessage.CSS.undefined=feedbackPanelUNDEFINED\
+FeedbackMessage.CSS.debug=feedbackPanelDEBUG\
+FeedbackMessage.CSS.info=feedbackPanelINFO\
+FeedbackMessage.CSS.success=feedbackPanelSUCCESS\
+FeedbackMessage.CSS.warning=feedbackPanelWARNING\
+FeedbackMessage.CSS.error=feedbackPanelERROR\
+FeedbackMessage.CSS.fatal=feedbackPanelFATAL
+
+FormComponentLabel.CSS.required=required\
+FormComponentLabel.CSS.invalid=error\
+FormComponentLabel.CSS.disabled=disabled
+
+OddEvenItem.CSS.odd=odd\
+OddEvenItem.CSS.even=even
+
+OddEvenListItem.CSS.odd=odd\
+OddEvenListItem.CSS.even=even
+
+AutoLabel.CSS.required=required\
+AutoLabel.CSS.invalid=error\
+AutoLabel.CSS.disabled=disabled
+
+OrderByLink.CSS.ascending=wicket_orderUp\
+OrderByLink.CSS.descending=wicket_orderDown\
+OrderByLink.CSS.none=wicket_orderNone
+
+TabbedPanel.CSS.container=tab-row\
+TabbedPanel.CSS.selected=selected\
+TabbedPanel.CSS.last=last
+
+Node.CSS.expanded=tree-junction-expanded\
+Node.CSS.collapsed=tree-junction-collapsed\
+Node.CSS.other=tree-junction
+
+Folder.CSS.other=tree-folder-other\
+Folder.CSS.closed=tree-folder-closed\
+Folder.CSS.open=tree-folder-open\
+Folder.CSS.selected=selected
+
+###### Generics related improvements in the signature of methods and
constructors with collections
[WICKET-5350](https://issues.apache.org/jira/browse/WICKET-5350)
+
+Components' methods and constructors which use collections have been updated
to follow best practices. List of updated components:
+
+AbstractChoice, CheckGroup, FileUploadField, ListView, PageableListView,
PropertyListView, AbstractPageableView, RefreshingView, ListDataProvider,
AjaxEditableChoiceLabel, Palette, SelectOption, SelectOptions, ChoiceFilter,
ChoiceFilteredPropertyColumn
+
+Model#of(Collection), Model#ofList(List) and Model#ofSet(Set) have been
adjusted to return collections without wildcards.
+
+###### Make FormComponent#convertInput() public
[WICKET-5708](https://issues.apache.org/jira/browse/WICKET-5708)
+
+The visibility of
org.apache.wicket.markup.html.form.FormComponent#convertInput() method has been
changed from \<em\>protected\</em\> to \<em\>public\</em\> to allow application
components and behaviors to convert the input of another form component(s)
during custom form (component) submit processing.
+
+###### Use commons-fileupload as Maven dependency instead of keeping copies of
its classes [WICKET-5503](https://issues.apache.org/jira/browse/WICKET-5503)
+
+All classes from package org.apache.wicket.util.upload.\*\* are now in
org.apache.commons.fileupload.\*\*.
+
+For example FileItem and FileUploadException.
+
+###### Rename PageSettings#recreateMountedPagesAfterExpiry to
#recreateBookmarkablePagesAfterExpiry
[WICKET-5829](https://issues.apache.org/jira/browse/WICKET-5829)
+
+###### Rename IStaticCacheableResource#getCacheableResourceStream() to
#getResourceStream()
[WICKET-5909](https://issues.apache.org/jira/browse/WICKET-5909)
+
+#### Behavior changes
+
+###### org.apache.wicket.request.Url#getQueryString
[WICKET-4664](https://issues.apache.org/jira/browse/WICKET-4664)
+
+Url#getQueryString() now behaves as HttpServletRequest behaves :
+
+- returns the query string without the leading "?"
+- returns null when there is no query string
+
+RequestUtils#decodeParameters() now strips the "?" from the output value.
+
+###### org.apache.wicket.request.http.WebResponse encodes the value of the
"filename" in Content-Disposition header
[WICKET-4934](https://issues.apache.org/jira/browse/WICKET-4934)
+
+The value of the file name used in "Content-Disposition" response header can
contain characters which should be [encoded](http://greenbytes.de/tech/tc2231/)
+
+When serving file with name 'fileN**รค**me.txt' with content disposition
*attachment* (or *inline*) Wicket will put a response header like:
+
+Content-Disposition", "attachment; fileN%C3%A4me.txt";
filename\*=UTF-8''fileN%C3%A4me.txt
+
+The value is not very human readable but this is the best way to show the file
name in cross browser compatible way.
+
+###### org.apache.wicket.markup.html.form.FormComponentLabel outputs
"required", "disabled" and "error" classes when its form component is either
required, disabled or invalid.
[WICKET-5177](https://issues.apache.org/jira/browse/WICKET-5177)
+
+This way it is in sync with AutoLabel (the auto component that is used for
"wicket:for" attribute).
+
+###### org.apache.wicket.markup.html.panel.FeedbackPanel Do not set CSS class
on the li \> span element for a feedback message
[WICKET-4831](https://issues.apache.org/jira/browse/WICKET-4831)
+
+The css class is now only applied to the li element and not to the span
inside. Additionally a FeedbackPanel#newMessageItem() method has been added to
allow customization of each feedback message item (similar to
DataTable#newRowItem()).
+
+###### AjaxEventBehavior doesn't prevent the default behavior of the
JavaScript event
[WICKET-5197](https://issues.apache.org/jira/browse/WICKET-5197)
+
+From now on only AjaxFallback\*\* components prevent the default JavaScript
event behavior so only the Ajax call is made when JavaScript is enabled in the
browser.\
+If the default behavior should be prevented in any use case then use:
+
+```java
+attributes.setPreventDefault(true);
+```
+
+###### Ajax behaviors let JavaScript events bubble by default
[WICKET-5198](https://issues.apache.org/jira/browse/WICKET-5198)
+
+If JavaScript events should not bubble then use:
+
+```java
+attributes.setEventPropagation(EventPropagation.STOP);
+```
+
+or:
+
+```java
+attributes.setEventPropagation(EventPropagation.STOP_IMMEDIATE);
+```
+
+###### PackageTextTemplate loads its content lazily
[WICKET-4579](https://issues.apache.org/jira/browse/WICKET-4579)
+
+PackageTextTemplate will load its content at first usage of
PackageTextTemplate#toString() or PackageTextTemplate#interpolate(Map) methods.\
+If its style/locale/variation/encoding are changed then it will reload its
content.
+
+###### AbstractLink no longer alters its markup to render itself as disabled
[WICKET-4904](https://issues.apache.org/jira/browse/WICKET-4904)
+
+The href and disabled attributes are still added/removed by AbstractLink as
required. But no further mangling of markup is performed.
org.apache.wicket.markup.html.link.DisabledLinkBehavior can be used to restore
the pre-Wicket-7.x representation of disabled links with
\<em\>\<span\>\</span\>\</em\> (note that \<em\> and \<span\> swap their
position though). If the old behavior is need it can be easily re-applied by
using org.apache.wicket.markup.html.link.DisabledLinkBehavior.LinkInstan [...]
+
+Hence "setAfterDisabledLink(String)" and "setBeforeDisabledLink(String)" have
been removed from AbstractLink.
+
+"isLinkEnabled()" has been removed as well. Use "isEnabledInHierarchy()" as
replacement.
+
+###### RadioChoice and CheckBoxMultipleChoice no longer append \<br/\> as
suffix [WICKET-5640](https://issues.apache.org/jira/browse/WICKET-5640)
+
+org.apache.wicket.markup.html.form.RadioChoice and
org.apache.wicket.markup.html.form.CheckBoxMultipleChoice use empty prefix and
suffix by default from now on.
+
+It is recommended to use CSS for styling them.
+
+To revert the old behavior for easier migration the application could use
org.apache.wicket.markup.html.form.RadioChoiceWicket6Listener and
org.apache.wicket.markup.html.form.CheckBoxMultipleChoiceWicket6Listener.
+
+These component instantiation listeners are marked as deprecated and will be
removed with Wicket 8.0.
+
+###### Button no longer silently ignores exceptions
[WICKET-5235](https://issues.apache.org/jira/browse/WICKET-5235)
+
+... when it renders its model into the value attribute.
+
+###### Improved AbstractAjaxTimerBehavior
[WICKET-5439](https://issues.apache.org/jira/browse/WICKET-5439)
+
+AbstractAjaxTimerBehavior no longer updates its hosting component when
restarted. Stopping and restarting is now possible on non-Ajax requests too.
+
+###### Check and Radio no longer render CSS class
[WICKET-5476](https://issues.apache.org/jira/browse/WICKET-5476)
+
+Check and Radio no longer generade a CSS class attribute, encoding their
group's markup id. Wicket no longer needs this - if you do, you can easily
write a suitable attribute value by yourself.
+
+###### FileParts must be parsed explicitly before trying to read them
[WICKET-5839](https://issues.apache.org/jira/browse/WICKET-5839)
+
+If a MultipartWebRequest is created manually then FileParts must be parsed
explicitly with #parseFileParts(). See
<http://wicketinaction.com/2012/11/uploading-files-to-wicket-iresource/> for
example.
+
+#### Deprecated classes/methods/fields are removed
[WICKET-5201](https://issues.apache.org/jira/browse/WICKET-5201)
+
+###### AbstractDefaultAjaxBehavior's #getSuccessHandler(),
#getFailureHandler(), #getChannel() and #getPrecondition() are removed.
+
+They were deprecated since 6.0.0 and were there only for backward
compatibility. Use #updateAjaxAttributes() to configure the same
functionalities.
+
+###### The old Tree component in wicket-extensions is removed.
+
+It was based on Swing APIs and many people complained about this. Use the new
Tree component introduced in Wicket 6.0.0 instead.
+
+###### Wicket.Window.unloadConfirmation has been removed
[WICKET-5246](https://issues.apache.org/jira/browse/WICKET-5246)
+
+In Wicket 6 a new setting has been added to ModalWindow -
org.apache.wicket.extensions.ajax.markup.html.modal.ModalWindow#showUnloadConfirmation().
In Wicket 7 the new Java API should be used instead of dealing with the
JavaScript property *Wicket.Window.unloadConfirmation*.
+
+###### AllVisitFilter has been removed.
+
+Use IVisitFilter.ANY instead.
+
+###### Label constructor with String argument has been removed
[WICKET-5201](https://issues.apache.org/jira/browse/WICKET-5201)
+
+Use Serializable argument instead.
+
+###### RangeValidator deprecated keys removed
+
+Use RangeValidator.\* instead of MinimumValidator and MaximumValidator.
+
+###### InlineFrame uses IPageProvider
[WICKET-5347](https://issues.apache.org/jira/browse/WICKET-5347)
+
+IPageLink has been removed because it was superseded by IPageProvider. Its
last usage has been removed from InlineFrame
+
+###### org.apache.wicket.markup.html.form.EnumChoiceRenderer#postprocess() is
removed [WICKET-5470](https://issues.apache.org/jira/browse/WICKET-5470)
+
+WICKET-5470 has shown that
org.apache.wicket.markup.html.form.EnumChoiceRenderer#postprocess() is not
really needed and the same can be achieved by overriding #getDisplayValue()
method and doing the processing after calling super.getDisplayValue().
+
+Additionally now the specializations of EnumChoiceRenderer can provide
completely custom implementation of #getDisplayValue().
+
+#### Using keyboard UP and DOWN keys will loop thru the AutoCompleter's
options [WICKET-5275](https://issues.apache.org/jira/browse/WICKET-5275)
+
+If the currently selected item is the first one and the user uses KEY_UP then
the selection will move to the last option. Similarly for KEY_DOWN - if the
selected option is the last one then using DOWN key will move the selection to
the first one.
+
+#### Form#findSubmittingComponent() doesn't throw exceptions for
invisible/disabled submitters
[WICKET-5672](https://issues.apache.org/jira/browse/WICKET-5672)
+
+The check whether the form submitter is invisible or disabled is moved to
Form#onFormSubmitted(). Now the applications can change the visible/enabled
state of the submitter in #onSubmit() implementations and later use
Form#findSubmittingComponent() in the application code. It is now
responsibility of the application to check whether the submitting component is
visible/enabled or not and react on this appropriately.
+
+#### Dependency updates
+
+All libraries on which Wicket modules depend are updated to their latest
stable versions.\
+The most notable ones are:
+
+- Spring Framework 4.1.x
+- Guice 4.0
+- ASM 5.x
+- CGLIB 3.1
+- SLF4J 1.7.x
+- Jetty (in the quickstart) 9.2.x