Show TOC

HintergrundProgrammierschnittstelle Dieses Dokument in der Navigationsstruktur finden

 

Für den Einsatz der Konfigurationsdaten aus Tabelle HTTPURLLOC steht eine einfache Programmierschnittstelle zur Verfügung. Das Interface IF_HTTP_SERVER (das in der Klasse CL_HTTP_SERVER implementiert ist) wurde um zwei Funktionen erweitert.

GET_LOCATION_EXCEPTION

Parameter

Art

Typisierungsart

Bezugstyp

PROTOCOL

Importing

Type

CSEQUENCE

APPLICATION

Importing

Type

CSEQUENCE

FOR_DOMAIN

Importing

Type

CSEQUENCE

SERVER

Importing

Type Ref To

IF_HTTP_SERVER

HOST

Exporting

Type

STRING

PORT

Exporting

Type

STRING

OUT_PROTOCOL

Exporting

Type

STRING

Die Methode GET_LOCATION ist eine Wrapper-Funktion für GET_LOCATION_EXCEPTION. Sie ruft zuerst das Ausnahme-Coding auf. Wird kein Wert zurückgegeben, verwendet sie den Standard AS-ABAP Namen und die Standard-Port-Konfiguration für die angeforderten Daten.

Parameter

Parameter

Beschreibung

PROTOCOL

Protokoll, für das die Daten benötigt werden. Es kann entweder HTTP (Standardwert) oder HTTPS sein.

Dieser Parameter ist optional.

Wird er nicht angegeben, und wenn das Server-Objekt verfügbar ist, dann wird die Abfrage auf das zu verwendende Protokoll durchgeführt.

APPLICATION

Anwendungsname, für die die URL generiert werden soll. Dieser Name wird gegen das Muster in HTTPURLLOC-APPLICATN gematcht.

Dieser Parameter ist optional

Dieser Parameter wird nur dann benötigt, wenn verschiedene Host- und Port-Angaben, abhängig von der Anwendung, konfiguriert sind. Für die BSP-Laufzeit wird /BSP/<namespace>/<application> verwendet.

FOR_DOMAIN

Dieser Parameter wird gegen das Muster in HTTPURLLOC-FOR_DOMAIN gematcht.

Dieser Parameter ist optional.

Wir empfehlen, diesen Parameter nicht mit einem Wert zu belegen.

SERVER

Dies ist eine Referenz auf das Server-Objekt, das verfügbar ist, wenn die Anwendung im Kontext eines eingehenden HTTP-Requests läuft. Dadurch kann der Matching-Algorithmus den Host-Header aus dem Request extrahieren und ihn als zusätzliches Kriterium für das Matchen gegen das HTTPURLLOC-HOST Feld verwenden.

Dieser Parameter ist optional.

Trotzdem empfehlen wir, dieses Feld immer anzugeben.

HOST

Dies ist der zurückgegebene Host-Name, der für die Generierung der voll spezifizierten URL verwendet werden soll. Wenn eine Eingabe gematcht wird, dann gibt dies den Wert von HTTPURLLOC-HOST, sonst bleibt dieser Parameter initial.

PORT

Dies ist wie der Wert von HTTPURLLOC-PORT

OUT_PROTOCOL

Dieser Parameter matcht das angeforderte importierende Protokoll-Feld, wenn es angegeben ist. Wenn jedoch die voll spezifizierte URL nicht benötigt wird, um ein Protokoll-Umschalten durchzuführen, sondern um bestimmte Ressourcen zu laden, empfehlen wir, den importierenden Protokoll-Parameter nicht zu setzen. Geben Sie stattdessen das Server-Objekt an. Anhand des Server-Objektes wird festgestellt, welches Protokoll gerade im Einsatz ist, und dann wird diese Angabe weiter verwendet. Der Algorithmus ist auch für die Fälle, wenn der Browser mit HTTPS mit einem reversen Proxy-Server kommuniziert und wenn HTTP für den AS-ABAP verwendet wird.

Hinweis Hinweis

Beachten Sie, dass diese Methoden in einer sehr tiefen Schicht integriert sind. Es wird nicht garantiert, dass sie in jedem Fall und von allen unterschiedlichen Frameworks aufgerufen werden. Für BSP wurde die Methode CONSTRUCT_BSP_URL für den Einsatz dieser Programmierschnittstelle erweitert.

Ende des Hinweises.