Configurar aplicaciones para el proveedor genérico de caché Spring
Puedes habilitar NCache como administrador de caché Spring para su aplicación siguiendo los pasos a continuación.
Requisitos previos para configurar aplicaciones para el proveedor genérico de caché Spring
- El mínimo requerido Java la versión es 17.0.
- La versión de Spring Framework debe ser 6.0.12 o superior.
Agregar paquetes de Maven
Debes agregar el siguiente Maven <dependency>
en tu pom.xml
archivo mientras trabaja con el NCache Integración de primavera.
<dependency>
<groupId>com.alachisoft.ncache</groupId>
<artifactId>ncache-spring</artifactId>
<version>x.x.x</version>
</dependency>
Note
- Para utilizar Maven paquetes para el NCache Professional, cambiar el
<artifactId>
como se muestra a continuación:
<artifactId>ncache-professional-spring</artifactId>
.
Definición de configuraciones
Note
Para habilitar el almacenamiento en caché en la aplicación Spring, agregue @EnableCaching anotación.
Después de agregar las dependencias de Maven requeridas, debe definir beans en su aplicación Spring utilizando la definición de Bean basada en Java o XML.
Definición de Bean basado en Java
Para definir Beans usando la definición basada en Java, agregue el @Frijol anotación en tu CacheConfiguration
clase como se muestra a continuación.
@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;
}
}
Note
Ingrese al establecer archivo de configuración método para especificar la ruta del xml archivo donde se configuran los cachés.
La definición de Bean basada en Java es un mejor enfoque que la definición basada en XML, ya que tiene seguridad de tipos y detecta todos los errores de tipo en tiempo de compilación.
Definición de Bean basada en XML
Para definir beans utilizando la definición basada en XML, agregue un .xml archivo en su aplicación que define beans para la aplicación y use el @Importación anotación para importar el recurso relevante en su archivo principal. Además, para garantizar un almacenamiento en caché correcto, especifique las siguientes propiedades para el cacheManager
.
- SpringConfigurationManager: Referencia a la NCache bean del administrador de configuración.
- ruta del archivo de registro: Ruta completa para los registros del administrador de caché.
<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>
Además, agregue un <bean>
etiqueta con el id como el NCacheConfigurationManager
y especificar el SpringConfigurationManager
clase. Especifique la ruta completa de su archivo de configuración ncache-primavera.xml como propiedad configFile del administrador de configuración.
Note
ncache-primavera.xml es el archivo XML donde se configuran los cachés.
<bean id="NCacheConfigurationManager" class="com.alachisoft.integrations.spring.configuration.SpringConfigurationManager">
<property name="configFile" value="ncache-spring.xml">
</bean>
Note
Si ruta del archivo de registro no se especifica, y NCache ha sido instalado, entonces el NCHOME/log-files/springCacheLogs
La aplicación utilizará la ruta de forma predeterminada. En caso contrario, utiliza el User Working Directory/springCacheLogs
camino.
Configurar cachés de primavera
La NCache El Centro de Gestión emplea el ncache-primavera.xml archivo proporcionado en el bean cacheManager para configurar cachés. Para configurar cachés, debe agregar un caché con sus propias propiedades (por ejemplo, caducidad y desalojo de elementos).
- nombre-de-caché-predeterminado: Esto le permite especificar un caché predeterminado para la aplicación Spring. Si falta la configuración de caché requerida en el archivo de configuración, utilizará el caché predeterminado.
- cachés: Se pueden definir varios cachés bajo esta etiqueta.
- ncache-ejemplo: Cada caché de Spring se asigna a una instancia de caché específica. Múltiples cachés de Spring pueden usar la misma instancia de caché. El NCache
cacheManager
para Spring registra los datos de cada caché de Spring en el caché. - prioridad: Esto especifica la prioridad relativa de los elementos agregados al caché. Si el desalojo basado en prioridad está habilitado, la caché desaloja primero los elementos con menor prioridad.
- tipo de caducidad: Habilita la caducidad absoluta o deslizante.
- período de caducidad: Especifica el tiempo (en segundos) después del cual la caché activa la caducidad.
<application-config default-cache-name="demoCache">
<caches>
<cache name="demoCache" ncacheid-instance="democache" priority="normal" expiration-type="absolute" expiration-period="300"/>
</caches>
</application-config>
Una vez que haya habilitado el almacenamiento en caché, el siguiente paso es vincular el comportamiento del almacenamiento en caché a los métodos y utilizar NCache como proveedor de almacenamiento en caché para Spring. Para ello, consulte la sección sobre Configurar aplicaciones mediante la declaración de almacenamiento en caché.