Programmierschnittstelle 

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

·        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 die /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

Server 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

Host 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

Port 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.

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.