Jakarta EE Guide for Spring Developers

Jakarta EE 9 changed its package namespace from javax.* to jakarta.*. It has significant repercussions across the entire Java ecosystem, including Spring. Spring Framework 6 and Spring Boot 3, which are supported by Tomcat 10 and Jetty 11, adopt Jakarta EE 9 APIs. This session is aimed to guide Spring developers through this transition seamlessly. A live coding demonstration using a Spring application on Open Liberty will dive into the steps involved and highlight areas requiring special attention.

Transcript

1. Ivar Grimstad

   Jakarta EE Developer Advocate
   Eclipse Foundation
   Jakarta EE Guide
   
   
   for Spring Developers
   Emily Jiang

   Cloud Native Architect and Advocate,
   STSM, IBM
   

   View Slide

2. @ivar_grimstad
   https://github.com/ivargrimstad
   https://www.linkedin.com/in/ivargrimstad
   @ivar_grimstad@mastadon.social
   ivargrimstad_of
   fi
   cial
   

   View Slide

3. @emilyfhjiang
   https://github.com/Emily-Jiang
   https://www.linkedin.com/in/emilyfhjiang
   @emilyjiang@mastadon.social
   

   View Slide

4. View Slide

5. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
   Speci
   fi
   cation
   Document
   API
   TCK
   Final Speci
   fi
   cation
   Compatible
   Implementation(s)
   Speci
   fi
   

   View Slide

6. Jakarta EE 10 Web Pro
   fi
   Jakarta EE 10 Platform
   Updated
   Not Updated
   New
   Authorization 2.1
   Activation 2.1
   Batch 2.1
   Connectors 2.1
   Mail 2.1
   Messaging 3.1
   Enterprise Beans 4.0
   RESTful Web Services 3.1
   JSON Processing 2.1
   JSON Binding 3.0
   Annotations 2.1
   CDI Lite 4.0
   Interceptors 2.1
   Dependency Injection 2.0
   Servlet 6.0
   Server Pages 3.1
   Expression Language 5.0
   Debugging Support 2.0
   Standard Tag Libraries 3.0
   Faces 4.0
   WebSocket 2.1
   Enterprise Beans Lite 4.0
   Persistence 3.1
   Transactions 2.0
   Managed Beans 2.0
   CDI 4.0
   Authentication 3.0
   Concurrency 3.0
   Security 3.0
   Bean Validation 3.0
   

   View Slide

7. Jakarta EE 10 Core Pro
   fi
   Jakarta EE 10 Web Pro
   fi
   le
   Updated
   Not Updated
   New
   RESTful Web Services 3.1
   JSON Processing 2.1
   JSON Binding 3.0
   Annotations 2.1
   CDI Lite 4.0
   Interceptors 2.1
   Dependency Injection 2.0
   Servlet 6.0
   Server Pages 3.1
   Expression Language 5.0
   Debugging Support 2.0
   Standard Tag Libraries 3.0
   Faces 4.0
   WebSocket 2.1
   Enterprise Beans Lite 4.0
   Persistence 3.1
   Transactions 2.0
   Managed Beans 2.0
   CDI 4.0
   Authentication 3.0
   Concurrency 3.0
   Security 3.0
   Bean Validation 3.0
   

   View Slide

8. Jakarta EE 10 Core Pro
   fi
   le
   Updated
   Not Updated
   New
   RESTful Web Services 3.1
   JSON Processing 2.1
   JSON Binding 3.0
   Annotations 2.1
   CDI Lite 4.0
   Interceptors 2.1
   Dependency Injection 2.0
   

   View Slide

9. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
   Jakarta EE 10
   
   
   API source level: Java SE 11
   API binary level: Java SE 11
   TCK run with: Java SE 11+17
   App Developers (YOU) can use Java SE 17 features if you like!!
   

   View Slide

10. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    How is this Relevant
    
    
    to
    ?
    

    View Slide

11. javax.* -> jakarta.*
    

    View Slide

12. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    builds on
    

    View Slide

13. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    javax.* -> jakarta.*
    

    View Slide

14. Authorization 2.1
    Activation 2.1
    Batch 2.1
    Connectors 2.1
    Mail 2.1
    Messaging 3.1
    Enterprise Beans 4.0
    RESTful Web Services 3.1
    JSON Processing 2.1
    JSON Binding 3.0
    Annotations 2.1
    CDI Lite 4.0
    Interceptors 2.1
    Dependency Injection 2.0
    Servlet 6.0
    Server Pages 3.1
    Expression Language 5.0
    Debugging Support 2.0
    Standard Tag Libraries 3.0
    Faces 4.0
    WebSocket 2.1
    Enterprise Beans Lite 4.0
    Persistence 3.1
    Transactions 2.0
    Managed Beans 2.0
    CDI 4.0
    Authentication 3.0
    Concurrency 3.0
    Security 3.0
    Bean Validation 3.0
    Jakarta EE 10 Web Pro
    fi
    le
    Updated
    Not Updated
    New
    

    View Slide

15. Hibernate ORM
    

    View Slide

16. UUID as Basic Java Type
    @Entity
    
    
    public class Item {
    
    
    
    
    @Id
    
    
    @GeneratedValue(strategy=GenerationType.UUID)
    
    
    private java.util.UUID id;
    
    
    private String description;
    
    
    …
    
    
    }
    

    View Slide

17. Authorization 2.1
    Activation 2.1
    Batch 2.1
    Connectors 2.1
    Mail 2.1
    Messaging 3.1
    Enterprise Beans 4.0
    RESTful Web Services 3.1
    JSON Processing 2.1
    JSON Binding 3.0
    Annotations 2.1
    CDI Lite 4.0
    Interceptors 2.1
    Dependency Injection 2.0
    Servlet 6.0
    Server Pages 3.1
    Expression Language 5.0
    Debugging Support 2.0
    Standard Tag Libraries 3.0
    Faces 4.0
    WebSocket 2.1
    Enterprise Beans Lite 4.0
    Persistence 3.1
    Transactions 2.0
    Managed Beans 2.0
    CDI 4.0
    Authentication 3.0
    Concurrency 3.0
    Security 3.0
    Bean Validation 3.0
    Jakarta EE 10 Platform
    Updated
    Not Updated
    New
    

    View Slide

18. Hibernate Validator
    

    View Slide

19. Authorization 2.1
    Activation 2.1
    Batch 2.1
    Connectors 2.1
    Mail 2.1
    Messaging 3.1
    Enterprise Beans 4.0
    RESTful Web Services 3.1
    JSON Processing 2.1
    JSON Binding 3.0
    Annotations 2.1
    CDI Lite 4.0
    Interceptors 2.1
    Dependency Injection 2.0
    Servlet 6.0
    Server Pages 3.1
    Expression Language 5.0
    Debugging Support 2.0
    Standard Tag Libraries 3.0
    Faces 4.0
    WebSocket 2.1
    Enterprise Beans Lite 4.0
    Persistence 3.1
    Transactions 2.0
    Managed Beans 2.0
    CDI 4.0
    Authentication 3.0
    Concurrency 3.0
    Security 3.0
    Bean Validation 3.0
    Jakarta EE 10 Platform
    Updated
    Not Updated
    New
    

    View Slide

20. Eclipse Jetty Apache Tomcat
    

    View Slide

21. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Demo
    

    View Slide

22. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    New Spring App
    Scenario 1
    

    View Slide

23. Spring Boot 3
    
    
    +
    
    
    Tomcat 9
    duke-spring
    Spring Boot 3
    
    
    +
    
    
    Tomcat 10
    duke-spring
    

    View Slide

24. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Upgrade Spring App
    Scenario 2
    

    View Slide

25. Spring Boot 2 Spring Boot 3
    duke-boot
    duke-boot
    

    View Slide

26. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    javax.* -> jakarta.*
    

    View Slide

27. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    IDE
    

    View Slide

28. View Slide

29. docs.openrewrite.org/recipes/java/migrate/jakarta
    

    View Slide

30. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    1. Update Spring version in pom.xml
    
    
    2. Update Jakarta EE version in pom.xml
    
    
    3. Fix the imports
    

    

    

    

    https://github.com/ivargrimstad/jakartaee-spring
    

    View Slide

31. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Upgrade Spring App
    Scenario 3
    with Dependencies
    

    View Slide

32. Spring Boot 2
    duke-boot
    duke-dep
    Spring Boot 3
    duke-boot
    duke-dep
    

    View Slide

33. duke-dep
    Source
    

    View Slide

34. Spring Boot 2
    duke-boot
    duke-dep
    Spring Boot 3
    duke-boot
    duke-dep
    2.0
    1.0
    

    View Slide

35. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    1. Update Spring version in pom.xml
    
    
    2. Update Jakarta EE version in pom.xml
    
    
    3. Fix the imports
    
    
    4. Repeat for Dependencies
    

    

    

    https://github.com/ivargrimstad/jakartaee-spring
    

    View Slide

36. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Upgrade Spring App
    Scenario 4
    with External Dependencies
    

    View Slide

37. Spring Boot 2
    duke-boot
    duke-dep duke-lib
    Spring Boot 3
    duke-boot
    duke-dep duke-lib
    

    View Slide

38. Source
    duke-dep
    Source
    duke-lib
    

    View Slide

39. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Transformation
    

    View Slide

40. Eclipse Transformer Apache Tomcat Migration Tool
    b.com/eclipse/transformerhttps://tomcat.apache.org/download-migration.cgi
    

    View Slide

41. Spring Boot 2
    duke-boot
    duke-dep duke-lib
    Spring Boot 3
    duke-boot
    duke-dep duke-lib
    2.0
    1.0 2.0
    1.0
    

    View Slide

42. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    1. Update Spring version in pom.xml
    
    
    2. Update Jakarta EE version in pom.xml
    
    
    3. Fix the imports
    
    
    4. Repeat for Dependencies
    
    
    5. Transform Libraries if necessary
    

    

    https://github.com/ivargrimstad/jakartaee-spring
    

    View Slide

43. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Additional Migration
    Steps
    

    View Slide

44. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    1. Update Spring version in pom.xml
    
    
    2. Update Jakarta EE version in pom.xml
    
    
    3. Fix the imports
    
    
    4. Repeat for Dependencies
    
    
    5. Transform Libraries if necessary
    
    
    6. Rename properties pre
    fi
    xed with javax
    
    
    7. Verify data and dynamic content
    https://github.com/ivargrimstad/jakartaee-spring
    

    View Slide

45. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Open Liberty
    

    View Slide

46. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Why is Spring Boot and Open
    Liberty a Good Combination?
    

    View Slide

47. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Open Liberty supports
    
    
    Spring Boot 1.5, 2.0
    

    View Slide

48. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Open Liberty 23.0.0.8-beta
    supports Spring Boot 3.0
    https://openliberty.io/blog/2023/08/03/23.0.0.8-beta.html
    

    View Slide

49. View Slide

50. View Slide

51. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Demo
    

    View Slide

52. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Beyond 10
    

    View Slide

53. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Jakarta EE 11
    Coming H1, 2024
    

    View Slide

54. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Release Cadence
    

    View Slide

55. COPYRIGHT (C) 2022, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Jakarta Data
    Standardizes the repository pattern for data access
    https://jakarta.ee/speci
    fi
    cations/
    NEW
    in
    Jakarta EE 11
    

    View Slide

56. COPYRIGHT (C) 2022, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Jakarta NoSQL
    Standardizes integration with NoSQL databases
    https://jakarta.ee/speci
    fi
    cations/nosql/
    Standalone
    

    View Slide

57. COPYRIGHT (C) 2022, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Jakarta RPC
    Standardizes gRPC within Jakarta EE
    https://jakarta.ee/speci
    fi
    cations/rpc/
    Standalone
    

    View Slide

58. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Jakarta EE 11
    
    
    API source level: Java SE 17 or 21
    API binary level: Java SE 17 or 21
    TCK run with: Java SE 21
    Work in
    Progress
    

    View Slide

59. COPYRIGHT (C) 2022, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    Summary
    

    View Slide

60. Jakarta EE 10 Platform
    Updated
    Not Updated
    New
    Authorization 2.1
    Activation 2.1
    Batch 2.1
    Connectors 2.1
    Mail 2.1
    Messaging 3.1
    Enterprise Beans 4.0
    RESTful Web Services 3.1
    JSON Processing 2.1
    JSON Binding 3.0
    Annotations 2.1
    CDI Lite 4.0
    Interceptors 2.1
    Dependency Injection 2.0
    Servlet 6.0
    Server Pages 3.1
    Expression Language 5.0
    Debugging Support 2.0
    Standard Tag Libraries 3.0
    Faces 4.0
    WebSocket 2.1
    Enterprise Beans Lite 4.0
    Persistence 3.1
    Transactions 2.0
    Managed Beans 2.0
    CDI 4.0
    Authentication 3.0
    Concurrency 3.0
    Security 3.0
    Bean Validation 3.0
    

    View Slide

61. Jakarta EE 10 Core Pro
    fi
    le
    Updated
    Not Updated
    New
    RESTful Web Services 3.1
    JSON Processing 2.1
    JSON Binding 3.0
    Annotations 2.1
    CDI Lite 4.0
    Interceptors 2.1
    Dependency Injection 2.0
    

    View Slide

62. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    How is Relevant
    
    
    to
    

    View Slide

63. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    builds on
    

    View Slide

64. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    javax.* -> jakarta.*
    

    View Slide

65. COPYRIGHT (C) 2023, ECLIPSE FOUNDATION, INC. | THIS WORK IS LICENSED UNDER A CREATIVE COMMONS ATTRIBUTION 4.0 INTERNATIONAL LICENSE (CC BY 4.0)
    1. Update Spring version in pom.xml
    
    
    2. Update Jakarta EE version in pom.xml
    
    
    3. Fix the imports
    
    
    4. Repeat for Dependencies
    
    
    5. Transform Libraries if necessary
    
    
    6. Rename properties pre
    fi
    xed with javax
    
    
    7. Verify data and dynamic content
    https://github.com/ivargrimstad/jakartaee-spring
    

    View Slide

66. Jakarta EE
    https://jakarta.ee
    Jakartablogs

    https://jakartablogs.ee/
    Ivar’s Hashtag Jakarta EE
    https://www.agilejava.eu/category/jakarta-ee/
    Demo Code
    https://github.com/ivargrimstad/jakartaee-spring
    

    View Slide

67. View Slide

68. Jakarta EE Overview
    Course available on
    

    View Slide