Rest.li 2.x upgrade instructions

Introduction

Rest.li 2.0 introduces a new backwards incompatible URI format, as well as removes several APIs that have been marked as deprecated for quite some time. This page documents the steps needed to upgrade from a 1.x release to a 2.x release.

Source code changes

Here are the steps you need to take to make your source code compatible with Rest.li 2.x:

1. Upgrade to the latest version of Rest.li 1.x
2. Compile your code with deprecation warnings turned on. This is typically done by setting the -Xlint:deprecation flag when using javac.
3. Fix all the deprecation warnings related to Rest.li APIs. Almost all APIs marked deprecated in Rest.li 1.x are removed in Rest.li 2.x. To do this, look at the Javadoc for the deprecated API to find out which non-deprecated method to use instead.

Protocol changes

Deployment ordering