Componentes personalizados 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 aplicativos móveis usando componentes de arrastar e soltar. O VMD permite definir o fluxo do aplicativo e criar a GUI usando os componentes fornecidos pelo IDE ou componentes que você mesmo criar. O VMD contém muitos componentes de Interface de usuário (IU) padrão que você pode usar para criar aplicativos 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 abertura, 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 compatíveis com JSR-75. Você aprenderá sobre os recursos básicos dos componentes e como navegar no conteúdo do armazenamento de memória do dispositivo e exibir o conteúdo dos arquivos de texto escolhidos. Além do componente personalizado Navegador do arquivo, usaremos outros dois componentes MIDP: Tela de abertura e Caixa de texto.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 6.9 ou posterior

Para acompanhar este tutorial, são necessários os recursos e softwares listados abaixo.

Software ou recurso Versão necessária
NetBeans IDE com Java ME Versão 6.9 ou posterior
Java Development Kit (JDK) Versão 6 ou versão 7

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:

  1. Baixe filebrowserexample.zip.
  2. Descompacte o arquivo.
  3. No IDE, escolha Arquivo > Abrir projetoe navegue até a pasta que contém os arquivos descompactados com o projeto FlieBrowserExample.
  4. Clique em Abrir projeto.
    A janela Projetos deve ter uma aparência semelhante a esta:

    Janela Projetos com o FileBrowserExample aberto

  5. 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.
  6. Na janela Emulador, clique no botão abaixo de "Iniciar."
    O emulador exibe um componente Tela de abertura, em seguida, Navegador de arquivo, como mostrado:

    Emulador WTK 2.5 exibindo o aplicativo Navegador de arquivo de amostra

  • 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:

  1. Crie o projeto FileBrowserExample
  2. Adicione pacotes e um MIDlet visual ao projeto FileBrowserExample
  3. Adicione componentes ao FileBrowserExample
  4. Adicione comandos aos componentes Caixa de texto e Navegador de arquivo
  5. Conecte os componentes para criar um fluxo de aplicativo
  6. Insira o método loadTextFile no código-fonte
  7. Executar o projeto

Criando o projeto FileBrowserExample

  1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione JavaME. Em Projetos, selecione Aplicativo móvel e clique em Próximo.
  2. Indique FileBrowserExample no campo Nome do projeto. Altere a Localização do projeto para um diretório em seu sistema. A partir de agora, vamos chamar esse diretório de $PROJECTHOME.
  3. Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
  4. Deixe o Sun Java Wireless Toolkit como a Plataforma do emulador selecionada. Clique em Próximo.
  5. Clique em Terminar.

    Observação: 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

  1. Escolha o projeto FileBrowserExample na janela Projeto e, a seguir, escolha Arquivo > Novo arquivo (Ctrl-N) . Em Categorias, selecione Classes Java. Em Tipos de arquivo, selecione Pacote Java. Clique em Próximo.
  2. Indique filebrowserexample no campo Nome do pacote. Clique em Terminar.
  3. Escolha o pacote filebrowserexample na janela Projeto e, a seguir, escolha Arquivo > Novo arquivo (Ctrl-N). Em Categorias, selecione MIDP. Em Tipos de arquivo, selecione MIDlet visual. Clique em Próximo.
  4. Indique FileBrowserExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.

Adicionando componentes ao FileBrowserExample

  1. 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
  2. Clique em splashScreen e, na janela Propriedades, altere o valor da propriedade Texto de null (nulo) para o FileBrowserExample.

Adicionando comandos ao FileBrowserExample

  1. Abra a janela Designer de fluxo.
  2. 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).
  3. 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 abertura. Da mesma forma, conecte os componentes como mostrado no gráfico seguinte.

Mostra o Designer de fluxo com componentes conectados por linhas de comando

Inserindo uma pré-ação no código-fonte

  1. Alterne para a janela Código-fonte.
  2. 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();
            }
        }
        
  3. Localize o método commandAction no código-fonte:
    Insira readFile(); na seção de pré-ação do FileBrowser.SELECT_FILE_COMMAND (logo após: if (command == FileBrowser.SELECT_FILE_COMMAND), onde diz //insira a prá-ação 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, realize as etapas abaixo:

  1. Coloque o cursor no componente FileBrowser no código-fonte e pressione Ctr-Shift-Espaço (ou selecione Código-fonte > Exibir documentação).
    O Javadoc deste elemento é exibido em uma janela pop-up.
  2. Clique em Exibir documentação no ícone de navegador da Web externo (Exibir documentação no navegador da Web externo) na janela pop-up para obter informações detalhadas sobre o componente FileBrowser em seu navegador.

início


Consulte também

início

get support for the NetBeans

Support


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo