Agregue dependencias de Maven y filtro de datos para sesiones de Java
Esta página proporciona los pasos para agregar dependencias de Maven y definir filtros para proveedores de sesiones de sitio único y de sitios múltiples para configurar sesiones web con NCache.
Agregar dependencias de Maven para sesiones de Java
El usuario debe agregar las siguientes dependencias de Maven en su pom.xml
archivo mientras trabaja con el NCache módulo de almacenamiento en caché de sesiones con una versión Tomcat 10 o menos. Agregará todos los .jar archivos a su proyecto.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-javax-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Para Tomcat versión 10+, agregue el siguiente Mavendependency
> en el pom.xml
archivo.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Note
Para utilizar Maven paquetes para el NCache Professional, cambiar el <artifactId>
como se muestra en:
<artifactId>ncache-professional-sessions</artifactId>
.
Definición de filtro para sesiones de Java
Después de agregar las dependencias de Maven requeridas a su aplicación, debe agregar el filtro en el descriptor de implementación de su aplicación web. El descriptor de implementación es un archivo XML llamado web.xml ubicado en el directorio WEB-INF en el directorio raíz de la aplicación. Para garantizar un almacenamiento en caché de sesión correcto, aplique esto como el primer filtro en su descriptor de implementación (ya que los filtros se ejecutan en el orden definido en el descriptor de implementación). El archivo de clase que contiene la implementación del filtro se muestra a continuación:
com.alachisoft.ncache.web.sessionstate.NCacheSessionStoreProvider
Para configurar un filtro, primero debe definirlo en elfiltrar> etiqueta y luego proporcione una asignación de URL para el filtro usando elmapeo de filtros> etiqueta. La siguiente configuración de filtro significa que el filtro se aplicará a todas las URL en una aplicación 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>
Puedes configurar el NCache filtro de sesión con la configuración especificada en el sesión.xml archivo ubicado en %NCHOME%/config
. Debe especificar configPath con el parámetro de inicialización del filtro para cargar los ajustes de configuración.
<init-param>
<param-name>configPath</param-name>
<param-value>%NCHOME%/config</param-value>
</init-param>
Note
El valor de configPath debe ser el directorio de instalación de NCache.
El siguiente es un ejemplo de cómo debería verse el descriptor de implementación después de definir el 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>
Puede configurar el módulo de sesión como uniregional o multirregional.
Proveedor de estado de sesión de sitio único
Para un proveedor de estado de sesión de una sola región, especifique el sesión.xml como sigue:
<?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>
Proveedor de estado de sesión multisitio
Debe especificar una caché primaria y una o más secundarias para cada granja web en el sesión.xml archivo. La caché principal se utilizará para todo el tráfico local y todas las cachés secundarias se utilizarán cuando un usuario sea redirigido a una región diferente. El prefijo sid definido para cada caché en el sesión.xml El archivo se agrega al ID de la sesión. Este prefijo sid ayuda a dirigir al cliente al caché que contiene la sesión.
Para el módulo de sesión multirregional, especifique la siguiente configuración en el sesión.xml archivo:
<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>
Vea también
Resumen conceptual
Aplicación de implementación
Compatibilidad con sesiones de Java en varios sitios
Registro de errores