3.2.5. JAX-RS- und RESTEasy-Änderungen

3.2.5.1. Konfiguration der JAX-RS- und RESTEasy-Änderungen

Die JBoss EAP 6 stellt RESTEasy automatisch ein, so dass Sie es nicht selbst konfigurieren müssen. Sie sollten daher jede bestehende RESTEasy-Konfiguration aus Ihrer web.xml-Datei entfernen und diese durch eine der folgenden drei Optionen ersetzen:
  1. Machen Sie javax.ws.rs.core.Application zur Unterklasse und verwenden Sie die @ApplicationPath-Annotation.
    Dies ist die einfachste Option und erfordert keine xml-Konfiguration. Machen Sie javax.ws.rs.core.Application einfach zu einer Unterklasse in Ihrer Applikation und und annotieren Sie sie mit dem Pfad, wo Ihre JAX-RS-Klassen verfügbar werden sollen. Zum Beispiel:
    @ApplicationPath("/mypath")
    public class MyApplication extends Application {
    }
    
    Im Beispiel oben sind Ihre JAX-RS-Ressourcen im Pfad /MY_WEB_APP_CONTEXT/mypath/ verfügbar.

    Anmerkung

    Beachten Sie, dass der Pfad als /mypath, und nicht als /mypath/* festgelegt werden sollte. Es sollten kein Schrägstrich oder Sternchen folgen.
  2. Machen Sie javax.ws.rs.core.Application zur Unterklasse und verwenden Sie die web.xml-Datei zur Einstellung des JAX-RS-Mappings.
    Falls Sie die @ApplicationPath-Annotation nicht verwenden möchten, so müssen Sie die javax.ws.rs.core.Application dennoch zur Unterklasse machen. Anschließend stellen Sie das JAX-RS-Mapping in der web.xml-Datei ein. Zum Beispiel:
    public class MyApplication extends Application {
    }
    
    <servlet-mapping>
       <servlet-name>com.acme.MyApplication</servlet-name>
       <url-pattern>/hello/*</url-pattern>
    </servlet-mapping>
    Im Beispiel oben sind die JAX-RS-Ressourcen im Pfad /MY_WEB_APP_CONTEXT/hello verfügbar.

    Anmerkung

    Sie können diese Vorgehensweise zur Außerkraftsetzung eines mittels der @ApplicationPath-Annotation eingestellten Applikationspfads verwenden.
  3. Bearbeiten Sie die web.xml-Datei.
    Falls Sie Application nicht zur Unterklasse machen wollen, so können Sie das JAX-RS-Mapping wie folgt in der web.xml-Datei einstellen:
    <servlet-mapping>
       <servlet-name>javax.ws.rs.core.Application</servlet-name>
       <url-pattern>/hello/*</url-pattern>
    </servlet-mapping>
    Im Beispiel oben sind die JAX-RS-Ressourcen im Pfad /MY_WEB_APP_CONTEXT/hello verfügbar.

    Anmerkung

    Wenn Sie diese Option wählen, so müssen Sie nur das Mapping hinzufügen. Das entsprechende Servlet müssen Sie nicht hinzufügen. Der Server ist für die automatische Hinzufügung des Servlets verantwortlich.