What's new in version 2.3

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 7 requirement
- better performance, security, network
- modern Javadoc style
- ensure core can still compile with Java 6 (Android and GWT compatibility)
- support for GWT 2.7
Web API documentation and management
- integration with online APISpark platform
- integration with API description languages (Swagger, RAML)
- introspection of various Java APIs for REST (Restlet API, JAX-RS API)
Jetty 9.2 upgrade
- client connector
- SPDY protocol
Restlet API refactoring
- support exceptions conversion
- direct access to raw HTTP headers
- remove ‘public’ qualifier from interface methods
- CORS (Cross-Origin Resource Sharing) headers support
Removals
- Windows installers
- Tanuki Service Wrapper configuration and files
- CDDL and LGPL licensing options (kept Apache and EPL)
- deprecate extensions planned for removal in V3.0 (e4, JDBC, JiBX, jSSLUtils, ROME, SIP, WebDAV, XDB, XStream)

Migration guide from version 2.2 to 2.3

This section intends to explain the main differences between the Restlet 2.2 and 2.3 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.3, 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.3.