Building a Mobile Application with Couchbase - Part 2

Este blog com várias partes o ajudará a criar um aplicativo móvel de ponta a ponta usando os recursos líderes do setor do Couchbase Lite. Os aplicativos de ponta a ponta, escalonáveis e de nível de produção incluem os seguintes recursos:

1. Um banco de dados incorporado - o armazenamento de dados localmente reduz as viagens de rede para um banco de dados centralizado para cada atividade no dispositivo. Isso contribui muito para melhorar a experiência do usuário.
2. Sincronização com outros dispositivos móveis pares e com um servidor centralizado.
3. Recursos analíticos avançados, pesquisa de texto completo e aprendizado de máquina no dispositivo.

Como há muito a ser abordado, dividimos este projeto em três partes. A Parte 1 apresenta o processo de criação de um aplicativo móvel que aproveita o Couchbase Lite e o utiliza como um banco de dados incorporado para armazenar dados. A Parte 2 (esta postagem) mostra como executar o Full-Text Search (FTS) no dispositivo. E a parte 3 mostrará o processo de sincronização dos dados com pares e um servidor Couchbase centralizado.

O que é o Couchbase Mobile?

O Couchbase é um banco de dados em nuvem NoSQL distribuído e premiado. Ele oferece versatilidade, desempenho, escalabilidade e valor financeiro inigualáveis em implantações na nuvem, no local, híbridas, distribuídas e de computação de borda.

As implantações móveis/edge são uma parte essencial do ecossistema digital que o Couchbase Mobile atende. Couchbase Mobile Inclui:

1. Banco de dados Couchbase Lite incorporado para dispositivos de borda
2. Sync Gateway de alto desempenho para sincronização ponto a ponto e sincronização centralizada de servidores
3. Os data centers de borda alimentados pelo Couchbase Server podem ser implantados na nuvem, no local ou em data centers de borda locais.

Visão geral do aplicativo móvel

O código para esse aplicativo de demonstração está disponível em meu Repositório do GitHub do Couchbase Mobile. Faça o download do arquivo Rateit.zip e extraia os arquivos para sua pasta local.

Como alternativa, você pode seguir as instruções deste blog para criar o aplicativo do zero.

A funcionalidade do aplicativo é dividida em três partes

1. Enviar solicitações de classificação
2. Receber solicitações de classificação de outras pessoas
3. Visualizar a solicitação classificada retornada por outros

Para obter uma compreensão mais profunda dos vários componentes do aplicativo, consulte Parte 1, onde enviamos/recebemos solicitações de classificação.

Adição de pesquisa de texto completo

Neste exemplo, adicionamos um simples pesquisa e o código para adicionar um índice invertido (usado por sistemas de pesquisa) que recebe a entrada do usuário e exibe resultados relevantes.

Primeiros passos: Revisar a documentação do CBLite

Consulte o documentação para entender os vários componentes de um aplicativo de banco de dados Couchbase Lite. Eu crio um banco de dados totalmente novo para esse aplicativo quando ele é chamado pela primeira vez. Como alternativa, o aplicativo também pode usar um banco de dados pré-criado.

As etapas para incorporar o banco de dados podem ser encontradas na seção Documentação do Couchbase Lite. Revise cada uma das seções para aprender a:

- criar e abrir um banco de dados
- gravar um documento no banco de dados incorporado
- escrever consultas para recuperar o documento
- expirar ou excluir um documento
- criar índices de pesquisa de texto completo
- criar uma expressão de pesquisa FTS
- criar uma consulta que incorpore a expressão de pesquisa

Pré-requisitos para a criação de aplicativos

Este aplicativo foi desenvolvido para dispositivos Android usando os seguintes pré-requisitos de software e hardware que você precisa conhecer:

1. Você precisa entender os fundamentos da criação de aplicativos com o Android Studio e da programação em Java.
2. Este aplicativo de demonstração e as capturas de tela relacionadas são provenientes da criação do aplicativo em um computador macOS.
3. Usamos (disponível gratuitamente) Android Studio 2020.3 para criar aplicativos móveis para dispositivos Android.
4. É usada a versão 3.0.0-beta02 do Couchbase Lite. As bibliotecas necessárias serão incorporadas ao código e não há necessidade de fazer download do software manualmente em seu desktop.

Compreensão do layout

Os arquivos de layout são arquivos XML que descrevem a tela do aplicativo móvel. Por exemplo, activity_main.xml tem o ENVIAR PARA, MENSAGEM, ASSUNTO além das duas visualizações de lista que mostram as solicitações recebidas e as recebidas.

Ele também define a função a ser invocada quando o CLIQUE PARA ENVIAR SOLICITAÇÃO DE CLASSIFICAÇÃO, SOLICITAÇÕES DE CLASSIFICAÇÃO RECEBIDAS e SOLICITAÇÕES DE CLASSIFICAÇÃO RECEBIDAS são pressionados. O código XML pode ser escrito manualmente ou gerado automaticamente, definindo os atributos na variável atributos seção do designer. Aqui, adicionamos uma entrada de pesquisa ao centro do layout:

Revisão do código

Há um arquivo de código que atualizamos para adicionar a lógica de pesquisa ao aplicativo, Mainactivity.java.

Localizar Mainactivity.java sob o java -> com.example.rateit e cole o seguinte código dentro da classe Atividade principal. O novo código é adicionado ao exemplo anterior na parte 1 - ele é encontrado na linha 8 e nas linhas 12-27 abaixo:

public void receivedata( View view ) throws CouchbaseLiteException {
    Context context = this;
    CouchbaseLite.init(context);
    userArray.clear();
    DatabaseConfiguration config = new DatabaseConfiguration();
    config.setDirectory(context.getFilesDir().getAbsolutePath());
    Database database = null;
    File dbFile = new File(context.getFilesDir(), "rateitdb");
    try { database = new Database("rateitdb", config); } 
        catch (CouchbaseLiteException e) { e.printStackTrace(); }

    if (!dbFile.exists()) {
        database.createIndex("descFTSIndex", IndexBuilder.fullTextIndex(FullTextIndexItem.property("URL")));
    }
    SearchView search = (SearchView) findViewById(R.id.searchView);
    Expression searchExp = FullTextExpression.index("descFTSIndex").match(String.valueOf(search.getQuery())) ;
    Query query = null;
    if (search.getQuery().toString().trim().isEmpty()) {
        query = (Query) QueryBuilder.select(SelectResult.all()).from(DataSource.database(database))
                .where(Expression.property("to").equalTo(Expression.string("rangana"))
                        .and(Expression.property("type").equalTo(Expression.string("received"))));
    } else {
        query = (Query) QueryBuilder.select(SelectResult.all()).from(DataSource.database(database))
                .where(Expression.property("to").equalTo(Expression.string("rangana"))
                        .and(Expression.property("type").equalTo(Expression.string("received")))
                        .and(searchExp));
    }

    int numrows = query.execute().allResults().size();
    Toast.makeText(getApplicationContext(), "num rows:::"+ numrows , Toast.LENGTH_LONG).show();

    try {
        query.execute().allResults().forEach(result -> {
            Dictionary thisDocsProps = result.getDictionary(0);
            String sendto = thisDocsProps.getString("sendto").trim();
            String URL = thisDocsProps.getString("URL").trim();
            String rating = thisDocsProps.getString("rating").trim();
            float ratingstars = thisDocsProps.getFloat("ratingstars");
            int stars = (int) ratingstars;
            rating = String.valueOf(thisDocsProps.getFloat("ratingstars"));
            userArray.add(new User(sendto, URL, rating,ratingstars));
        });
    } catch (CouchbaseLiteException e) {
        e.printStackTrace();
    }

    userAdapter = new UserCustomAdapter(MainActivity.this, R.layout.customlayout, userArray);
    userList = (ListView) findViewById(R.id.listView);
    userList.setItemsCanFocus(false);
    userList.setAdapter(userAdapter);

    userList.setOnItemClickListener(new OnItemClickListener() {
        @Override
        public void onItemClick(AdapterView<?> parent, View v, final int position, long id) {
            Log.i("List View Clicked", "**********");
            Toast.makeText(MainActivity.this, "List View Clicked:" + position, Toast.LENGTH_LONG).show();
        }
    });
    database.close();
}

público vazio dados recebidos( Ver visualização ) lançamentos CouchbaseLiteException {

Contexto contexto = este;

CouchbaseLite.inicial(contexto);

userArray.claro();

DatabaseConfiguration configuração = novo DatabaseConfiguration();

configuração.setDirectory(contexto.getFilesDir().getAbsolutePath());

Banco de dados banco de dados = nulo;

Arquivo dbFile = novo Arquivo(contexto.getFilesDir(), "rateitdb");

tentar { banco de dados = novo Banco de dados("rateitdb", configuração); }

captura (CouchbaseLiteException e) { e.printStackTrace(); }

se (!dbFile.existe()) {

banco de dados.createIndex("descFTSIndex", IndexBuilder.fullTextIndex(FullTextIndexItem.propriedade("URL")));

}

SearchView pesquisa = (SearchView) findViewById(R.id.searchView);

Expressão searchExp = FullTextExpression.índice("descFTSIndex").partida(Cordas.valueOf(pesquisa.getQuery())) ;

Consulta consulta = nulo;

se (pesquisa.getQuery().toString().acabamento().isEmpty()) {

consulta = (Consulta) Criador de consultas.selecionar(SelecionarResultado.todos()).de(Fonte de dados.banco de dados(banco de dados))

.onde(Expressão.propriedade("para").igual a(Expressão.string("rangana"))

.e(Expressão.propriedade("tipo").igual a(Expressão.string("recebido"))));

} mais {

consulta = (Consulta) Criador de consultas.selecionar(SelecionarResultado.todos()).de(Fonte de dados.banco de dados(banco de dados))

.onde(Expressão.propriedade("para").igual a(Expressão.string("rangana"))

.e(Expressão.propriedade("tipo").igual a(Expressão.string("recebido")))

.e(searchExp));

}

int linhas numéricas = consulta.executar().allResults().tamanho();

Torradas.makeText(getApplicationContext(), "num rows:::"+ linhas numéricas , Torradas.LENGTH_LONG).show();

tentar {

consulta.executar().allResults().forEach(resultado -> {

Dicionário thisDocsProps = resultado.getDictionary(0);

Cordas enviar para = thisDocsProps.getString("sendto").acabamento();

Cordas URL = thisDocsProps.getString("URL").acabamento();

Cordas classificação = thisDocsProps.getString("classificação").acabamento();

flutuante estrelas de classificação = thisDocsProps.getFloat("ratingstars");

int estrelas = (int) estrelas de classificação;

classificação = Cordas.valueOf(thisDocsProps.getFloat("ratingstars"));

userArray.adicionar(novo Usuário(enviar para, URL, classificação,estrelas de classificação));

});

} captura (CouchbaseLiteException e) {

e.printStackTrace();

}

userAdapter = novo Adaptador personalizado do usuário(Atividade principal.este, R.layout.layout personalizado, userArray);

userList = (Visualização de lista) findViewById(R.id.listView);

userList.setItemsCanFocus(falso);

userList.setAdapter(userAdapter);

userList.setOnItemClickListener(novo OnItemClickListener() {

@Override

público vazio onItemClick(Visão do adaptador<?> pai, Ver v, final int posição, longo id) {

Registro.i("Visualização de lista clicada", "**********");

Torradas.makeText(Atividade principal.este, "List View Clicado:" + posição, Torradas.LENGTH_LONG).show();

}

});

banco de dados.próximo();

}

O dados recebidos As funções são ativadas quando SOLICITAÇÕES DE CLASSIFICAÇÃO RECEBIDAS é clicado. Ele exibe todas as solicitações de classificação recebidas, executando uma consulta no banco de dados local para obter os registros.

Ele permite que você insira uma classificação e cria um registro JSON com a classificação. Quando o registro TAXA é clicado, ele grava a solicitação de volta no banco de dados com um tipo de documento de classificado. Se o DELETE é clicado, o registro é excluído definindo-se o tempo de vida do documento (TTL) para expirar.

As novas seções de código funcionam da seguinte forma:

1. Primeiro adicionamos um índice FTS se o arquivo de banco de dados não existir, indicando a primeira entrada no aplicativo.
2. Crie a expressão de pesquisa se o usuário inserir uma string de pesquisa
3. Crie a consulta usando a expressão de pesquisa e execute-a

Instalação da fiação do layout

O código a seguir precisa ser adicionado a activity_main.xml. Ele adiciona o botão de pesquisa e seu rótulo:

<SearchView
   android:id="@+id/searchView"
   android:layout_width="226dp"
   android:layout_height="40dp"
   android:layout_marginStart="4dp"
   android:layout_marginEnd="8dp"
   android:layout_marginBottom="4dp"
   android:background="@color/white"
   app:layout_constraintBottom_toTopOf="@+id/listView"
   app:layout_constraintEnd_toEndOf="parent"
   app:layout_constraintStart_toEndOf="@+id/textView4"
   app:layout_constraintTop_toBottomOf="@+id/Received" />

<TextView
   android:id="@+id/textView4"
   android:layout_width="158dp"
   android:layout_height="38dp"
   android:layout_marginStart="10dp"
   android:layout_marginBottom="4dp"
   android:background="#7BE67F"
   android:backgroundTint="#7BE67F"
   android:fontFamily="sans-serif-black"
   android:gravity="center"
   android:text="Search Text"
   android:textAllCaps="true"
   android:textStyle="bold"
   app:layout_constraintBottom_toTopOf="@+id/listView"
   app:layout_constraintStart_toStartOf="parent"
   app:layout_constraintTop_toBottomOf="@+id/Received" />

<SearchView

androide:id="@+id/searchView"

androide:layout_width="226dp"

androide:layout_height="40dp"

androide:layout_marginStart="4dp"

androide:layout_marginEnd="8dp"

androide:layout_marginBottom="4dp"

androide:fundo="@color/white"

aplicativo:layout_constraintBottom_toTopOf="@+id/listView"

aplicativo:layout_constraintEnd_toEndOf="pai"

aplicativo:layout_constraintStart_toEndOf="@+id/textView4"

aplicativo:layout_constraintTop_toBottomOf="@+id/Received" />

<TextView

androide:id="@+id/textView4"

androide:layout_width="158dp"

androide:layout_height="38dp"

androide:layout_marginStart="10dp"

androide:layout_marginBottom="4dp"

androide:fundo="#7BE67F"

androide:backgroundTint="#7BE67F"

androide:fontFamily="sans-serif-black"

androide:gravidade="center" (centro)

androide:texto="Texto de pesquisa"

androide:textAllCaps="true" (verdadeiro)

androide:textStyle="negrito"

aplicativo:layout_constraintBottom_toTopOf="@+id/listView"

aplicativo:layout_constraintStart_toStartOf="pai"

aplicativo:layout_constraintTop_toBottomOf="@+id/Received" />

Compilação do código

Quando todo o código tiver sido atualizado, clique em Build → ReBuild Project. Quando isso for bem-sucedido, clique em Criar → Executar.

Você será solicitado a escolher o emulador na primeira vez que executar o aplicativo, por exemplo, selecione o NEXUS 5X API 25, como eu fiz. Quando a execução estiver concluída, a página principal terá a seguinte aparência:

Agora você implantou com êxito o código no emulador de sua escolha. Quando o usuário digita uma parte da string de URL, os resultados relevantes são exibidos.

Próximas etapas

Esta é a segunda parte da série de blogs, Criação de um aplicativo móvel com o Couchbaseque se concentra em uma solução móvel completa de ponta a ponta. A primeira parte mostrou como criar um aplicativo que usa um banco de dados Couchbase Lite incorporado para armazenar, recuperar e excluir documentos armazenados localmente no dispositivo.

A Parte 2 adicionou a capacidade de fazer pesquisas baseadas em texto, e a terceira e última parte desta série adicionará a sincronização ponto a ponto e a sincronização com um banco de dados centralizado.

Os principais recursos mencionados nesta postagem incluem:

Sandhya Krishnamurthy, engenheira de soluções sênior, Couchbase

Compartilhe este artigo

Platform

Self-Managed

Services

Capabilities

Why Couchbase?

Migrate to Capella

By Use Case

By Industry

By Application Need

Popular Docs

By Developer Role

Quickstart

Resource Center

About

Partnerships

Our Services

Partners: Register a Deal

Ready to register a deal with Couchbase?

Marriott

Criação de um aplicativo móvel com o Couchbase - Parte 2

O que é o Couchbase Mobile?

Visão geral do aplicativo móvel

Adição de pesquisa de texto completo

Primeiros passos: Revisar a documentação do CBLite

Pré-requisitos para a criação de aplicativos

Compreensão do layout

Revisão do código

Instalação da fiação do layout

Compilação do código

Próximas etapas

Receba atualizações do blog do Couchbase em sua caixa de entrada

Autor

Postado por Sandhya Krishnamurthy, engenheira de soluções sênior, Couchbase

Deixe um comentário Cancelar resposta

Pronto para começar a usar o Couchbase Capella?

Iniciar a construção

Use o Capella gratuitamente

Entre em contato