Por Matteo Sist, jefe de tecnolog\u00eda m\u00f3vil, @MOLO17<\/a><\/em><\/em> Uno de los ingredientes clave para aprender a hacer una gran aplicaci\u00f3n m\u00f3vil es utilizar una buena base de datos. Por eso, en este art\u00edculo vamos a mostrar lo f\u00e1cil que es integrar Couchbase Lite en una app para iOS.<\/span><\/p>\n \u00bfQu\u00e9 es Couchbase Lite? Couchbase Lite es el SDK para m\u00f3viles del Couchbase M\u00f3vil<\/a> que permite a los desarrolladores integrar f\u00e1cilmente una base de datos NoSQL en aplicaciones m\u00f3viles.<\/span><\/p>\n Este blog repasar\u00e1 las operaciones CRUD (crear, leer, actualizar, eliminar), proporcionando detalles adem\u00e1s de consejos y trucos para cada uno de los pasos necesarios, y destacar\u00e1 una de mis funciones favoritas, Sync Gateway.<\/span><\/p>\n El primer paso es crear un documento con Couchbase. Couchbase tiene un m\u00e9todo para crear un documento, guardarDocumento<\/strong><\/em>. Este m\u00e9todo acepta dos par\u00e1metros. El primero es el documento (CouchbaseLiteSwift.MutableDocument)<\/span>\u00a0 y el segundo es un par\u00e1metro opcional (CouchbaseLiteSwift.ConcurrencyControl<\/span>\u00a0) que da a los usuarios la opci\u00f3n de resolver posibles conflictos autom\u00e1ticamente o lanzar una excepci\u00f3n para permitir a los usuarios resolver el conflicto manualmente. El valor por defecto es \"LastWriteWins<\/strong><\/em>“.<\/span><\/p>\n \u00a0<\/span>C\u00f3mo utilizarlo guardarDocumento<\/strong><\/em> \u00bfm\u00e9todo?<\/span><\/p>\n En primer lugar, necesitamos una instancia de base de datos (CouchbaseLiteSwift.Database<\/span>\u00a0), as\u00ed que basta con iniciar una nueva base de datos:<\/span><\/p>\n \u00a0<\/span>A continuaci\u00f3n, tenemos que crear el documento que queremos guardar. Por lo tanto, crear un nuevo documento CouchbaseLiteSwift.MutableDocument<\/span>\u00a0 y a\u00f1adir algunos campos:<\/span><\/p>\n \u00a0<\/span>Por \u00faltimo, gu\u00e1rdalo:<\/span><\/p>\n Como puedes ver, crear y guardar un documento dentro de Couchbase es realmente sencillo e intuitivo.<\/span><\/p>\n \u00a0<\/span><\/p>\n – <\/span>Mecanograf\u00eda:<\/b> En el documento he a\u00f1adido un campo llamado tipo<\/strong> doc.setString(“Contact”, forKey: “type”)<\/span>\u00a0. Se trata de un truco que permite dividir f\u00e1cilmente un documento en tipos y facilita las operaciones de lectura. M\u00e1s adelante demostrar\u00e9 c\u00f3mo utilizar este campo.<\/span><\/p>\n – <\/span>Id:<\/b> No necesitas proporcionar un id cuando creas un documento. Es un campo opcional, y si no lo haces, Couchbase genera un UUID por ti.<\/span><\/p>\n – <\/span>Creaci\u00f3n de documentos:<\/b> Si lo desea, puede crear un documento a partir de un diccionario (o un mapa clave-valor) simplemente pasando el diccionario como par\u00e1metro en el constructor del documento.<\/span><\/p>\n \u00a0<\/span><\/p>\n Ahora que hemos creado nuestro primer documento tambi\u00e9n queremos leerlo y mostrarlo en una lista.\u00a0<\/span>Hay dos formas de recuperar un documento:<\/span><\/p>\n \u00a0<\/span>Para recuperar un documento utilizando su id necesitamos primero una instancia de base de datos para una operaci\u00f3n de lectura.<\/span><\/p>\n Entonces podemos utilizar el m\u00e9todo documento<\/strong><\/em>\u00a0que necesita el id del documento para recuperarlo. El tipo de retorno de este m\u00e9todo es un objeto documento opcional (CouchbaseLiteSwift.Document?) que ser\u00e1 nil si el documento no existe.<\/span><\/p>\n <\/p>\n En cuanto a la operaci\u00f3n get by id, tambi\u00e9n necesitamos una instancia de la base de datos para la consulta.<\/span><\/p>\n <\/p>\n El siguiente paso es crear la consulta. Para ello necesitamos utilizar el metalenguaje **N1QL**. N1QL, el lenguaje de consulta de Couchbase que extiende SQL a datos JSON, permite a los usuarios definir una consulta con una sintaxis similar a SQL sobre una base de datos NoSQL. Mira el ejemplo de abajo.<\/span><\/p>\n <\/p>\n De este modo, definimos una consulta sencilla que busca todos los documentos (con todos los campos, por supuesto) de la base de datos en los que el campo \"tipo\" es igual a \"Contacto\".<\/span><\/p>\n Ahora, s\u00f3lo tenemos que ejecutar la consulta y recibiremos un conjunto de resultados con todos los documentos que cumplan las opciones de la consulta.<\/span><\/p>\n <\/p>\n El objeto resultado se ajusta al protocolo iterador, por lo que puede iterarse para obtener cada documento y hacer cosas. El resultado devuelto por la consulta es una instant\u00e1nea de los datos en el momento de la ejecuci\u00f3n. No se tendr\u00e1n en cuenta los cambios de documento realizados posteriormente.<\/span><\/p>\n \u00a0<\/span><\/p>\n – <\/span>Escucha de consultas:<\/b> Couchbase tambi\u00e9n proporciona otro m\u00e9todo para ejecutar consultas que permiten a los usuarios no s\u00f3lo recuperar datos de la consulta construida, sino tambi\u00e9n escuchar futuros cambios. Hacer esto es tan simple como el primer m\u00e9todo. Echa un vistazo<\/span><\/p>\n The listener will be invoked every time the documents included in the query result change. The token returned from the “`addChangeListener“` methods can be used to stop listening as follows:<\/span><\/p>\n – <\/span>Conversi\u00f3n de documentos:<\/b> En cuanto a la creaci\u00f3n, puede convertir f\u00e1cilmente un documento en un diccionario (y viceversa) utilizando toDictionary()<\/strong><\/em> m\u00e9todo.<\/span><\/p>\n \u00a0<\/span><\/p>\n Ahora que ya podemos crear y leer documentos en Couchbase, vamos a actualizar nuestro documento.<\/span><\/p>\n Actualizar un documento es muy similar a crearlo. Basta con obtener un documento para actualizarlo, actualizarlo y volver a guardarlo. Veamos c\u00f3mo.<\/span><\/p>\n Inicie la base de datos:<\/span><\/p>\n Recuperar el documento a actualizar:<\/span><\/p>\n Ed\u00edtalo.<\/span><\/p>\n Y, por supuesto, gu\u00e1rdalo:<\/span><\/p>\n <\/p>\n <\/p>\n Por \u00faltimo, pero no por ello menos importante, tal vez desee eliminar algunos documentos, he aqu\u00ed c\u00f3mo hacerlo.<\/span><\/p>\n Como siempre, necesitamos la base de datos.<\/span><\/p>\n De forma similar a la operaci\u00f3n de actualizaci\u00f3n, debemos recuperar el documento a eliminar. Para ello, utilizaremos el m\u00e9todo document by id.<\/span><\/p>\n Ahora podemos utilizar el borrar<\/strong><\/em> para eliminar un documento. Al igual que con guardarDocumento<\/strong><\/em>podemos optar por resolver los conflictos de forma manual o autom\u00e1tica.\u00a0<\/span><\/p>\n <\/p>\n Ahora podemos integrar Couchbase Lite en nuestras aplicaciones utilizando CRUD:<\/span><\/p>\n Pero a\u00fan hay m\u00e1s. Couchbase proporciona otra caracter\u00edstica maravillosa: Sync Gateway<\/span><\/p>\n \u00a0<\/span><\/p>\n Sync es una de mis funcionalidades favoritas de Couchbase porque es tan simple como efectiva. Couchbase Lite proporciona esta funcionalidad para configurar una base de datos remota.<\/span><\/p>\n Profundicemos en el c\u00f3digo.<\/span><\/p>\n Adem\u00e1s de nuestra base de datos, necesitamos otro objeto: el replicador.<\/span><\/p>\n \u00a0<\/span>Lo que necesito para iniciar un objeto replicador (CouchbaseLiteSwift.Replicator) es un objeto de configuraci\u00f3n donde el \u00fanico campo obligatorio es la url del Sync Gateway.<\/span><\/p>\n \u00a0<\/span>Los dem\u00e1s campos opcionales son replicatorType<\/strong><\/em>, donde los usuarios pueden elegir si la replicaci\u00f3n debe funcionar hacia arriba, hacia dentro, hacia abajo, o ambas cosas. Otro campo es continuo<\/strong><\/em>, un indicador que permite a los usuarios configurar si la replicaci\u00f3n debe ejecutarse una sola vez o de forma continua.<\/span>\u00a0<\/span><\/p>\n Con el replicador<\/strong><\/em>\u00a0s\u00f3lo necesitamos iniciar la replicaci\u00f3n.<\/span><\/p>\n O detener la replicaci\u00f3n.<\/span><\/p>\n <\/p>\n – <\/span>Estado de la replicaci\u00f3n de escucha:<\/b> Tanto para la consulta como para la replicaci\u00f3n podemos a\u00f1adir un listener para recibir los cambios de estado de la replicaci\u00f3n. A continuaci\u00f3n se muestra el c\u00f3digo.<\/span>\u00a0<\/span><\/p>\n En cuanto a las consultas, el token debe utilizarse para eliminar el oyente del replicador.<\/span><\/p>\n <\/p>\n \u00a0<\/span>Couchbase Lite, como parte de la suite Couchbase Mobile, es una poderosa flecha en la aljaba de un desarrollador m\u00f3vil. Es f\u00e1cil de aprender, y en este art\u00edculo solo hemos mostrado una peque\u00f1a parte de su potencial, as\u00ed que mi consejo es que profundices en las funcionalidades de Couchbase que te permitir\u00e1n integrar f\u00e1cilmente y tomar el control total de la base de datos que soporta tus aplicaciones m\u00f3viles.<\/span><\/p>\n Sobre Matteo Sist, @MOLO17<\/em><\/strong><\/p>\n Matteo empez\u00f3 a colaborar con MOLO17<\/a> como Desarrollador Android cuando estaba en el instituto (a trav\u00e9s de un curso de Tecnolog\u00eda de la Informaci\u00f3n). Contratado en 2015, se uni\u00f3 al equipo de desarrollo m\u00f3vil asumiendo el papel de desarrollador clave para las plataformas iOS y Android. Competente en lenguajes de desarrollo de aplicaciones m\u00f3viles nativas<\/a>Desde Java y Objective-C hasta los m\u00e1s recientes Kotlin y Swift, ha dise\u00f1ado y desarrollado varias soluciones de \u00e9xito para dispositivos m\u00f3viles dirigidas a consumidores y empresas. En 2016, se convirti\u00f3 en Tech Lead gestionando el equipo de desarrollo de aplicaciones m\u00f3viles, y en 2019, cofund\u00f3 MobileBridge (una empresa hermana de MOLO17).<\/em><\/p>\n <\/p>","protected":false},"excerpt":{"rendered":" Learn Couchbase Lite in 5 Minutes and follow the CRUD By Matteo Sist, Mobile Tech Lead, @MOLO17 One of the key ingredients in learning to make a great mobile app is to use a good database. So, in this article […]<\/p>","protected":false},"author":31146,"featured_media":13873,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[7667,1810,9410,2366],"tags":[1536],"ppma_author":[8921],"class_list":["post-8679","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-couchbase-lite","category-couchbase-mobile","category-objective-c","category-sync-gateway","tag-ios"],"acf":[],"yoast_head":"\n
\n<\/span><\/p>\nC como Crear<\/span><\/h2>\n
do {\r\n database = try Database(name: \"DatabaseName\")\r\n} catch {\r\n fatalError(\"Error opening database\")\r\n}<\/pre>\nlet doc = MutableDocument(id: \"MyUniqueDocumentIdentifier\")\r\ndoc.setString(\"Mickey\", forKey: \"name\")\r\ndoc.setString(\"Mouse\", forKey: \"surname\")\r\ndoc.setInt(91, forKey: \"age\")\r\ndoc.setString(\"Contact\", forKey: \"type\")<\/pre>\n
do {\r\n try database.saveDocument(doc, concurrencyControl: .lastWriteWins)\r\n} catch {\r\n fatalError(\"Error saving document\")\r\n}<\/pre>\nTrucos y consejos para aprender con Couchbase Lite<\/span><\/h3>\n
R de lectura<\/span><\/h2>\n
\n
Obtener por id<\/span><\/h3>\n
do {\r\n database = try Database(name: \"DatabaseName\")\r\n} catch {\r\n fatalError(\"Error opening database\")\r\n}<\/pre>\nlet doc = database.document(withID: \"MyUniqueDocumentIdentifier\")<\/pre>\n
Consulta<\/span><\/h3>\n
do {\r\n database = try Database(name: \"DatabaseName\")\r\n} catch {\r\n fatalError(\"Error opening database\")\r\n}<\/pre>\nlet query = QueryBuilder\r\n .select(SelectResult.all())\r\n .from(DataSource.database(database))\r\n .where(Expression.property(\"type\").equalTo(Expression.string(\"Contact\")))<\/pre>\n
do {\r\n result = try query.execute()\r\n} catch {\r\n fatalError(\"Invalid query\")\r\n}<\/pre>\nTrucos y consejos <\/span>Aprender con Couchbase Lite<\/h3>\n
let token = query.addChangeListener { queryChange in\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 result = queryChange.results?.allResults()\r\n}<\/pre>\nquery.removeChangeListener(withToken: token)<\/pre>\n
U como Actualizaci\u00f3n<\/span><\/h2>\n
do {\r\n database = try Database(name: \"DatabaseName\")\r\n} catch {\r\n fatalError(\"Error opening database\")\r\n}<\/pre>\nlet doc = database.document(withID: \"MyUniqueDocumentIdentifier\")<\/pre>\n
let docToUpdate = doc.toMutable()\r\ndocToUpdate.setString(\"Male\", forKey: \"gender\")<\/pre>\n
do {\r\n try database.saveDocument(docToUpdate, concurrencyControl: .lastWriteWins)\r\n} catch {\r\n fatalError(\"Error updating document\")\r\n}<\/pre>\nD como Borrar<\/span><\/h2>\n
do {\r\n database = try Database(name: \"DatabaseName\")\r\n} catch {\r\n fatalError(\"Error opening database\")\r\n}<\/pre>\nlet doc = database.document(withID: \"MyUniqueDocumentIdentifier\")<\/pre>\n
do {\r\n try database.deleteDocument(doc, concurrencyControl: .lastWriteWins)\r\n} catch {\r\n fatalError(\"Error deleting document\")\r\n}<\/pre>\nCouchbase Sync Gateway es tan f\u00e1cil de aprender como Couchbase Lite<\/span><\/h2>\n
\n
Sincroniza<\/span>\u00a0<\/span><\/h2>\n
do {\r\n database = try Database(name: DatabaseName)\r\n} catch {\r\n fatalError(\"Error opening database\")\r\n}<\/pre>\nlet targetEndpoint = URLEndpoint(url: \"ws:\/\/localhost:4984\/bucketname\/\")\r\nlet replConfig = ReplicatorConfiguration(database: database, target: targetEndpoint)\r\nreplConfig.replicatorType = .pushAndPull\r\nreplConfig.continuous = true\r\nreplConfig.authenticator = BasicAuthenticator(username: Username, password: Password)\r\nreplicator = Replicator(config: replConfig)<\/pre>\n
replicator.start()<\/pre>\n
replicator.stop()<\/pre>\n
Trucos y consejos para aprender con Sync<\/span><\/h3>\n
let token = replicator.addChangeListener { changes in\r\n status = changes.status\r\n}<\/pre>\nreplicator.removeChangeListener(withToken: token)<\/pre>\n
Conclusi\u00f3n, Couchbase Lite es f\u00e1cil de aprender<\/span><\/h2>\n