Componentes personalizados do Visual Mobile Designer: Compositor SMS
Contribuição de Karol Harezlak
O Visual Mobile Designer (VMD) é uma interface gráfica
no NetBeans Mobility pack que permite que você crie aplicações móveis arrastando e
soltando componentes. O VMD permite que você defina o fluxo da aplicação e crie a sua GUI usando os componentes fornecidos pelo Mobility pack, ou componentes que você mesmo cria. 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 abertura, Itens de tabela, etc.
O Compositor SMS é um componente personalizado que fornece um mecanismo e uma interface de usuário para enviar mensagens curtas usando o SMS (Short Message Service).
Este componente utiliza a Wireless Messaging API JSR-120. Esta API não faz parte da especificação MIDP 2.0, assim, este componente personalizado só pode ser implantado em dispositivos que possuam suporte interno para a JSR-120.
Visão geral da aplicação
Este exemplo mostra como usar o componente Compositor SMS em uma aplicação móvel para dispositivos habilitados para Wireless Messaging API (WMA).
Você aprenderá os recursos básicos deste componente e como enviar mensagens usando o SMS.
Além do componente personalizado Compositor SMS, usaremos dois outros componentes MIDP: Tela de abertura e Alerta.
Requisitos
Antes de começar, você deve instalar o seguinte software no seu computador:
- NetBeans IDE 6.0 com Mobility Pack (download)
- Java Standard Development Kit (JDK) versão 6.0 (download)
Caso não conheça o NetBeans Mobility Pack, você deve começar
com o Guia de início rápido do NetBeans 6.0
Mobility CLDC/MIDP antes de continuar.
Instalando e executando a aplicação de amostra
Antes de começar, talvez você queira ver o resultado final do
tutorial.
Siga as etapas seguintes para instalar a aplicação SMSComposerExample:
- Baixe SMSComposerExample.zip.
- Descompacte o arquivo.
- No IDE, escolha Arquivo > Abrir projeto e vá para a pasta que contém o arquivo descompactado.
- Abra as janelas Projeto e Inspetor. Ela deve ser parecida com o seguinte:
- 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 a aplicação é executada, uma janela do emulador se abre e exibe a aplicação que está sendo executada no emulador do dispositivo padrão.
Na janela Emulador, clique no botão abaixo de
"Iniciar."O emulador exibe um componente Tela de splash, depois, o Compositor SMS, conforme mostrado:
- Mova o cursor para cima e para baixo para navegar nas opções disponíveis como Número de telefone ou Mensagem.
- Clique no botão "Alterar" para alterar o número de telefone, o texto da mensagem ou pressione "Enviar" para enviar a mensagem.
- Clique no botão abaixo de "Sair" para fechar a
aplicação.
Criando uma aplicação com o componente personalizado Compositor SMS
Agora que você viu o componente Compositor SMS em ação, vamos
voltar para o início e criar essa aplicação. Para criar a aplicação, faça o seguinte:
- Crie o projeto SMSComposerExample
- Adicione pacotes e um
MIDlet visual ao projeto SMSComposerExample
- Adicione
componentes ao SMSComposerExample
- Adicione
comandos ao Compositor SMS
- Conecte os
componentes para criar um fluxo de aplicação
- Modifique a tarefa da tela de espera
Executar o projeto
Criando o projeto
SMSComposerExample
- Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Em Categorias, selecione Mobility. Em Projetos, selecione Aplicação MIDP e clique em Próximo.
- Indique
SMSComposerExample
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.
- Desmarque a caixa de verificação Criar Hello MIDlet. Clique em Próximo.
- Deixe o Java ME Wireless Toolkit
como a Plataforma de destino selecionada. Clique em Próximo.
Clique em Terminar. A pasta do projeto contém todos os códigos-fonte e os metadados do projeto, como o script Ant do projeto. A
própria aplicação é exibida na janea Design de fluxo do
Visual Mobile Designer.
Adicionando pacotes e um
MIDlet visual ao projeto SMSComposerExample
- Escolha o projeto
SMSComposerExample
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
smscomposerexample
no campo Nome do pacote. Clique em Terminar.
- Escolha o pacote
smscomposerexample
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 SMSComposerExample nos campos Nome do MIDlet e Nome da classe MIDP. Clique em Terminar.
Adicionando componentes ao SMSComposerExample
- 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
- Compositor SMS
- Tela de espera
- Alerta (duas vezes)
- Clique em slashScreen e, na janela Propriedades, altere o
valor da propriedade Texto de "nulo" para "Exemplo
do Compositor SMS"
-
Clique em alert1 e, na janela Propriedades, altere o valor da propriedade Nome da instância de "alert1" para "alertSent" e, da mesma forma, em alert2, altere a propriedade Nome da instância de "alert2" para "alertError".
-
Clique em alertSent e, na janela Propriedades, altere o valor da propriedade String para "Mensagem enviada", da mesma forma, altere a propriedade String no componente alertError para "Erro"
- Clique em smsComposer e, na janela Propriedades, desmarque a propriedade Enviar automaticamente (categoria Propriedades do SMS).
Adicionando comandos ao SMSComposerExample
- 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 smsComposer).
Conectando componentes
- 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.
Modifique a tarefa da tela de espera
- Na janela Navegador, localize o componente de tarefa (categoria Recursos), clique com o botão direito do mouse no componente de tarefa na janela Navegador e escolha a opção Ir para código-fonte. Na janela Código-fonte, localize a seção
// write task-execution user code here" e substitua-a por smsComposer.sendSMS();
Executando o projeto
- Pressione <F6> para executar o projeto principal. Como alternativa, você pode selecionar Executar > Executar projeto principal.
Para saber mais sobre o componente Compositor SMS
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:
- Escolha Ajuda > Referências de Javadoc org.netbeans.microediton.lcdui.wma
- Clique em
org.netbeans.microedition.lcdui.wma para ver os links das informações do componente.
Tutoriais relacionados
