发出 HTTPS 请求

区域 ID

REGION_ID 是 Google 根据您在创建应用时选择的区域分配的缩写代码。此代码不对应于国家/地区或省，尽管某些区域 ID 可能类似于常用国家/地区代码和省代码。对于 2020 年 2 月以后创建的应用，REGION_ID.r 包含在 App Engine 网址中。对于在此日期之前创建的现有应用，网址中的区域 ID 是可选的。

详细了解区域 ID。

本页面介绍了如何使用 URL Fetch 服务针对第二代运行时从 App Engine 应用发出 HTTP(S) 请求。

在按照本页上的说明进行操作前，我们建议您在使用 URL Fetch 服务之前使用语言惯用解决方案发出 HTTP(S) 请求。使用 URL Fetch 的主要用例是，您想要向其他 App Engine 应用发出 HTTP(S) 请求，并在该请求中声明应用的身份。

如需详细了解请求大小限制以及网址提取请求中发送的标头，请参阅出站请求。

默认情况下，在 Java 运行时中运行的应用使用标准 Java 类（例如 java.net.HttpURLConnection）来发出 HTTP(S) 请求。您可以像为任何其他 Java 应用一样发送请求。

使用标准运行时环境网络类

如果您使用标准 Java 网络类，则应用可以使用以下功能：

对请求数据的 32 MB 限制不适用。
支持 HTTP 2.0。
支持可从 Java 版 Cloud 客户端库访问的所有基于 Google Cloud的 API。

使用 URL Fetch

如果您必须在 Java 应用中使用URL Fetch，请将以下行添加到 appengine-web.xml 文件中：

 <url-stream-handler>urlfetch</url-stream-handler>

例如：

<xml version="1.0" encoding="utf-8">
<appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
  <!-- ... -->
  <url-stream-handler>urlfetch</url-stream-handler>
  <!-- ... -->
</appengine-web-app>

发出 HTTP 请求

如需使用URL Fetch服务来发出出站 HTTP(S) 请求，请使用 java.net.URLConnection。

以下代码段演示了如何执行基本 HTTP GET 请求。应用创建新的 URL 对象，然后调用该对象的 openStream() 方法来检索该网址中的内容：

URL url = new URL("http://api.icndb.com/jokes/random");
BufferedReader reader = new BufferedReader(new InputStreamReader(url.openStream()));
StringBuffer json = new StringBuffer();
String line;

while ((line = reader.readLine()) != null) {
  json.append(line);
}
reader.close();

如需执行更高级的请求，请使用 java.net.HttpURLConnection，具体如下：

新建一个 URL 对象。
通过调用 URL 对象的 openConnection() 方法，创建新的 URLConnection 对象。
通过将 URLConnection 对象转换为 HttpURLConnection 对象类型，创建新的 HttpURLConnection 对象。
设置该 HttpURLConnection 对象的请求方法。
为该请求创建输出流。
将请求负载写入该输出流。
关闭输出流。

以下代码段演示了如何使用 HttpURLConnection 执行更高级的请求，并通过 PUT 请求从Web表单提交数据：

URL url = new URL("http://jsonplaceholder.typicode.com/posts/" + id);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
// Enable output for the connection.
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
conn.setRequestProperty("Accept", "application/json");
// Set HTTP request method.
conn.setRequestMethod("PUT");

// Create JSON request.
JSONObject jsonObj =
    new JSONObject().put("userId", 1).put("id", id).put("title", text).put("body", text);

OutputStreamWriter writer = new OutputStreamWriter(conn.getOutputStream());
writer.write(jsonObj.toString());
writer.close();

int respCode = conn.getResponseCode(); // New items get NOT_FOUND on PUT
if (respCode == HttpURLConnection.HTTP_OK || respCode == HttpURLConnection.HTTP_NOT_FOUND) {
  req.setAttribute("error", "");
  StringBuilder response = new StringBuilder();
  String line;

  // Read input data stream.
  BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream()));
  while ((line = reader.readLine()) != null) {
    response.append(line);
  }
  reader.close();
  req.setAttribute("response", response.toString());
} else {
  req.setAttribute("error", conn.getResponseCode() + " " + conn.getResponseMessage());
}

设置请求超时

如果您使用 URL Fetch，可以使用 appengine-web.xml 文件中的 appengine.api.urlfetch.defaultDeadline 设置来调整请求的默认时限。

设置标头

如果您使用 URL Fetch，则可以通过调用 HttpURLConnection 对象的 setRequestProperty() 方法，为传出请求设置 HTTP 标头。以下代码段将 X-MyApp-Version 标头设置为 2.7.3：

conn.setRequestProperty("X-MyApp-Version", "2.7.3");

停用重定向

默认情况下，HttpURLConnection 遵循 HTTP 重定向。

如果您使用 URL Fetch，则默认情况下，URL Fetch 服务最多遵循五个重定向。这些重定向可能会将敏感信息（如授权标头）转发到重定向的目的地。如果应用不需要 HTTP 重定向，则建议您停用重定向。

如需停用此行为，请将值 false 传递到 HttpURLConnection 对象的 setInstanceFollowRedirects() 方法：

conn.setInstanceFollowRedirects(false);

如果应用直接使用底层 urlfetch 软件包而不是 java.net，则应用必须指定 doNotFollowRedirects。