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 se tornam invalidados. Isso pode ser útil quando trabalhar com dados leva mais tempo para obterque 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 limpas.
• 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, todo o cache é liberado.
• Cache de par de coluna e linha 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 cache com escopo e um par de tabelas

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

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Crie um cache com escopo.
   1. Ir para Todos > 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 o 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, compactando-os.
   6. Clique em Enviar.
   O cache com escopo foi criado.
2. Crie um par de cache.
   1. Ir para Todos > Definição do Sistema > Pares de cache com escopo.
   2. Clique em Novo e clique na lupa para selecionar um cache no campo Cache com escopo.
   3. Selecione uma tabela no menu Tabela.
   4. 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 limpas.
      • 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, todo o cache é liberado.
      • Cache de par de coluna e linha 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.
   5. Clique em Enviar.
   O par de tabelas de cache com escopo foi criado e está pronto para uso com a API ScopedCacheManager.