Пример: кэширование общего назначения

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info

Для более быстрого доступа к данным можно использовать политики, позволяющие хранить их в кэше общего назначения. С помощью следующих политик ваш прокси-сервер сможет хранить и извлекать кэшированные данные во время выполнения:

Эти правила предназначены для общего кэширования данных, используемых вашими прокси-серверами.

Пример кода в этом разделе основан на примере прокси-сервера для исходящей аутентификации OAuth на Github (см. список примеров ). В этом примере используется политика кэширования для хранения токена доступа OAuth для повторного использования в нескольких исходящих вызовах.

Каждый тип политики определяется XML-схемой (.xsd). Для справки, схемы политик доступны на GitHub.

В следующем примере токен доступа OAuth записывается в кэш с помощью политики PopulateCache. Токен OAuth извлекается для последующих запросов с помощью политики LookupCache. После истечения срока действия токена доступа используется JavaScript для получения нового токена доступа, который, в свою очередь, кэшируется политикой PopulateCache.

Заполнить кэш

Используйте политику PopulateCache для записи данных в кэш. В этом примере в кэш записывается токен доступа OAuth. Для получения дополнительной информации о политике см. раздел «Политика PopulateCache» .

<PopulateCache name="token-cache">
    <!-- The cache to write to. -->
    <CacheResource>mycache</CacheResource>
    <!-- The source of the data, a variable containing the value. -->
    <Source>twitter-translate.apiAccessToken</Source>
    <!-- An enumeration representing a prefix for namespace scope. -->
    <Scope>Exclusive</Scope>
    <!-- A unique pointer (a flow variable value) to the data. Use this later to retrieve it. -->
    <CacheKey>
        <KeyFragment>apiAccessToken</KeyFragment>
        <KeyFragment ref="request.queryparam.client_id"></KeyFragment>
    </CacheKey>
    <!-- Entries placed into the cache with this policy will expire after 600 seconds. -->
    <ExpirySettings>
        <TimeoutInSec>600</TimeoutInSec>
    </ExpirySettings>
</PopulateCache>

Переменные могут заполняться политиками или кодом. В этом примере переменная Source заполняется следующим вызовом JavaScript: context.setVariable('twitter-translate.apiAccessToken', getAccessToken());

Дополнительную информацию о ключах кэша см. в разделе «Работа с ключами кэша» .

Поиск кэшированных данных

Вы можете получить кэшированные значения с помощью политики LookupCache. Следующая политика LookupCache считывает значение из mycache и записывает его в переменную twitter-translate.apiAccessToken . Для получения дополнительной информации о политике см. раздел «Политика LookupCache» .

<LookupCache name="token-cache">
    <!-- The cache to read from. -->
    <CacheResource>mycache</CacheResource>
    <!-- Where to assign the retrieved value - here, a variable. -->
    <AssignTo>twitter-translate.apiAccessToken</AssignTo>
    <!-- An enumeration representing a prefix for namespace scope. -->
    <Scope>Exclusive</Scope>
    <!-- The unique pointer (a flow variable value) that was used to store the data in the cache. -->

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

Очистите кэш

Аннулирование кэша можно выполнить явно, указав HTTP-заголовок. При получении запроса, содержащего указанный HTTP-заголовок, кэш будет очищен. Для получения дополнительной информации о политике см. политику InvalidateCache .

<InvalidateCache name="InvalidateMyCache">
    <!-- The cache to invalidate. -->
    <CacheResource>test-cache</CacheResource>
    <!-- An enumeration representing a prefix for namespace scope. -->
    <Scope>Exclusive</Scope>
    <!-- Fragments constructing the unique pointer used when 
        the data was put into the cache. -->
    <CacheKey>
        <KeyFragment>apiAccessToken</KeyFragment>
        <KeyFragment ref="request.queryparam.client_id" />
    </CacheKey>
    <PurgeChildEntries>true</PurgeChildEntries>
</InvalidateCache>