3.2.5. Alterações JAX-RS e RESTEasy
3.2.5.1. Configuração das Alterações JAX-RS e RESTEasy
O JBoss EAP 6 automaticamente configura o RESTEasy, de forma que não é necessário configurá-lo. Portanto, a configuração RESTEasy existente de seu arquivo
web.xml deve ser removida por completo e substituí-la por uma das três opções abaixo:
- Subclassifique o
javax.ws.rs.core.Applicatione use a anotação@ApplicationPath.Esta é a opção mais fácil e não requer qualquer configuração xml. Apenas subclassifique ojavax.ws.rs.core.Applicationem 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/mypathe não/mypath/*. Não deve ter nenhum asterísco ou barra. - Subclassifique
javax.ws.rs.core.Applicatione use o arquivoweb.xmlpara configurar o mapeamento JAX-RS.Caso não deseje usar a anotação@ApplicationPath, será necessário subclassificar da mesma forma ojavax.ws.rs.core.Application. Então, será necessário 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/hellodo caminho.Nota
É possível 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 deseje subclassificar oApplication, é possível 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/hellodo caminho.Nota
Caso escolha esta opção, será necessário apenas adicionar o mapeamento. Não é necessário adicionar o servlet correspondente. O servidor é responsável pela adição do servlet correspondente automaticamente.