ColdFusion - Aprender a programar

Transcrição

1 ColdFusion - Aprender a programar Date : 17 de Dezembro de 2007 CFML Parte 3 Variáveis + Dump + Param + Operadores Lógicos Olá pessoal, chegamos à 3ª parte sobre ColdFusion... nesta parte vamos trabalhar mais um pouco com variáveis, como nomeá-las correctamente, duas funções muito úteis (cfdump e cfparam), como enviar/receber as variáveis via FORM e URL. 1 - Nomenclatura de variáveis. Algo muito importante, mas que eu não citei antes, é como devemos chamar as variáveis que iremos utilizar. Existem algumas regras que devem ser seguídas. A) Não iniciar o nome de uma variável utilizando NÚMEROS. B) Não utilizar caracteres especiais e/ou palavras reservadas. C) Não utilizar espaços nos nomes. Alguns exemplos: Correcto: - nome - variables.nome - Session.nome Pplware 1 / 7

2 - Application.nome - url.nome - form. nome - variables.meu_nome Errado: - variables.1nome - 1nome - variables.meu nome - cfelse - cfif Então, sempre que forem criar as vossas variáveis, lembrem-se de seguir este padrão. OBS: O alvo (target) irá variar dependendo do caso. 2 Envio/Recebimento/Recuperação de variáveis. Como já foi mostrado anteriormente, nós podemos trabalhar com uma variável desta forma. para criar para mostrar o conteúdo #variables.nome# No entanto, e se quisermos trabalhar com variáveis dinâmicas ao invés de fixas? Com o exemplo a seguir, iremos criar algumas variáveis e enviá-las de diferentes formas. URL: Variáveis viajam via URL através do endereço (querystring) da página, ou seja, a variável irá aparecer na barra de endereços. crie um ficheiro chamado: P03_envia_variaveisURL_01.cfm e coloque o código abaixo: Nome: O código acima irá criar um formulário chamado form01, com a página P03_recebe_variaveisURL_01.cfm como destino ( action ) e com o método get. Logo em seguida escrevemos a palavra Nome e criamos um campo input do tipo text com o nome de txtnome. Pplware 2 / 7

3 De seguida criamos um campo input do tipo submit com o valor Enviar. OBS: Existem dois métodos para formulários. - Get: envia os dados do formulário via URL. - Post: envia os dados do formulário via FORM. Corra a página no navegador, o resultado será este: Agora crie uma nova página chamada: P03_recebe_variaveisURL_01.cfm e coloque-lhe o seguinte código. Seu nome é: #url.txtnome# O resultado será este: OBS: Notem no sublinhado a vermelho na URL o nome da nossa variável (txtnome) e o valor que lhe demos (neste exemplo: Marcos) Este valor foi o nome que eu escrevi no campo da primeira página, antes de pressionar o botão Enviar. Pplware 3 / 7

4 Neste exemplo, o cfoutput agarrou na variável url.txtnome, txtnome foi o nome que demos para esta variável e, URL é o target da variável, ou seja, de onde esta vem. Outra forma de criarmos uma variável de URL é durante a criação de um link, por exemplo, pode adicionar a linha abaixo no final do código da primeira página. Enviar Página Ao clicar neste link o resultado será o mesmo, a única diferença é a criação da variável, que foi feita manualmente na própria URL do link. Neste tipo de criação, as variáveis devem começar a sere criadas após o final do endereço desejado + o sinal?. O? significa que o endereço acabou e que a partir dali começarão a ser declaradas as variáveis. Pode declarar várias variáveis, que devem ser separadas pelo símbolo: &. Exemplo: Enviar Página Desta forma estamos a enviar as seguintes variáveis/valores -txtnome = Marcos - Site =Pplware - Ano = 2007 Como recuperar estas novas variáveis? Da mesma forma que recuperamos a primeira, basta colocar o nome delas e o target dentro da tag Nome: #url.txtnome# Site: #url.site# Ano: #url.ano# OBS: Este exemplo acima só funcionará pelo método do LINK pois estas variáveis não existem no formulário, logo, ao enviar o formulário, a próxima página irá procurar por variáveis que não existem, o que ocasionará em um ecrã de erro. Em breve mostrarei algumas soluções para este tipo de problema. FORM O método de enviar/receber variáveis via form é praticamente igual ao via URL, a diferença é que os dados trafegam escondidos do utilizador. Para utilizar o método form, crie duas novas páginas trocando a palavra URL dos nomes pela palavra FORM. Pplware 4 / 7

5 No código destas duas novas páginas, realize as seguintes mudanças Página que envia: - Substituir o método (method) de GET para POST. - Apagar a linha com o link que criamos por último. Página que recebe: - Substituir a target URL pela target FORM. - Deixar apenas a variável txtnome dentro do e apagar as outras. Pronto.. o nosso novo método de envio/recuperação de variáveis está pronto. Para criar novos campos, basta criar novos inputs com nomes diferentes dentro do formulário e preenchê-los. Para mostrá-los, basta adicionar os nomes das variáveis dentro do que ele irá automaticamente buscar o valor das variáveis. CFDUMP A tag é amplamente utilizada para debugar o que está acontece com uma variável ou targets de variáveis. Para visualizar o seu funcionamento realize o seguinte procedimento. Abra a página que recebe as variáveis via URL (P03_recebe_variaveisURL_01.cfm) e no final adicione a seguinte linha de código. OBS: A tag apenas adiciona uma linha na página. Abaixo do nosso output aparecerão 2 quadrados coloridos representando o nosso dump. O primeiro representa o dump da variável específica que pedimos ( url.txtnome ). O segundo representa o dump do target de variáveis que pedimos( url ). Ecrã: Pplware 5 / 7

6 O dump também é utilizado em outras ocasiões, por exemplo para sabermos o que é devolvido de uma consulta à uma base de dados. Trabalharemos com ele novamente no futuro. CFPARAM Voltando à nossa primeira página desta 3ª parte. Bom, como devem lembrar-se, devido ao facto do nosso formulário inicial somente possuir o campo txtnome ao clicarmos no nosso link (que possui 3 variáveis), um ecrã de erro nos seria mostrado caso clicássemos no nosso botão de Enviar, no entanto, caso clicássemos no link, o erro não seria mostrado. Qual razão? Unicamente por um motivo. A página que estamos a requerer espera que 3 variáveis existam. Caso cliquemos no link as 3 variáveis serão criadas e enviadas. Caso cliquemos no botão, apenas uma variável será criada e enviada. Como contornar este problema? Bom, dentre os vários modos, um deles é a utilização da tag. A tag CFPARAM funciona verificando se uma variável existe e, caso ela não exista, ela cria a variável e atribui um valor pré-definido. Abra novamente a página (P03_recebe_variaveisURL_01.cfm) e adicione as seguintes linhas de código no COMEÇO da página. Corram novamente a primeira página, escreva seu nome e, desta vez, utilizem o botão para enviar os dados. O resultado será este: Pplware 6 / 7

7 Powered by TCPDF ( Ao carregarmos esta página, a mesma situação será encontrada, esta página irá pedir 3 variáveis mas só teremos uma, o ecrã de erro desapareceu porque utilizamos o cfparam. Ao carregarmos esta página o que aconteceu? O primeiro CFPARAM verificou se a variável url.site existia, caso ela existisse, nada aconteceria, no entanto, como não existia, ele criou-a e atribuiu-lhe o valor Site Não Informado. O mesmo aconteceu com a variável url.ano. Bom, por hoje é só pessoal, brinquem um pouco enviando variáveis via FORM e URL de uma página para a outra e utilizando o CFPARAM para tratar possíveis erros, bem como o CFDUMP para verificar o que está a vir de dentro das variáveis e targets. A partir da próxima parte iremos tratar estes erros de outra forma, através de operadores lógicos. Abraços Pplware 7 / 7