Páginas em Cache

O Lumis permite otimização de acesso a páginas através do recurso de cache HTML.

Quando uma página é configurada para usar o cache html, o Lumis Portal gerencia seu acesso gerando um arquivo HTML com o conteúdo correspondente para cada URL. Caso a URL possua parâmetros, por exemplo, em uma página que se deseja exibir o detalhe de uma notícia específica, o Lumis Portal gera um arquivo HTML para cada conjunto de parâmetros reconhecidos.

As páginas que possuem interfaces de interação com o usuário, cujos parâmetros não são conhecidos pelo portal, somente podem ser cacheadas se  estas interfaces estiverem configuradas como client-side. Isso é porque interfaces que possuem render actions, assim como outras requisições de POST, não funcionam normalmente em cache HTML, pois este leva em conta apenas query string e não parâmetros em POST .

Quando a interface é configurada para ter renderização client-side, ela funciona corretamente em uma página com cache HTML habilitado, pois os render actions são renderizados dinamicamente, sem utilizar a infraestrutura de cache HTML. Tais interfaces são: filtros com valores digitados pelo usuário, Participar do serviço de Sala de Chat, login (utilizando o estilo da interface padrão do produto), entre outros. A exceção está para o serviço de Busca já que os parâmetros são passados via query string, e portanto, será gerada um cache html para cada consulta.

Interfaces que executam process actions não podem ser cacheadas.

Há uma limitação quanto às páginas que contém interfaces de adicionar e editar, pertencentes aos serviços de Fórum, Wiki e Blog, por exemplo. Elas não podem ter o cache HTML habilitado. Devido à sua característica dinâmica, não compensa habilitar o cache html para as páginas desses serviços.
 

O cache HTML de página é opcional e precisa ser determinado nas propriedades gerais de cada uma, na administração do portal.

Páginas que Não são cacheadas (páginas dinâmicas) serão sempre exibidas como: /main.jsp?lumPageId= XXXXX.

Já o cache de página (página estática) é exibida com extensão ".HTM". Além disso, o nome do arquivo é um Guid. Como exemplo: http://dominio:porta/contexto/data/pages/8A488A1D22BD37260122BD51809F0652.htm. A página htm é gerada em www/data/page.

Importante ressaltar que a extensão é configurável e com URLs amigáveis o Guid será adaptado.

A URL é aquela definida no elemento <frameworkUrl> da configuração <htmlGeneration> localizado no arquivo lumisdata/config/lumisportalconfig.xml:
 

Neste arquivo encontram-se também outra configurações que podem ser realizadas para o funcionamento desejado de cache de página. Abaixo, os detalhes dessas configurações:

• connectTimeout: Número de milissegundos para timeout da conexão do gerador de cache, como padrão 30000;

• pageRequestTimeout: tempo em milisegundos de espera para a geração de uma página HTML;

• frameworkURL: Permite definir a URL que o gerador de cache utiliza para exibir as páginas HTML . Quando não definida neste parâmetro, ou se a configuração <htmlGeneration> estiver comentada,  será assumido o  valor do parâmetro  <frameworkURL> localizado no início do arquivo lumisPortalConfig.xml;

• htmlCacheLogNavigation: Quando habilitado (valor "1"), informações de monitoração do evento de visualização de páginas também são coletadas para páginas com cache HTML;

• htmlFileExtension: determina qual extensão será utilizada para as páginas geradas. Por default, é .HTM;

• shtmlFileExtension: determina qual extensão será utilizada para as páginas geradas quando estiver sendo utilizada a tecnologia SSI. Por default, é .shtml;

• sendRedirectOnPageNotFound: configuração para cache com ssi. Se configurado para "true" (valor default ) permite que, quando o cache com SSI é acessado, mas ainda não foi gerado, efetua um sendRedirect para o browser acessar novamente a página htm, após ela ser gerada.

Este parâmetro faz-se necessário, por exemplo, no cenários de alguns servidores de aplicação utilizarem recurso de cache. Dessa forma, mesmo que a página htm exista, o resultado pode ser como não encontrada, e somente após alguns segundos o cache do servidor de aplicação é atualizado;

• waitBeforeSendRedirect: configuração para cache com ssi. Permite configurar o tempo em milissegundos de espera para ser realizado um sendRedirect para o browser acessar novamente a página HTM, após ela ser gerada. O valor default é de 500 milissegundos.

Este parâmetro faz-se necessário, por exemplo, no mesmo cenário descrito acima. Seria o tempo em milissegundos necessário para fazer o próximo sendRedirect, no intervalo utilizado pelo servidor de aplicação para atualizar o seu cache .

As operações de limpeza de cache disponibilizadas no Portal Studio não são submetidas à restrição mencionada anteriormente. Da mesma forma, outras operações podem decidir não usar o limite estipulado através da API durante a emissão do evento. A configuração é utilizada se outro limite não for forçado pela implementação que gera o evento.
 

O gerenciador de páginas em cache exibe as seguintes informações:

A ordenação das páginas HTML pode ser alterada por qualquer uma das outras colunas exibidas no gerenciador.

A geração de cache é centralizada em threads que podem utilizar dois modos para geração de página HTML: geração sob demanda e geração automática. Nos dois modos, o browser solicita a requisição, através de uma URL. Se o cache estiver desatualizado é solicitado para o gerador gerar essa página. Após a geração é entregue para o browser a página gerada. O gerador é um processo em paralelo que acontece com a geração sob demanda que agiliza a geração das páginas desatualizadas.

Limpar Cache do canal ou da Página

O Lumis permite provocar a limpeza de cache pela árvore de canal através das propriedades descritas Limpeza de Cache.

Funções Administrativas do Gerenciador de Cache

Desabilitar Geração é util, por exemplo, em um cenário de importação/exportação de ambiente com grande número de acessos de usuários. Durante a atualização de canais e páginas, o gerador HTML limpa os caches e, com isso,  se houver acesso aos canais durante a importação, o usuários podem acessar páginas antigas.

Para desabilitar a geração de cache de uma página específica, acessar suas propriedades via right-click, e atribuir o valor "Não" para o campo Gerar arquivo html. Dessa forma, para cada cache HTML da página, o Status será "Desabilitado", significando que o usuário não acessará mais uma página HTML e sim uma página dinâmica (JSP);

Insira os filtros desejados, como demonstra a imagem a seguir:

Para os campos canal, página e template de página a seta para direita abre a interface que possibilita a seleção do elemento desejado, o “X” em vermelho ao lado apaga o input à esquerda que contem o respectivo valor.

Para os caminhos amigáveis, o input ao lado do texto caminho amigável possibilita a adição do valor na lista, também é possível acionar o botão clicando a tecla ‘ENTER’, após inserido na lista o caminho inserido pode ser apagado clicando no ‘X’ pertencente a mesma linha, ou pode trazer o valor para edição se for clicado sobre seu texto, (esta operação implica em retirar o caminho clicado da lista e inserir o seu valor no input, a partir deste momento o procedimento é equivalente a uma adição comum).

Clique Ok. Um relatório de parâmetros será exibido no painel de confirmação de expiração, note que além dos parâmetros selecionados, existe um campo ‘Número de cache de páginas a serem expirados’ que traz a quantidade de caches a serem expirados, para prosseguir com a expiração clique em confirmar, caso contrário clique em voltar para alterar os filtros.

 
     Descrição dos filtros:
 

Cada um dos filtros acima é combinado com os demais (se preenchidos) usando um ‘and’, aplicando-se às páginas e canais que pertençam a interseção destes elementos, ou seja, se um canal for selecionado e uma página que não pertença a mesma árvore deste canal, a interseção será vazia, logo não haverá caches a serem expirados.

   
  Comportamento da expiração das páginas:

Ao selecionar um conjunto de caches de páginas a ser expirada, esta implicará na expiração dos canais ancestrais de cada página. O inverso não é feito, ou seja, caso um canal tenha sido selecionado para ser expirados, mas seus filhos não estejam na mesma seleção, apenas o canal em questão é expirado.