Por vezes em nosso projeto, pode surgir a necessidade de gerar um arquivo a partir de um determinado conteúdo, como por exemplo: uma lista de itens na tela, instruções que sejam interessantes para o usuário possuir impresso, um boleto bancário e outros.

Esses arquivos temporários são gerados no momento da solicitação do usuário e após ser enviado ao usuário, esses arquivos ficam nos servidores por até 10 minutos, podendo ser gerado novamente através de outra solicitação.

Pré-requisitos

Antes de começar a seguir os passos do tutorial é preciso ter certeza de que se tem um ambiente minimamente preparado para reproduzir o exemplo. Abaixo estão os requisitos principais.

Requisitos:

1. Projeto do tipo mobile ou web criado. Caso haja dúvidas de como criar esse tipo de projeto acesse o link ( Criar projeto );

Visão geral: exemplo

Nesse tutorial iremos aprender a gerar um arquivo para download. Nesse exemplo simples, iremos informar um texto e o mesmo será adicionado ao arquivo e enviado ao usuário para download.

Figura 1 - Exemplo do download do arquivo gerado no momento da solicitação

Criando a função de blocos

Clique com o botão de menu do mouse na pasta Bloco de Programação (Blockly) ( localizada em "Código Fonte (src) / Principal (main) / Código Fonte Server (java) /") e selecione Novo → Bloco de Programação, adicione o nome do Arquivo e clique em finalizar (Figura 2).

Figura 2 - Criando o bloco de programação

Com a função do Bloco de Programação gerada, vamos adicionar o bloco "Para" (seção Funções) e precisaremos criar 3 novas variáveis (seção Variáveis): link, texto e arquivo.

Arraste o "definir (link)" na seção Variáveis, mais os blocos "criar texto com" e "Texto" (seção Texto) e os blocos "Pasta reciclável da aplicação" e "Separador de arquivo" da seção Arquivo. O nosso objetivo aqui é concatenando o endereço, passando o endereço da pasta de arquivos temporários da aplicação, mais o separador de diretórios "/" e por fim o nome do arquivo, que nesse exemplo será "novoArquivo.txt". Deve ficar como na Figura 3.

Figura 3 - Criando o link do arquivo

Dando sequência, arraste o bloco "definir (texto)" (seção Variáveis) e o bloco "Texto" (seção Texto). Para esse exemplo estamos passando o texto "Olá mundo!", porém para uma situação real, seria possível passar uma lista de itens, um bloco que gere boletos em PDF ou qualquer outra coisa.

Traga também para a função, os blocos "definir (arquivo)" (seção Variáveis) e "Abrir arquivo para escrita", passando a variável "link" no parâmetro "Caminho do arquivo" e a variável "texto" no parâmetro "texto", como na Figura 4.

Finalizaremos a função adicionando o bloco "Iniciar download de arquivo físico" da seção Arquivo, passando a variável "link".

Figura 3 - Adicionando o conteúdo ao arquivo e iniciando o download

Adicionando evento

Para testarmos, vamos adicionar um botão na nossa tela home.view.html ("Códigos Fontes / Principal / Códigos Fontes Cliente / views / logged/"), renomeá-lo para "Download" e adicionar um evento ao clicar, chamará o bloco que criamos.

Para adicionar o evento, basta selecionar o botão (1), ir na aba eventos (2), clicar em "…" da propriedade "Ao Clicar" (3), depois em "…" do bloco de programação servidor (4) da janela "Events" para procurar o evento e finalize selecionando a função que acabamos de criar (5).

Figura 3 - Adicionando o evento ao botão download

Testando o download do arquivo

Salve os arquivos alterados e execute a aplicação (F9) ou Debug (F11). Após abrir a aplicação, informe login e senha "admin" e confirme para acessar a página home. Clique no botão "Download" para receber o arquivo de texto "novoArquivo.txt" com o conteúdo: Olá mundo!.

Figura 4 - Ao clicar no botão, o arquivo criado é enviado ao usuário