3.2.4. Alterações JAX-RS e RESTEasy

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

O JBoss Enterprise Application Plataform automaticamente configura o RESTEasy, de forma que você não precisa configurá-lo. Portanto, você deve remover toda configuração RESTEasy existente de seu arquivo web.xml e substituí-la por uma das três opções abaixo:

  1. Sub-classifique o 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. Apenas sub-classifique o javax.ws.rs.core.Application em seu aplicativo e anote-o com o caminho que deseja para disponibilizar as classes JAX-RS. Por exemplo:
    @ApplicationPath("/mypath")
    public class MyApplication extends Application {
    }
    
    Na amostra acima, os seus recursos JAX-RS estão disponíveis no caminho /MY_WEB_APP_CONTEXT/mypath/.

    Nota

    Perceba que o caminho deve ser especificado como /mypath e não /mypath/*. Não deve ter nenhum asterísco ou barra.
  2. Sub-classifique javax.ws.rs.core.Application e use o arquivo web.xml para configurar o mapeamento JAX-RS.
    Caso você não deseje usar a anotação @ApplicationPath, você terá que sub-classificar da mesma forma o javax.ws.rs.core.Application. Você então irá 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>
    
    Na amostra acima, os seus recursos JAX-RS estão disponíveis no /MY_WEB_APP_CONTEXT/hello do caminho.

    Nota

    Você pode usar também esta abordagem para substituir um caminho de aplicativo que foi configurado usando a anotação @ApplicationPath.
  3. Modificação do arquivo web.xml.
    Caso você deseje sub-classificar o Application, você pode configurar o mapeamento JAX-RS no arquivo web.xml, conforme abaixo:
    <servlet-mapping>
       <servlet-name>javax.ws.rs.core.Application</servlet-name>
       <url-pattern>/hello/*</url-pattern>
    </servlet-mapping>
    
    Na amostra acima, os seus recursos JAX-RS estão disponíveis no /MY_WEB_APP_CONTEXT/hello do caminho.

    Nota

    Caso você escolha esta opção, você precisará apenas adicionar o mapeamento. Você não precisa adicionar o servlet correspondente. O servidor é responsável pela adição do servlet correspondente automaticamente.