本頁面由 Cloud Translation API 翻譯而成。

如何在 JavaCallout 中使用屬性

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

什麼是 Java 呼叫？

如果您是第一次使用 JavaCallouts，建議先參閱「如何建立 Java 呼叫」。

在 JavaCallout 政策中使用屬性

您可以在 JavaCallout 政策中指定名稱/值組合，並在執行階段透過 Java 程式碼存取這些組合。您必須為每個屬性指定字串常值，無法在這個元素中參照流程變數。

我們來逐步說明使用屬性的簡單 JavaCallout 政策範例。在本例中，我們建立的 Proxy 包含 JavaCallout 政策。這項政策會使用 <Properties> 元素指定名稱/值組合。在 Java 程式碼中，我們會擷取值並用來設定回應標頭。

下載專案

為簡化作業，您可以從 GitHub 上的 Apigee api-platform-samples 存放區下載這個專案。

將 api-platform-samples 下載或複製到您的系統。
在所選的終端機或程式碼編輯器中，前往 api-platform-samples/doc-samples/java-properties 專案。

JavaCallout 政策

這項政策使用 <Properties> 元素。這個元素可讓您指定名稱/值組合。在執行階段，Java 程式碼可以存取政策中指定的屬性值，我們稍後會看到這點。

<JavaCallout name="java-callout">
    <ClassName>com.apigeesample.JavaProperties</ClassName>
    <ResourceURL>java://edge-custom-policy-java-properties.jar</ResourceURL>
    <Properties>
        <Property name="prop">WORLD!</Property>
    </Properties>
</JavaCallout>

Java 程式碼範例

這個範例的 Java 程式碼說明如何擷取 JavaCallout 政策中指定的屬性。在範例專案中，您可以在 java-properties/callout/src/main/java/JavaProperties.java 中找到原始碼。我們會在稍後的本主題中，逐步說明如何編譯及部署這段程式碼。

package com.apigeesample;

import com.apigee.flow.execution.ExecutionContext;
import com.apigee.flow.execution.ExecutionResult;
import com.apigee.flow.execution.spi.Execution;
import com.apigee.flow.message.MessageContext;

import java.util.Map;

public class JavaProperties implements Execution {

	private Map <String,String> properties; // read-only

	public JavaProperties(Map <String,String> properties) {
	        this.properties = properties;
	}

	public ExecutionResult execute(MessageContext messageContext, ExecutionContext executionContext) {

		try {

		    messageContext.getMessage().setHeader("X-PROPERTY-HELLO", this.properties.get("prop"));

            return ExecutionResult.SUCCESS;

		} catch (Exception e) {
			return ExecutionResult.ABORT;
		}
	}
}

使用 Maven 編譯程式碼

專案已設定完成，因此您可以使用 Maven 編譯。如果您想使用 javac，我們也會提供範例。

請確認您已安裝 Maven：
```
mvn -version
```
執行指令碼 java-properties/buildsetup.sh。這個指令碼會在您的本機 Maven 存放區中，安裝必要的 JAR 依附元件。
cd 至 java-properties/callout 目錄。
執行 Maven：
```
mvn clean package
```
注意：如果收到 Maven 錯誤訊息，請確認您位於 java-properties/callout 目錄。
如要確認 JAR 檔案 edge-custom-policy-java-properties.jar 是否已複製到 java-properties/apiproxy/resources/java，這是您要透過 Proxy 部署的 JAR 檔案必要位置。

使用 javac 編譯 (選用)

如要使用 javac 編譯程式碼，可以執行類似下列的動作 (從 java-properties 目錄)。系統會在 java-properties/lib 目錄中提供必要的 JAR 檔案。

cd 至 api-platform-samples/doc-samples/java-properties。
請確認路徑中是否有 javac。
```
javac -version
```

執行下列 javac 指令：

javac -d . -classpath ./lib/expressions-1.0.0.jar:./lib/message-flow-1.0.0.jar:. callout/src/main/java/JavaProperties.java

建立 JAR 檔案：

jar -cvf edge-custom-policy-java-properties.jar ./com/apigeesample/JavaProperties.class
將 JAR 檔案複製到 apiproxy/resources/java 目錄。這是您要透過 Proxy 部署的 JAR 檔案必要位置。
```
cp edge-custom-policy-java-properties.jar apiproxy/resources/java
```

部署及呼叫 Proxy

./java-properties 目錄中提供部署指令碼。但執行前，您需要先完成快速設定。

cd 至 api-platform-samples/doc-samples/java-properties
如要部署 Proxy，最簡單的方法是將 Proxy 封裝在 ZIP 檔案中，然後將 Proxy 套件上傳至 Apigee 機構的環境。請參閱「建立 API Proxy」。請務必使用「上傳 Proxy 組合」選項。另請參閱 Apigee 社群中的「上傳 API Proxy 組合的訣竅」。
部署 Proxy 後，請嘗試呼叫：
```
curl  https://$HOSTNAME/java-properties
```
Proxy 會傳回標頭：X-PROPERTY-HELLO: WORLD!。請注意，我們在政策中新增了屬性名稱/值組合 "prop/WORLD!"。JavaCallout 政策會擷取 "WORLD!" 值，並將其設為名為 X-PROPERTY-HELLO 的標頭：
```
messageContext.getMessage().setHeader("X-PROPERTY-HELLO", this.properties.get("prop"));
```