This is an automated email from the ASF dual-hosted git repository.

dashorst pushed a commit to branch wicket-10.x
in repository https://gitbox.apache.org/repos/asf/wicket.git


The following commit(s) were added to refs/heads/wicket-10.x by this push:
     new e52b50e1b7 Add the Wicket 10 migration guide from the wiki
e52b50e1b7 is described below

commit e52b50e1b7f8338e47b3215e301f160aed34fadd
Author: Martijn Dashorst <[email protected]>
AuthorDate: Wed Nov 4 08:21:53 2026 +0100

    Add the Wicket 10 migration guide from the wiki
    
    The migration guides move from the wiki into the source tree of their
    release line. This adds migration-to-10.md, converted from the wiki page
    "Migration to Wicket 10.0" (version 13, last edited 2023-10-16):
    
      https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=181308033
    
    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-10.md | 93 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)

diff --git a/migration-to-10.md b/migration-to-10.md
new file mode 100644
index 0000000000..77802d77a6
--- /dev/null
+++ b/migration-to-10.md
@@ -0,0 +1,93 @@
+<!--
+   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 10
+
+The main topic in Wicket 10 is the migration from Javax APIs to Jakarta APIs.
+
+As a result Wicket upgraded its dependency of Spring Framework to 6.x which 
also led to requirement to use Java 17 for building and running Wicket 
applications.
+
+## Automatic migration
+
+#### Add migration recipes to Wicket 10 
[WICKET-7029](https://issues.apache.org/jira/browse/WICKET-7029)
+
+Apache Wicket 10 provides automatic migration based on 
[OpenRewrite](https://docs.openrewrite.org/).
+
+Usage:
+
+*Maven command*
+
+```text
+mvn -U org.openrewrite.maven:rewrite-maven-plugin:run 
-Drewrite.recipeArtifactCoordinates=org.apache.wicket:wicket-migration:LATEST 
-DactiveRecipes=org.apache.wicket.BestPractices
+```
+
+## **TODO**
+
+#### Use stable version of Commons FileUpload 
[FILEUPLOAD-309](https://issues.apache.org/jira/browse/FILEUPLOAD-309)
+
+#### Re-enable cdi-unit tests once there is a new release 
[cdi-unit#195](https://github.com/cdi-unit/cdi-unit/issues/195)
+
+## **Changes**
+
+#### WicketTester and related classes have been extracted to wicket-tester 
Maven module [WICKET-7072](https://issues.apache.org/jira/browse/WICKET-7072)
+
+TL;DR: Add *org.apache.wicket:wicket-tester* as a test dependency to your 
project and fix the imports in your project.
+
+Until now WicketTester class was a member of the wicket-core module. But it 
depends on JUnit to do its job and this caused problems in JPMS (Java 9+ 
modules) because JPMS does not support optional dependencies like Maven/Gradle 
do. For this reason WicketTester and the other \*\*Tester classes have been 
extracted to a new Maven/JPMS module - ***wicket-tester***. Same is valid for 
WebSocketTester - it has been moved to ***wicket-web-socket-tester*** module,
+
+#### wicket-http2 module have been merged to wicket-core module 
[WICKET-6887](https://issues.apache.org/jira/browse/WICKET-6887)
+
+Since Wicket 10.0 requires Servlet 5.0+ the HTTP2 PushBuilder abstraction has 
been moved from wicket-experimental/wicket-http2/wicket-http2-servlet4 and 
wicket-http2-core to wicket-core module.
+
+PushHeaderItem class has been moved to package 
*org.apache.wicket.markup.head.http2*.
+
+#### Render MarkupContainer class name as an attribute 
[WICKET-6890](https://issues.apache.org/jira/browse/WICKET-6890)
+
+When 
org.apache.wicket.settings.DebugSettings#isOutputMarkupContainerClassName() 
returns *true* then the MarkupContainer class name should be rendered as an 
attribute of the component tag instead of as an HTML comment because an HTML 
comment may break a CSS rule, e.g. by appearing between two sibling HTML 
elements.
+
+For example:
+
+With CSS rule like *p + p {color: red;}* then the text color of any paragraph 
that follows another paragraph will be red. But if an HTML comment appears 
between them then the rule won't apply.
+
+#### Make ApplicationContextMock smarter by delegating to 
DefaultListableBeanFactory 
[WICKET-6893](https://issues.apache.org/jira/browse/WICKET-6893)
+
+ApplicationContextMock now uses internally an instance of 
DefaultListableBeanFactory and this way it implements almost all methods of 
Spring's ApplicationContext. In addition ApplicationContextMock now extends 
from Spring's AbstractApplicationContext and thus could be used fully in 
AnnotProxyFieldValueFactory and SpringBeanLocator.
+
+#### Replace CGLib with ByteBuddy 
[WICKET-6913](https://issues.apache.org/jira/browse/WICKET-6913)
+
+Wicket used CGLib for creating serializable proxies for classes. CGLib is not 
well maintained since several years and it does not work with JDK 17 where 
illegal access is no more allowed. For this reason it usage has been replaced 
with ByteBuddy library.
+
+This is a change in implementation in wicket-ioc module, without API changes 
for the end-user applications!
+
+## **Dependencies**
+
+#### Wicket 10 requires Java 17
+
+#### Wicket 10 requires Servlet 5+
+
+I.e. Jakarta APIs
+
+#### Spring Framework to 6.x 
[WICKET-6940](https://issues.apache.org/jira/browse/WICKET-6940)
+
+#### Guice to 7.x
+
+Upgrade Guice to 7.0.0 
[WICKET-7053](https://issues.apache.org/jira/browse/WICKET-7053)
+
+#### Commons Fileupload to 2.x 
[WICKET-6915](https://issues.apache.org/jira/browse/WICKET-6915)
+
+#### Jackson to 2.13.x
+
+Upgrade Jackson to 2.13.4 
[WICKET-7009](https://issues.apache.org/jira/browse/WICKET-7009)

Reply via email to