Litebase 1.3 e SuperWaba – Parte 01

Litebase 1.3 e SuperWaba – Parte 01

Wellington Pinto de Oliveira

Conhecendo os bastidores

Litebase é um sistema de gerenciamento de dados simples (implementado a partir do antigo PDBDriver que será descontinuado pela equipe da SuperWaba) desenvolvido para pequenos dispositivos. Este produto foi lançado juntamente com o SuperWaba versão 5.7 (ver Nota 1). O novo formato interno dos arquivos proporcionou um melhor desempenho do produto, que se tornou também mais robusto.

Encontramos no Litebase os conceitos de chave primária simples, índices simples, etc.. A versão atual não possui Join entre tabelas, esta implementação já está pronta e será lançada na versão 2.00. Nesta versão também devemos ter novidades com relação a chaves, será possível a criação de chaves compostas bem como índices compostos.

Nota 1. Dicas rápidas

1 - A portabilidade do Litebase é baseada na portabilidade do SuperWaba. Para conhecer os equipamentos suportados o programador deve acessar a página http://www.superwaba.com.br/pt/pdas_compativeis.asp;

2 - Para o leitor que não conhece o SuperWaba, aconselho a leitura do seguinte PDF: http://www.softpalm.com.br/download/waba.pdf .

Tipos de dados

Os tipos suportados pelo Litebase estão dispostos na Tabela 1.

Tabela 1. Tipos reconhecidos pelo Litebase 1.3.

Criando tabelas, chaves e índices

A sintaxe para criar uma tabela é semelhante ao comando:

CREATE TABLE NOME_TABELA (CAMPO1 TIPO, CAMPO2 TIPO,...).

Para fixar a criação de tabelas crie um projeto no Eclipse com o nome “Artigo WebMobile I”. Neste projeto crie um pacote chamado “samples” e dentro deste pacote uma classe chamada “Primeiro”, conforme Figura 1.

Figura 1. Estrutura do projeto

Nesta classe vamos criar uma tabela com a estrutura exposta na Tabela 2 e vários métodos que devem manipular a informações nesta tabela. Para isto, digite o código da Listagem 1 na classe Primeiro.

Tabela 2. Campos da tabela PESSOAS

package samples;

import litebase.LitebaseConnection;

import waba.sys.Settings;

import waba.sys.Vm;

public class Primeiro extends waba.ui.MainWindow{

  public void onStart()

  {

         //Iniciando a conexão

         LitebaseConnection conn = LitebaseConnection.getInstance(Settings.appCreatorId);

         Vm.debug("Abriu a conexão com: " + Settings.appCreatorId);

         //Gerando as SQLs

         String sql_create = "CREATE TABLE PESSOAS(COD_RG CHAR(20),NOME CHAR(50) NOCASE,DAT_NASCIMENTO DATE,HOUR_CADASTRO DATETIME)";

         String sql_key = "ALTER TABLE PESSOAS ADD PRIMARY KEY(COD_RG)";

         //Validando se já existe a tabela

         if(!conn.exists("PESSOAS"))

         {

                   try

                   {

         //Este método só pode ser usado para CREATE TABLE, ele é void e

         //não retorna se a instrução foi executada ou não

                            conn.execute(sql_create);

                            Vm.debug("A tabela não existe, então ela foi criada");                     

  //Para criar a chave primária temos que executar uma segunda ação

  //usando o executeUpdate(). Ao criar esta chave estamos garantindo

  //integridade da informação armazenada

                            conn.executeUpdate(sql_key);

                            Vm.debug("Chave e indice criado com sucesso");

                   }

                   catch(Exception ex){

                            Vm.debug("Erro: " + ex.getMessage());  

                   }

         }

         else

                   Vm.debug("Não foi preciso criar pois a tabela já existe");

         Vm.debug("Fim");

  }//FIM DO MÉTODO

}

Listagem 1. Código da classe samples.Principal

Para executar o projeto configure o eclipse. Caso não saiba como fazer, recorra ao PDF apontado na Nota 1.

Ao executar o código pela primeira vez, a seguinte resposta é escrita no Console:

141 - Abriu a conexão com: HdBA

156 - A tabela não existe, então ela foi criada

172 - Chave e indice criado com sucesso

172 – Fim