Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację Apigee X. info
Wprowadzenie
Aby uzyskać dostęp do zmiennych przepływu Apigee Edge w aplikacji Node.js, użyj modułu apigee-access. Moduł zawiera metody pobierania, ustawiania i usuwania zmiennych. Zawiera też wygodną metodę ustawienia zmiennej całkowitej.
Zmienne przepływu występują w kontekście przepływu proxy interfejsu API. Niektóre zmienne są „wbudowane” w Edge. Inne są tworzone podczas wykonywania zasad, a Ty możesz tworzyć własne zmienne. Zmienne przepływu są zwykle używane do przekazywania danych z jednej zasady do drugiej oraz do określania warunków w przepływach warunkowych. Informacje o zmiennych przepływu znajdziesz w artykule Zmienna przepływu i warunki.
Więcej informacji o module apigee-access i jego innych funkcjach znajdziesz w artykule Korzystanie z modułu apigee-access (w języku angielskim).
Przykład działania
Załóżmy, że zasada Edge działająca na ścieżce przepływu żądania ustawia zmienną o nazwie AuthenticatedUserId. Poniższy kod uzyskuje dostęp do tej zmiennej i wypisuje ją do dziennika. Dodatkowo ten kod ustawia zmienną. Następnie możesz uzyskać dostęp do tej zmiennej w ramach zasady, którą ilustrujemy poniżej.
var http = require('http');
var apigee = require('apigee-access');
http.createServer(function (request, response) {
// The request parameter must be a request object that came from the http module
var userId = apigee.getVariable(request, 'AuthenticatedUserId');
apigee.setVariable(request, "custom.foo", "Bar");
console.log('Authenticated Apigee User ID is %s', userId);
response.writeHead(200, {'Content-Type': 'text/plain'});
response.end('Hello World\n');
}).listen(8124);
console.log('Server running at http://127.0.0.1:8124/');
Możesz skopiować ten kod do pliku JavaScript, wdrożyć go w Edge i wypróbować. Zadzwoń pod numer server.js. Aby go wdrożyć:
apigeetool deploynodeapp -u username -p password -o myorg -e test -n access -d . -m server.js -b /access
Po wdrożeniu aplikacji w Edge dodaj zasadę AssignMessage z tą konfiguracją do procesu żądania ProxyEndpoint:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="AddUserId">
<DisplayName>AddUserId</DisplayName>
<FaultRules/>
<Properties/>
<AssignVariable>
<Name>AuthenticatedUserId</Name>
<Value>ntesla</Value>
<Ref/>
</AssignVariable>
<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
<AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
Następnie dodaj do przepływu danych odpowiedzi TargetEndpoint kolejną regułę AssignMessage:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="SetHeader">
<DisplayName>SetHeader</DisplayName>
<FaultRules/>
<Properties/>
<Set>
<Headers>
<Header name="MySpecialHeader">{custom.foo}</Header>
</Headers>
</Set>
<IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
<AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
Możesz wywołać serwer proxy w ten sposób:
curl -i http://myorg-test.apigee.net/access
W interfejsie zarządzania przejdź na stronę strony proxy dostępu i otwórz widok Opracowywanie. Kliknij Logi Node.js, aby wyświetlić dane wyjściowe logów z serwera proxy. Jeśli serwer proxy jest skonfigurowany poprawnie, zobaczysz, że ustawiona została zmienna userId. W oknie terminala zobaczysz też nagłówek ustawiony w wyniku cURL:
HTTP/1.1 200 OK Content-Type: text/plain Date: Tue, 27 05 2014 23:20:52 GMT MySpecialHeader: Bar Content-Length: 12 Connection: keep-alive
Metody
getVariable
var result = getVariable(httpRequest, name);
Pobiera zmienną o nazwie.
Parametry:
httpRequest: obiekt żądania pochodzący z modułu http.name: (ciąg) nazwa zmiennej do pobrania.
Zwroty:
Ciąg znaków lub liczba, w zależności od typu ustawionego za pomocą setVariable(), gdy został utworzony przez Ciebie w innym miejscu lub przez zasady. Jeśli korzystasz z jednej z domyślnych zmiennych Edge, listę typów znajdziesz w przewodniku po zmiennych. Informacje o typach zmiennych tworzonych przez zasady znajdziesz w odpowiednim temacie pomocy.
Przykłady:
var apigee = require('apigee-access');
// "httpRequest" must be a request object that came from the http module
var val1 = apigee.getVariable(request, 'TestVariable');
var val2 = apigee.getVariable(request, 'request.client.ip');
setVariable
setVariable(httpRequest, name, value);
Ustawia zmienną. Niektóre zmienne są tylko do odczytu, a metoda setvariable() zgłasza wyjątek, jeśli spróbujesz ustawić jedną z nich. Informacje o tym, które zmienne są tylko do odczytu, znajdziesz w dokumentacji dotyczącej zmiennych.
Parametry:
httpRequest: obiekt żądania pochodzący z modułu http.name: (ciąg znaków) nazwa zmiennej do pobrania.value: może być liczbą, ciągiem znaków, wartością logiczną, wartością null lub niezdefiniowaną.
Przykład:
var apigee = require('apigee-access');
apigee.setVariable(request, 'TestVariable', 'bar');
// This will throw an exception because client.ip is read-only.
apigee.setVariable(request, 'client.ip');
setIntVariable
setIntVariable(httpRequest, name, value);
Metoda setIntVariable() jest metodą udogodnienia, która najpierw zmienia parametr wartości na liczbę całkowitą, a następnie go ustawia.
Parametry:
httpRequest: obiekt żądania pochodzący z modułu http.name: (string) nazwa zmiennej do ustawienia.value: parametr wartości musi być ciągiem znaków lub liczbą.
Przykład:
var apigee = require('apigee-access');
// Convert "123" to an integer and set it
apigee.setIntVariable(request, 'TestVariable', '123');
// Use something that's already a number
apigee.setIntVariable(request, 'TestVariable2', 42);
deleteVariable
Usuwa zmienną nazwaną. Usunięcie zmiennej tylko do odczytu powoduje błąd. Pełną listę zmiennych tylko do odczytu znajdziesz w dokumentacji zmiennych.
deleteVariable(httpRequest, name);
Parametry:
httpRequest: obiekt żądania pochodzący z modułu http.name: (ciąg znaków) nazwa zmiennej do usunięcia.
Przykład:
apigee.deleteVariable(request, 'TestVariable');
// This will throw an exception because client.ip is a read-only variable.
apigee.deleteVariable(request, 'client.ip');