Ajouter des dépendances Maven et un filtre de données pour les sessions Java
Cette page fournit les étapes pour ajouter des dépendances Maven et définir un filtre pour les fournisseurs de sessions mono-site et multi-sites afin de configurer des sessions Web avec NCache.
Ajout de dépendances Maven pour les sessions Java
L'utilisateur doit ajouter les dépendances Maven suivantes dans son pom.xml
fichier tout en travaillant avec le NCache module de mise en cache de session avec une version Tomcat 10 ou inférieure. Il ajoutera tous les .jar fichiers à votre projet.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-javax-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Pour Tomcat version 10+, ajoutez le Maven suivantdependency
> dans le pom.xml
fichier.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Notes
Utiliser Maven forfaits pour le NCache Professional, changer la <artifactId>
comme représenté sur la:
<artifactId>ncache-professional-sessions</artifactId>
.
Définition d'un filtre pour les sessions Java
Après avoir ajouté les dépendances Maven requises à votre application, vous devez ajouter le filtre dans le descripteur de déploiement de votre application Web. Le descripteur de déploiement est un fichier XML nommé web.xml situé dans le répertoire WEB-INF sous le répertoire racine de l'application. Pour garantir une mise en cache correcte des sessions, appliquez-le comme premier filtre dans votre descripteur de déploiement (car les filtres s'exécutent dans l'ordre défini dans le descripteur de déploiement). Le fichier de classe contenant l'implémentation du filtre est le suivant :
com.alachisoft.ncache.web.sessionstate.NCacheSessionStoreProvider
Pour configurer un filtre, vous devez d'abord le définir sous leune fonction filtre> balise, puis fournissez un mappage d'URL pour le filtre à l'aide de lamappage de filtre> balise. La configuration de filtre suivante signifie que le filtre sera appliqué à toutes les URL d'une application 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>
Vous pouvez configurer le NCache filtre de session avec les paramètres spécifiés dans le session.xml fichier situé à %NCHOME%/config
. Vous devez spécifier le configPath avec le paramètre d'initialisation du filtre pour charger les paramètres de configuration.
<init-param>
<param-name>configPath</param-name>
<param-value>%NCHOME%/config</param-value>
</init-param>
Notes
La valeur de configPath doit être le répertoire d'installation de NCache.
Voici un exemple de la façon dont le descripteur de déploiement devrait ressembler après avoir défini le filtre.
<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>
Vous pouvez configurer le module de session comme étant unirégional ou multirégional.
Fournisseur d'état de session monosite
Pour un fournisseur d'état de session monorégional, spécifiez le session.xml comme suit:
<?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>
Fournisseur d'état de session multisite
Vous devez spécifier un cache principal et un ou plusieurs caches secondaires pour chaque batterie de serveurs Web dans le session.xml déposer. Le cache principal sera utilisé pour tout le trafic local et tous les caches secondaires seront utilisés lorsqu'un utilisateur est redirigé vers une autre région. Le préfixe sid défini pour chaque cache dans le session.xml Le fichier est ajouté à l’ID de session. Ce préfixe sid permet de diriger le client vers le cache contenant la session.
Pour le module de session multirégional, spécifiez la configuration suivante dans le session.xml fichier:
<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>
Voir aussi
Aperçu conceptuel
Déploiement de l'application
Prise en charge des sessions Java multi-sites
Journalisation des erreurs