{"id":2226,"date":"2016-04-14T17:44:31","date_gmt":"2016-04-14T17:44:30","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=2226"},"modified":"2023-08-11T11:37:47","modified_gmt":"2023-08-11T18:37:47","slug":"spring-boot-couchbase-integration","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/es\/spring-boot-couchbase-integration\/","title":{"rendered":"Couchbase como ciudadano de primera clase de Spring Boot 1.4"},"content":{"rendered":"

Spring Boot 1.4.0<\/code> HITO 2<\/a> \u00a1ya est\u00e1 disponible! Este es un buen momento para hablaros del esfuerzo conjunto entre los miembros del equipo de Spring Boot y el equipo de Couchbase Java SDK para ofrecer una integraci\u00f3n de primera clase de Couchbase en Spring Boot :)<\/p>\n

<\/p>\n

En Spring Boot 1.4.0<\/code>Couchbase se convierte en un ciudadano de primera clase del ecosistema Spring Boot.<\/p>\n

Integraci\u00f3n del SDK de Couchbase<\/h2>\n

Spring Boot ahora reconoce directamente cuando se tiene la directiva SDK de Couchbase<\/code> en tu classpath. Y cuando ese sea el caso, instanciar\u00e1 un archivo Grupo<\/code> y un Cubo<\/code> frijol para usted utilizando autoconfiguraci\u00f3n<\/em>.<\/p>\n

Spring Boot puede recoger propiedades para configurar a\u00fan m\u00e1s estas clases principales del SDK, incluso la clase CouchbaseEnvironment<\/code>!<\/p>\n

Se reconocen las siguientes propiedades de bootstrapping:<\/p>\n

spring.couchbase.bootstrap-hosts\r\nspring.couchbase.bucket.name\r\nspring.couchbase.bucket.password\r\n<\/pre>\n
El ajuste del entorno (puntos finales IO, compatibilidad con SSL y tiempos de espera predeterminados de la API de sincronizaci\u00f3n) se expone a trav\u00e9s de las siguientes propiedades:<\/p>\n
spring.couchbase.env.endpoints.key-value\r\nspring.couchbase.env.endpoints.query\r\nspring.couchbase.env.endpoints.view\r\n\r\nspring.couchbase.env.ssl.enabled\r\nspring.couchbase.env.ssl.key-store\r\nspring.couchbase.env.ssl.key-store-password\r\n\r\nspring.couchbase.env.timeouts.connect\r\nspring.couchbase.env.timeouts.key-value\r\nspring.couchbase.env.timeouts.query\r\nspring.couchbase.env.timeouts.view\r\n<\/pre>\n
Esto s\u00ed que es ayuda: \u2b50\ufe0f\u2b50\ufe0f\u2b50\ufe0f\u2b50\ufe0f\u2b50\ufe0f<\/p>\n
ADVERTENCIA<\/strong>: Tenga en cuenta que en el hito anterior las propiedades de bootstrapping llevaban el prefijo \" spring.*data*.couchbase<\/code> \", que ahora se convierte en \" spring.couchbase<\/code> “.<\/p><\/blockquote>\n
Implementaci\u00f3n de Spring Cache<\/h2>\n
En Cach\u00e9 de primavera<\/a> tiene una implementaci\u00f3n en Couchbase 2.x, couchbase-spring-cache<\/code><\/a>.<\/p>\n
Spring Boot reconoce ahora esta implementaci\u00f3n de cach\u00e9 cuando tanto el SDK de Java como la aplicaci\u00f3n couchbase-spring-cache<\/code> est\u00e1n en el classpath.<\/p>\n
Esto se integra muy bien con la secci\u00f3n anterior, ya que el almacenamiento subyacente por defecto Cubo<\/code> para las cach\u00e9s es el autoconfigurado por Spring Boot :)<\/p>\n
NOTA<\/strong>: La implementaci\u00f3n de la cach\u00e9 se ha sacado del proyecto Spring Data Couchbase a su propio proyecto (en el repositorio github de Couchbase), para que pueda ser utilizado y liberado por separado de Spring Data.<\/p><\/blockquote>\n
CONSEJO<\/strong>: No te olvides de configurar al menos el spring.couchbase.bootstrap-hosts<\/code> propiedad.<\/p><\/blockquote>\n
Esta aplicaci\u00f3n de la Gestor de cach\u00e9<\/code> permite almacenar datos de varias cach\u00e9s en el mismo bucket de Couchbase, anteponiendo autom\u00e1ticamente a las claves en Couchbase el nombre de cada cach\u00e9.<\/p>\n
En CouchbaseCacheManager<\/code> reutilizar\u00e1 autom\u00e1ticamente el Cubo<\/code> autoconfigurados por Spring Boot. Simplemente a\u00f1adiendo una propiedad para listar declarativamente los nombres de las cach\u00e9s, se precargar\u00e1n las cach\u00e9s correspondientes:<\/p>\n
spring.cache.type=couchbase\r\nspring.cache.cache-names=foo,bar\r\n<\/pre>\n
Asistencia de cinco estrellas, \u00a1te lo decimos nosotros!<\/p>\n
Incluso puede configurarlo para almacenar datos para diferentes cach\u00e9s en m\u00faltiples cubos. Las cach\u00e9s pueden configurarse utilizando un patr\u00f3n de construcci\u00f3n fluido (por ejemplo, en un modelo CacheManagerCustomizer<\/code>). Este CacheBuilder<\/code> tambi\u00e9n permite ajustar a\u00fan m\u00e1s las cach\u00e9s, como establecer un tiempo de caducidad por defecto:<\/p>\n
@Configuration\r\npublic class CouchbaseCacheConfiguration {\r\n\r\n  private final Cluster cluster;\r\n\r\n  \/\/inject the Cluster from Boot core Couchbase support\r\n  public CouchbaseCacheConfiguration(Cluster cluster) {\r\n    this.cluster = cluster;\r\n  }\r\n\r\n  @Bean\r\n  public Bucket anotherBucket() {\r\n    return this.cluster.openBucket(\"another\", \"secret\");\r\n  }\r\n\r\n  @Bean\r\n  public CacheManagerCustomizer cmCustomizer() {\r\n    return c -> {\r\n      c.prepareCache(\"biz\", CacheBuilder\r\n              .newInstance(anotherBucket())\r\n              .withExpirationInMillis(2000));\r\n    };\r\n  }\r\n}<\/code><\/pre>\n
Esta implementaci\u00f3n puede utilizar vistas para borrar selectivamente cach\u00e9s que est\u00e1n colocadas en el mismo Bucket.<\/p>\n
Por \u00faltimo, admite la creaci\u00f3n din\u00e1mica de cach\u00e9s a medida que se solicitan. Para activarlo, simplemente omite declarar cualquier nombre de cach\u00e9 y simplemente activa la cach\u00e9 de Couchbase con la propiedad relevante:<\/p>\n
spring.cache.type=couchbase\r\n<\/pre>\n
Esto utilizar\u00e1 el Spring Boot autoconfigurado Cubo<\/code> como cubo por defecto para todas las cach\u00e9s creadas din\u00e1micamente.<\/p>\n
Diversi\u00f3n con @Cacheable<\/code> \u00bfte espera?<\/p>\n
Integraci\u00f3n de datos de Spring<\/h2>\n
Spring Data Couchbase 2.1.0<\/code><\/a> (release train Hopper) ha incluido varias modificaciones que hacen que la integraci\u00f3n con Spring Boot sea pan comido.<\/p>\n
Primero el sospechoso de siempre: por defecto Spring Boot autoconfigurar\u00e1 Spring Data Couchbase para que utilice la directiva Cubo<\/code> creado. Esto es posible gracias a haber separado las partes principales de configuraci\u00f3n del SDK en un CouchbaseConfigurer<\/code> mientras que lo que es realmente espec\u00edfico de Spring Data se encuentra en una nueva clase base, AbstractCouchbaseDataConfiguration<\/code>.<\/p>\n
Si s\u00f3lo utiliza datos de Spring, puede seguir utilizando la funci\u00f3n AbstractCouchbaseConfiguration<\/code>que ahora es tanto un CouchbaseConfigurer como un AbstractCouchbaseDataConfiguration.<\/p>\n
Sin embargo, si utiliza Spring Boot, se autoconfigurar\u00e1 un archivo CouchbaseConfigurer<\/code>. Siempre puedes afinar tu propio AbstractCouchbaseDataConfiguration<\/code> e inyectar el configurador en \u00e9l.<\/p>\n
Otras funciones de Spring Data Couchbase<\/h3>\n
La versi\u00f3n 2.1.0 tambi\u00e9n incluye algunas novedades:<\/p>\n