HTTP(S)-Anfragen senden

Regions-ID

REGION_ID ist ein abgekürzter Code, den Google anhand der Region zuweist, die Sie beim Erstellen Ihrer Anwendung ausgewählt haben. Der Code bezieht sich nicht auf ein Land oder eine Provinz, auch wenn einige Regions-IDs häufig verwendeten Länder- und Provinzcodes ähneln können. Bei Anwendungen, die nach Februar 2020 erstellt wurden, ist REGION_ID.r in den App Engine-URLs enthalten. Bei Anwendungen, die vor diesem Datum erstellt wurden, ist die Regions-ID in der URL optional.

Hier finden Sie weitere Informationen zu Regions-IDs.

OK

Auf dieser Seite wird beschrieben, wie Sie in Ihrer App Engine-Anwendung HTTP(S)-Anfragen senden.

In der Java 8-Laufzeit ausgeführte Anwendungen verwenden standardmäßig Java-Standardklassen für HTTP(S)-Anfragen, z. B. java.net.HttpURLConnection. Sie senden Anfragen wie bei jeder anderen Java-Anwendung. Um das Standardverhalten zu verwenden, müssen Sie die Abrechnung für Ihre Anwendung aktivieren. Andernfalls erhalten Sie die folgenden Ausnahmen:

• java.net.UnknownHostException
• java.net.SocketTimeoutException
• java.io.IOException

Standardlaufzeit-Netzwerkklassen verwenden

Wenn Sie die Standard-Netzwerkklassen für Java verwenden, hat Ihre Anwendung Zugriff auf die folgenden Features:

• Die Beschränkung auf 32 MB für Anfragedaten wird entfernt.
• HTTP 2.0 wird unterstützt.
• Alle Google Cloud-basierten APIs, die über die Google Cloud-Clientbibliothek für Java zugänglich sind, werden unterstützt.

URL Fetch verwenden

Warnung: Verwenden Sie URL Fetch nicht, wenn Sie den serverlosen VPC-Zugriff eingerichtet haben oder Cloud-Clientbibliotheken verwenden. für Java. URL Fetch verarbeitet alle ausgehenden Anfragen und führt dazu, dass Anfragen, die Sie an Ihr VPC-Netzwerk oder die Clientbibliotheken senden, fehlschlagen. Wenn eines dieser Szenarien auf Sie zutrifft, achten Sie darauf, dass das Feld url-stream-handler in Ihrer Konfiguration nicht auf urlfetch gesetzt ist. Anwendungen, die Cloud-Clientbibliotheken für Java verwenden und versuchen, URL Fetch über den Wrapper URLConnection zu nutzen, werden nicht unterstützt.

Wenn Sie URL Fetch in einer Java 8-Anwendung verwenden müssen, fügen Sie der Datei appengine-web.xml die folgende Zeile hinzu:

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

Beispiel:

<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>

Hinweis: Auf den Metadatenserver kann nur mit nativen Java-Sockets und dem nativen Stream-Handler zugegriffen werden. Der Dienst urlfetch wird nicht unterstützt.

HTTP-Request senden

Verwenden Sie die Methode java.net.URLConnection, um ausgehende HTTP-Anfragen zu senden.

Das folgende Snippet veranschaulicht, wie eine grundlegende HTTP-GET-Anfrage ausgeführt wird: Die Anwendung erstellt ein neues URL-Objekt und ruft dann die openStream()-Methode des Objekts auf, um den Inhalt unter dieser URL abzurufen:

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();

Für komplexere Anfragen verwenden Sie java.net.HttpURLConnection so:

1. Erstellen Sie ein neues URL-Objekt.
2. Erstellen Sie ein neues URLConnection-Objekt, indem Sie die Methode openConnection() des URL-Objekts aufrufen.
3. Erstellen Sie ein neues HttpURLConnection-Objekt, indem Sie das URLConnection-Objekt in den Objekttyp HttpURLConnection umwandeln.
4. Legen Sie die Anfragemethode des HttpURLConnection-Objekts fest.
5. Erstellen Sie einen Ausgabestream für den Request.
6. Schreiben Sie die Request-Nutzlast in den Stream.
7. Schließen Sie den Stream.

Das folgende Snippet zeigt, wie Sie mit HttpURLConnection eine komplexere Anfrage ausführen und Daten aus einem Webformular über eine PUT-Anfrage senden:

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());
}

Anfragezeitüberschreitung festlegen

Wenn Sie URL Fetch verwenden, können Sie die Standardfrist für Anfragen mit der Einstellung appengine.api.urlfetch.defaultDeadline in der Datei appengine-web.xml anpassen.

Headers festlegen

Wenn Sie den URL-Abruf verwenden, können Sie einen HTTP-Header für die ausgehende Anfrage festlegen, indem Sie die Methode setRequestProperty() Ihres HttpURLConnection-Objekts aufrufen. Mit dem folgenden Snippet wird der Header von X-MyApp-Version auf 2.7.3 gesetzt:

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

Weiterleitungen deaktivieren

Wichtig: Zur Verbesserung der Sicherheit Ihrer Anwendung wird empfohlen, Weiterleitungen zu deaktivieren.

HttpURLConnection folgt standardmäßig HTTP-Weiterleitungen.

Wenn Sie URL-Abruf verwenden, folgt der zugrunde liegende URL-Abrufdienst standardmäßig bis zu fünf Weiterleitungen. Diese Weiterleitungen können vertrauliche Informationen wie Autorisierungsheader an das Weiterleitungsziel weiterleiten. Wenn Ihre Anwendung keine HTTP-Weiterleitungen erfordert, empfehlen wir, die Weiterleitungen zu deaktivieren.

Um dieses Verhalten zu deaktivieren, übergeben Sie den Wert false an die Methode setInstanceFollowRedirects() des HttpURLConnection-Objekts:

conn.setInstanceFollowRedirects(false);

Wenn die Anwendung anstatt java.net direkt das zugrunde liegende Paket urlfetch verwendet, muss in der Anwendung doNotFollowRedirects angegeben sein.

HTTPS-Request senden

Wenn Sie URL Fetch verwenden, senden Sie eine HTTPS-Anfrage mit der Klasse FetchOptions im Paket urlfetch und rufen Sie validateCertificate() auf.

Asynchrone Requests senden

HTTP(S)-Requests sind standardmäßig synchron. Um eine asynchrone Anfrage zu senden, muss Ihre Anwendung die Methode fetchAsync() von URLFetchService verwenden. Diese Methode gibt eine java.util.concurrent.Future<HTTPResponse> zurück.

Requests an andere App Engine-Anwendungen senden

Wenn Sie eine Anfrage an eine andere App Engine-Anwendung senden, muss die Identität dieser Anwendung bestätigt werden. Geben Sie zusätzlich in die Anfrage den Header X-Appengine-Inbound-Appid ein. Wenn Sie den URL-Abrufdienst so konfigurieren, dass er keiner Weiterleitung folgt, fügt App Engine diesen Header automatisch zu Anfragen hinzu.

Informationen zum Deaktivieren von Weiterleitungen finden Sie unter Weiterleitungen deaktivieren.

Hinweis: Beim Senden von Anfragen an eine andere App Engine-Anwendung sollten Sie statt einer benutzerdefinierten Domain den zugehörigen REGION_ID.r.appspot.com-Domainnamen verwenden.

Nächste Schritte

Unter Ausgehende Anfragen finden Sie weitere Informationen zum URL-Abrufdienst, z. B. zu den Headern, die in einer URL-Abrufanfrage gesendet werden.