使从 AEM 中缓存的页面失效 invalidating-cached-pages-from-aem

在将 Dispatcher 与 AEM 结合使用时，必须配置两者之间的交互以确保高效的缓存管理。根据您的环境，配置还可以提高性能。

设置 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 缓存失效（或进行刷新），您可以向 Dispatcher 发出 HTTP 请求。例如，您可以创建一个 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

以下代码实施一个向 Dispatcher 发送失效请求的 servlet。此 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());
  }
 }
}