LookupCache 政策

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

配置如何在运行时检索缓存值。

此政策适用于通用短期缓存。它与 Populate Cache 政策（用于写入条目）和 Invalidate Cache 政策（用于使条目失效）搭配使用。

如需了解如何缓存后端资源的响应，请参阅 Response Cache 政策。

元素参考

下面列出了您可以在此政策中配置的元素。

<LookupCache async="false" continueOnError="false" enabled="true" name="Lookup-Cache-1">
    <DisplayName>Lookup Cache 1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref=""/>
    </CacheKey>
    <!-- Omit this element if you're using the included shared cache. -->
    <CacheResource/>
    <CacheLookupTimeoutInSeconds/>
    <Scope>Exclusive</Scope>
    <AssignTo>flowVar</AssignTo>
</LookupCache>

默认情况下包含共享缓存。如需使用共享缓存，请省略此政策配置中的 <CacheResource> 元素。

如需详细了解底层数据存储区，请参阅缓存内部。如需详细了解如何配置缓存，请参阅创建和修改环境缓存。

<LookupCache> 属性

The following table describes attributes that are common to all policy parent elements:

<DisplayName> element

Use in addition to the name attribute to label the policy in the management UI proxy editor with a different, natural-language name.

<DisplayName>Policy Display Name</DisplayName>

<AssignTo> 元素

指定从缓存中检索缓存条目后将为其分配的变量。此变量必须可写入。如果缓存查找未检索值，则不会设置变量。

<AssignTo>variable_to_receive_cached_value</AssignTo>

<CacheKey> 元素

配置存储在缓存中的数据块的唯一指针。

<CacheKey>
    <Prefix>string</Prefix>
    <KeyFragment ref="variable_name" />
    <KeyFragment>literal_string</KeyFragment>
</CacheKey>

<CacheKey> 构造缓存中存储的每个数据块的名称。

在运行时，<KeyFragment> 值前面会附加 <Scope> 元素值或 <Prefix> 值。例如，以下命令会产生 UserToken__apiAccessToken__<value_of_client_id> 的缓存键：

<CacheKey>
    <Prefix>UserToken</Prefix>
    <KeyFragment>apiAccessToken</KeyFragment>
    <KeyFragment ref="request.queryparam.client_id" />
</CacheKey>

您可将 <CacheKey> 元素与 <Prefix> 和 <Scope> 搭配使用。如需了解详情，请参阅使用缓存键。

<CacheLookupTimeoutInSeconds> 元素

指定缓存查找失败后的秒数，经过此时间之后将视为缓存未命中。如果发生这种情况，流会沿着缓存未命中的路径继续执行。

<CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>

<CacheResource> 元素

指定存储消息的缓存。

如果此政策（以及对应的 PopulateCache 和 InvalidateCache 政策）使用了所包含的共享缓存，请完全忽略此元素。

<CacheResource>cache_to_use</CacheResource>

如需详细了解如何配置缓存，请参阅创建和修改环境缓存。

<CacheKey>/<KeyFragment> 元素

指定应在缓存键中包含的值，从而创建用于将请求与缓存响应匹配的命名空间。

<KeyFragment ref="variable_name"/>
<KeyFragment>literal_string</KeyFragment>

这可以是键（您提供的静态名称）或值（通过引用变量设置的动态条目）。组合的所有指定片段（加上前缀）都串联在一起以创建缓存键。

<KeyFragment>apiAccessToken</KeyFragment>
<KeyFragment ref="request.queryparam.client_id" />

您可将 <KeyFragment> 元素与 <Prefix> 和 <Scope> 搭配使用。如需了解详情，请参阅使用缓存键。

属性

<CacheKey>/<Prefix> 元素

指定要用作缓存键前缀的值。

<Prefix>prefix_string</Prefix>

如果您想指定自己的值，而不是 <Scope> 枚举值，请使用此值，而不是 <Scope>。如果已定义，<Prefix> 将在写入缓存的条目的缓存键值前面。<Prefix> 元素值会替换 <Scope> 元素值。

您可将 <Prefix> 元素与 <CacheKey> 和 <Scope> 搭配使用。如需了解详情，请参阅使用缓存键。

<Scope> 元素

在 <CacheKey> 元素中未提供 <Prefix> 元素时，用于构造缓存键前缀的枚举。

<Scope>scope_enumeration</Scope>

<Scope> 设置确定根据 <Scope> 值前置的缓存键。例如，将范围设置为 Exclusive 时，缓存键将采用以下格式：orgName__envName__applicationName__proxy|TargetName__ [ serializedCacheKey ]。

如果 <CacheKey> 中存在 <Prefix> 元素，则它会取代 <Scope> 元素值。有效值包括以下枚举。

您可将 <Scope> 元素与 <CacheKey> 和 <Prefix> 搭配使用。如需了解详情，请参阅使用缓存键。

可接受的值

apifactory__test__weatherapi__16__default__apiAccessToken

使用说明

将此政策用于通用缓存。在运行时，LookupCache 政策会从缓存中检索值，将该值分配给您使用 AssignTo 元素指定的变量（如果未检索任何值，则不会设置该变量）。它会根据通过组合了 CacheKey 和 Scope 元素的配置创建的缓存键查找值。换言之，如需通过 PopulateCache 政策检索添加到缓存的特定值，您的 LookupCache 政策必须配置缓存键元素相关元素，其方式与 PopulateCache 政策相同。

采用 Populate Cache 政策、LookupCache 政策和 InvalidateCache 政策的通用缓存使用您配置的缓存或默认添加的共享缓存。在大多数情况下，底层共享缓存应满足您的需求。如需使用默认缓存，只需省略 <CacheResource> 元素即可。

如需详细了解如何配置缓存，请参阅创建和修改环境缓存。如需详细了解底层数据存储区，请参阅缓存内部。

流变量

流变量可用于配置基于 HTTP 标头或消息内容或者流中可用的上下文的政策和流的动态运行时行为。如需详细了解流变量，请参阅变量参考文档。

自定义您在 LookupCache 政策中定义的缓存行为后，以下预定义的流变量将可用。

错误代码

This section describes the error messages and flow variables that are set when this policy triggers an error. This information is important to know if you are developing fault rules for a proxy. To learn more, see What you need to know about policy errors and Handling faults.

Error code prefix

N/A

Runtime errors

This policy does not throw any runtime errors.

Deployment errors

These errors can occur when you deploy a proxy containing this policy.

Fault variables

N/A

Example error response

N/A