3.2.5. Alterações em JAX-RS e RESTEasy

3.2.5.1. Configuração das Alterações em JAX-RS e RESTEasy

O JBoss EAP 6 configura automaticamente o RESTEasy para que você não precise configurá-lo. Portanto, toda a configuração RESTEasy existente de seu arquivo web.xml deve ser removida por completo e substituída por uma das três opções abaixo:
  1. Subclassifique javax.ws.rs.core.Application e use a anotação @ApplicationPath.
    Esta é a opção mais fácil e não requer qualquer configuração xml. Simplesmente crie uma subclasse javax.ws.rs.core.Application em seu aplicativo e anote-a com o caminho onde deseja disponibilizar as suas classes JAX-RS. Por exemplo:
    @ApplicationPath("/mypath")
    public class MyApplication extends Application {
    }
    
    No exemplo acima, os seus recursos JAX-RS estão disponíveis no caminho /MY_WEB_APP_CONTEXT/mypath/.

    Nota

    Observe que o caminho deve ser especificado como /mypath e não, /mypath/*, sem barra ou asterisco.
  2. Subclassifique javax.ws.rs.core.Application e use o arquivo web.xml para configurar o mapeamento JAX-RS.
    Caso não deseja usar a anotação @ApplicationPath, ainda será necessário subclassificar javax.ws.rs.core.Application. E, então, será necessário configurar o mapeamento JAX-RS no arquivo web.xml. Por exemplo:
    public class MyApplication extends Application {
    }
    
    <servlet-mapping>
       <servlet-name>com.acme.MyApplication</servlet-name>
       <url-pattern>/hello/*</url-pattern>
    </servlet-mapping>
    No exemplo acima, os seus recursos JAX-RS estão disponíveis no caminho /MY_WEB_APP_CONTEXT/hello.

    Nota

    É possível usar também esta abordagem para substituir um caminho de aplicativo que foi configurado usando a anotação @ApplicationPath.
  3. Modifique o arquivo web.xml.
    Caso deseja subclassificar o Application, é possível configurar o mapeamento JAX-RS no arquivo web.xml, como a seguir:
    <servlet-mapping>
       <servlet-name>javax.ws.rs.core.Application</servlet-name>
       <url-pattern>/hello/*</url-pattern>
    </servlet-mapping>
    No exemplo acima, os seus recursos JAX-RS estão disponíveis no caminho /MY_WEB_APP_CONTEXT/hello.

    Nota

    Quando esta opção é escolhida, é necessário apenas adicionar o mapeamento. Não é necessário adicionar o servlet correspondente. O servidor é responsável por adicionar o servlet correspondente automaticamente.