Por Matteo Sist, l\u00edder de tecnologia m\u00f3vel, @MOLO17<\/a><\/em><\/em> Um dos principais ingredientes para aprender a criar um \u00f3timo aplicativo m\u00f3vel \u00e9 usar um bom banco de dados. Portanto, neste artigo, mostraremos como \u00e9 f\u00e1cil integrar o Couchbase Lite em um aplicativo iOS.<\/span><\/p>\n O que \u00e9 o Couchbase Lite? O Couchbase Lite \u00e9 o SDK m\u00f3vel do Couchbase Mobile<\/a> que permite que os desenvolvedores integrem facilmente um banco de dados NoSQL em aplicativos m\u00f3veis.<\/span><\/p>\n Este blog analisar\u00e1 as opera\u00e7\u00f5es CRUD (criar, ler, atualizar, excluir), fornecendo detalhes, al\u00e9m de dicas e truques para cada uma das etapas necess\u00e1rias, e destacar\u00e1 um dos meus recursos favoritos, o Sync Gateway.<\/span><\/p>\n A primeira etapa \u00e9 criar um documento com o Couchbase. O Couchbase tem um m\u00e9todo para criar um documento, salvarDocumento<\/strong><\/em>. Esse m\u00e9todo aceita dois par\u00e2metros. O primeiro \u00e9 o documento (CouchbaseLiteSwift.MutableDocument)<\/span>\u00a0 a ser salvo, e o segundo \u00e9 um par\u00e2metro opcional (CouchbaseLiteSwift.ConcurrencyControl<\/span>\u00a0) que d\u00e1 aos usu\u00e1rios a op\u00e7\u00e3o de resolver poss\u00edveis conflitos automaticamente ou lan\u00e7ar uma exce\u00e7\u00e3o para permitir que os usu\u00e1rios resolvam o conflito manualmente. O valor padr\u00e3o \u00e9 \"LastWriteWins<\/strong><\/em>“.<\/span><\/p>\n \u00a0<\/span>Como usar salvarDocumento<\/strong><\/em> m\u00e9todo?<\/span><\/p>\n Primeiro, precisamos de uma inst\u00e2ncia de banco de dados (CouchbaseLiteSwift.Database<\/span>\u00a0), portanto, basta iniciar um novo banco de dados:<\/span><\/p>\n \u00a0<\/span>Em seguida, precisamos criar o documento que queremos salvar. Portanto, crie um novo documento CouchbaseLiteSwift.MutableDocument<\/span>\u00a0 e adicionar alguns campos:<\/span><\/p>\n \u00a0<\/span>Por fim, salve-o:<\/span><\/p>\n Como voc\u00ea pode ver, criar e salvar um documento no Couchbase \u00e9 muito simples e intuitivo.<\/span><\/p>\n \u00a0<\/span><\/p>\n – <\/span>Digita\u00e7\u00e3o:<\/b> No documento, adicionei um campo chamado tipo<\/strong> doc.setString(“Contact”, forKey: “type”)<\/span>\u00a0. Esse \u00e9 um truque que permite dividir facilmente um documento em tipos e facilita as opera\u00e7\u00f5es de leitura. Mais adiante, demonstrarei como usar esse campo.<\/span><\/p>\n – <\/span>Id:<\/b> Voc\u00ea n\u00e3o precisa fornecer um ID ao criar um documento. \u00c9 um campo opcional e, se voc\u00ea n\u00e3o o fizer, o Couchbase gera um UUID para voc\u00ea.<\/span><\/p>\n – <\/span>Cria\u00e7\u00e3o de documentos:<\/b> Se desejar, voc\u00ea pode criar um documento a partir de um dicion\u00e1rio (ou de um mapa de valores chave) simplesmente passando o dicion\u00e1rio como par\u00e2metro no construtor do documento.<\/span><\/p>\n \u00a0<\/span><\/p>\n Agora que criamos nosso primeiro documento, tamb\u00e9m queremos l\u00ea-lo e exibi-lo em uma lista.\u00a0<\/span>H\u00e1 duas maneiras de recuperar um documento:<\/span><\/p>\n \u00a0<\/span>Para recuperar um documento usando seu ID, primeiro precisamos de uma inst\u00e2ncia do banco de dados para uma opera\u00e7\u00e3o de leitura.<\/span><\/p>\n Ent\u00e3o, podemos usar o m\u00e9todo documento<\/strong><\/em>\u00a0que precisa do ID do documento para recuper\u00e1-lo. O tipo de retorno desse m\u00e9todo \u00e9 um objeto de documento opcional (CouchbaseLiteSwift.Document?) que ser\u00e1 nulo se o documento n\u00e3o existir.<\/span><\/p>\n <\/p>\n Quanto \u00e0 opera\u00e7\u00e3o get by id, tamb\u00e9m precisamos de uma inst\u00e2ncia do banco de dados para a consulta.<\/span><\/p>\n <\/p>\n A pr\u00f3xima etapa \u00e9 criar a consulta. Para isso, precisamos usar a metalinguagem **N1QL**. N1QL, a linguagem de consulta do Couchbase que estende o SQL para dados JSON, permite que os usu\u00e1rios definam uma consulta com uma sintaxe semelhante \u00e0 do SQL em um banco de dados NoSQL. Veja o exemplo abaixo.<\/span><\/p>\n <\/p>\n Dessa forma, definimos uma consulta simples que pesquisou todos os documentos (com todos os campos, \u00e9 claro) do banco de dados em que o campo \"type\" \u00e9 igual a \"Contact\".<\/span><\/p>\n Agora, basta executar a consulta e receberemos um conjunto de resultados contendo todos os documentos que observam as op\u00e7\u00f5es da consulta.<\/span><\/p>\n <\/p>\n O resultado do objeto est\u00e1 em conformidade com o protocolo do iterador, portanto, pode ser iterado para obter cada documento e fazer coisas. O resultado retornado pela consulta \u00e9 um instant\u00e2neo dos dados no momento da execu\u00e7\u00e3o. As altera\u00e7\u00f5es feitas no documento posteriormente n\u00e3o ser\u00e3o consideradas.<\/span><\/p>\n \u00a0<\/span><\/p>\n – <\/span>Ouvinte de consulta:<\/b> O Couchbase tamb\u00e9m fornece outro m\u00e9todo para executar consultas que permitem que os usu\u00e1rios n\u00e3o apenas recuperem dados da consulta criada, mas tamb\u00e9m ou\u00e7am futuras altera\u00e7\u00f5es. Fazer isso \u00e9 t\u00e3o simples quanto o primeiro m\u00e9todo. D\u00ea uma olhada!<\/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>Convers\u00e3o de documentos:<\/b> Quanto \u00e0 cria\u00e7\u00e3o, voc\u00ea pode converter facilmente um documento em um dicion\u00e1rio (e vice-versa) usando toDictionary()<\/strong><\/em> m\u00e9todo.<\/span><\/p>\n \u00a0<\/span><\/p>\n Agora que podemos criar e ler documentos no Couchbase, vamos atualizar nosso documento.<\/span><\/p>\n A atualiza\u00e7\u00e3o de um documento \u00e9 muito semelhante \u00e0 cria\u00e7\u00e3o de um. Voc\u00ea s\u00f3 precisa obter um documento para atualizar, depois atualiz\u00e1-lo e salv\u00e1-lo novamente. Vamos ver como.<\/span><\/p>\n Inicie o banco de dados:<\/span><\/p>\n Recupere o documento a ser atualizado:<\/span><\/p>\n Edite-o.<\/span><\/p>\n E, \u00e9 claro, salve-o:<\/span><\/p>\n <\/p>\n <\/p>\n Por \u00faltimo, mas n\u00e3o menos importante, talvez voc\u00ea queira excluir alguns documentos, veja como isso pode ser feito.<\/span><\/p>\n Como sempre, precisamos do banco de dados.<\/span><\/p>\n Da mesma forma que a opera\u00e7\u00e3o de atualiza\u00e7\u00e3o, devemos recuperar o documento a ser exclu\u00eddo. Portanto, voc\u00ea usar\u00e1 o m\u00e9todo document by id.<\/span><\/p>\n Agora podemos usar o excluir<\/strong><\/em> para excluir um documento. Assim como no salvarDocumento<\/strong><\/em>Se o conflito for resolvido, podemos optar por resolv\u00ea-lo manual ou automaticamente.\u00a0<\/span><\/p>\n <\/p>\n Agora podemos integrar o Couchbase Lite em nossos aplicativos usando CRUD:<\/span><\/p>\n Mas h\u00e1 mais. O Couchbase oferece outro recurso maravilhoso: Sync Gateway<\/span><\/p>\n \u00a0<\/span><\/p>\n A sincroniza\u00e7\u00e3o \u00e9 uma das minhas funcionalidades favoritas do Couchbase porque \u00e9 t\u00e3o simples quanto eficaz. O Couchbase Lite fornece essa funcionalidade para configurar um banco de dados remoto.<\/span><\/p>\n Vamos nos aprofundar no c\u00f3digo.<\/span><\/p>\n Al\u00e9m do nosso banco de dados, precisamos de outro objeto: o replicador.<\/span><\/p>\n \u00a0<\/span>O que eu preciso para iniciar um objeto replicador (CouchbaseLiteSwift.Replicator) \u00e9 um objeto de configura\u00e7\u00e3o em que o \u00fanico campo obrigat\u00f3rio \u00e9 a url do Sync Gateway.<\/span><\/p>\n \u00a0<\/span>Os outros campos opcionais incluem replicatorType<\/strong><\/em>onde os usu\u00e1rios podem escolher se a replica\u00e7\u00e3o deve funcionar para cima, para dentro, para baixo ou ambos. Outro campo \u00e9 cont\u00ednuo<\/strong><\/em>um sinalizador que permite que os usu\u00e1rios configurem se a replica\u00e7\u00e3o deve ou n\u00e3o ser executada uma vez ou continuamente.<\/span>\u00a0<\/span><\/p>\n Com o replicador<\/strong><\/em>\u00a0precisamos apenas iniciar a replica\u00e7\u00e3o.<\/span><\/p>\n Ou interromper a replica\u00e7\u00e3o.<\/span><\/p>\n <\/p>\n – <\/span>Status da replica\u00e7\u00e3o de escuta:<\/b> Tanto para a consulta quanto para a replica\u00e7\u00e3o, podemos adicionar um ouvinte para receber altera\u00e7\u00f5es no status da replica\u00e7\u00e3o. Abaixo est\u00e1 o c\u00f3digo.<\/span>\u00a0<\/span><\/p>\n Quanto \u00e0s consultas, o token deve ser usado para remover o ouvinte do replicador.<\/span><\/p>\n <\/p>\n \u00a0<\/span>O Couchbase Lite, como parte do pacote Couchbase Mobile, \u00e9 uma flecha poderosa na aljava de um desenvolvedor m\u00f3vel. \u00c9 f\u00e1cil de aprender e, neste artigo, mostramos apenas uma pequena parte de seu potencial, portanto, minha recomenda\u00e7\u00e3o \u00e9 que voc\u00ea se aprofunde nas funcionalidades do Couchbase que lhe permitir\u00e3o integrar facilmente e assumir o controle total do banco de dados que d\u00e1 suporte aos seus aplicativos m\u00f3veis.<\/span><\/p>\n Sobre Matteo Sist, @MOLO17<\/em><\/strong><\/p>\n Matteo come\u00e7ou a colaborar com MOLO17<\/a> como desenvolvedor Android quando estava no ensino m\u00e9dio (por meio de um curso de Tecnologia da Informa\u00e7\u00e3o). Recrutado em 2015, ele se juntou \u00e0 equipe de desenvolvimento m\u00f3vel, assumindo a fun\u00e7\u00e3o de desenvolvedor principal para as plataformas iOS e Android. Tem habilidade em linguagens para desenvolvimento de aplicativos m\u00f3veis nativos<\/a>Em sua carreira, ele projetou e desenvolveu v\u00e1rias solu\u00e7\u00f5es bem-sucedidas para dispositivos m\u00f3veis voltados para consumidores e empresas, desde Java e Objective-C at\u00e9 as mais recentes Kotlin e Swift. Em 2016, tornou-se l\u00edder t\u00e9cnico gerenciando a equipe de desenvolvimento de aplicativos m\u00f3veis e, em 2019, foi cofundador da MobileBridge (uma empresa irm\u00e3 da 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 Criar<\/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>\nDicas e truques para aprender com o Couchbase Lite<\/span><\/h3>\n
R como leitura<\/span><\/h2>\n
\n
Obter 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>\nDicas e truques <\/span>para aprender com o 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 atualiza\u00e7\u00e3o<\/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 Excluir<\/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>\nO Couchbase Sync Gateway \u00e9 t\u00e3o f\u00e1cil de aprender quanto o Couchbase Lite<\/span><\/h2>\n
\n
Sincroniza\u00e7\u00e3o<\/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
Dicas e truques para aprender com o Sync<\/span><\/h3>\n
let token = replicator.addChangeListener { changes in\r\n status = changes.status\r\n}<\/pre>\nreplicator.removeChangeListener(withToken: token)<\/pre>\n
Conclus\u00e3o, o Couchbase Lite \u00e9 f\u00e1cil de aprender<\/span><\/h2>\n