Spring Data Couchbase 2.0 es una reescritura del conector Spring Data Couchbase 1.4.x original. Se basa en el SDK Java 2.2 de Couchbase y hace un uso intensivo del nuevo lenguaje de consulta N1QL (que se introdujo en Couchbase Server 4.0) para ofrecer m\u00e1s funciones a los usuarios de Spring Data.<\/p>\n
En Primer hito<\/a> se public\u00f3 el pasado mes de agosto, a continuaci\u00f3n se lanz\u00f3 una versi\u00f3n candidata y, desde entonces, se han implementado nuevas funciones (y se han corregido errores).<\/p>\n Hagamos un r\u00e1pido recorrido por lo que ha cambiado (con una notaci\u00f3n de \u2b50 a \u2b50\u2b50\u2b50 de lo impresionante y significativa que nos parece cada caracter\u00edstica...):<\/p>\n Las principales diferencias entre la generaci\u00f3n 1.x de Spring Data Couchbase<\/a> y su versi\u00f3n 2.x son:<\/p>\n Por supuesto, puede seguir accediendo a la API de nivel inferior mediante la funci\u00f3n \u2b50\u2b50\u2b50<\/p>\n La gran novedad de Couchbase 4.0 es N1QL<\/strong>, una extensi\u00f3n de SQL que funciona con documentos JSON (por lo que a\u00f1ad\u00eda a SQL especificidades relacionadas con JSON).<\/p>\n Esto es especialmente bueno para los N1QL es ahora la funci\u00f3n de respaldo por defecto de Couchbase para los m\u00e9todos de Repositorio. Tambi\u00e9n puede optar por utilizar la interfaz @Query si desea ser expl\u00edcito en la consulta ejecutada.<\/p>\n \u2b50\u2b50<\/p>\n Un gran cambio en esta versi\u00f3n es que ahora, las consultas de repositorio (tambi\u00e9n conocidas como m\u00e9todos de repositorio personalizados) que se basan en vistas est\u00e1n m\u00e1s en l\u00ednea con la filosof\u00eda de Spring Data. Tambi\u00e9n tienen que ser anotados expl\u00edcitamente con Esto significa que nada espec\u00edfico de Couchbase deber\u00eda filtrarse en la interfaz de tu repositorio. En su lugar, lo que puedes hacer es utilizar mecanismos de derivaci\u00f3n de consultas para la mayor\u00eda de las consultas.<\/p>\n La derivaci\u00f3n de consultas tambi\u00e9n es posible en peque\u00f1a medida, con la aceptaci\u00f3n de unas pocas palabras clave en un m\u00e9todo basado en vistas.<\/p>\n \u2b50<\/p>\n Otra novedad que antes no se soportaba es la ejecuci\u00f3n de la funci\u00f3n reducir si se dispone de ella. Ahora, para ejecutarla, basta con establecer el par\u00e1metro Tambi\u00e9n puede anteponer a su m\u00e9todo el prefijo \"count\" en lugar de \"find\" si le resulta \u00fatil (es decir, si realmente utiliza la funci\u00f3n de reducci\u00f3n \"count\").<\/p>\n Tenga en cuenta que la funci\u00f3n de reducci\u00f3n en Couchbase puede ser algo diferente a la preexistente _count, e incluso podr\u00eda devolver algo diferente a un long como un Del mismo modo, si se a\u00f1ade la variaci\u00f3n \"topX\" o \"firstX\" en el nombre de un m\u00e9todo, se establecer\u00e1 un l\u00edmite adicional en la solicitud (por ejemplo. \u2b50\u2b50\u2b50<\/p>\n Una cosa que surge a menudo cuando se utilizan \u00edndices secundarios poblados as\u00edncronamente como vistas y GSI (el nuevo motor de \u00edndice secundario que respalda a N1QL), es la necesidad de leer inmediatamente las modificaciones de sus operaciones de escritura anteriores.<\/p>\n Esto implica que la vista\/N1QL no debe responder mientras los datos est\u00e9n a\u00fan en proceso de indexaci\u00f3n, por lo que se sacrifica algo de rendimiento en favor de la consistencia.<\/p>\n Lo contrario (y por defecto en Spring Data Couchbase) es favorecer el rendimiento aceptando que se devuelvan datos obsoletos.<\/p>\n Hemos a\u00f1adido una sem\u00e1ntica global para configurar todas las consultas (basadas en vistas o en N1QL) que son construidas por el framework a trav\u00e9s de la derivaci\u00f3n de consultas, proporcionando una peque\u00f1a abstracci\u00f3n en torno al concepto de Consistencia.<\/p>\n Esto se hace anulando la funci\u00f3n Tambi\u00e9n puede hacerlo en XML utilizando el atributo de coherencia en la variable Desde GA, los m\u00e9todos CRUD en repositorios ahora tambi\u00e9n tienen en cuenta la consistencia configurada por defecto.<\/p>\n \u2b50<\/p>\n Algunos usuarios han informado de problemas con Spring Data y la parte de Couchbase Mobile, con la puerta de enlace de sincronizaci\u00f3n rechazando documentos que contienen campos prefijados por un gui\u00f3n bajo.<\/p>\n Esto es problem\u00e1tico para Spring Data, ya que por defecto almacena la informaci\u00f3n de tipo en un archivo La soluci\u00f3n es permitir, a trav\u00e9s de la configuraci\u00f3n, modificar el nombre de ese campo de informaci\u00f3n de tipo. Puede hacerlo anulando la directiva Este campo es el que utilizan las consultas N1QL generadas para filtrar s\u00f3lo los documentos correspondientes a la entidad del repositorio.<\/p>\n \u2b50\u2b50<\/p>\n Utilizando N1QL, para consultas que se generan a trav\u00e9s de la derivaci\u00f3n de consultas, \u2b50\u2b50\u2b50<\/p>\n Consulta Couchbase usando coordenadas Siempre que su entidad tenga un Las consultas sobre c\u00edrculos y pol\u00edgonos se realizan r\u00e1pidamente en el servidor como aproximaciones de cajas delimitadoras y, a continuaci\u00f3n, el marco elimina los falsos positivos antes de presentar los resultados.<\/p>\n Puede aprovechar el aspecto multidimensional de Couchbase Spatial Views para a\u00f1adir dimensiones adicionales a sus consultas (por ejemplo, tiendas que abren tarde por la noche dentro de una ciudad...).<\/p>\n Nota: si desea reutilizar las anotaciones, tambi\u00e9n puede hacerlo (funciona para \u2b50\u2b50\u2b50<\/p>\n Las consultas en l\u00ednea pueden utilizar la notaci\u00f3n SpEL para:<\/p>\n \u2b50\u2b50<\/p>\n \u26a0\ufe0f IMPORTANTE: esto se considera una ayuda durante el desarrollo\/pruebas y se desaconseja en producci\u00f3n.<\/em><\/strong><\/p>\n Para asegurarse de que la indexaci\u00f3n N1QL de las entidades de un repositorio determinado est\u00e1 activada en un entorno de desarrollo o preproducci\u00f3n, se puede anotar con Adem\u00e1s, la vista de respaldo para la operaci\u00f3n CRUD puede crearse autom\u00e1ticamente anotando el repositorio con Esta funci\u00f3n debe activarse adicionalmente redefiniendo el campo \u2b50\u2b50<\/p>\n Esto est\u00e1 especialmente dirigido a las consultas N1QL en l\u00ednea con funciones de agregaci\u00f3n como \u2b50\u2b50<\/p>\n Utilice par\u00e1metros con nombre o par\u00e1metros posicionales, pero no ambos. La sintaxis de los par\u00e1metros con nombre es \u2b50<\/p>\n Otras caracter\u00edsticas son:<\/p>\n Tambi\u00e9n se han implementado algunas correcciones de errores y mejoras con respecto a la RC1.<\/p>\n \u2b50\u2b50\u2b50<\/p>\n Documentaci\u00f3n<\/a> tambi\u00e9n se ha mejorado, a\u00f1adiendo ejemplos orientados a Couchbase sobre c\u00f3mo a\u00f1adir la implementaci\u00f3n de un m\u00e9todo personalizado a un repositorio, c\u00f3mo cambiar la clase base de todos los repositorios, c\u00f3mo tratar con SpEL en consultas en l\u00ednea, ...<\/p>\n En Cach\u00e9 de primavera<\/a> ha salido del repositorio de Spring Data. Todav\u00eda est\u00e1 ah\u00ed y planeamos mejorarlo. Por ahora puedes encontrarlo en Couchbase repositorio<\/a> en github pero pronto deber\u00eda reintegrarse a la familia oficial de proyectos Spring.<\/p>\n Puede a\u00f1adir lo siguiente a su proyecto Esperamos que disfrute de esta versi\u00f3n y de todas las novedades que aporta. El siguiente paso ser\u00e1 volver a conectar con el 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":"\nNovedades de Spring Data Couchbase 2.0<\/h2>\n
\n
CouchbaseTemplate<\/code>s que se conectan cada uno a un bucket diferente, o incluso a clusters diferentes).<\/li>\nCouchbaseTemplate<\/code> en lugar del CouchbaseRepository<\/code> e incluso se puede acceder a la interfaz subyacente Cubo<\/code> del SDK.<\/p>\nM\u00e9todos de repositorio a trav\u00e9s de N1QL<\/h2>\n
Repositorio<\/code> y derivaci\u00f3n de consultas en Spring Data, porque la gran mayor\u00eda de las palabras clave de derivaci\u00f3n de consultas se pueden traducir f\u00e1cilmente a 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 repositorio a trav\u00e9s de Views<\/h2>\n
@View(viewName=\"algo\")<\/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>\nUso de la funci\u00f3n de reducci\u00f3n de Views<\/h2>\n
reducir<\/code> a true en el Ver<\/code> anotaci\u00f3n.<\/p>\nJsonObject<\/code>como por ejemplo Estad\u00edsticas<\/code>.<\/p>\nfindFirst5ByLastName<\/code> limitar\u00e1 la lista a 5 resultados).<\/p>\nConfigurar la coherencia, leer sus propios escritos<\/h2>\n
AbstractCouchbaseConfiguration<\/code>'s getDefaultConsistency()<\/code> m\u00e9todo. Coherencia<\/code> es un enum que permite elegir entre LEER_ESCRITURAS_PROPIAS<\/code>, FUERTEMENTE_CONSISTENTE<\/code>, UPDATE_AFTER<\/code> y EVENTUALMENTE_CONSISTENTE<\/code>. Consulte la documentaci\u00f3n oficial para obtener m\u00e1s informaci\u00f3n sobre c\u00f3mo funcionan exactamente y cu\u00e1l es su impacto en el momento de la consulta.<\/p>\n<\/code> etiqueta.<\/p>\nModificaci\u00f3n del campo de informaci\u00f3n de tipo en JSON almacenado<\/h2>\n
Clase<\/code> campo :(<\/p>\ntypeKey()<\/code> m\u00e9todo en AbstractCouchbaseConfiguration<\/code>. Por ejemplo, puede utilizar la constante MappingCouchbaseConverter.TYPEKEY_SYNCGATEWAY_COMPATIBLE<\/code> (que es \"javaClass<\/code>“).<\/p>\nApoyo a
Pageable<\/code>\/Petici\u00f3n de p\u00e1gina<\/code> en las consultas derivadas de N1QL<\/h2>\nPageable<\/code> y Ordenar<\/code> ahora son compatibles.<\/p>\n\n
PagingAndSortingRepository<\/code> basado en N1QL.<\/li>\nfindAll<\/code> que dependen de N1QL para la paginaci\u00f3n y\/o la ordenaci\u00f3n. Utiliza la coherencia configurada por defecto.<\/li>\n<\/ul>\nConsultas geoespaciales y multidimensionales mediante vistas espaciales<\/h2>\n
Punto<\/code> (o x<\/code> y y<\/code>), puede encontrarlo utilizando<\/p>\n\n
findByLocationWithin(Caja \u00e1rea)<\/code><\/li>\nfindByLocationWithin(C\u00edrculo \u00e1rea)<\/code>, findByLocationWithin(Punto centro, Distancia radio)<\/code>.<\/li>\nfindByLocationWithin(Pol\u00edgono \u00e1rea)<\/code>, findByLocationWithin(Punto[] pol\u00edgono)<\/code>.<\/li>\nfindByLocationNear(Punto cercano, Distancia maxDistancia)<\/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>\nVer<\/code> y @Query<\/code> tambi\u00e9n):<\/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>\nEn l\u00ednea
N1QL<\/code> @Query<\/code> ahora son compatibles con SpEL<\/h2>\n\n
#{#n1ql.selectEntity}<\/code> para generar un SELECT ... FROM ...<\/code> y #{#n1ql.filter}<\/code> en el DONDE<\/code> para limitar la consulta a la entidad correcta.<\/li>\nLa creaci\u00f3n de \u00edndices \"principales\" del repositorio puede activarse autom\u00e1ticamente<\/h2>\n
@N1qlPrimaryIndexed<\/code> (que permite realizar consultas de forma libre en todo el bucket) y @N1qlSecondaryIndexed<\/code> (que indexar\u00e1 s\u00f3lo los documentos correspondientes al tipo de entidad, de forma similar a la cl\u00e1usula WHERE producida por SpEL #{#n1ql.filter}<\/code>).<\/p>\n@VerIndexado<\/code> (tendr\u00e1 que proporcionar el nombre del documento de dise\u00f1o, que debe corresponder al nombre de clase simple de la entidad con la primera letra en min\u00fascula).<\/p>\nindexManager<\/code> jud\u00eda en el AbstractCouchbaseConfiguration<\/code>.<\/p>\nTipos de retorno simples (primitivos y
Cadena<\/code>) cuando se utiliza una proyecci\u00f3n de una sola fila<\/h2>\nCONTAR(*)<\/code>, AVG(campo)<\/code>La consulta debe devolver una \u00fanica fila con una \u00fanica proyecci\u00f3n.<\/p>\nSoporte de par\u00e1metros con nombre en las consultas en l\u00ednea N1QL<\/h2>\n
$paramName<\/code>que requiere que cada par\u00e1metro del m\u00e9todo se anote con @Param(\"paramNombre\")<\/code>.<\/p>\nOtras caracter\u00edsticas<\/h2>\n
\n
couchbase<\/code>\", para evitar enfrentamientos con otras tiendas.<\/li>\nCouchbaseTemplate<\/code><\/li>\n@Documento<\/code>como largo<\/code> + timeUnit<\/code><\/li>\n<\/ul>\nDocumentaci\u00f3n<\/h2>\n
Nota sobre Spring Cache<\/h2>\n
Obtener Spring Data Couchbase<\/h2>\n
pom.xml<\/code> para obtener esta versi\u00f3n GA (en el dependencias<\/code> secci\u00f3n:<\/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>\nTolva<\/code> tren de liberaci\u00f3n con una versi\u00f3n 2.1<\/code> antes del verano.<\/p>","protected":false},"excerpt":{"rendered":"