要求的處理方式

本文件說明您的 App Engine 應用程式如何接收要求及傳送回應。詳情請參閱要求標頭參考資料

如果您的應用程式使用這些服務,則可以設定要求的位址,將要求傳送到特定服務或該服務的特定版本。如要進一步瞭解服務的轉送功能,請參閱要求的轉送方式

處理要求

您的應用程式負責啟動網路伺服器和處理要求。您可以使用任何適用於您的開發語言的網路架構。

您的應用程式伺服器設定可以確定處理並行要求的方式。Eclipse Jetty 9 執行階段已經過並行設定,但如果您使用的是 Java 8 執行階段,則是否要進行並行設定取決於您的應用程式或架構。

App Engine 收到應用程式的網路要求時,會叫用網址對應的 Servlet,如應用程式的部署作業描述元 (WEB-INF/ 目錄中的 web.xml 檔案) 所述。接著使用 Java Servlet API 3.1 版提供要求資料給 Servlet,然後接受回應資料。

下列 Servlet 類別的範例會在使用者瀏覽器上顯示簡單訊息。

import java.io.IOException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class MyServlet extends HttpServlet {
    @Override
    public void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws IOException {
        resp.setContentType("text/plain");
        resp.getWriter().println("Hello, world");
    }
}

配額與限制

App Engine 會在流量增加時自動分配資源給您的應用程式。然而,這項作業受到下列限制:

  • 如果是具有低延遲時間的應用程式 (要求的回應時間不到一秒),App Engine 保有自動調整資源配置的能力;如果是具有高延遲時間 (例如在要求眾多的情況下,每個要求的回應時間超過一秒) 及高總處理量的應用程式,則需要白銀級、爍金級或白金級的支援。選用這些等級支援方案的客戶可聯絡支援代表,要求提高總處理量上限。

  • 使用大量 CPU 資源的應用程式可能會引發額外延遲,以和相同伺服器上的其他應用程式有效率地共用資源。針對靜態檔案的要求則不受這些延遲限制的規範。

每個傳送至應用程式的要求均會計入「要求」限制,而回應要求所傳送的資料則會計入「連出頻寬 (可計費)」限制。

HTTP 及 HTTPS (加密連線) 要求均會計入「要求」、「連入頻寬 (可計費)」及「連出頻寬 (可計費)」的限制。GCP 主控台的「Quota Details」(配額詳細資料) 頁面也會將「Secure Requests」(安全要求)、「Secure Incoming Bandwidth」(安全連入頻寬) 與「Secure Outgoing Bandwidth」(安全連出頻寬) 回報成不同的值以供參考。僅有 HTTPS 要求會計入這些值。詳情請參閱配額頁面。

下列限制專門適用於要求處理常式:

要求限制

  • 僅接受上限為 15KB 的要求標頭。
  • 要求的大小總計不能超過 32MB。
  • 所有 HTTP/2 要求在轉送至應用程式伺服器時都會轉譯為 HTTP/1.1 要求。
  • 安全資料傳輸層 (SSL) 連線會在負載平衡器上終止。來自負載平衡器的流量會透過加密通道傳送至執行個體,然後再透過 HTTP 轉送至應用程式伺服器。X-Forwarded-Proto 標頭會清楚標示來源要求是 HTTP 還是 HTTPS。

回應限制

  • 回應會以 64k 區塊進行緩衝。
  • 回應無大小限制。
  • 回應時間以一小時為限。

不支援的 HTTP 要求

App Engine 彈性環境不支援下列功能:

  • 傳送至後端服務的 HTTP/2 流量。
  • 直接存取執行個體的 HTTP 要求。

要求標頭

傳入 HTTP 要求包含用戶端傳送的 HTTP 標頭。基於安全性考量,部分標頭在送達應用程式之前會由中繼 Proxy 進行處理或修改。

詳情請參閱要求標頭參考資料

要求回應

App Engine 會使用要求物件和回應物件來呼叫 Servlet,然後等待 Servlet 填入回應物件並回傳。Servlet 回傳時,回應物件上的資料會傳送給使用者。

您產生的回應會受到一些限制,而且在傳回用戶端前可能已經過修改。

停用緩衝

根據預設,所有來自 App Engine 的回應都會在 64k 區塊中進行緩衝。您可以在某些情況下停用緩衝,直接將位元組串流至用戶端。此方法通常適用於使用等待 GET 或伺服器推送事件 (SSE) 的情況。如要停用緩衝,請將 X-Accel-Buffering 回應標頭設為 no

X-Accel-Buffering: no

強制 HTTPS 連線

基於安全性考量,所有應用程式皆應鼓勵用戶端透過 https 連線。您可以使用 Strict-Transport-Security 標頭,指示瀏覽器針對指定網頁或整個網域採用 https 而非 http,例如:

Strict-Transport-Security: max-age=31536000; includeSubDomains

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Java 適用的 App Engine 彈性環境文件