使 AEM 中的快取頁面失效 invalidating-cached-pages-from-aem

在搭配 AEM 使用 Dispatcher 時，必須設定互動以確保有效的快取管理。 根據您的環境，此設定也可提高效能。

設定 AEM 使用者帳戶 setting-up-aem-user-accounts

系統會使用預設 admin 使用者帳戶來驗證預設情況下安裝的複寫代理程式。 您應該建立專用使用者帳戶以搭配複寫代理程式使用。

如需詳細資訊，請參閱 AEM 安全性檢查清單的設定複寫和傳輸使用者一節。

使編寫環境中的 Dispatcher 快取失效 invalidating-dispatcher-cache-from-the-authoring-environment

發佈頁面時，AEM 編寫執行個體上的複寫代理程式會傳送快取失效請求給 Dispatcher。 此請求最終會導致 Dispatcher 在發佈新內容時重新整理快取中的檔案。

請使用以下程序在 AEM 編寫執行個體上設定複寫代理程式，以便在啟用頁面時讓 Dispatcher 快取失效：

或者，您也可以從 AEM Touch UI 存取及設定 Dispatcher Flush 代理程式。

如需如何啟用對虛名 URL 之存取權的詳細資訊，請參閱啟用對虛名 URL 的存取權。

這個做法可能有兩個問題：

使發佈執行個體中的 Dispatcher 快取失效 invalidating-dispatcher-cache-from-a-publishing-instance

在某些情況下，可以從編寫環境將快取管理轉移到發佈執行個體來獲得效能的提升。 然後在收到已發佈的頁面時，會由發佈環境 (而不是 AEM 編寫環境) 傳送快取失效請求給 Dispatcher。

這類情況包括：

Dispatcher 清除作業是由發佈執行個體上運作的複寫代理程式所控制。 不過，設定是在編寫環境上進行，然後透過啟用代理程式進行傳輸：

在設定後，當您啟用編寫環境中的頁面進行發佈時，此代理程式會起始標準複寫。 記錄中包含的訊息會指示來自您的發佈伺服器的請求，類似於以下範例：

手動讓 Dispatcher 快取失效 manually-invalidating-the-dispatcher-cache

若要讓 Dispatcher 快取失效 (或將其清除) 而不啟用頁面，您可以發出 HTTP 請求給 Dispatcher。 例如，您可以建立 AEM 應用程式，好讓管理員或其他應用程式可以清除快取。

HTTP 請求會讓 Dispatcher 從快取中刪除特定檔案。 然後 Dispatcher 會選擇性地以新複本重新整理快取。

刪除快取檔案 delete-cached-files

發出 HTTP 請求讓 Dispatcher 從快取中刪除檔案。 Dispatcher 只有在收到頁面的用戶端請求時才會再次快取檔案。 以這種方式刪除快取檔案適用於不太可能接收相同頁面的同時請求的網站。

HTTP 請求具有以下形式：

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
CQ-Handle: path-pattern
Content-Length: 0

Dispatcher 會清除 (刪除) 名稱符合 CQ-Handler 標頭值的快取檔案和資料夾。 例如，/content/geomtrixx-outdoors/en 的 CQ-Handle 符合以下項目：

接觸 .stat 檔案會使得 Dispatcher 快取中的其他所有檔案 (或高至特定層級，視 /statfileslevel 設定而定) 失效。 將這個檔案的最後修改日期與快取文件的最後修改日期做比較，並在 .stat 檔案比較新的時候重新提取該文件。 如需詳細資訊，請參閱依照資料夾層級讓檔案失效。

您可以藉由傳送其他標頭 CQ-Action-Scope: ResourceOnly 來避免失效 (也就是接觸 .stat 檔案)。 這可用來清除特定資源，而不會讓快取的其他部分 (例如動態建立的 JSON 資料) 失效，並且需要獨立於快取之外的定期清除 (例如，表示從第三方系統取得的資料以顯示新聞、股票行情等)。

刪除並重新快取檔案 delete-and-recache-files

發出 HTTP 請求讓 Dispatcher 刪除快取檔案，然後立即擷取並重新快取檔案。 當網站可能接收相同頁面的同時用戶端請求時，刪除並立即重新快取檔案。 立即重新快取可確保 Dispatcher 只會擷取及快取頁面一次，而不是針對每個同時用戶端請求擷取及快取頁面一次。

注意： ​刪除及重新快取檔案應該只能在發佈執行個體上執行。 從編寫執行個體執行時，如果在發佈資源前嘗試重新快取資源，則會發生競爭情況。

HTTP 請求具有以下形式：

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
`Content-Type: text/plain
CQ-Handle: path-pattern
Content-Length: numchars in bodypage_path0

page_path1
...
page_pathn

立即重新快取的頁面路徑會列在訊息本文中的個別字行上。 CQ-Handle 的值是讓重新快取的頁面失效的頁面的路徑。 (請參閱快取設定項目的 /statfileslevel 參數。) 以下範例 HTTP 請求訊息會刪除並重新聯繫 /content/geometrixx-outdoors/en.html page：

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
Content-Type: text/plain
CQ-Handle: /content/geometrixx-outdoors/en/men.html
Content-Length: 36

/content/geometrixx-outdoors/en.html

清除 servlet 範例 example-flush-servlet

以下程式碼會實作一個 servlet，以便將失效請求傳送給 Dispatcher。 此 servlet 會收到包含 handle 和 page 參數的請求訊息。 這兩個參數分別會提供 CQ-Handle 標頭的值以及要重新快取的頁面的路徑。 此 servlet 會使用這些值來為 Dispatcher 建構 HTTP 請求。

將此 servlet 部署到發佈執行個體時，以下 URL 會使 Dispatcher 刪除 /content/geometrixx-outdoors/en.html 頁面然後快取新的複本。

10.36.79.223:4503/bin/flushcache/html?page=/content/geometrixx-outdoors/en.html&handle=/content/geometrixx-outdoors/en/men.html

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Property;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.api.SlingHttpServletResponse;
import org.apache.sling.api.servlets.SlingSafeMethodsServlet;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import org.apache.commons.httpclient.*;
import org.apache.commons.httpclient.methods.PostMethod;
import org.apache.commons.httpclient.methods.StringRequestEntity;

@Component(metatype=true)
@Service
public class Flushcache extends SlingSafeMethodsServlet {

 @Property(value="/bin/flushcache")
 static final String SERVLET_PATH="sling.servlet.paths";

 private Logger logger = LoggerFactory.getLogger(this.getClass());

 public void doGet(SlingHttpServletRequest request, SlingHttpServletResponse response) {
  try{
      //retrieve the request parameters
      String handle = request.getParameter("handle");
      String page = request.getParameter("page");

      //hard-coding connection properties is a bad practice, but is done here to simplify the example
      String server = "localhost";
      String uri = "/dispatcher/invalidate.cache";

      HttpClient client = new HttpClient();

      PostMethod post = new PostMethod("https://"+host+uri);
      post.setRequestHeader("CQ-Action", "Activate");
      post.setRequestHeader("CQ-Handle",handle);

      StringRequestEntity body = new StringRequestEntity(page,null,null);
      post.setRequestEntity(body);
      post.setRequestHeader("Content-length", String.valueOf(body.getContentLength()));
      client.executeMethod(post);
      post.releaseConnection();
      //log the results
      logger.info("result: " + post.getResponseBodyAsString());
      }
  }catch(Exception e){
      logger.error("Flushcache servlet exception: " + e.getMessage());
  }
 }
}