Diese Seite gilt für Apigee und Apigee Hybrid.
Apigee Edge-Dokumentation aufrufen
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.
So gehts:
Sie verwenden eine Richtlinie speziell für die Sprache, um Aufrufe von einem Proxyfluss an den enthaltenen Code zu senden. Apigee enthält für jede der unterstützten Sprachen eine separate Richtlinie: JavaScript-Richtlinie, JavaCallout-Richtlinie und PythonScript-Richtlinie.
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 das Ergebnis des Codes in eine Apigee-Flussvariable 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 Ihrem API-Proxy die Datei (oder JAR) als Ressourcendatei hinzu.
Weitere Informationen zu Ressourcendateien finden Sie unter Ressourcendateien.
- Fügen Sie die Richtlinie für die Sprache hinzu, die Sie verwenden.
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-Sicherheitsmodell lässt keine Systemaufrufe wie Netzwerk-E/A, Dateisystem-Lese-/Schreibvorgänge, aktuelle Nutzerinformationen, Prozessliste und CPU-/Speicherauslastung zu. 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.
Weitere Informationen und Beispiele zu Richtlinien finden Sie unter JavaScript-Richtlinie.
Java
Verwenden Sie die Java-Callout-Richtlinie für Aufrufe von Java-Code aus dem Ablauf Ihres Proxys. Das Richtlinienreferenzthema enthält Beispiele.
Python
Verwenden Sie die Python-Skriptrichtlinie, um Python-Code aufzurufen.