O Spring Data Couchbase 2.0 \u00e9 uma reescrita do conector original do Spring Data Couchbase 1.4.x. Ele \u00e9 baseado no Couchbase Java 2.2 SDK e faz uso intenso da nova linguagem de consulta N1QL (que foi introduzida no Couchbase Server 4.0) para oferecer mais recursos aos usu\u00e1rios do Spring Data.<\/p>\n
O Primeiro marco<\/a> foi lan\u00e7ado em agosto do ano passado, seguido de um Release Candidate e, desde ent\u00e3o, recursos adicionais (e corre\u00e7\u00f5es de bugs) foram implementados, e agora a vers\u00e3o GA pode ser liberada para o p\u00fablico.<\/p>\n Vamos fazer um r\u00e1pido tour pelo que mudou (com uma nota\u00e7\u00e3o de \u2b50 a \u2b50\u2b50\u2b50\u2b50 de qu\u00e3o incr\u00edvel e significativo achamos que cada recurso \u00e9?)<\/p>\n As principais diferen\u00e7as entre a gera\u00e7\u00e3o 1.x do Dados do Spring Couchbase<\/a> e sua vers\u00e3o 2.x s\u00e3o:<\/p>\n \u00c9 claro que voc\u00ea ainda pode acessar a API de n\u00edvel inferior usando o \u2b50\u2b50\u2b50<\/p>\n O grande novo recurso do Couchbase 4.0 \u00e9 N1QL<\/strong>uma extens\u00e3o SQL que funciona em documentos JSON (portanto, adicionou especificidades relacionadas ao JSON ao SQL).<\/p>\n Isso \u00e9 especialmente bom para o O N1QL agora \u00e9 o recurso padr\u00e3o de apoio do Couchbase para os m\u00e9todos do Reposit\u00f3rio. Voc\u00ea tamb\u00e9m pode optar por usar a interface @Query se quiser ser expl\u00edcito na consulta executada.<\/p>\n \u2b50\u2b50<\/p>\n Uma grande mudan\u00e7a nesta vers\u00e3o \u00e9 que, agora, as consultas de reposit\u00f3rio (tamb\u00e9m conhecidas como m\u00e9todos de reposit\u00f3rio personalizados) baseadas em exibi\u00e7\u00f5es est\u00e3o mais alinhadas com a filosofia do Spring Data. Elas tamb\u00e9m precisam ser anotadas explicitamente com Isso significa que nada espec\u00edfico do Couchbase deve vazar para a interface do seu reposit\u00f3rio. Em vez disso, o que voc\u00ea pode fazer \u00e9 usar mecanismos de deriva\u00e7\u00e3o de consultas para a maioria das consultas.<\/p>\n A deriva\u00e7\u00e3o de consultas tamb\u00e9m \u00e9 poss\u00edvel em pequena escala, com algumas palavras-chave sendo aceitas em um m\u00e9todo apoiado em visualiza\u00e7\u00e3o.<\/p>\n \u2b50<\/p>\n Outra novidade que n\u00e3o era suportada anteriormente \u00e9 a execu\u00e7\u00e3o da fun\u00e7\u00e3o de redu\u00e7\u00e3o, se voc\u00ea tiver uma. Agora, para execut\u00e1-la, basta definir o par\u00e2metro Voc\u00ea tamb\u00e9m pode prefixar seu m\u00e9todo com \"count\" em vez de \"find\" se isso for significativo para voc\u00ea (ou seja, se voc\u00ea realmente usar a fun\u00e7\u00e3o de redu\u00e7\u00e3o \"count\").<\/p>\n Observe que a fun\u00e7\u00e3o reduce no Couchbase pode ser algo diferente da fun\u00e7\u00e3o _count preexistente e pode at\u00e9 mesmo retornar algo diferente de um long, como um Da mesma forma, adicionar a varia\u00e7\u00e3o \"topX\" ou \"firstX\" em um nome de m\u00e9todo resultar\u00e1 na defini\u00e7\u00e3o de um limite adicional na solicita\u00e7\u00e3o (por exemplo. \u2b50\u2b50\u2b50<\/p>\n Um aspecto que surge com frequ\u00eancia ao usar \u00edndices secund\u00e1rios preenchidos de forma ass\u00edncrona, como exibi\u00e7\u00f5es e GSI (o novo mecanismo de \u00edndice secund\u00e1rio que d\u00e1 suporte ao N1QL), \u00e9 a necessidade de ler imediatamente as modifica\u00e7\u00f5es de suas opera\u00e7\u00f5es de grava\u00e7\u00e3o anteriores.<\/p>\n Isso implica que a exibi\u00e7\u00e3o\/N1QL n\u00e3o deve responder enquanto os dados ainda estiverem em processo de indexa\u00e7\u00e3o, o que sacrifica um pouco o desempenho em favor da consist\u00eancia.<\/p>\n O oposto (e o padr\u00e3o atual do Spring Data Couchbase) \u00e9 favorecer o desempenho aceitando o retorno de dados obsoletos.<\/p>\n Adicionamos uma sem\u00e2ntica global para configurar todas as consultas (baseadas em visualiza\u00e7\u00e3o ou em N1QL) que s\u00e3o constru\u00eddas pela estrutura por meio da deriva\u00e7\u00e3o de consultas, fornecendo uma pequena abstra\u00e7\u00e3o em torno do conceito de consist\u00eancia.<\/p>\n Isso \u00e9 feito substituindo o Voc\u00ea tamb\u00e9m pode fazer isso em XML usando o atributo de consist\u00eancia no Desde o GA, os m\u00e9todos CRUD nos reposit\u00f3rios agora tamb\u00e9m levam em conta a consist\u00eancia configurada por padr\u00e3o.<\/p>\n \u2b50<\/p>\n Alguns usu\u00e1rios relataram problemas com o Spring Data e o Couchbase Mobile, com o Sync Gateway rejeitando documentos que cont\u00eam campos prefixados por um sublinhado.<\/p>\n Isso \u00e9 problem\u00e1tico para o Spring Data, pois, por padr\u00e3o, ele armazena as informa\u00e7\u00f5es de tipo em um A solu\u00e7\u00e3o \u00e9 permitir, por meio da configura\u00e7\u00e3o, modificar o nome do campo de informa\u00e7\u00f5es desse tipo. Voc\u00ea pode fazer isso substituindo o campo Esse campo \u00e9 usado pelas consultas N1QL geradas para filtrar apenas os documentos correspondentes \u00e0 entidade do reposit\u00f3rio.<\/p>\n \u2b50\u2b50<\/p>\n Usando o N1QL, para consultas geradas por meio da deriva\u00e7\u00e3o de consultas, \u2b50\u2b50\u2b50<\/p>\n Consultar o Couchbase usando coordenadas! Desde que sua entidade tenha um As consultas de c\u00edrculos e pol\u00edgonos s\u00e3o realizadas rapidamente como aproxima\u00e7\u00f5es de caixas delimitadoras no servidor e, em seguida, os falsos positivos s\u00e3o eliminados pela estrutura antes de apresentar os resultados.<\/p>\n Voc\u00ea pode aproveitar o aspecto multidimensional do Couchbase Spatial Views para adicionar dimens\u00f5es extras \u00e0s suas consultas (por exemplo, lojas que abrem tarde da noite em uma cidade...).<\/p>\n Observa\u00e7\u00e3o: se quiser reutilizar anota\u00e7\u00f5es, voc\u00ea tamb\u00e9m pode fazer isso (funciona para \u2b50\u2b50\u2b50<\/p>\n As consultas em linha podem usar a nota\u00e7\u00e3o SpEL para:<\/p>\n \u2b50\u2b50<\/p>\n \u26a0\ufe0f IMPORTANTE: isso \u00e9 considerado um aux\u00edlio durante o desenvolvimento\/testes e n\u00e3o \u00e9 recomendado na produ\u00e7\u00e3o<\/em><\/strong><\/p>\n Para garantir que a indexa\u00e7\u00e3o N1QL das entidades em um determinado reposit\u00f3rio seja ativada em um ambiente de desenvolvimento ou pr\u00e9-produ\u00e7\u00e3o, \u00e9 poss\u00edvel anot\u00e1-lo com Al\u00e9m disso, a visualiza\u00e7\u00e3o de apoio para a opera\u00e7\u00e3o CRUD pode ser criada automaticamente ao anotar o reposit\u00f3rio com Al\u00e9m disso, esse recurso deve ser ativado por meio da redefini\u00e7\u00e3o da op\u00e7\u00e3o \u2b50\u2b50<\/p>\n Isso \u00e9 especialmente voltado para consultas N1QL em linha com fun\u00e7\u00f5es de agrega\u00e7\u00e3o como \u2b50\u2b50<\/p>\n Use par\u00e2metros nomeados ou par\u00e2metros posicionais, mas n\u00e3o ambos. A sintaxe para par\u00e2metros nomeados \u00e9 \u2b50<\/p>\n Outros recursos incluem:<\/p>\n Algumas corre\u00e7\u00f5es de bugs e melhorias em rela\u00e7\u00e3o ao RC1 tamb\u00e9m foram implementadas.<\/p>\n \u2b50\u2b50\u2b50<\/p>\n Documenta\u00e7\u00e3o<\/a> tamb\u00e9m foi aprimorado, adicionando exemplos orientados para o Couchbase sobre como adicionar a implementa\u00e7\u00e3o de um m\u00e9todo personalizado a um reposit\u00f3rio, como alterar a classe base de todos os reposit\u00f3rios, como lidar com SpEL em consultas em linha, ...<\/p>\n O Spring Cache<\/a> foi movido para fora do reposit\u00f3rio do Spring Data. Ele ainda est\u00e1 l\u00e1 e planejamos aprimor\u00e1-lo. Por enquanto, voc\u00ea pode encontr\u00e1-lo em um Couchbase reposit\u00f3rio<\/a> no github, mas em breve ele dever\u00e1 se reintegrar \u00e0 fam\u00edlia oficial de projetos do Spring.<\/p>\n Voc\u00ea pode adicionar o seguinte \u00e0 se\u00e7\u00e3o Esperamos que voc\u00ea goste dessa vers\u00e3o e de todos os novos recursos que ela traz para a mesa. A pr\u00f3xima etapa ser\u00e1 a reinser\u00e7\u00e3o no Spring Data Couchbase 2.0 is a rewrite of the original Spring Data Couchbase 1.4.x connector. It is based on the Couchbase Java 2.2 SDK and makes heavy use of the new query language N1QL (which was introduced in Couchbase Server […]<\/p>","protected":false},"author":48,"featured_media":13873,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[1818],"tags":[1424,1465],"ppma_author":[9022],"class_list":["post-2162","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-java","tag-spring","tag-spring-data"],"acf":[],"yoast_head":"\nNovos recursos no Spring Data Couchbase 2.0<\/h2>\n
\n
CouchbaseTemplate<\/code>s que se conectam a um bucket diferente, ou at\u00e9 mesmo a clusters diferentes!)<\/li>\nCouchbaseTemplate<\/code> em vez de CouchbaseRepository<\/code> e voc\u00ea pode at\u00e9 mesmo acessar a interface subjacente Balde<\/code> do SDK.<\/p>\nM\u00e9todos de reposit\u00f3rio por meio do N1QL<\/h2>\n
Reposit\u00f3rio<\/code> padr\u00e3o e deriva\u00e7\u00e3o de consultas no Spring Data, porque a grande maioria das palavras-chave de deriva\u00e7\u00e3o de consultas pode ser facilmente traduzida para N1QL.<\/p>\npublic interface UserRepository extends Repository<User, String> {\r\n\r\n User findByUsernameEquals(String username);\r\n\r\n List findByUsernameContains(String contains);\r\n\r\n @Query \/\/optional for N1QL query derivation but more explicit\r\n List findByAgeBetween(int minAge, int maxAge);\r\n}<\/code><\/pre>\n<\/div>\nM\u00e9todos de reposit\u00f3rio por meio de visualiza\u00e7\u00f5es<\/h2>\n
@View(viewName=\"something\")<\/code>.<\/p>\npublic interface UserRepository extends Repository<User, String> {\r\n\r\n @Override\r\n @View(designDocument = \"user\", viewName = \"customFindAllView\")\r\n Iterable findAll();\r\n\r\n @View(viewName = \"customFindByNameView\")\r\n User findByUsernameIs(String lowKey);\r\n\r\n @View(viewName = \"customFindByNameView\")\r\n List findByUsernameBetween(String lowKey, String highKey);\r\n}<\/code><\/pre>\n<\/div>\nUsando a fun\u00e7\u00e3o reduce das visualiza\u00e7\u00f5es<\/h2>\n
reduzir<\/code> para true no sinalizador @Ver<\/code> anota\u00e7\u00e3o.<\/p>\nJsonObject<\/code>, como no caso do built-in _estat\u00edsticas<\/code>.<\/p>\nfindFirst5ByLastName<\/code> limitar\u00e1 a lista a 5 resultados).<\/p>\nConfigurando a consist\u00eancia, leia seus pr\u00f3prios textos<\/h2>\n
AbstractCouchbaseConfiguration<\/code>'s getDefaultConsistency()<\/code> m\u00e9todo. Consist\u00eancia<\/code> \u00e9 um enum que permite que voc\u00ea escolha entre LER_SUAS_PR\u00d3PRIAS_ESCRITAS<\/code>, FORTEMENTE_CONSISTENTE<\/code>, UPDATE_AFTER<\/code> e EVENTUALMENTE_CONSISTENTE<\/code>. Consulte a documenta\u00e7\u00e3o oficial para obter mais informa\u00e7\u00f5es sobre como eles funcionam exatamente e qual \u00e9 o impacto deles no momento da consulta.<\/p>\n<\/code> tag.<\/p>\nAltera\u00e7\u00e3o do campo de informa\u00e7\u00f5es de tipo no JSON armazenado<\/h2>\n
_classe<\/code> campo :(<\/p>\ntypeKey()<\/code> m\u00e9todo em AbstractCouchbaseConfiguration<\/code>. Por exemplo, voc\u00ea pode usar a constante MappingCouchbaseConverter.TYPEKEY_SYNCGATEWAY_COMPATIBLE<\/code> (que \u00e9 \"javaClass<\/code>“).<\/p>\nSuporte para
Pagin\u00e1vel<\/code>\/Solicita\u00e7\u00e3o de p\u00e1gina<\/code> em consultas derivadas do N1QL<\/h2>\nPagin\u00e1vel<\/code> e Classificar<\/code> agora s\u00e3o compat\u00edveis.<\/p>\n\n
PagingAndSortingRepository (Reposit\u00f3rio de pagina\u00e7\u00e3o e classifica\u00e7\u00e3o)<\/code> com base no N1QL.<\/li>\nfindAll<\/code> m\u00e9todos que dependem do N1QL para pagina\u00e7\u00e3o e\/ou classifica\u00e7\u00e3o. Usa a consist\u00eancia configurada padr\u00e3o.<\/li>\n<\/ul>\nConsultas geoespaciais e multidimensionais usando visualiza\u00e7\u00f5es espaciais<\/h2>\n
Ponto<\/code> (ou x<\/code> e y<\/code>), voc\u00ea pode encontr\u00e1-lo usando:<\/p>\n\n
findByLocationWithin(Box area)<\/code><\/li>\nfindByLocationWithin(Circle area)<\/code>, findByLocationWithin(Point center, Distance radius)<\/code>.<\/li>\nfindByLocationWithin(Polygon area)<\/code>, findByLocationWithin(Point[] polygon)<\/code>.<\/li>\nfindByLocationNear(Point near, Distance maxDistance)<\/code>.<\/li>\n<\/ul>\npublic interface DimensionalPartyRepository extends CrudRepository<Party, String> {\r\n\r\n @Dimensional(designDocument = \"partyGeo\", spatialViewName = \"byLocation\")\r\n List findByLocationNear(Point p, Distance d);\r\n\r\n @Dimensional(designDocument = \"partyGeo\", spatialViewName = \"byLocation\")\r\n List findByLocationWithin(Box boundingBox);\r\n\r\n @Dimensional(designDocument = \"partyGeo\", spatialViewName = \"byLocation\")\r\n List findByLocationWithin(Polygon zone);\r\n \r\n @Dimensional(designDocument = \"partyGeo\", spatialViewName = \"byLocationAndAttendees\", dimensions = 3)\r\n List findByLocationWithinAndAttendeesGreaterThan(Polygon zone, double minAttendees);\r\n}<\/code><\/pre>\n<\/div>\n@Ver<\/code> e @Query<\/code> tamb\u00e9m):<\/p>\npublic interface DimensionalPartyRepository extends CrudRepository<Party, String> {\r\n\r\n \/\/define your own meta-annotation\r\n @Dimensional(designDocument = \"partyGeo\", spatialViewName = \"byLocation\", dimensions = 2)\r\n @Retention(RetentionPolicy.RUNTIME)\r\n @interface IndexedByLocation { }\r\n \r\n \/\/use it :)\r\n @IndexedByLocation\r\n List findByLocationNear(Point p, Distance d);\r\n\r\n @IndexedByLocation\r\n List findByLocationWithin(Box boundingBox);\r\n\r\n @IndexedByLocation\r\n List findByLocationWithin(Polygon zone);\r\n \r\n \/\/here we use a variation with 3 dimensions, so we need to revert to @Dimensional\r\n @Dimensional(designDocument = \"partyGeo\", spatialViewName = \"byLocationAndAttendees\", dimensions = 3)\r\n List findByLocationWithinAndAttendeesGreaterThan(Polygon zone, double minAttendees);\r\n}<\/code><\/pre>\n<\/div>\nEm linha
N1QL<\/code> @Query<\/code> agora tem suporte para SpEL<\/h2>\n\n
#{#n1ql.selectEntity}<\/code> para gerar um SELECT ... FROM ...<\/code> cl\u00e1usula e #{#n1ql.filter}<\/code> no ONDE<\/code> para limitar a consulta \u00e0 entidade correta.<\/li>\nA cria\u00e7\u00e3o dos \u00edndices \"principais\" do reposit\u00f3rio pode ser acionada automaticamente<\/h2>\n
@N1qlPrimaryIndexed<\/code> (que permite a consulta de forma livre em todo o balde) e @N1qlSecondaryIndexed<\/code> (que indexar\u00e1 apenas os documentos correspondentes ao tipo de entidade, de forma semelhante \u00e0 cl\u00e1usula WHERE produzida pelo SpEL #{#n1ql.filter}<\/code>).<\/p>\n@ViewIndexed<\/code> (voc\u00ea precisar\u00e1 fornecer o nome do documento de design, que deve corresponder ao nome da classe simples da entidade com a primeira letra em min\u00fascula).<\/p>\ngerenciador de \u00edndice<\/code> feij\u00e3o no AbstractCouchbaseConfiguration<\/code>.<\/p>\nTipos de retorno simples (primitivos e
Cordas<\/code>) agora s\u00e3o suportados ao usar uma proje\u00e7\u00e3o de linha \u00fanica<\/h2>\nCOUNT(*)<\/code>, AVG(campo)<\/code>etc... A consulta deve retornar uma \u00fanica linha com uma \u00fanica proje\u00e7\u00e3o.<\/p>\nSuporte a par\u00e2metros nomeados em consultas em linha do N1QL<\/h2>\n
$paramName<\/code>exigindo que cada par\u00e2metro do m\u00e9todo seja anotado com @Param(\"paramName\")<\/code>.<\/p>\nOutros recursos<\/h2>\n
\n
couchbase<\/code>\", a fim de evitar conflitos com outras lojas.<\/li>\nCouchbaseTemplate<\/code><\/li>\n@Documento<\/code>, como um longo<\/code> + timeUnit<\/code><\/li>\n<\/ul>\nDocumenta\u00e7\u00e3o<\/h2>\n
Uma observa\u00e7\u00e3o sobre o Spring Cache<\/h2>\n
Obtendo o Spring Data Couchbase<\/h2>\n
pom.xml<\/code> para obter essa vers\u00e3o do GA (no depend\u00eancias<\/code> se\u00e7\u00e3o:<\/p>\n<!---->\r\n \r\n org.springframework.data\r\n spring-data-couchbase\r\n 2.0.0.RELEASE\r\n \r\n<!----><\/code><\/pre>\n<\/div>\nFunil<\/code> trem de lan\u00e7amento com uma vers\u00e3o 2.1<\/code> esperado antes do ver\u00e3o.<\/p>","protected":false},"excerpt":{"rendered":"