Configurer les applications pour le fournisseur de cache Spring générique
Vous pouvez activer NCache en tant que gestionnaire de cache Spring pour votre application en suivant les étapes ci-dessous.
Conditions préalables à la configuration des applications pour le fournisseur générique Spring Cache
- Le minimum requis Java la version est 17.0.
- La version de Spring Framework devrait être 6.0.12 ou plus.
Ajouter des packages Maven
Vous devez ajouter le Maven suivant <dependency>
dans votre pom.xml
fichier tout en travaillant avec le NCache Intégration du printemps.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-spring</artifactId>
<version>x.x.x</version>
</dependency>
Notes
- Utiliser Maven forfaits pour le NCache Professional, changer la
<artifactId>
comme indiqué ci-dessous:
<artifactId>ncache-professional-spring</artifactId>
.
Définition des configurations
Notes
Pour activer la mise en cache dans l'application Spring, ajoutez @EnableCaching annotation.
Après avoir ajouté les dépendances Maven requises, vous devez définir des beans dans votre application Spring à l'aide de la définition de bean Java ou XML.
Définition de bean basée sur Java
Pour définir des Beans à l'aide de la définition basée sur Java, ajoutez le @Haricot annotation dans votre CacheConfiguration
classe comme ci-dessous.
@Configuration
class CachingConfiguration {
@Bean
public CacheManager cacheManager() {
String resource = Path.of(System.getenv("NCHOME"), "config/ncache-spring.xml").toString();
SpringConfigurationManager springConfigurationManager = new SpringConfigurationManager();
springConfigurationManager.setConfigFile(resource);
NCacheCacheManager cacheManager = new NCacheCacheManager();
cacheManager.setSpringConfigurationManager(springConfigurationManager);
return cacheManager;
}
}
Notes
Utilisez l'option setConfigFile méthode pour spécifier le chemin de la xml fichier où les caches sont configurés.
La définition Bean basée sur Java est une meilleure approche que la définition basée sur XML car elle est de type sécurisé et détecte toutes les erreurs de type au moment de la compilation.
Définition de bean basée sur XML
Pour définir des beans à l'aide de la définition basée sur XML, ajoutez un .xml fichier dans votre application qui définit les beans pour l'application et utilisez le @ImportResource annotation pour importer la ressource pertinente dans votre fichier principal. De plus, pour garantir une mise en cache correcte, spécifiez les propriétés suivantes pour le cacheManager
.
- springConfigurationManager : Référence à la NCache bean du gestionnaire de configuration.
- logFilePath : Chemin complet pour les journaux du gestionnaire de cache.
<bean id="cacheManager" class="com.alachisoft.integrations.spring.NCacheCacheManager">
<property name="springConfigurationManager" ref="NCacheConfigurationManager"/>
<property name="logFilePath" value="C:\Program Files\NCache\log-files\CustomerDBSpringLogs"/>
</bean>
Ajoutez également un <bean>
tag avec le id car NCacheConfigurationManager
et spécifiez le SpringConfigurationManager
classe. Spécifiez le chemin complet de votre fichier de configuration ncache-spring.xml en tant que propriété configFile du gestionnaire de configuration.
Notes
ncache-spring.xml est le fichier XML dans lequel les caches sont configurés.
<bean id="NCacheConfigurationManager" class="com.alachisoft.integrations.spring.configuration.SpringConfigurationManager">
<property name="configFile" value="ncache-spring.xml">
</bean>
Notes
Si la chemin du fichier journal n'est pas précisé, et NCache a été installé, alors le NCHOME/log-files/springCacheLogs
path sera utilisé par défaut par l’application. Sinon, il utilise le User Working Directory/springCacheLogs
chemin.
Configurer les caches Spring
La NCache Le centre de gestion emploie le ncache-spring.xml fichier fourni dans le bean cacheManager pour configurer les caches. Pour configurer les caches, vous devez ajouter un cache avec ses propres propriétés (par exemple, l'expiration et l'expulsion des éléments).
- nom-cache-par-défaut : Cela vous permet de spécifier un cache par défaut pour l'application Spring. Si la configuration du cache requise est manquante dans le fichier de configuration, il utilisera le cache par défaut.
- cache : Plusieurs caches peuvent être définis sous cette balise.
- ncache-exemple: Chaque cache Spring est mappé sur une instance de cache spécifique. Plusieurs caches Spring peuvent utiliser la même instance de cache. Le NCache
cacheManager
for Spring enregistre les données de chaque cache Spring dans le cache. - priorité: Ceci spécifie la priorité relative des éléments ajoutés au cache. Si l'expulsion basée sur la priorité est activée, le cache expulse en premier les éléments ayant la priorité la moins élevée.
- type d'expiration : Active l’expiration absolue ou glissante.
- période d'expiration : Spécifie le délai (en secondes) après lequel le cache déclenche l'expiration.
<application-config default-cache-name="demoCache">
<caches>
<cache name="demoCache" ncacheid-instance="democache" priority="normal" expiration-type="absolute" expiration-period="300"/>
</caches>
</application-config>
Une fois que vous avez activé la mise en cache, l'étape suivante consiste à lier le comportement de mise en cache aux méthodes et à utiliser NCache en tant que fournisseur de mise en cache pour Spring. Pour ce faire, reportez-vous à la section sur Configurer les applications à l'aide de la déclaration de mise en cache.
Voir aussi
NCache en tant que cache de données Spring
Journalisation des erreurs