JAX-RS-Laufzeitumgebung inaktivieren
Einige Fälle erfordern die Inaktivierung der Laufzeitumgebung von Java™ API for RESTful Web Services (JAX-RS). Wenn die JAX-RS-Laufzeitumgebung inaktiviert ist, sind JAX-RS-Features nicht verfügbar, einschließlich Basisfunktionen der JAX-RS-Laufzeit, EJB-Laufzeitintegration, JCDI-Laufzeitintegration und Servlet-3.0-Web-Container-Integration.
Informationen zu diesem Vorgang
Die Inaktivierung der JAX-RS-Laufzeitumgebung hat zur Folge, dass alle Anwendungsverarbeitungen im Zusammenhang mit JAX-RS, einschließlich die Verarbeitung von Klassen mit gescannten JAX-RS-Annotationen, EJB-Metadaten und JCDI-Bean-Aktivierung, nicht mehr ausgeführt werden. Die JAX-RS-Laufzeitumgebung wird nicht für die Verarbeitung von Anforderungen an den und Antworten vom Web-Container verwendet.

Die expliziten Verbindungspunkte zur IBM® JAX-RS-Laufzeitumgebung sind die Servletklasse com.ibm.websphere.jaxrs.server.IBMRestServlet und die Filterklasse com.ibm.websphere.jaxrs.server.IBMRestFilter. Wenn Sie diese Klassen als Servletklasse oder Servletfilter in der Datei web.xml des Webmoduls angegeben haben, wird die IBM JAX-RS-Laufzeitumgebung für die Verarbeitung der Anforderungen für dieses Servlet verwendet.
Wenn Sie die JAX-RS-Laufzeitumgebung dahingehend inaktivieren möchten, ersetzen Sie diese Klassen durch eine beliebige andere Servlet- oder Filterklasse, die die erwarteten Anforderungen an das Servlet bearbeiten kann, oder entfernen Sie das Servlet vollständig aus der Datei web.xml.

Auch wenn Sie die Klassen com.ibm.websphere.jaxrs.server.IBMRestServlet bzw. com.ibm.websphere.jaxrs.server.IBMRestFilter nicht explizit verwenden, kann es sein, dass die JAX-RS-Laufzeitumgebung die Anwendung weiterhin verarbeitet. Wenn beispielsweise die Datei web.xml eines Webmoduls auf Servlet 3.0 basiert und die entsprechenden Bedingungen gemäß der JSR-311-Spezifikation erfüllt sind, verarbeitet die JAX-RS-Laufzeitumgebung gescannte Klassen mit JAX-RS-Annotationen und könnte ein Servlet injizieren, das Anforderungen an die JAX-RS-Ressourcen in der Anwendung verarbeiten kann.
Wenn Sie diese und andere Funktionen, wie z. B. EJB- und JCDI-Integration, inaktivieren möchten, setzen Sie die angepasste JVM-Eigenschaft com.ibm.websphere.jaxrs.server.DisableIBMJAXRSEngine im Anwendungsserver auf den Wert true.
Vorgehensweise
Ergebnisse
Die Verarbeitung Ihrer Anwendung durch die JAX-RS-Laufzeitumgebung ist jetzt inaktiviert.