What's new in version 2.4

Introduction

In the next sections, you will get a synthesis of the major changes done to the Restlet Framework in version 2.4.

Main changes

  • Java 8 requirement
  • Jetty 9.4 upgrade
    • removed SPDY protocol
  • Security fixes
    • upgrade dependencies in order to fix CVEs
      • Jetty 9.4.11.v20180605
      • Apache Fileupload 1.3.3
      • Apache commons.io 2.6
      • Apache commons-collections 3.2.2
      • Spring 3.2.8.RELEASE
      • Jackson 2.9.6
      • Apache commons httpclient 4.5.6
      • Apache solr 7.4.0
  • Removals
    • removed extensions deprecated in version 2.3: e4, JDBC, JSSLUtils, ROME, SDC, SIP, XDB, XStream.
    • deprecate extensions planned for removal in V2.5 (EMF, JAX-RS, OAuth, OpenID and RAML)
    • Eclipse p2 site won’t be maintained anymore
  • Misc
    • the Apache HTTP Client extension has been un-deprecated and will continue to be maintained as part of the V2.x branch.

Migration guide from version 2.3 to 2.4

This section intends to explain the main differences between the Restlet 2.3 and 2.4 releases and to help you migrate your existing applications. Both releases are meant to be compatible at the API level, so you should at most observe deprecate features while upgrading.

Note that if you intend to migrate directly from 1.1 to 2.4, you should really consider migrating first from 1.1 to 2.0. For migration instructions between 1.1 and 2.0, you can check this page.

Replace all JAR files

Restlet JARs and dependencies

Deprecated API features

The next step is to look at each deprecated feature and look in the Javadocs at the preferred alternative in version 2.4.