CAPÍTULO 35 Como utilizar os componentes ColdFusion Os componentes ColdFusion (CFC) permitem ao usuário encapsular lógicas de aplicação e de negócios (business logic) em unidades auto-controladas reutilizáveis. Os componentes ColdFusion também oferecem uma maneira rápida e fácil de se criar serviços para a Web. É possível utilizar o Macromedia Dreamweaver MX para criar e modificar CFCs. Também é possível utilizar o Dreamweaver para construir páginas da web que utilizam CFCs. Observação: Os CFCs podem ser utilizados somente com o Macromedia ColdFusion MX. Os CFCs não são suportados no ColdFusion 5. Este capítulo contém as seguintes seções: Como compreender os componentes ColdFusion, na página 587 Como criar visualmente um componente no Dreamweaver, na página 588 Como exibir os componentes ColdFusion no Dreamweaver, na página 589 Como editar os componentes ColdFusion no Dreamweaver, na página 590 Como criar páginas da Web que utilizam componentes ColdFusion, na página 591 Como compreender os componentes ColdFusion Um componente ColdFusion é uma unidade de software reutilizável escrita em linguagem de marcação ColdFusion (CFML). Os CFCs ajudam a tornar o código reutilizável e fácil de manter. Esta seção descreve as vantagens dos CFCs. As seções posteriores descrevem como o Dreamweaver pode ajudar o usuário a trabalhar com CFCs. Para obter mais informações sobre tags CFC, consulte a ajuda do ColdFusion no Dreamweaver (Ajuda > Como utilizar o ColdFusion). A finalidade dos componentes ColdFusion é assegurar aos desenvolvedores um modo simples, mas poderoso de encapsular elementos de seus sites na Web. Esses componentes geralmente são utilizados para lógica de aplicação ou negócios. Use tags personalizadas para elementos de apresentação, como saudações, menus dinâmicos e assim por diante. Da mesma forma que muitos outros tipos de construção, os sites dinâmicos podem normalmente beneficiar-se das partes intercambiáveis. Por exemplo: um site dinâmico pode executar a mesma consulta repetidamente ou calcular o preço total de páginas com carrinho de compras e recalculálo sempre que item for adicionado. Estas tarefas podem ser controladas por componentes. É possível ajustar, aperfeiçoar, estender e até mesmo substituir um componente com impacto mínimo sobre o restante do aplicativo. 587
Vamos supor que uma loja on-line calcule as taxas de remessa com base no preço dos pedidos. Para pedidos abaixo de R$ 20, o custo da remessa será R$ 4. Para pedidos entre R$ 20 e R$ 40, o custo da remessa será R$ 6 e assim sucessivamente. É possível inserir a lógica para calcular o custo da remessa tanto na página do carrinho de compra como na página de resumo do pedido, mas isso confundiria o código de apresentação HTML e o código de lógica CFML e geralmente tornaria o código difícil de manter e reutilizar. Neste caso, recomenda-se criar um componente ColdFusion de denominado Pricing, que possui, entre outras coisas, uma função chamada processamento de compras (ShippingCharge). Esta função toma um preço como argumento e retorna uma taxa de remessa. Por exemplo: se o valor do argumento for 32,80, a função retornará o valor 6. Tanto na página de carrinho de compra como na página de resumo do pedido, é possível inserir uma tag especial para chamar a função de processamento de compras. Quando a página é solicitada, a função é ativada e uma taxa de remessa retorna à página. Em seguida, a loja anuncia uma promoção especial: remessa grátis para todos os pedidos acima de R$ 100. A mudança é feita nas taxas de remessa em um local (função ShippingCharge do componente Pricing) e todas as páginas que utilizam a função automaticamente adquirem taxas de remessa exatas. Como criar visualmente um componente no Dreamweaver É possível utilizar o Dreamweaver para definir um componente ColdFusion e suas funções visualmente. O Dreamweaver cria um arquivo.cfc e insere as tags CFML necessárias automaticamente. Observação: Dependendo do componente, talvez você tenha de completar algum código à mão. Para criar visualmente um componente ColdFusion: 1 Abra uma página ColdFusion no Dreamweaver. 2 No painel Componentes (Janela > Componentes), selecione Componentes CF no menu pop-up. 3 No painel Componentes, clique no botão de adição (+). A caixa de diálogo Criar componente se abre. 4 Preencha a caixa de diálogo e clique em OK. Para obter mais informações, clique no botão Ajuda da caixa de diálogo. O Dreamweaver grava um arquivo.cfc e o salva na pasta especificada. O novo componente também aparece no painel Componentes (após clicar em Atualizar). Para remover um componente, é necessário excluir o arquivo.cfc do servidor manualmente. 588 Capítulo 35
Como exibir os componentes ColdFusion no Dreamweaver Há uma maneira de examinar visualmente os componentes ColdFusion definidos para o site no Dreamweaver. O Dreamweaver lê os arquivos.cfc localizados no servidor e exibe as informações sobre eles em uma exibição hierárquica fácil de navegar no painel Componentes. Observação: O Dreamweaver procura pelos componentes no servidor de teste (consulte Como especificar onde as páginas dinâmicas podem ser processadas, na página 144). Se desejar exibir os componentes localizados em outro servidor, modifique as configurações do servidor de teste. É possível executar de modo específico quaisquer uma das ações a seguir no Dreamweaver: Listar todos os componentes ColdFusion definidos para o site Explorar as funções e argumentos de cada componente Inspecionar as propriedades das funções supridas como serviços da Web Para exibir os componentes ColdFusion no Dreamweaver: 1 Abra qualquer página ColdFusion no Dreamweaver. 2 No painel Componentes (Janela > Componentes), selecione Componentes CF no menu pop-up. 3 Clique no botão Atualizar no painel para recuperar os componentes. O Dreamweaver exibe os pacotes de componentes no servidor. Um pacote de componentes é uma pasta que contém arquivos CFC. Se os pacotes de componentes existentes não forem exibidos, clique no botão Atualizar na barra de ferramentas do painel. 4 Clique no ícone de adição (+) ao lado do nome do pacote para exibir os componentes armazenados no pacote. 5 Para listar as funções de um componente, clique no ícone (+) ao lado do nome do componente. 6 Para visualizar os argumentos de uma função, bem como o tipo de argumento e se são exigidos ou opcionais, abra a ramificação da função na árvore hierárquica. As funções que não levam argumentos têm possuem o ícone de adição (+) ao lado delas. 7 Para exibir rapidamente os detalhes de um argumento, função, componente ou pacote, selecione o item na árvore hierárquica e clique no ícone Obter detalhes na barra de ferramentas do painel. Também é possível clicar com o botão direito do mouse no item e selecionar Obter detalhes no menu pop-up. O Dreamweaver exibirá os detalhes sobre o item em uma caixa de mensagem. Como utilizar os componentes ColdFusion 589
Como editar os componentes ColdFusion no Dreamweaver O Dreamweaver oferece uma maneira simples e eficaz de editar o código dos componentes ColdFusion definidos para seu site. Por exemplo: é possível adicionar, modificar ou excluir qualquer função de componente sem sair do Dreamweaver. Para utilizar este recurso, o ambiente de desenvolvimento deve estar configurado do seguinte modo: O ColdFusion MX deve estar funcionando localmente. Na caixa de diálogo Avançado da Definição do site no Dreamweaver, o tipo de acesso especificado na categoria Servidor de teste deve ser Local/Rede. Na caixa de diálogo Avançado em Definição do site, o caminho da pasta raiz local deve ser a mesma que a do caminho da pasta do servidor de teste (por exemplo: c:\inetpub\wwwroot\cf_projetos\mynewapp \). É possível verificar e modificar esses caminhos selecionando Site > Editar os sites. O componente deve estar armazenado na pasta do site local ou em qualquer subpasta em seu disco rígido. Antes de editar um CFC, abra qualquer página ColdFusion no Dreamweaver e visualize os componentes no painel Componentes. Para exibir os componentes, abra o painel Componentes (Janela > Componentes), selecione Componentes CF no menu pop-up e clique no botão Atualizar no painel. Uma vez que ColdFusion MX está funcionando localmente, o Dreamweaver exibe pacotes de componentes em seu disco rígido. Para obter mais informações, veja Como exibir os componentes ColdFusion no Dreamweaver, na página 589. Para editar um componente: 1 Geralmente, para editar um arquivo de componente, abra o pacote e clique duas vezes no nome do componente na árvore hierárquica. O Dreamweaver abrirá o arquivo do componente na visualização de código. 2 Para editar uma função, argumento ou propriedade específica, clique duas vezes no item na árvore hierárquica. 3 Efetue as alterações manualmente na visualização de código. 4 Salve o arquivo (Arquivo > Salvar). Para exibir qualquer função nova no painel Componentes, atualize a exibição clicando no botão Atualizar na barra de ferramentas do painel. 590 Capítulo 35
Como criar páginas da Web que utilizam componentes ColdFusion Uma maneira de utilizar uma função de componente em suas páginas da Web é escrever código na página que chama a função quando a página é solicitada. É possível utilizar o Dreamweaver para ajudá-lo a escrever este código. Observação: Para conhecer outros métodos de uso de componentes, veja a ajuda do ColdFusion no Dreamweaver (Ajuda > Como utilizar o ColdFusion). Para utilizar componente ColdFusion em uma página da Web: 1 No Dreamweaver, abra a página ColdFusion que utilizará a função do componente. 2 Alterne para o modo de visualização de código (Exibir > Código). 3 Abra o painel Componentes (Janela > Componentes) e selecione Componentes CF no menu pop-up do painel. 4 Localize o componente que deseja inserir utilizando um dos métodos a seguir: Arraste uma função da árvore hierárquica para a página. O Dreamweaver insere o código na página para chamar a função. Selecione a função no painel e clique no ícone Inserir na barra de ferramentas do painel (segundo ícone à direita). O Dreamweaver insere o código no ponto de inserção da página. 5 Se você inserir uma função com argumentos, complete o código de argumento manualmente. Para obter mais informações, veja a ajuda do ColdFusion no Dreamweaver (Ajuda > Como utilizar o ColdFusion). 6 Salve a página (Arquivo > Salvar). Como utilizar os componentes ColdFusion 591
592 Capítulo 35