Fügen Sie Maven-Abhängigkeiten und Datenfilter für Java-Sitzungen hinzu
Auf dieser Seite finden Sie die Schritte zum Hinzufügen von Maven-Abhängigkeiten und zum Definieren von Filtern für Single-Site- und Multi-Site-Sitzungsanbieter zum Konfigurieren von Websitzungen NCache.
Hinzufügen von Maven-Abhängigkeiten für Java-Sitzungen
Der Benutzer muss die folgenden Maven-Abhängigkeiten in seiner hinzufügen pom.xml
Datei während der Arbeit mit dem NCache Sitzungs-Caching-Modul mit einer Tomcat-Version 10 oder niedriger. Es wird alles hinzugefügt . Jar Dateien zu Ihrem Projekt hinzufügen.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-javax-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Fügen Sie für Tomcat Version 10+ den folgenden Maven hinzudependency
> in der pom.xml
Datei.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Note
So verwenden Sie Maven Pakete für die NCache Professional, ändere das <artifactId>
wie gezeigt in:
<artifactId>ncache-professional-sessions</artifactId>
.
Filter für Java-Sitzungen definieren
Nachdem Sie Ihrer Anwendung die erforderlichen Maven-Abhängigkeiten hinzugefügt haben, müssen Sie den Filter im Bereitstellungsdeskriptor Ihrer Webanwendung hinzufügen. Der Bereitstellungsdeskriptor ist eine XML-Datei mit dem Namen web.xml befindet sich im WEB-INF-Verzeichnis im Stammverzeichnis der Anwendung. Um eine korrekte Sitzungszwischenspeicherung sicherzustellen, wenden Sie dies als ersten Filter in Ihrem Bereitstellungsdeskriptor an (da Filter in der im Bereitstellungsdeskriptor definierten Reihenfolge ausgeführt werden). Die Klassendatei, die die Filterimplementierung enthält, sieht wie folgt aus:
com.alachisoft.ncache.web.sessionstate.NCacheSessionStoreProvider
Um einen Filter zu konfigurieren, müssen Sie ihn zunächst unter definierenFilter>-Tag und stellen Sie dann mithilfe des eine URL-Zuordnung für den Filter bereitFilterzuordnung> Tag. Die folgende Filterkonfiguration bedeutet, dass der Filter auf alle URLs in einer Webanwendung angewendet wird.
<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>
Sie können das konfigurieren NCache Sitzungsfilter mit den in der angegebenen Einstellungen session.xml Datei befindet sich bei %NCHOME%/config
. Sie müssen den configPath mit dem Filterinitialisierungsparameter angeben, um die Konfigurationseinstellungen zu laden.
<init-param>
<param-name>configPath</param-name>
<param-value>%NCHOME%/config</param-value>
</init-param>
Note
Der Wert von configPath muss das Installationsverzeichnis von sein NCache.
Im Folgenden sehen Sie ein Beispiel dafür, wie der Implementierungsdeskriptor nach der Definition des Filters aussehen sollte.
<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>
Sie können das Sitzungsmodul als einregional oder multiregional konfigurieren.
Single-Site-Sitzungsstatusanbieter
Geben Sie für einen einzelnen regionalen Sitzungsstatusanbieter den an session.xml wie folgt:
<?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>
Multi-Site-Sitzungsstatusanbieter
Sie müssen für jede Webfarm in der einen primären und einen oder mehrere sekundäre Caches angeben session.xml Datei. Der primäre Cache wird für den gesamten lokalen Datenverkehr verwendet und alle sekundären Caches werden verwendet, wenn ein Benutzer in eine andere Region umgeleitet wird. Das für jeden Cache im definierte Sid-Präfix session.xml Die Datei wird zur Sitzungs-ID hinzugefügt. Dieses Sid-Präfix hilft dabei, den Client zum Cache zu leiten, in dem sich die Sitzung befindet.
Geben Sie für das multiregionale Sitzungsmodul die folgende Konfiguration im an session.xml Datei:
<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>
Siehe auch
Konzeptionelle Übersicht
Anwendung bereitstellen
Multisite-Java-Session-Unterstützung
Fehlerprotokollierung