Guia do desenvolvedor da API ScopedCacheManager

Os caches com escopo permitem que os clientes armazenem dados personalizados na memória para acesso mais rápido e definam quando eles serão invalidados. Isso pode ser útil quando o trabalho com dados leva mais tempo para obterisso do zero, como os resultados de uma consulta em várias tabelas. Use a API ScopedCacheManager para recuperar, definir e liberar dados de cache para aplicações com escopo.

Este guia inclui instruções para criar um cache com escopo e um par de tabelas para usar com a API ScopedCacheManager.

Você pode atribuir os seguintes tipos de pares de tabelas a um cache com escopo:

• Cache de par de tabelas: quando você precisa executar qualquer operação de atualização na tabela, todas as entradas no cache também são liberadas.
• Cache de par de linhas da tabela: quando você precisa executar qualquer operação de atualização na tabela, somente as entradas que têm o mesmo sys_id do registro editado são limpas do cache. As outras entradas permanecem as mesmas.
• Cache de par de colunas da tabela: quando você edita um campo na lista de colunas selecionadas, o cache inteiro é liberado.
• Cache de par de colunas e linhas da tabela: quando você edita um campo na lista de colunas selecionadas, as entradas que têm o mesmo sys_id do registro editado são limpas do cache.

Como criar um par de cache e tabela com escopo

Crie um cache com escopo e defina seu par de caches.

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Crie um cache com escopo. Ir para Tudo > Definição do Sistema > Caches com escopo.
2. Clique em Novo e insira um nome significativo no campo Nome do cache.
3. Insira um número no campo Máximo de entradas. Este valor representa o número máximo de entradas permitidas para este cache. O valor máximo é 100.
   Nota:

   O campo Aplicação deve incluir automaticamente o nome da aplicação com escopo para a qual este cache está sendo criado.
4. Certifique-se de que a caixa de seleção Ativo esteja marcada.
5. Marque a caixa de seleção Sempre compactar se quiser que os valores de cache com escopo ocupem menos espaço na memória ao serem compactados.
6. Clique em Enviar.
   O cache com escopo foi criado.
7. Crie um par de caches. Ir para Tudo > Definição do Sistema > Pares de cache com escopo.
8. Clique em Novo e clique na lupa para selecionar um cache no campo Cache com escopo.
9. Selecione uma tabela no menu Tabela.
10. Selecione uma opção no menu Tipo de par.
    • Cache de par de tabelas: quando você precisa executar qualquer operação de atualização na tabela, todas as entradas no cache também são liberadas.
    • Cache de par de linhas da tabela: quando você precisa executar qualquer operação de atualização na tabela, somente as entradas que têm o mesmo sys_id do registro editado são limpas do cache. As outras entradas permanecem as mesmas.
    • Cache de par de colunas da tabela: quando você edita um campo na lista de colunas selecionadas, o cache inteiro é liberado.
    • Cache de par de colunas e linhas da tabela: quando você edita um campo na lista de colunas selecionadas, as entradas que têm o mesmo sys_id do registro editado são limpas do cache.
11. Clique em Enviar.
    O par de tabelas de cache com escopo foi criado e está pronto para uso com a API ScopedCacheManager.