Componentes padrão do Visual Mobile Designer: criando um navegador de arquivo de dispositivo móvel
O Visual Mobile Designer (VMD) é uma interface gráfica do NetBeans Mobility que permite criar aplicações móveis usando componentes de arrastar e soltar. O VMD permite definir o fluxo da aplicação e criar a GUI usando os componentes fornecidos pelo IDE ou os componentes criados por você. O VMD contém muitos componentes Interface de usuário (IU) padrão
que você pode usar para criar aplicações como Listas, Alertas, Formulários e
Imagens. Ele também inclui componentes personalizados que simplificam a criação de recursos mais complexos, tais como Telas de espera, Telas de splash, Itens de tabela, etc.
O navegador de arquivo é um componente personalizado que fornece uma interface do usuário que funciona com o sistema de arquivos do dispositivo.
Ele oferece funcionalidade básica para navegar o conteúdo da memória de armazenamento dos dispositivos. Esse componente utiliza a API
FileConnection que é parte da especificação JSR-75
para pacotes opcionais de PDA da Plataforma Java ME. JSR-75 não é uma parte da especificação MIDP 2.0 e é por isso que o componente
personalizado pode ser usado somente com dispositivos ativados por JSR-75.
Este tutorial mostra como usar o componente Navegador de arquivo em um aplicativo móvel para dispositivos ativados por JSR-75. Você aprenderá sobre os recursos básicos dos componentes e como explorar o conteúdo do armazenamento de memória do dispositivo e o conteúdo de exibição dos arquivos de texto escolhidos. Além do componente personalizado Navegador de arquivo, usaremos outros componentes MIDP: Tela de splash e Caixa de texto.
Nota: se estiver utilizando o NetBeans IDE 6.8, consulte o tutorial Criando um navegador de arquivo do dispositivo móvel no NetBeans IDE 6.8.
Conteúdo
Para levar a cabo este tutorial, são necessários os seguintes recursos e softwares.
Instalando e executando o aplicativo de amostra
Antes de começar, talvez você queira ver o resultado final do
tutorial.
Siga as etapas seguintes para instalar o aplicativo FileBrowserExample:
- Baixe filebrowserexample.zip.
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado com o projeto FileBrowserExample.
- Clique em Abrir projeto.
A janela Projetos deve ter uma aparência semelhante a esta:
- Na janela Projetos, clique com o botão direito do mouse no nó do projeto e escolha Executar projeto (ou pressione a tecla F6). Conforme o aplicativo é executado, uma janela do emulador se abre e exibe o aplicativo que está sendo executado no emulador do dispositivo padrão.
- Na janela Emulador, clique no botão abaixo de
"Iniciar."
O emulador exibe um componente Tela de splash,
em seguida, Navegador de arquivo, como mostrado:
- Mova o cursor para cima e para baixo para
navegar pelos arquivos e pastas disponíveis.
- Clique no botão abaixo de
"Selecionar" para abrir a pasta ou o arquivo.
- Clique no botão abaixo de "Sair" para fechar o aplicativo.
início
Criando um aplicativo com o componente personalizado Navegador de arquivo
Agora que você viu o componente Navegador de arquivo em ação, vamos
voltar para o início e criar essa aplicação. Para criar o aplicativo, faça o seguinte:
- Crie o projeto
FileBrowserExample
- Adicione pacotes e um
MIDlet visual ao projeto FileBrowserExample
- Adicione
componentes ao FileBrowserExample
- Adicione
comandos aos componentes Caixa de texto e Navegador de arquivo
- Conectar os componentes para criar um fluxo de aplicativo
- Insira o método
loadTextFile no código-fonte
- Executar o projeto
Criando o projeto
FileBrowserExample
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione JavaME. Em Projetos, selecione Aplicativo móvel e clique em Próximo.
- Indique
FileBrowserExample
no campo Nome do projeto. Altere a Localização do projeto para um diretório em seu sistema. A partir de agora, esse diretório será chamado de $PROJECTHOME.
- Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
- Deixe o Sun Java Wireless Toolkit como a plataforma do emulador selecionada. Clique em Próximo.
- Clique em Terminar.
Nota: a pasta do projeto contém todos os códigos-fonte e metadados do projeto, como o script Ant do projeto. A própria aplicação é exibida na janela Design de fluxo do Visual Mobile Designer.
Adicionando pacotes e um
MIDlet visual ao projeto FileBrowserExample
- Escolha o projeto
FileBrowserExample na janela Projeto, em seguida, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione Classes Java. Em Tipos de arquivo,
selecione Pacote Java. Clique em Próximo.
- Indique
filebrowserexample
no campo Nome do pacote. Clique em Terminar.
- Escolha o pacote
filebrowserexample na janela Projeto, em seguida, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione
MIDlet visual. Clique em Próximo.
- Indique
FileBrowserExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
Adicionando componentes ao
FileBrowserExample
- Alterne seu Visual MIDlet para a janela
Designer de fluxo. Arraste os seguintes componentes da Paleta de componentes e solte-os no Designer de fluxo:
- Tela de splash
- Caixa de texto
- Navegador de arquivo
- Clique em splashScreen e, na janela Propriedades, altere o valor da propriedade Texto de null para Exemplo de navegador de arquivo.
Adicionando comandos ao
FileBrowserExample
- Abra a janela Designer de fluxo.
- Escolha o comando Sair na seção
Comandos da Paleta do componente. Arraste-o e solte na janela
Designer de fluxo (componente Navegador de arquivo).
- Escolha o comando Voltar na seção Comandos da
Paleta do componente e arraste-o e solte no componente Caixa de texto.
Conectando os componentes para criar um fluxo de aplicativo
Na janela Design de fluxo, clique em Ponto de início no
Dispositivo móvel e arraste-o para o componente Tela de splash. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.
Inserindo uma pré-ação no
código-fonte
- Alterne para a janela Código-fonte.
-
Insira o código seguinte no fim do código-fonte. Esse
método é responsável por ler os arquivos selecionados:
/**
* Read file
*/
private void readFile() {
try {
FileConnection textFile = fileBrowser.getSelectedFile();
getTextBox().setString("");
InputStream fis = textFile.openInputStream();
byte[] b = new byte[1024];
int length = fis.read(b, 0, 1024);
fis.close();
if (length > 0) {
textBox.setString(new String(b, 0, length));
}
} catch (IOException ex) {
ex.printStackTrace();
}
}
Localize o método commandAction no código-fonte:
Insira readFile(); na seção de ações prévias do FileBrowser.SELECT_FILE_COMMAND (logo depois de: if (command == FileBrowser.SELECT_FILE_COMMAND), que diz //write pre-action code here (escrever código da ação prévia aqui)):
Executando o projeto
Pressione <F6> para executar o projeto principal ou selecione Executar > Executar projeto principal.
início
Javadoc para o componente Navegador de arquivo
O NetBeans IDE oferece Javadocs de API do componente Navegador de arquivo, assim como outros componentes que você pode usar no VMD. Para ler os Javadocs do componente Navegador de arquivo, complete as etapas abaixo:
- No código-fonte, coloque o cursor no componente FileBrowser e pressione Ctrl-Shift-Barra de espaço (ou escolha Código-fonte > Mostrar documentação).
O Javadoc para este elemento é exibido em uma janela suspensa.
- Clique em Mostrar documentação no ícone do navegador da Web externo (
) na janela pop-up para visualizar informações detalhadas sobre o componente FileBrowser no seu navegador.
início
Consulte também
início
