{"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\/pt\/spring-boot-couchbase-integration\/","title":{"rendered":"Couchbase como um cidad\u00e3o de primeira classe do Spring Boot 1.4"},"content":{"rendered":"

Inicializa\u00e7\u00e3o do Spring 1.4.0<\/code> MILESTONE 2<\/a> foi lan\u00e7ado! Este \u00e9 um bom momento para falar sobre o esfor\u00e7o conjunto entre os membros da equipe do Spring Boot e a equipe do Couchbase Java SDK para oferecer uma integra\u00e7\u00e3o de primeira classe do Couchbase no Spring Boot :)<\/p>\n

<\/p>\n

Em Inicializa\u00e7\u00e3o do Spring 1.4.0<\/code>Com o Spring Boot, o Couchbase se torna um cidad\u00e3o de primeira classe do ecossistema do Spring Boot!<\/p>\n

Integra\u00e7\u00e3o do SDK do Couchbase<\/h2>\n

O Spring Boot agora reconhece diretamente quando voc\u00ea tem a op\u00e7\u00e3o SDK do Couchbase<\/code> em seu classpath. E quando esse \u00e9 o caso, ele instancia um Aglomerado<\/code> e um Balde<\/code> para voc\u00ea usando autoconfigura\u00e7\u00e3o<\/em>.<\/p>\n

O Spring Boot pode pegar propriedades para configurar ainda mais essas classes principais do SDK, at\u00e9 mesmo a classe CouchbaseEnvironment<\/code>!<\/p>\n

As seguintes propriedades de bootstrapping s\u00e3o reconhecidas:<\/p>\n

spring.couchbase.bootstrap-hosts\r\nspring.couchbase.bucket.name\r\nspring.couchbase.bucket.password\r\n<\/pre>\n
O ajuste do ambiente (pontos de extremidade de IO, suporte a SSL e tempos limite padr\u00e3o da API de sincroniza\u00e7\u00e3o) \u00e9 exposto por meio das seguintes propriedades:<\/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
Esse \u00e9 o suporte do \u2b50\ufe0f\u2b50\ufe0f\u2b50\ufe0f\u2b50\ufe0f\u2b50\ufe0f!<\/p>\n
AVISO<\/strong>: Observe que, na etapa anterior, as propriedades de bootstrapping eram prefixadas com \" spring.*data*.couchbase<\/code> \", agora se tornando \" spring.couchbase<\/code> “.<\/p><\/blockquote>\n
Implementa\u00e7\u00e3o do cache do Spring<\/h2>\n
O Spring Cache<\/a> tem uma implementa\u00e7\u00e3o do Couchbase 2.x, couchbase-spring-cache<\/code><\/a>.<\/p>\n
O Spring Boot agora reconhece essa implementa\u00e7\u00e3o de cache quando tanto o Java SDK quanto o couchbase-spring-cache<\/code> est\u00e3o no classpath.<\/p>\n
Isso se integra perfeitamente \u00e0 se\u00e7\u00e3o anterior, visto que o armazenamento subjacente padr\u00e3o Balde<\/code> para os caches \u00e9 aquele autoconfigurado pelo Spring Boot :)<\/p>\n
OBSERVA\u00c7\u00c3O<\/strong>: A implementa\u00e7\u00e3o do cache foi retirada do projeto Spring Data Couchbase e colocada em seu pr\u00f3prio projeto (no reposit\u00f3rio github do Couchbase), para que pudesse ser usada e lan\u00e7ada separadamente do Spring Data.<\/p><\/blockquote>\n
DICA<\/strong>: N\u00e3o se esque\u00e7a de, pelo menos, configurar o spring.couchbase.bootstrap-hosts<\/code> propriedade.<\/p><\/blockquote>\n
Essa implementa\u00e7\u00e3o do Gerenciador de cache<\/code> permite armazenar dados de v\u00e1rios caches no mesmo bucket do Couchbase, prefixando automaticamente as chaves no Couchbase com o nome de cada cache.<\/p>\n
O CouchbaseCacheManager<\/code> reutilizar\u00e1 automaticamente o Balde<\/code> autoconfigurados pelo Spring Boot. Basta adicionar uma propriedade para listar declarativamente os nomes de cache para que os caches correspondentes sejam pr\u00e9-carregados:<\/p>\n
spring.cache.type=couchbase\r\nspring.cache.cache-names=foo,bar\r\n<\/pre>\n
N\u00f3s lhe dizemos que o suporte \u00e9 cinco estrelas!<\/p>\n
Voc\u00ea pode at\u00e9 mesmo configur\u00e1-lo para armazenar dados de diferentes caches em v\u00e1rios buckets. Os caches podem ent\u00e3o ser configurados usando um padr\u00e3o de construtor fluente (por exemplo, em um CacheManagerCustomizer<\/code>). Esse CacheBuilder<\/code> tamb\u00e9m permite que voc\u00ea ajuste ainda mais os caches, como definir um tempo de expira\u00e7\u00e3o padr\u00e3o:<\/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
Essa implementa\u00e7\u00e3o pode usar exibi\u00e7\u00f5es para limpar seletivamente caches que est\u00e3o localizados no mesmo Bucket.<\/p>\n
Por fim, ele oferece suporte \u00e0 cria\u00e7\u00e3o din\u00e2mica de caches \u00e0 medida que eles s\u00e3o solicitados. Para ativar isso, simplesmente omita a declara\u00e7\u00e3o de qualquer nome de cache e ative o cache do Couchbase com a propriedade relevante:<\/p>\n
spring.cache.type=couchbase\r\n<\/pre>\n
Isso usar\u00e1 a configura\u00e7\u00e3o autom\u00e1tica do Spring Boot Balde<\/code> como o bucket padr\u00e3o para todos os caches criados dinamicamente.<\/p>\n
Divers\u00e3o com @Cacheable<\/code> espera por voc\u00ea?<\/p>\n
Integra\u00e7\u00e3o de dados do Spring<\/h2>\n
Dados do Spring Couchbase 2.1.0<\/code><\/a> (trem de lan\u00e7amento Hopper) incluiu v\u00e1rias modifica\u00e7\u00f5es que facilitam a integra\u00e7\u00e3o com o Spring Boot.<\/p>\n
Primeiro, o suspeito de sempre: por padr\u00e3o, o Spring Boot configurar\u00e1 automaticamente o Spring Data Couchbase para usar o Balde<\/code> que ele criou. Isso \u00e9 poss\u00edvel porque as partes principais da configura\u00e7\u00e3o do SDK foram separadas em um Configurador do Couchbase<\/code> enquanto o que \u00e9 realmente espec\u00edfico do Spring Data est\u00e1 localizado em uma nova classe base, AbstractCouchbaseDataConfiguration<\/code>.<\/p>\n
Se voc\u00ea usar apenas o Spring Data, poder\u00e1 continuar usando o AbstractCouchbaseConfiguration<\/code>que agora \u00e9 um CouchbaseConfigurer e um AbstractCouchbaseDataConfiguration.<\/p>\n
No entanto, se voc\u00ea usar o Spring Boot, ele configurar\u00e1 automaticamente um Configurador do Couchbase<\/code>. Voc\u00ea sempre pode ajustar seu pr\u00f3prio AbstractCouchbaseDataConfiguration<\/code> e injetar o configurador nele.<\/p>\n
Outros recursos do Spring Data Couchbase<\/h3>\n
A vers\u00e3o 2.1.0 tamb\u00e9m inclui alguns novos recursos:<\/p>\n