Generierung von WADL-Dokumenten für HTTP-OPTIONS-Anforderungen inaktivieren

Ein Entwickler kann entscheiden, dass ein WADL-Dokument nicht für eine Ressource verfügbar gemacht werden soll, damit keine Informationen zum Service zugänglich werden. Informationen zum Service können besser über ein Dokument, das vom Entwickler außerhalb des Service bereitgestellt wird, abgerufen werden.

Informationen zu diesem Vorgang

Standardmäßig können Sie ein WADL-Dokument für eine bestimmte Ressource anfordern, indem Sie eine HTTP-OPTIONS-Anforderung für einen JAX-RS-URL (Java™ API for RESTful Web Services) aufrufen. Sie können eine OPTIONS-Anforderung mit den meisten HTTP-Clients absetzen. Wenn Sie dieses Verhalten nicht wünschen und standardmäßig nur ein leeres Dokument für OPTIONS-Anforderungen zurückgeben möchten, können Sie die Standard-WADL-Generierung für Ihre Anwendung inaktivieren.

Im folgenden Beispiel können Sie die Standard-WADL-Generierung für Ihre Anwendung inaktivieren.

Vorgehensweise

  1. Erstellen Sie eine Eigenschaftendatei, die die angepassten Eigenschaften für die Anwendung enthält. Das folgende Beispiel veranschaulicht eine einfache Eigenschaftendatei:
    org.apache.wink.server.options.handler=none
  2. Stellen Sie die Eigenschaftendatei in Ihre Anwendung.
  3. Verwenden Sie den Initialisierungsparameter propertiesLocation in der Datei web.xml. Das folgende Beispiel veranschaulicht eine Datei web.xml mit dem Initialisierungsparameter propertiesLocation.
    <?xml version="1.0" encoding="UTF-8"?>
    
    <web-app xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/
    j2ee/web-app_3_0.xsd"
        version="3.0">
        <servlet>
            <servlet-name>javax.ws.rs.core.Application</servlet-name>
            <load-on-startup>1</load-on-startup>
            <init-param>
                <param-name>propertiesLocation</param-name>
                <param-value>path/to/file.properties</param-value>
            </init-param>
          </servlet>    <servlet-mapping>
            <servlet-name>javax.ws.rs.core.Application</servlet-name>
            <url-pattern>/*</url-pattern>
        </servlet-mapping>
    </web-app>

Ergebnisse

Sie haben die Standard-WADL-Generierung für Ihre Anwendung inaktiviert.


Symbol, das den Typ des Artikels anzeigt. Taskartikel



Symbol für Zeitmarke Letzte Aktualisierung: 25.05.2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_jaxrs_wadl_http_options
Dateiname:twbs_jaxrs_wadl_http_options.html