<\/h3>\n
<\/p>\n
Fondo<\/h3>\n
Couchbase Mobile Stack se compone de Couchbase Server, Couchbase Sync Gateway y Couchbase Lite embedded Database. Puede obtener m\u00e1s informaci\u00f3n sobre el servidor en la Gu\u00eda de introducci\u00f3n a Couchbase Server<\/a> y el Sync Gateway en el\u00a0Gu\u00eda de introducci\u00f3n a Couchbase Sync Gateway<\/a>.<\/p>\n Asumir\u00e9 que est\u00e1s familiarizado con el desarrollo de aplicaciones iOS y los conceptos b\u00e1sicos de Swift. Si quieres leer sobre bases de datos NoSQL o Couchbase, puedes encontrar un mont\u00f3n de recursos en el\u00a0Couchbase<\/a>\u00a0sitio.<\/p>\n Couchbase es de c\u00f3digo abierto. Todo lo que voy a utilizar aqu\u00ed es libre de probar.<\/p>\n Couchbase Lite puede utilizarse en varios modos de despliegue.<\/p>\n Aqu\u00ed nos centraremos en la Opci\u00f3n 1.<\/p>\n Couchbase Lite expone una API nativa para iOS, Android y Windows que permite a las aplicaciones interactuar f\u00e1cilmente con la plataforma Couchbase. Como desarrollador de aplicaciones, no tienes que preocuparte por el funcionamiento interno de la base de datos integrada de Couchbase Lite, sino que puedes centrarte en crear tu aplicaci\u00f3n. La API nativa te permite interactuar con el framework de Couchbase Lite como lo har\u00edas con otros frameworks\/subsistemas de la plataforma. De nuevo, hablaremos de Couchbase Mobile v1.4 en esta entrada del blog. Puedes obtener una lista completa de las APIs en nuestro Desarrollador Couchbase<\/a> sitio.<\/p>\n Hay muchas opciones para integrar el framework Couchbase Lite en tu aplicaci\u00f3n iOS. Probablemente la m\u00e1s sencilla sea utilizar sistemas de gesti\u00f3n de dependencias como Cocoapods<\/a> o Cartago<\/a>pero si lo prefiere, puede incluir manualmente el framework en su proyecto de aplicaci\u00f3n. Echa un vistazo a nuestro Gu\u00eda de inicio de Couchbase Mobile<\/a>\u00a0para las distintas opciones de integraci\u00f3n.<\/p>\n Nota<\/strong> que en el caso de una aplicaci\u00f3n Swift, despu\u00e9s de importar el framework, tendr\u00e1s que crear un Bridging Header (si tu aplicaci\u00f3n no tiene ya uno) e importar los siguientes archivos<\/p>\n <\/p>\n Descargue el proyecto de demostraci\u00f3n de Xcode desde Repo de Github<\/a> . Utilizaremos esta aplicaci\u00f3n como ejemplo en el resto del blog.<\/p>\n <\/p>\n Esta aplicaci\u00f3n utiliza Cocoapods para integrar el framework Couchbase Lite y pretende familiarizarte con los conceptos b\u00e1sicos del uso del framework Couchbase Lite. Una vez descargada, compila y ejecuta la aplicaci\u00f3n. Puedes usar esta aplicaci\u00f3n como punto de partida y extenderla para probar otras APIs.<\/p>\n <\/p>\n Abra el\u00a0DBMainMenuViewController.swift<\/em> y localice el archivo\u00a0createDBWithName<\/em> funci\u00f3n.<\/p>\n Esto crear\u00e1 una base de datos con el nombre especificado en la ruta por defecto (\/Library\/Application Support). Puede especificar un directorio diferente cuando instale la aplicaci\u00f3n CBLManager<\/a> clase.<\/p>\n Esto es muy sencillo. Abra el DBListTableViewController.swift<\/em> expediente. La direcci\u00f3n allDatabaseNames<\/em> propiedad en CBLManager<\/em> enumera las bases de datos creadas.<\/p>\n Abra el\u00a0DocListTableViewController.swift<\/em> y localice el archivo\u00a0crearDocConNombre<\/em> funci\u00f3n.<\/p>\n Esto crea una nueva revisi\u00f3n del documento con las propiedades de usuario especificadas<\/p>\n Abra el\u00a0DocListTableViewController.swift<\/em> y localice el archivo\u00a0getAllDocumentForDatabase<\/em>\u00a0funci\u00f3n<\/p>\n \u00a0<\/strong>Abra el\u00a0DocListTableViewController.swift<\/em> y localice el archivo\u00a0updateDocConNombre\u00a0<\/em>funci\u00f3n.<\/p>\n \u00a0<\/strong>Abra el\u00a0DocListTableViewController.swift<\/em> y localice el archivo\u00a0deleteDocAtIndex<\/em>\u00a0funci\u00f3n.<\/p>\n Abra el\u00a0DocListTableViewController.swift<\/em> y localice el archivo\u00a0addLiveQueryObserverAndStartObserving<\/em>\u00a0funci\u00f3n<\/p>\n Siempre que se produzca un cambio en la base de datos que afecte a la propiedad \"rows\" del objeto LiveQuery, tu aplicaci\u00f3n recibir\u00e1 una notificaci\u00f3n de cambios. Cuando recibas la notificaci\u00f3n de cambio, puedes actualizar tu UI, que en este caso ser\u00eda recargar la tableview.<\/p>\n Abra el DBListTableViewController.swift<\/em>\u00a0\u00a0y localice el archivo\u00a0deleteDatabaseAtIndex<\/em>\u00a0funci\u00f3n.<\/p>\n La eliminaci\u00f3n de una base de datos se gestiona mediante una simple llamada a delete() en la base de datos.<\/p>\n Como puedes ver, es bastante sencillo integrar una versi\u00f3n independiente de Couchbase Lite en tu nueva o existente aplicaci\u00f3n iOS. Puedes descargar la aplicaci\u00f3n de ejemplo de la que hablamos en este post desde Repo de Github<\/a> y prueba a explorar las distintas interfaces. Si tienes m\u00e1s preguntas, no dudes en ponerte en contacto conmigo en Twitter @rajagp<\/a> o env\u00edeme un correo electr\u00f3nico priya.rajagopal@couchbase.com<\/a>.<\/p>\n En Foros de desarrollo de Couchbase Mobile<\/a> es otro buen lugar para resolver tus dudas sobre m\u00f3viles. Adem\u00e1s, echa un vistazo a la Portal para desarrolladores de Couchbase<\/a> para obtener m\u00e1s informaci\u00f3n sobre Couchbase Mobile.<\/p>\n <\/p>","protected":false},"excerpt":{"rendered":" This post looks at\u00a0 how you can get started with\u00a0Couchbase Lite in\u00a0your iOS App. Couchbase Lite is an embedded JSON database that can work standalone, in a P2P network, or with a\u00a0Sync Gateway as a remote endpoint. While we will […]<\/p>","protected":false},"author":1423,"featured_media":3217,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[1815,7667,1810,1816,9410],"tags":[1536,1909],"ppma_author":[8948],"class_list":["post-3205","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-best-practices-and-tutorials","category-couchbase-lite","category-couchbase-mobile","category-couchbase-server","category-objective-c","tag-ios","tag-swift"],"acf":[],"yoast_head":"\nCouchbase Lite<\/h3>\n
\n
API nativa<\/h4>\n
Integraci\u00f3n<\/h3>\n
#import <CouchbaseLite\/CouchbaseLite.h>\r\n#import <CouchbaseLiteListener\/CBLListener.h><\/pre>\n
Aplicaci\u00f3n de demostraci\u00f3n<\/h3>\n
git clone git@github.com:couchbaselabs\/couchbase-lite-ios-starterapp.git<\/pre>\n
![\"\"](\"https:\/\/www.couchbase.com\/blog\/wp-content\/uploads\/2017\/04\/cblitedemo-compressor.gif\")
<\/p>\nFlujo de trabajo b\u00e1sico<\/h3>\n
Creaci\u00f3n de una base de datos local<\/strong><\/h4>\n
do {\r\n \/\/ 1: Set Database Options\r\n let options = CBLDatabaseOptions()\r\n options.storageType = kCBLSQLiteStorage\r\n options.create = true\r\n\r\n \/\/ 2: Create a DB if it does not exist else return handle to existing one\r\n try cbManager.openDatabaseNamed(name.lowercased(), with: options)\r\n}\r\ncatch {\r\n\/\/ handle error\r\n}\r\n<\/pre>\n\n
Listado de bases de datos<\/strong><\/h4>\n
A\u00f1adir un nuevo documento a una base de datos<\/strong><\/h4>\n
do {\r\n \/\/ 1: Create Document with unique Id\r\n let doc = self.db?.createDocument()\r\n \r\n \/\/ 2: Construct user properties Object\r\n let userProps = [DocumentUserProperties.name.rawValue:name,DocumentUserProperties.overview.rawValue:overview]\r\n \r\n \/\/ 3: Add a new revision with specified user properties\r\n let _ = try doc?.putProperties(userProps) \r\n }\r\n catch {\r\n \/\/ handle error \r\n }<\/pre>\n\n
Listado de documentos en la base de datos<\/strong><\/h4>\n
do {\r\n\u00a0 \u00a0 \u00a0 guard let dbName = dbName else {\r\n\u00a0 \u00a0 \u00a0 return\r\n\u00a0 \u00a0 \u00a0 \u00a0}\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ 1. Get handle to DB with specified name\r\n\u00a0 \u00a0 \u00a0 self.db = try cbManager.existingDatabaseNamed(dbName)\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n \/\/ 2. Create Query to fetch all documents. You can set a number of properties\r\n \/\/ on the query object\r\n\u00a0 \u00a0 \u00a0 \u00a0liveQuery = self.db?.createAllDocumentsQuery().asLive()\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 guard let liveQuery = liveQuery else {\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0return\r\n\u00a0 \u00a0 \u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ 3: You can optionally set a number of properties on the query object.\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ Explore other properties on the query object\r\n\u00a0 \u00a0 \u00a0 \u00a0liveQuery.limit = UInt(UINT32_MAX) \/\/ All documents\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ \u00a0 query.postFilter =\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \/\/4. Start observing for changes to the database\r\n\u00a0 \u00a0 \u00a0 \u00a0self.addLiveQueryObserverAndStartObserving()\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0 \u00a0\/\/ 5: Run the query to fetch documents asynchronously\r\n\u00a0 \u00a0 \u00a0 liveQuery.runAsync({ (enumerator, error) in\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0switch error {\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 case nil:\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\/\/ 6: The \"enumerator\" is of type CBLQueryEnumerator and\r\n \/\/ is an enumerator for the results\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 self.docsEnumerator = enumerator\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 default: \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 }\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 })\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0 }\r\n\u00a0 \u00a0 \u00a0 \u00a0 catch\u00a0 {\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\/\/ handle error\r\n\u00a0 \u00a0 \u00a0 \u00a0 }\r\n<\/pre>\n\n
Editar un documento existente <\/strong><\/h4>\n
do {\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ 1: Get the document associated with the row\r\n\u00a0 \u00a0 \u00a0 let doc = self.docAtIndex(index)\r\n\u00a0\u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ 2: Construct user properties Object with updated values\r\n\u00a0 \u00a0 \u00a0 \u00a0var userProps = [DocumentUserProperties.name.rawValue:name,DocumentUserProperties.overview.rawValue:overview]\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ 3: If a previous revision of document exists, make sure to specify that.\r\n \/\/ SInce its an update, it should exist!\r\n\u00a0 \u00a0 \u00a0 if let revId = doc?.currentRevisionID\u00a0 {\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 userProps[\"_rev\"] = revId\r\n\u00a0 \u00a0 \u00a0 }\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \/\/ 4: Add a new revision with specified user properties\r\n\u00a0 \u00a0 \u00a0 let savedRev = try doc?.putProperties(userProps)\r\n\u00a0 }\r\n\u00a0 catch\u00a0 {\r\n\u00a0 \/\/ handle error\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 }\r\n\r\n\u00a0fileprivate func docAtIndex(_ index:Int) -> CBLDocument? {\r\n\u00a0 \u00a0 \u00a0 \u00a0 \/\/ 1. Get the CBLQueryRow object at specified index\r\n\u00a0 \u00a0 \u00a0 \u00a0 let queryRow = self.docsEnumerator?.row(at: UInt(index))\r\n\u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0 \/\/ 2: Get the document associated with the row\r\n\u00a0 \u00a0 \u00a0 \u00a0 let doc = queryRow?.document\u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0 return doc\r\n }\r\n<\/pre>\n\n
Borrar un documento existente <\/strong><\/h4>\n
do {\r\n \u00a0 \u00a0 \u00a0 \/\/ 1: Get the document associated with the row\r\n\u00a0 \u00a0 \u00a0 \u00a0let doc = self.docAtIndex(index)\u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0\u00a0\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0 \u00a0 \u00a0\/\/ 2: Delete the document\r\n\u00a0 \u00a0 \u00a0 \u00a0try doc?.delete()\r\n\u00a0\u00a0 }\r\n\u00a0 \u00a0catch\u00a0 {\r\n\u00a0\u00a0\u00a0 \u00a0 \u00a0\/\/ Handle error\r\n\u00a0 \u00a0}\r\n<\/pre>\n\n
Observar los cambios en los documentos de la base de datos<\/strong><\/h4>\n
\u00a0\u00a0 \/\/ 1. iOS Specific. Add observer to the live Query object\r\n\u00a0 \u00a0 \u00a0 \u00a0 liveQuery.addObserver(self, forKeyPath: \"rows\", options: NSKeyValueObservingOptions.new, context: nil)\r\n\u00a0\u00a0 \u00a0 \u00a0 \u00a0\r\n\u00a0 \u00a0\/\/ 2. Start observing changes\r\n\u00a0 \u00a0 \u00a0 \u00a0 liveQuery.start()\r\n<\/pre>\n
\n
override func observeValue(forKeyPath keyPath: String?, of object: Any?, change: [NSKeyValueChangeKey : Any]?, context: UnsafeMutableRawPointer?) {\r\n\u00a0 \u00a0 \u00a0 \u00a0 if keyPath == \"rows\" {\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 self.docsEnumerator = self.liveQuery?.rows\r\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 tableView.reloadData()\r\n\u00a0 \u00a0 \u00a0 \u00a0 }\r\n\u00a0 \u00a0 }\r\n<\/pre>\n<\/h4>\n
Eliminar una base de datos<\/strong><\/h4>\n
do {\r\n \/\/ 1. Get handle to database if exists\r\n let db = try cbManager.existingDatabaseNamed(dbToDelete)\r\n \r\n \/\/ 2. Delete the database\r\n try db.delete()\r\n \r\n \/\/ 3. update local bookkeeping\r\n self.dbNames?.remove(at: indexPath.row)\r\n\r\n \/\/ 4. Update UI\r\n tableView.deleteRows(at: [indexPath], with: .automatic)\r\n }\r\n catch {\r\n \/\/ handle error\r\n }<\/pre>\nConclusi\u00f3n<\/h3>\n