Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen
Sie können Code in Programmiersprachen wie JavaScript, Java und Python hinzufügen und dann von anderen Teilen eines API-Proxys auf diesen Code zugreifen. Unterstützung für prozeduralen Code soll Ihnen die Implementierung einer komplexen Verarbeitung von Flussvariablen, Fehlern sowie Anfrage- und Antworttexten erleichtern.
Mit proaktivem Code können Sie Folgendes tun:
- Erstellen oder ändern komplexer Textwerte wie Anfrage- und Antwortwerte.
- URLs umbenennen, z. B. um eine Ziel-Endpunkt-URL zu maskieren
- Hinzufügen weiterer Logik, die in den enthaltenen Richtlinien nicht enthalten ist.
Funktionsweise
Sie verwenden eine Richtlinie speziell für die Sprache, um Aufrufe von einem Proxyfluss an den enthaltenen Code zu senden. Für jede der unterstützten Sprachen enthält Apigee Edge eine separate Richtlinie: JavaScript-Richtlinie, Java-Callout-Richtlinie und Python-Skriptrichtlinie.
Im Folgenden wird dies allgemein beschrieben. Weitere Informationen finden Sie in den Richtlinienreferenzen.
- Schreiben Sie den Code, den Sie verwenden möchten, in einer separaten Datei.
- Fügen Sie in Ihrem Code das Ergebnis der Codeverarbeitung in eine Apigee Edge-Ablaufvariable ein.
Der Variablenwert wird an einer anderen Stelle in Ihrem API-Proxy abgerufen. Weitere Informationen zu Flussvariablen finden Sie unter Proxystatus mit Ablaufvariablen verwalten.
- Fügen Sie Ihre Datei (oder JAR) als Ressourcendatei zu Ihrem API-Proxy hinzu.
Weitere Informationen zu Ressourcendateien finden Sie unter Ressourcendateien.
- Fügen Sie die Richtlinie für die von Ihnen verwendete Sprache hinzu.
Konfigurieren Sie die Richtlinie, um Ihren Code von der gewünschten Stelle im Ablauf des API-Proxys aus aufzurufen.
- Mit einer Richtlinie können Sie den Wert des Codes aus der Flussvariablen abrufen.
Beschränkungen
Das Apigee Edge-Sicherheitsmodell erlaubt keine Systemaufrufe wie Netzwerk-E/A, Lese-/Schreibvorgänge im Dateisystem, aktuelle Nutzerinformationen, Prozessliste und CPU-/Speicherauslastung. Auch wenn einige dieser Aufrufe funktional sein können, werden sie nicht unterstützt und können jederzeit deaktiviert werden. Aus Gründen der Aufwärtskompatibilität sollten Sie solche Aufrufe im Code vermeiden.
Für jede unterstützte Sprache können weitere Einschränkungen bestehen, wie in der entsprechenden Richtlinienreferenz der Sprache beschrieben.
Unterstützte Sprachen
JavaScript
Die Unterstützung für JavaScript umfasst ein vollständiges Objektmodell zur Verarbeitung von Variablen und Werten, die für einen API-Proxy spezifisch sind. Weitere Informationen finden Sie unter JavaScript-Objektmodell.
Referenzinformationen und Beispiele zu Richtlinien finden Sie unter JavaScript-Richtlinie und Programmierung von API-Proxys mit JavaScript. Beispielcode finden Sie in der Beispielliste mit JavaScript-Code.
Java
Verwenden Sie die Java-Callout-Richtlinie für Aufrufe von Java-Code aus dem Ablauf Ihres Proxys. Das Richtlinienreferenzthema enthält Beispiele.
Außerdem sind die folgenden Themen hilfreich:
Suchen Sie nach Beispielcode aus der Stichprobenliste, in der Java enthalten ist.
Python
Verwenden Sie die Python-Skriptrichtlinie, um Python-Code aufzurufen.
Suchen Sie nach Beispielcode aus der Stichprobenliste, in der Python enthalten ist.