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:
- 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 ojavax.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. - Sub-classifique
javax.ws.rs.core.Application
e use o arquivoweb.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 ojavax.ws.rs.core.Application
. Você então irá configurar o mapeamento JAX-RS no arquivoweb.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
. - Modificação do arquivo
web.xml
.Caso você deseje sub-classificar oApplication
, você pode configurar o mapeamento JAX-RS no arquivoweb.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.