Aggiungi dipendenze Maven e filtro dati per sessioni Java
Questa pagina fornisce i passaggi per aggiungere dipendenze Maven e definire filtri per provider di sessioni a sito singolo e multisito per configurare sessioni Web con NCache.
Aggiunta di dipendenze Maven per sessioni Java
L'utente deve aggiungere le seguenti dipendenze Maven nel loro pom.xml
file mentre si lavora con il file NCache modulo di memorizzazione nella cache della sessione con una versione Tomcat 10 o inferiore. Aggiungerà tutto il .jar file al tuo progetto.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-javax-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Per Tomcat versione 10+, aggiungi il seguente Mavendependency
> nel pom.xml
file.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-sessions</artifactId>
<version>x.x.x</version>
</dependency>
Note:
Per utilizzare Maven pacchetti per il NCache Professional, cambiare il <artifactId>
Come mostrato in:
<artifactId>ncache-professional-sessions</artifactId>
.
Definizione del filtro per le sessioni Java
Dopo aver aggiunto le dipendenze Maven richieste alla tua applicazione, devi aggiungere il filtro nel descrittore di distribuzione della tua applicazione web. Il descrittore di distribuzione è un file XML denominato web.xml situato nella directory WEB-INF nella directory root dell'applicazione. Per garantire la corretta memorizzazione nella cache della sessione, applicalo come primo filtro nel descrittore di distribuzione (poiché i filtri vengono eseguiti nell'ordine definito nel descrittore di distribuzione). Il file di classe contenente l'implementazione del filtro è come mostrato di seguito:
com.alachisoft.ncache.web.sessionstate.NCacheSessionStoreProvider
Per configurare un filtro, devi prima definirlo sotto ilfiltro> tag e quindi fornire una mappatura URL per il filtro utilizzando il tagmappatura dei filtri> etichetta. La configurazione del filtro seguente indica che il filtro verrà applicato a tutti gli URL in un'applicazione 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>
Puoi configurare il NCache filtro di sessione con le impostazioni specificate nel file sessione.xml file che si trova in %NCHOME%/config
. È necessario specificare configPath con il parametro di inizializzazione del filtro per caricare le impostazioni di configurazione.
<init-param>
<param-name>configPath</param-name>
<param-value>%NCHOME%/config</param-value>
</init-param>
Note:
Il valore di configPath deve essere la directory di installazione di NCache.
Quello che segue è un esempio di come dovrebbe apparire il descrittore di distribuzione dopo aver definito il 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>
È possibile configurare il modulo di sessione come a regione singola o multiregionale.
Provider dello stato della sessione a sito singolo
Per un provider di stato sessione a regione singola, specificare il file sessione.xml come 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>
Provider di stato sessione multisito
È necessario specificare una cache primaria e una o più cache secondarie per ciascuna web farm nel file sessione.xml file. La cache primaria verrà utilizzata per tutto il traffico locale e tutte le cache secondarie verranno utilizzate quando un utente viene reindirizzato a una regione diversa. Il prefisso sid definito per ciascuna cache nel file sessione.xml il file viene aggiunto all'ID sessione. Questo prefisso sid aiuta a indirizzare il client alla cache che contiene la sessione.
Per il modulo di sessione multiregionale, specificare la seguente configurazione nel file sessione.xml file:
<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>
Vedere anche
Panoramica concettuale
Distribuzione dell'applicazione
Supporto per sessioni Java multisito
Registrazione errori