BlackBerry Java SDK. Data Storage Versão: 6.0. Guia do desenvolvedor

Transcrição

1 BlackBerry Java SDK Data Storage Versão: 6.0 Guia do desenvolvedor

2 Publicado: SWD

3 Conteúdo 1 Visão geral do armazenamento de dados... 4 Recursos do armazenamento de dados... 4 Considerações para a escolha de uma abordagem de armazenamento de dados... 5 Locais de armazenamento... 5 Acesso à memória Armazenamento de arquivos no sistema de arquivos... 7 Exemplo de código: Criação de pastas... 8 Exemplo de código: Criação de arquivos... 8 Exemplo de código: Gravação de texto em arquivos... 9 Exemplo de código: Leitura de seções de arquivos binários... 9 Exemplo de código: Como usar o System.getProperty() para exibir o caminho à pasta de vídeo Exemplo de código: Recuperação de listas de raízes montadas Armazenamento em bancos de dadossqlite Exibição de bancos de dados SQLite Simular um cartão de memória Segurança de bancos de dados SQLite Exemplo de código: Criando um banco de dados criptografado SQLite Desempenho de bancos de dados SQLite Prática recomendada: Otimizando o desempenho do banco de dados SQLite Criação e exclusão de bancos de dados SQLite Arquivos de banco de dados SQLite Codificação de caracteres Criar um banco de dados SQLite Exemplo de código: Criando um banco de dados SQLite Exemplo de código: Adicionando um esquema a um banco de dados SQLite Exemplo de código: Excluindo um banco de dados SQLite Como trabalhar com bancos de dados SQLite Uso de transações Uso de parâmetros SQL Uso de limitações de chaves estrangeiras Exemplo de código: Inserção de dados de tabela Exemplo de código: Recuperação de dados de tabela Exemplo de código: Exclusão de dados de tabela Exemplo de código: Atualização de dados de tabela Exemplo de código: Listagem de tabelas de banco de dados... 32

4 Aplicativo de exemplo SQLite Visão geral Arquivos no aplicativo de exemplo Interfaces em destaque Classes em destaque Instale o aplicativo de exemplo Execute o aplicativo de amostra Armazenamento persistente de objetos Segurança de objetos persistentes Restrição do acesso a objetos persistentes Desempenho de um armazenamento persistente Prática recomendada: Como usar uma seleção de estrutura de dados eficiente Prática recomendada: Como preservar handles de objeto Limpeza de objetos persistentes Como criar um armazenamento persistente Criar um armazenamento de dados persistente Armazenar dados persistentes Armazenar um objeto em uma transação em lote Como trabalhar com o armazenamento persistente Obter dados persistentes Remover dados persistentes Remover dados persistentes específicos de um BlackBerry Java Application Obter um conjunto do armazenamento persistente Armazenamento não-persistente de objetos Usos comuns do armazenamento em tempo de execução Segurança de armazenamento em tempo de execução Proteger dados de armazenamento em tempo de execução usando chaves de assinatura de código Adicionar um objeto ao armazenamento em tempo de execução Substituir um objeto no armazenamento em tempo de execução Obter o armazenamento em tempo de execução Obter um objeto Runtime registrado Obter um objeto Runtime não registrado Exemplo de código: Armazenamento de Strings no armazenamento em tempo de execução Exemplo de código: Como obter uma string armazenada pelo armazenamento em tempo de execução Exemplo de código: Como criar um singleton usando a API RuntimeStore Armazenamento de dados no armazenamento de registros... 51

5 Criar um armazenamento de registros Adicionar um registro a um armazenamento de registros Exemplo de código: Adição de registros a um armazenamento de registros Obter um registro de um armazenamento de registros Obter todos os registros de um armazenamento de registros Exemplo de código: Armazenamento e recuperação dos dados com o armazenamento de registros Gerenciamento de dados Prática recomendada: Diminuição do uso da memória Remoção de dados confidenciais Uso do Coletor de lixo Coleta de lixo completa em um aparelho BlackBerry Gerenciamento de memória baixa Como identificar situações de pouca memória disponível nos aparelhos BlackBerry Como fazer backup dos dados Mais informações Enviar comentários Glossário Histórico da revisão de documentos Aviso legal... 67

6 Visão geral do armazenamento de dados Visão geral do armazenamento de dados 1 Há várias maneiras possíveis de armazenar, compartilhar e gerenciar dados em seus aplicativos BlackBerry Java : Abordagem de armazenamento de dados Sistema de arquivos Banco de dados SQLite Armazenamento persistente Armazenamento em tempo de execução Armazenamento de registros Descrição e API Armazena dados em arquivos e pastas usando a API FileConnection. Armazena dados em bancos de dados relacionais usando a API Banco de dados. Salva objetos através da reinicialização de aparelhos usando a API PersistentStore. Salva objetos não persistentes, o que é útil para compartilhar dados entre aplicativos e criar singletons em todo o sistema usando a API RuntimeStore. Armazena dados no Sistema de gerenciamento de registros do MIDP usando a API RMS. Recursos do armazenamento de dados A tabela a seguir compara cada abordagem. Recursos Sistema de arquivos Banco de dados SQLite Data format Qualquer Arquivo de banco de dados relacional Storage locations Maximum storage limit Armazenament o de aplicativo, cartão de memória externo, armazenament o incorporado de mídia Tamanho de partições a que o usuário tem acesso Cartão de memória externo, armazenam ento incorporado de mídia Tamanho de partições a que o usuário tem acesso Armazenamento persistente Armazenament o em tempo de execução Armazenamento de registros Objeto Java Objeto Java Serializado Armazenament o de aplicativo Armazenament o disponível de aplicativo Armazenamen to de aplicativo Armazenamen to disponível de aplicativo Armazenament o de aplicativo Difere de acordo com a versão do BlackBerry Device Software 4

7 Locais de armazenamento Recursos BlackBerry Device Software support Persists across device restarts Applications can share data Sistema de arquivos 4.2 ou posterior (API FileConnection) Banco de dados SQLite 5.0 ou posterior Armazenamento persistente Tudo Armazenament o em tempo de execução 3.6 ou posterior Sim Sim Sim Não Sim Sim Sim Sim Sim Sim Armazenamento de registros Tudo Considerações para a escolha de uma abordagem de armazenamento de dados O sistema de arquivos é geralmente a localização mais eficiente de armazenamento para arquivos grandes somente leitura, tais como vídeos ou gráficos grandes. Para armazenar outros dados que não sejam arquivos grandes somente leitura, os bancos de dados SQLite são uma opção expansível de armazenamento de dados. A memória em aparelhos sem fio pode ser muito limitada, portanto procure não armazenar todos os dados no aparelho. Os aparelhos BlackBerry estão frequentemente conectados, de forma que seu aplicativo pode acessar os dados quando necessário. Em muitos casos, o melhor método é armazenar dados através de aparelhos que reiniciam apenas para dados que são frequentemente acessados. Ao pensar em que local armazenar dados essenciais, lembre-se de que é possível remover cartões microsd. Há mais latência ao gravar no armazenamento do aplicativo do que há ao ler a partir dele. Por exemplo, ler do armazenamento persistente é relativamente rápido enquanto que confirmar é relativamente lento. O sistema de arquivos e o armazenamento de registros são abordagens baseadas em padrões, enquanto o armazenamento persistente e o armazenamento em tempo de execução são específicos a aparelhos BlackBerry. Se deseja que seu aplicativo seja executado em outros aparelhos compatíveis com Java ME, utilize uma abordagem baseada em padrões. Locais de armazenamento Diferentes aparelhos BlackBerry suportam diferentes lugares para armazenar dados. Os seguintes locais de armazenamento estão disponíveis, dependendo do modelo do aparelho BlackBerry: Armazenamento de aplicativo Este local de armazenamento é interno para o aparelho BlackBerry. Ele contém o sistema operacional, o BlackBerry Java Virtual Machine e um sistema de arquivos internos. O armazenamento de aplicativo também é chamado memória flash e memória interna. O armazenamento de aplicativo é o único lugar em um aparelho BlackBerry no qual os aplicativos podem ser executados. Todos os aparelhos BlackBerry têm armazenamento de aplicativo. 5

8 Locais de armazenamento Armazenamento de cartão de memória externo Armazenamento de mídia interno Este local de armazenamento é um cartão microsd que os usuários do aparelho BlackBerry podem inserir para estender a quantidade de armazenamento em seus aparelhos. É opcional e removível. Um sistema de arquivos FAT é montado no cartão de memória. Os cartões microsd são suportados em todos os aparelhos executando o BlackBerry Device Software 4.2 ou posterior, com exceção do BlackBerry 8700 Series. Este local de armazenamento é um cartão de memória incorporado chamado emmc. Ele não é removível. Um sistema de arquivos FAT é montado no cartão de memória incorporado. O armazenamento incorporado de memória também é chamado de cartão de memória interna e memória interna do aparelho. O armazenamento de mídia incorporado está incluído em alguns modelos do aparelho BlackBerry. Acesso à memória O ambiente BlackBerry Java foi projetado para impedir que os aplicativos causem problemas, de forma acidental ou intencional, em outros aplicativos ou no próprio aparelho BlackBerry. Os aplicativos têm permissão de gravação apenas na memória do aparelho BlackBerry usada pela BlackBerry Java Virtual Machine; eles não podem acessar a memória virtual ou o armazenamento persistente de outros aplicativos (a não ser que seja especificamente concedido acesso para isso). Os aplicativos personalizados só podem acessar armazenamento persistente ou dados de usuários, ou estabelecer comunicação com outros aplicativos, por meio de APIs específicas. A Research In Motion deve assinar digitalmente os aplicativos que utilizem certas APIs BlackBerry para fornecer uma trilha de auditoria dos aplicativos que usam APIs confidenciais. 6

9 Armazenamento de arquivos no sistema de arquivos Armazenamento de arquivos no sistema de arquivos Você pode, automaticamente, criar e gerenciar os arquivos e as pastas em aparelhos BlackBerry com a API FileConnection. A API FileConnection foi introduzida com o BlackBerry Device Software 4.2. A API FileConnection é implementada no pacote javax.microedition.io.file. A API FileConnection é definida pelo JSR 75 e é incorporada à Estrutura genérica de conexão. O componente principal da API FileConnection é a classe javax.microedition.io.file.fileconnection. Diferentemente de outras conexões de Estrutura genérica de conexão, os objetos FileConnection podem, com êxito, ser retornados do método javax.microedition.io.connector.open() sem se referir a um arquivo ou uma pasta existente. Este comportamento permite a criação de novos arquivos e pastas em um sistema de arquivos. Além da documentação da RIM, há muitas fontes de informações sobre JSR 75 e a Estrutura genérica de conexão. Além disso, a RIM fornece extensões à API FileConnection. O pacote net.rim.device.api.io.file inclui as seguintes classes e interfaces: FileSystemJournal e FileSystemJournalListener oferecem uma maneira de detectar alterações ao sistema de arquivos. ExtendedFileConnection ExtendedFileConnection permite a criptografia e a proteção de arquivos. Você pode acessar o sistema de arquivos no armazenamento interno e no armazenamento externo por cartão de memória: 2 Armazenament o interno Armazenament o externo Armazenamento interno é o armazenamento de aplicativo ou o armazenamento incorporado de mídia. Todos os aparelhos têm armazenamento interno. Para acessar o armazenamento interno, use o caminho file:///store. Por exemplo: FileConnection fc = (FileConnection)Connector.open("file:///Store") Você pode acessar o armazenamento externo por cartão de memória apenas em aparelhos com cartões microsd. Para acessar armazenamento externo por cartão de memória, use o caminho file:///sdcard. Por exemplo: FileConnection fc = (FileConnection)Connector.open("file:///SDCard") Arquivos criados por seu aplicativo não são excluídos automaticamente quando o aplicativo é desinstalado. Os aparelhos que têm armazenamento incorporado de mídia têm uma partição de sistema de arquivos chamada Sistema. No BlackBerry Device Software 5.0 e posterior, a partição do sistema é somente leitura e está reservada para o uso do sistema. Em versões anteriores ao BlackBerry Device Software 5.0, a partição do sistema é de leitura/ gravação. Você pode acessar esta partição com o caminho file:///system. 7

10 Exemplo de código: Criação de pastas Exemplo de código: Criação de pastas import net.rim.device.api.system.application; import javax.microedition.io.*; import javax.microedition.io.file.*; import java.io.ioexception; public class CreateFolderApp extends Application public static void main(string[] args) CreateFolderApp app = new CreateFolderApp(); app.setacceptevents(false); try // the final slash in the folder path is required FileConnection fc = (FileConnection)Connector.open("file:///SDCard/ testfolder/"); // If no exception is thrown, the URI is valid but the folder may not exist. if (!fc.exists()) fc.mkdir(); // create the folder if it doesn't exist fc.close(); catch (IOException ioe) System.out.println(ioe.getMessage() ); Exemplo de código: Criação de arquivos import javax.microedition.io.*; import java.io.ioexception; import javax.microedition.io.file.*; import net.rim.device.api.system.application.*; public class CreateFileApp extends Application public static void main(string[] args) CreateFileApp app = new CreateFileApp(); app.setacceptevents(false); try FileConnection fc = (FileConnection)Connector.open("file:///store/home/ user/newfile.txt"); // If no exception is thrown, then the URI is valid, but the file may or may not exist. if (!fc.exists()) fc.create(); // create the file if it doesn't exist 8

11 Exemplo de código: Gravação de texto em arquivos fc.close(); catch (IOException ioe) System.out.println(ioe.getMessage() ); Exemplo de código: Gravação de texto em arquivos import net.rim.device.api.system.application; import javax.microedition.io.*; import javax.microedition.io.file.*; import java.io.ioexception; import java.io.outputstream; public class AddFileContent extends Application public static void main(string[] args) AddFileContent app = new AddFileContent(); app.setacceptevents(false); try FileConnection fc = (FileConnection)Connector.open("file:///store/home/user/ newfile.txt"); // If no exception is thrown, then the URI is valid, but the file may or may not exist. if (!fc.exists()) fc.create(); // create the file if it doesn't exist OutputStream outstream = fc.openoutputstream(); outstream.write("test content".getbytes()); outstream.close(); fc.close(); catch (IOException ioe) System.out.println(ioe.getMessage() ); Exemplo de código: Leitura de seções de arquivos binários Este exemplo de código demonstra como ler seções de um arquivo binário lendo informações de cabeçalho de um arquivo.gif. O aplicativo lê a largura e a altura da imagem no cabeçalho. Para executar o exemplo de código, você deve colocar um arquivo.gif na pasta raiz de um cartão de memória em um aparelho BlackBerry. 9

12 Exemplo de código: Leitura de seções de arquivos binários import net.rim.device.api.ui.*; import net.rim.device.api.io.*; import javax.microedition.io.file.*; import javax.microedition.io.*; import java.io.*; import net.rim.device.api.ui.component.*; import net.rim.device.api.ui.container.*; public class RandomFileAccess extends UiApplication public static void main(string[] args) RandomFileAccess app = new RandomFileAccess(); app.entereventdispatcher(); public RandomFileAccess() pushscreen(new HomeScreen()); class HomeScreen extends MainScreen public HomeScreen() settitle("random File Access Sample"); try FileConnection fc = (FileConnection)Connector.open("file:///SDCard/ test.gif"); boolean bfileexists = fc.exists(); if (!bfileexists) Dialog.alert("Cannot find specified GIF file."); System.exit(0); DataInputStream in = fc.opendatainputstream(); byte[] widthbytes = new byte[2]; byte[] heightbytes = new byte[2]; if ( in instanceof Seekable ) ((Seekable) in).setposition(6); in.read(widthbytes,0,2); ((Seekable) in).setposition(8); in.read(heightbytes,0,2); int widthpixels = widthbytes[0] * widthbytes[1]; int heightpixels = heightbytes[0] * heightbytes[1]; add(new LabelField("Width: " + widthpixels + "\nheight: " + heightpixels)); in.close(); fc.close(); catch (IOException ioe) ioe.printstacktrace(); 10

13 Exemplo de código: Como usar o System.getProperty() para exibir o caminho à pasta de vídeo Exemplo de código: Como usar o System.getProperty() para exibir o caminho à pasta de vídeo import net.rim.device.api.ui.component.labelfield.*; import net.rim.device.api.ui.container.mainscreen.*; import net.rim.device.api.ui.uiapplication.*; public class GetVidDir extends UiApplication public static void main(string args[]) GetVidDir app = new GetVidDir(); app.entereventdispatcher(); public GetVidDir() HomeScreen hs = new HomeScreen(); pushscreen(hs); class HomeScreen extends MainScreen public HomeScreen() LabelField msg = new LabelField(System.getProperty("fileconn.dir.videos")); add(msg); Exemplo de código: Recuperação de listas de raízes montadas import java.util.enumeration.*; import javax.microedition.io.file.filesystemregistry,*; import net.rim.device.api.ui.component.labelfield.*; import net.rim.device.api.ui.container.mainscreen.*; import net.rim.device.api.ui.uiapplication.*; public class ListMountedRoots extends UiApplication public static void main(string[] args) ListMountedRoots app = new ListMountedRoots(); app.entereventdispatcher(); public ListMountedRoots() pushscreen(new HomeScreen()); 11

14 Exemplo de código: Recuperação de listas de raízes montadas class HomeScreen extends MainScreen public HomeScreen() StringBuffer msg = new StringBuffer( The mounted roots are:\n ); Enumeration e = FileSystemRegistry.listRoots(); while (e.hasmoreelements()) msg.append( e.nextelement() ); msg.append( \n ); add(new LabelField(msg)); 12

15 Armazenamento em bancos de dadossqlite Armazenamento em bancos de dadossqlite 3 Os bancos de dados SQLite não requerem nenhuma configuração nem administração. Ao contrário do esquema e dos dados, a área de ocupação do banco de dados é muito pequena (cerca de 300 KB). Para criar e usar bancos de dados SQLite em um aplicativo Java, você deve usar a API Banco de dados. As classes necessárias em bancos de dados SQLite estão no pacote net.rim.device.api.database. O BlackBerry Device Software 6.0 usa o SQLite versão Nota: Este guia descreve como usar bancos de dados SQLite em aplicativos Java. Há outras maneiras de usar bancos de dados SQLite em um aparelho BlackBerry. Eles são aplicativos BlackBerry WebWorks, HTML5 e Google Gears. Para obter mais informações, consulte docs.blackberry.com. Exibição de bancos de dados SQLite Visualizadores de bancos de dados SQLite estão disponíveis a partir de revendedores terceirizados. Estes visualizadores podem ser úteis no processo de desenvolvimento de seus bancos de dados. Os visualizadores de bancos de dados são especialmente úteis para ver alterações em um banco de dados. Ao executar uma instrução SQL, é possível consultar o resultado no visualizador de bancos de dados imediatamente. Um visualizador de bancos de dados SQLite é executado em seu computador, e não no aparelho BlackBerry. Para usar o visualizador, configure o BlackBerry Smartphone Simulator para emular um cartão microsd. Assim, quando executar seu aplicativo, o banco de dados será armazenado em um diretório no computador e o visualizador de bancos de dados poderá lê-lo. Os visualizadores de bancos de dados SQLite não funcionam em bancos de dados criptografados. Você poderá criptografar o banco de dados quando seu aplicativo SQLite for concluído. Simular um cartão de memória Para exibir os bancos de dados SQLite em um visualizador de banco de dados, você talvez tenha que configurar o BlackBerry Smartphone Simulator para emular um cartão de memória. Por padrão, os arquivos de banco de dados são armazenados em um cartão de memória. 1. Crie uma pasta no computador para armazenar arquivos de emulação para o cartão de memória. 2. No menu Simulate, clique em Change SD Card. 3. Clique em Add Directory. 4. Navegue até a pasta que você criou e clique nela. 5. Clique em OK. 6. Clique em Close. Segurança de bancos de dados SQLite Seu banco de dados SQLite pode ter as seguintes configurações de segurança: 13

16 Segurança de bancos de dados SQLite Não criptografado, acessível de qualquer aplicativo no aparelho BlackBerry Criptografado, acessível de qualquer aplicativo no aparelho Criptografado e protegido, acessível somente a partir de aplicativos no aparelho que estiverem assinados com a chave de assinatura de código Não há maneiras de criar um banco de dados não-criptografado e restringir seu uso para apenas um aplicativo. Isso ocorre porque há outras maneiras (usando operações de E/S do arquivo) de ler um arquivo de banco de dados nãocriptografado de outros aplicativos. A implementação da criptografia e da proteção é realizada com a classe DatabaseSecurityOptions. Criptografia O algoritmo usado para implementar a criptografia SQLite é o AES 256. Um banco de dados criptografado não pode ser movido para outro aparelho: ele pode ser aberto apenas no aparelho onde foi originalmente criado. Para transferir um banco de dados criptografado para outro aparelho, você deverá, primeiro, descriptografá-lo. Um aplicativo pode abrir ou criar um banco de dados criptografado apenas quando o aparelho está desbloqueado. Se um banco de dados estiver aberto quando um aparelho for desbloqueado, o banco de dados continuará a ser legível e gravável. A criptografia não protege o seu banco de dados de forma que ele não fique acessível a outros aplicativos no aparelho. Para restringir o acesso, você deve assinar o banco de dados com uma chave de assinatura de código. O exemplo de código a seguir cria um banco de dados criptografado, mas não assinado. Ele cria um objeto DatabaseSecurityOptions chamado dbso que passa true como o único valor do parâmetro: try URI myuri = URI.create("file:///SDCard/Databases/SQLite_Guide/" + "MyEncryptedDatabase.db"); DatabaseSecurityOptions dbso = new DatabaseSecurityOptions(true); d = DatabaseFactory.create(myURI,dbso); d.close(); catch ( Exception e ) System.out.println( e.getmessage() ); e.printstacktrace(); Criptografia e proteção Para restringir um banco de dados de forma que ele possa ser acessado somente pelo aplicativo do qual ele faz parte, você deve assinar o banco de dados com uma chave de assinatura de código. Para restringir o acesso a um aplicativo, você deve usar uma chave exclusiva gerada com o uso da ferramenta Signing Authority. Essa assinatura é separada da assinatura de código que você cria para APIs controladas. 14

17 Segurança de bancos de dados SQLite Também é possível usar a chave de assinatura de código para compartilhar o acesso ao banco de dados com outros aplicativos específicos. Quando vários aplicativos são assinados com a mesma chave, todos os aplicativos têm acesso ao banco de dados. Para especificar que um banco de dados seja criptografado e assinado, você poderá optar por dois construtores idênticos. O exemplo de código a seguir criptografa e protege um banco de dados existente. Primeiro, o exemplo de código recupera a chave de assinatura de código de um arquivo chamado XYZ. Depois, ele criptografa e assina o banco de dados. Se o banco de dados já estiver criptografado, o método será encerrado cuidadosamente. CodeSigningKey codesigningkey = CodeSigningKey.get(CodeModuleManager.getModuleHandle( "SQLiteDemo" ), "XYZ"); try DatabaseFactory.encrypt(uri, new DatabaseSecurityOptions(codeSigningKey)); catch(databaseexception dbe) errordialog("encryption failed - " + dbe.tostring()); Exemplo de código: Criando um banco de dados criptografado SQLite Por padrão, os arquivos de banco de dados são armazenados em um cartão de memória. Se você usar o BlackBerry Smartphone Simulator, talvez seja preciso Simular um cartão de memória. import net.rim.device.api.ui.*; import net.rim.device.api.ui.component.*; import net.rim.device.api.ui.container.*; import net.rim.device.api.database.*; import net.rim.device.api.io.*; public class CreateEncryptedDatabase extends UiApplication public static void main(string[] args) CreateEncryptedDatabase theapp = new CreateEncryptedDatabase(); theapp.entereventdispatcher(); public CreateEncryptedDatabase() pushscreen(new CreateEncryptedDatabaseScreen()); class CreateEncryptedDatabaseScreen extends MainScreen Database d; public CreateEncryptedDatabaseScreen() LabelField title = new LabelField("SQLite Create Encrypted Database Sample", LabelField.ELLIPSIS LabelField.USE_ALL_WIDTH); settitle(title); add(new RichTextField("Creating an encrypted database called " + "MyEncryptedDatabase.db on the SDCard.")); 15

18 Desempenho de bancos de dados SQLite try URI myuri = URI.create("file:///SDCard/Databases/SQLite_Guide/" + "MyEncryptedDatabase.db"); DatabaseSecurityOptions dbso = new DatabaseSecurityOptions(true); d = DatabaseFactory.create(myURI,dbso); d.close(); catch ( Exception e ) System.out.println( e.getmessage() ); e.printstacktrace(); Desempenho de bancos de dados SQLite Comparado com um computador, um smartphone fornece um ambiente bastante limitado para um banco de dados SQLite. Para obter o desempenho ideal em um aparelho BlackBerry, você deve construir seu banco de dados com estas limitações em mente. Em um aparelho BlackBerry, apenas uma conexão leitura-gravação de banco de dados a um banco de dados SQLite pode ser feita por vez. Outras conexões de banco de dados são somente leitura. Há um limite de 16 conexões simultâneas de banco de dados, e de três a seis dessas são usadas pelo aplicativo de mídia. Há limites quanto à quantidade de RAM disponível para um banco de dados SQLite para o armazenamento de estruturas de dados internas para esquemas e transações e o suporte a BLOBs em uma tabela. No BlackBerry Device Software 5.0, o limite é 512 KB. No BlackBerry Device Software 6.0, o limite é 5 MB. O esquema de banco de dados inteiro é carregado na memória quando um banco de dados SQLite é aberto e persiste até que o banco de dados seja fechado. O esquema para cada tabela, gatilho, índice etc. ocupa uma determinada quantidade de RAM. Além disso, o limite de memória para vincular BLOBs é significativamente menor do que o limite total de memória e variará dependendo do restante deixado após a alocação de memória para estruturas de dados SQLite, esquemas e transações em andamento. Se planeja criar um banco de dados com um esquema grande ou inserir BLOBs grandes, você deve testar o banco de dados em seus aparelhos BlackBerry de destino para assegurar-se de que os aparelhos tenham memória adequada. O comprimento máximo de consulta SQL é 4 KB. Prática recomendada: Otimizando o desempenho do banco de dados SQLite Considere as seguintes diretrizes: 16

19 Desempenho de bancos de dados SQLite Prática recomendada Descrição Armazenar o mínimo de dados possível Usar transações explícitas Criar índices eficientes A maioria do tempo de processamento dos bancos de dados SQLite é dedicada a ler e gravar no armazenamento. Menos dados geralmente significa menos leitura e gravação. O mecanismo de banco de dados SQLite armazena em cache as páginas de banco de dados freqüentemente acessadas. Ao armazenar menos dados, você pode aumentar a probabilidade de o mecanismo de banco de dados SQLite recuperar dados solicitados mais rapidamente do cache, em vez de recuperar do acesso de armazenamento, que é relativamente lento. Se não usar transações explícitas, uma transação começará antes que cada instrução seja executada e terminará depois que a instrução for executada. Este comportamento padrão é ineficiente. Requer que o arquivo de diário seja aberto, reaberto, editado e fechado para cada instrução. Com transações explícitas, você pode agrupar instruções. Os índices podem reduzir bastante o tempo requerido para varrer uma tabela. Considere as seguintes diretrizes: Minimizar o tamanho das linhas Armazenar BLOBs adequadamente Usar tabelas temporárias Usar parâmetros SQL Evitar subconsultas Desfragmentar o banco de dados A ordem das colunas em um índice afeta o desempenho. As colunas que geralmente são usadas nas cláusulas WHERE devem ser colocadas primeiro, seguidas por colunas que geralmente são usadas em cláusulas ORDER BY. Para as colunas contendo dados que são recuperados, crie um índice de cobertura. Evite índices duplicados. O mecanismo de banco de dados SQLite cria automaticamente índices para colunas que têm limitações UNIQUE ou PRIMARY KEY. Se houver uma coluna muito larga, coloque-a em uma tabela separada. Se seus dados incluem BLOBs, armazene cada BLOB em uma tabela separada. Se os BLOBs forem muito grandes, você poderá armazená-los como arquivos fora do banco de dados (e armazenar o caminho para cada arquivo no banco de dados), mas esta prática introduz códigos extras para a busca de nomes de arquivos. Se não precisar que os dados estejam disponíveis após reiniciar os aparelhos BlackBerry, use a instrução CREATE TEMP TABLE em vez de CREATE TABLE. Para executar um conjunto de instruções do mesmo formato, primeiro prepare uma instrução genérica que use parâmetros SQL. Você pode executar a instrução através da iteração pelos valores variáveis e vincular os valores às variáveis nomeadas em cada iteração. Em alguns casos, o mecanismo de banco de dados SQLite armazena subconsultas que resultam em um arquivo temporário, o que pode retardar o processamento. Use o comando VACUUM do SQLite para desfragmentar o banco de dados. Este processo também reduz o tamanho do arquivo do banco de dados. 17

20 Criação e exclusão de bancos de dados SQLite Prática recomendada Descrição Considerar a ordem das colunas nas instruções em tabela A ordem das colunas em uma instrução em tabela afeta o desempenho, especialmente na ausência de um índice, porque o mecanismo de banco de dados SQLite varre as colunas na ordem definida na instrução em tabela. As colunas que contêm quantidades pequenas de dados que são frequentemente acessados devem ser colocadas antes das colunas que contêm quantidades grandes de dados que são acessados com menos frequência. Criação e exclusão de bancos de dados SQLite Você pode criar bancos de dados temporários ou permanentes. A instrução CREATE TABLE cria um banco de dados permanente, ou regular. Quando você não precisar armazenar dados através de redefinições de aparelhos, você deverá usar a instrução CREATE TEMP TABLE para criar tabelas temporárias, pois são mais eficientes. As tabelas temporárias criadas são armazenadas em um banco de dados temporário junto com todos os índices, gatilhos e exibições associadas. O arquivo de banco de dados temporário é excluído automaticamente quando a conexão do banco de dados é fechada. Quando seu aplicativo é removido, os bancos de dados permanentes associados com seu aplicativo não são excluídos automaticamente. Arquivos de banco de dados SQLite Cada banco de dados SQLite é armazenado em um único arquivo. Se você só especificar o nome do banco de dados como valor do parâmetro para DatabaseFactory.create(), o arquivo de banco de dados será criado no armazenamento externo por cartão de memória. O local padrão para o arquivo de banco de dados é /SDCard/ databases/nome_do_aplicativo/. O nome do aplicativo que cria o banco de dados é incluído no caminho padrão para evitar nomes repetidos. Você não pode armazenar bancos de dados SQLite no armazenamento de aplicativo. O armazenamento externo por cartão de memória é o local preferido de armazenamento para bancos de dados se o aparelho BlackBerry oferecer suporte. Nos aparelhos que suportam o armazenamento externo por cartão de memória, você pode criar bancos de dados em armazenamento externo por cartão de memória especificando o caminho /SDcard/. Se o seu aplicativo tiver sido projetado para armazenar seu banco de dados SQLite no armazenamento de mídia incorporado, você deverá implementar seu aplicativo de modo que seja fácil modificar o código para alterar o local de armazenamento do banco de dados. Nos aparelhos que suportam o armazenamento de mídia incorporado, você pode criar bancos de dados em armazenamento de mídia incorporado especificando o caminho /store/. Quando seu aplicativo é desinstalado, os bancos de dados SQLite associados a ele não são removidos automaticamente. Codificação de caracteres A API Banco de dados usa codificação de caracteres UTF-8. O Java armazena as strings internamente em UTF-8, de forma que você não precisa fazer nenhuma codificação nem conversão. 18