docs/src/main/docbook/migration.xml

<?xml version="1.0"?>
<!--

    Copyright (c) 2012, 2020 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->

<!DOCTYPE chapter [<!ENTITY % ents SYSTEM "jersey.ent" > %ents;]>
<chapter xmlns="http://docbook.org/ns/docbook"
         version="5.0"
         xml:lang="en"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xsi:schemaLocation="http://docbook.org/ns/docbook http://docbook.org/xml/5.0/xsd/docbook.xsd
                             http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd"
         xml:id="migration">
    <title>Migration Guide</title>

    <section xml:id="mig-3.0.0">
        <title>Migrating from Jersey 2.32 to &version;.</title>
        <section xml:id="mig-3.0.0-breaking-changes">
            <title>Breaking Changes</title>
            <para>
                <itemizedlist>
                    <listitem>
                        <para>
                            The most fundamental change in Jersey &version; and later is namespace change.
                            Since Jakarta EE 9 the <literal>jakarta.</literal> namespace is introduced as a replacement
                            for javax namespace from Java EE.
                        </para>
                        <para>
                            Due to required jakartification several modules where omitted (because of not satisfied dependencies).
                            Or require higher JDK (11+).
                        </para>
                        <para>
                            Spring for now is not supported.
                        </para>
                        <para>
                            Examples and tests are reduced in quantity (so you probably will not find all those examples which were available
                            in the 2.32 version).
                        </para>
                    </listitem>
                </itemizedlist>
            </para>
        </section>
        <section xml:id="mig-3.0.0-removed-deprecated">
            <title>Removed deprecated APIs</title>
            <para>
                <itemizedlist>
                    <listitem>
                        <para>
                            Jackson 1 support was removed.
                        </para>
                    </listitem>
                </itemizedlist>
            </para>
        </section>
        <section xml:id="mig-3.0.0-application-servers">
            <title>Application servers for Jersey</title>
            <para>
                At the end of the year 2020 only few application servers where supporting Jakarta EE 9.
                Those are <literal>GlassFish 6.0.0 (RCx)</literal>, <literal>Tomcat 10 (Mx)</literal> and
                <literal>Jetty 11.x (JDK 11+ required)</literal>
            </para>
        </section>
    </section>

</chapter>