您目前查看的是 Apigee Edge 說明文件。
參閱 Apigee X說明文件。 資訊
簡介
使用 apigee-access 模組在 Node.js 應用程式中存取 Apigee Edge 資料流變數。模組包含取得、設定和刪除變數的方法。它也提供設定整數變數的簡易方法。
流程變數存在於 API Proxy 流程中。部分變數是 Edge 的「內建」變數。有些則是在執行政策時建立，您也可以自行建立變數。流程變數通常用於將資料從某項政策傳遞至另一個政策，以及在條件式流程中設定條件。如要瞭解流程變數，請參閱「流程變數和條件」。
如要瞭解 apigee-access 模組及其其他功能，請參閱「使用 apigee-access 模組」。
實際範例
假設在要求流程路徑中執行的 Edge 政策會設定名為 AuthenticatedUserId 的變數。下列程式碼會存取該變數，並將該變數輸出至記錄。此外，此程式碼會設定變數。接著，您可以透過政策存取這個變數，詳情請參閱下方說明。
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/');
您可以將這段程式碼複製到 JavaScript 檔案中，並部署至 Edge 試用。呼叫 server.js 檔案。如要部署，請使用：
apigeetool deploynodeapp -u username -p password -o myorg -e test -n access -d . -m server.js -b /access
將應用程式部署至 Edge 後，請在 ProxyEndpoint 要求流程中新增 AssignMessage 政策，並加入下列設定：
<?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>
接著，將其他 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>
呼叫 Proxy 的方式如下：
curl -i http://myorg-test.apigee.net/access
接著，前往管理 UI 中存取權 Proxy 的頁面，然後開啟「Develop」(開發) 檢視畫面。按一下「Node.js 記錄」，即可查看 Proxy 的記錄輸出內容。如果 Proxy 設定正確，您會看到 userId 變數已設定。您也會在終端機視窗的 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
方法
getVariable
var result = getVariable(httpRequest, name);
取得命名變數。
參數：
httpRequest：來自 http 模組的要求物件。name：(字串) 要擷取的變數名稱。
退貨：
字串或數字，取決於您使用 setVariable() 設定的類型，以及該變數是由您在其他位置建立，還是由政策建立。如果您存取的是現成的 Edge 變數，可以在變數參考資料中找到類型清單。如要瞭解政策建立的變數類型，請參閱特定政策參考主題。
例如：
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);
設定變數。有些變數是唯讀，如果您嘗試設定其中一個變數，setVariable() 方法會擲回例外狀況。如要判斷哪些變數是唯讀變數，請參閱變數參考資料。
參數：
httpRequest：來自 http 模組的要求物件。name：(字串) 要擷取的變數名稱。value：可以是數字、字串、布林值、空值或未定義。
範例：
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);
setIntVariable() 方法是方便方法，會先將值參數強制設為整數，然後再進行設定。
參數：
httpRequest：來自 http 模組的要求物件。name：(字串) 要設定的變數名稱。value：值參數必須是字串或數字。
範例：
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
刪除已命名變數。刪除唯讀變數會導致錯誤。如需只讀變數的完整清單，請參閱「變數參考資料」。
deleteVariable(httpRequest, name);
參數：
httpRequest：來自 http 模組的要求物件。name：(字串) 要刪除的變數名稱。
範例：
apigee.deleteVariable(request, 'TestVariable');
// This will throw an exception because client.ip is a read-only variable.
apigee.deleteVariable(request, 'client.ip');