Chapter 40. Migration from older versions

40.1. Migrating from 1.0.x and 1.1-RC1

You can expect the following changes when you migrate to the latest version of RESTEasy:
  • You can now turn on RESTEasy's role-based security (@RolesAllowed) by using the new resteasy.role.based.security context-param.
  • @Wrapped is now enabled by default for Lists, Arrays, and Sets of JAXB objects. You can also change the namespace and element names with this annotation.
  • @Wrapped is not enclosed in a RESTEasy namespace prefix, and now uses the default namespace instead of the http://jboss.org/resteasy namespace.
  • @Wrapped JSON is now enclosed in a simple JSON Array.
  • Placing the resteasy-jackson-provider-xxx.jar in your classpath triggers the Jackson JSON provider. This can cause code errors if you had previously been using the Jettison JAXB/JSON providers. To fix this, you must either remove Jackson from your WEB-INF/lib or the classpath, or use the @NoJackson annotation on your JAXB classes.
  • The tjws and servlet-api artifacts are now scoped as provided in the resteasy-jar dependencies. If you have trouble with Class not found errors, you may need to scope them as provided or test in your pom files.
            <dependency>
                <groupId>javax.servlet</groupId>
                <artifactId>servlet-api</artifactId>
                <scope>provided</scope>
            </dependency>
            <dependency>
                <groupId>tjws</groupId>
                <artifactId>webserver</artifactId>
                <scope>provided</scope>
            </dependency>