3.2.5. Changements JAX-RS et RESTEasy

3.2.5.1. Configurer les changements de JAX-RS et de RESTEasy

JBoss EAP 6 installe RESTEasy automatiquement, donc vous n'avez pas besoin de le configurer vous-même. Vous devez donc supprimer toute la configuration RESTEasy existante de votre fichier web.xml et la remplacer par l'une de ces trois options :
  1. Sous-classe de javax.ws.rs.core.Application et utiliser l'annotation @ApplicationPath.
    C'est l'option la plus simple qui ne nécessite pas de configuration xml. Il suffit de mettre javax.ws.rs.core.Application en sous-classe dans votre application et de l'annoter par le chemin d'accès où vous souhaitez rendre vos classes de JAX-RS disponibles. Par exemple : 
    @ApplicationPath("/mypath")
public class MyApplication extends Application {
}
    Dans l'exemple suivant, les ressources JAX-RS sont disponibles dans /MY_WEB_APP_CONTEXT/mypath/.

    Note

    Notez que le chemin doit être spécifié /mypath, et non pas /mypath/*. Il ne doit pas y avoir de barre oblique, ni d'astérisque.
  2. Mettre javax.ws.rs.core.Application en sous-classe et utiliser le fichier web.xml pour mettre en place le mappage de JAX-RS.
    Si vous ne souhaitez pas utiliser l'annotation @ApplicationPath, vous devrez toujours mettre javax.ws.rs.core.Application en sous-classe. Puis, mettrez en place le mappage JAX-RS dans le fichier web.xml. Ainsi : 
    public class MyApplication extends Application {
}

    <servlet-mapping>
   <servlet-name>com.acme.MyApplication</servlet-name>
   <url-pattern>/hello/*</url-pattern>
</servlet-mapping>
    Dans l'exemple ci-dessus, vos ressources JAX-RS sont disponibles dans le chemin /MY_WEB_APP_CONTEXT/hello.

    Note

    Vous pouvez également utiliser cette approche pour remplacer le chemin d'application qui était mis en place pour l'annotation @ApplicationPath.
  3. Modifier le fichier web.xml
    Si vous ne souhaitez pas mettre Application en sous-classe, vous pourrez mettre en place le mappage JAX-RS dans le fichier web.xml comme suit : 
    <servlet-mapping>
   <servlet-name>javax.ws.rs.core.Application</servlet-name>
   <url-pattern>/hello/*</url-pattern>
</servlet-mapping>
    Dans l'exemple ci-dessus, vos ressources JAX-RS sont disponibles dans le chemin /MY_WEB_APP_CONTEXT/hello.

    Note

    Quand vous choisissez cette option, vous n'avez qu'à ajouter le mappage. Vous n'avez pas besoin d'ajouter le servlet correspondant. Le serveur est responsable d'ajouter le servet correspondant automatiquement.
Rapporter un bogue