Adicionar dependências Maven e filtro de dados para sessões Java
Esta página fornece as etapas para adicionar dependências do Maven e definir filtros para provedores de sessões de site único e multisite para configurar sessões da Web com NCache.
Adicionando dependências Maven para sessões Java
O usuário precisa adicionar as seguintes dependências do Maven em seu pom.xml
arquivo enquanto trabalha com o NCache módulo de cache de sessão com Tomcat versão 10 ou inferior. Ele irá adicionar todos os .jar arquivos para o seu projeto.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-javax-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Para Tomcat versão 10+, adicione o seguinte Mavendependency
> no pom.xml
arquivo.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Note
Para utilizar o Maven pacotes para o NCache Professional, mudar o <artifactId>
como mostrado em:
<artifactId>ncache-professional-sessions</artifactId>
.
Definindo Filtro para Sessões Java
Depois de adicionar as dependências Maven necessárias ao seu aplicativo, você precisa adicionar o filtro no descritor de implantação do seu aplicativo web. O descritor de implantação é um arquivo XML denominado web.xml localizado no diretório WEB-INF no diretório raiz do aplicativo. Para garantir o cache de sessão correto, aplique-o como o primeiro filtro em seu descritor de implantação (já que os filtros são executados na ordem definida no descritor de implantação). O arquivo de classe contendo a implementação do filtro é mostrado abaixo:
com.alachisoft.ncache.web.sessionstate.NCacheSessionStoreProvider
Para configurar um filtro, você deve defini-lo primeiro sob ofiltro> tag e, em seguida, forneça um mapeamento de URL para o filtro usando omapeamento de filtro> etiqueta. A configuração de filtro a seguir significa que o filtro será aplicado a todas as URLs em um aplicativo da web.
<filter>
<filter-name>NCacheSessionProvider</filter-name>
<filter-class>com.alachisoft.ncache.web.session.NCacheSessionProvider</filter-class>
</filter>
<filter-mapping>
<filter-name>NCacheSessionProvider</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
Você pode configurar o NCache filtro de sessão com as configurações especificadas no sessão.xml arquivo localizado em %NCHOME%/config
. Você deve especificar o configPath com o parâmetro de inicialização do filtro para carregar as definições de configuração.
<init-param>
<param-name>configPath</param-name>
<param-value>%NCHOME%/config</param-value>
</init-param>
Note
O valor do configPath deve ser o diretório de instalação do NCache.
Veja a seguir um exemplo de como o descritor de implantação deve ficar depois de definir o filtro.
<session-config>
<session-timeout>30</session-timeout>
</session-config>
<filter>
<filter-name>NCacheSessionProvider</filter-name>
<filter-class>com.alachisoft.ncache.web.session.NCacheSessionProvider</filter-class>
<init-param>
<param-name>configPath</param-name>
<param-value>%NCHOME%/config</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>NCacheSessionProvider</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
Você pode configurar o módulo de sessão como regional único ou multirregional.
Provedor de estado de sessão de site único
Para um provedor de estado de sessão regional único, especifique o sessão.xml como se segue:
<?xml version="1.0" encoding="UTF-8"?>
<servlet-session-config>
<cache id="demoCache"/>
<log log-props="log4j.properties"/>
<locking enable-session-locking="true" retries-count="2" retry-interval="500ms" lock-timeout="36000ms" empty-session-when-locked="false"/>
</servlet-session-config>
Provedor de estado de sessão multissite
Você deve especificar um cache primário e um ou mais caches secundários para cada web farm no campo sessão.xml arquivo. O cache primário será usado para todo o tráfego local e todos os caches secundários serão usados quando um usuário for redirecionado para uma região diferente. O prefixo sid definido para cada cache no sessão.xml arquivo é adicionado ao ID da sessão. Este prefixo sid ajuda a direcionar o cliente para o cache que contém a sessão.
Para o módulo de sessão multirregional, especifique a seguinte configuração no arquivo sessão.xml arquivo:
<servlet-session-config>
<log log-props="log4j.properties"/>
<locking enable-session-locking="true" retries-count="2" retry-interval="500ms" lock-timeout="36000ms" empty-session-when-locked="false"/>
<multi-site-cache>
<primary-cache id="LondonCache" sid-prefix="LDNC"/>
<secondary-cache id="TokyoCache" sid-prefix="TKYC"/>
<secondary-cache id="NewYorkCache" sid-prefix="NYKC"/>
</multi-site-cache>
</servlet-session-config>
Veja também
Visão Geral Conceitual
Como implantar o aplicativo
Suporte a sessão Java multi-site
Registro de erros