Usar componentes do ColdFusion no Dreamweaver

Sobre os componentes do ColdFusion

Os arquivos de componente do ColdFusion (CFC) permitem encapsular lógica de aplicativo e de negócios em unidades independentes e reutilizáveis.Os CFCs também oferecem uma maneira rápida e fácil de criar serviços web.

Um CFC é uma unidade de software reutilizável escrita em linguagem de marcação ColdFusion (CFML), que facilita a reutilização e manutenção do código.

Você pode usar o Dreamweaver para trabalhar com CFCs. Para obter informações sobre tags e sintaxe de CFC, consulte a documentação do ColdFusion no Dreamweaver (Ajuda > Usando ColdFusion).

Os CFCs foram criados para oferecer uma maneira simples, mas poderosa, para desenvolvedores encapsularem elementos de seus sites.Geralmente, você deve usar componentes para aplicativo ou lógica de negócios.Use tags personalizadas para elementos de apresentação, como saudações personalizadas, menus dinâmicos e assim por diante.

Como em muitos outros tipos de construção, sites dinâmicos podem frequentemente se beneficiar de partes intercambiáveis.Por exemplo, um site dinâmico pode executar a mesma consulta repetidamente ou calcular o preço total de páginas do carrinho de compras e recalculá-lo sempre que um item for adicionado.Essas tarefas podem ser tratadas por componentes. Você pode corrigir, melhorar, estender e até mesmo substituir um componente com impacto mínimo no restante do aplicativo.

Suponha que uma loja na web calcule taxas de envio com base no preço dos pedidos.Para pedidos abaixo de US$ 20, a taxa de envio é US$ 4; para pedidos entre US$ 20 e US$ 40, a taxa de envio é US$ 6, e assim por diante.Você poderia inserir a lógica para calcular a taxa de envio tanto na página do carrinho de compras quanto na página de checkout, mas isso misturaria código de apresentação HTML e código lógico CFML, tornando geralmente o código difícil de manter e reutilizar.

Você decide criar um CFC chamado Pricing que tem, entre outras coisas, uma função chamada ShippingCharge.A função recebe um preço como argumento e retorna uma taxa de envio.Por exemplo, se o valor do argumento for 32,80, a função retorna 6.

Tanto na página do carrinho de compras quanto na página de checkout, você insere uma tag especial para invocar a função ShippingCharge.Quando a página é solicitada, a função é invocada e uma taxa de envio é retornada à página.

Mais tarde, a loja anuncia uma promoção especial: envio grátis para todos os pedidos acima de US$ 100.Você faz a alteração nas taxas de envio em um local—a função ShippingCharge do componente Pricing—e todas as páginas que usam a função automaticamente recebem taxas de envio precisas.

Visão geral do painel Componentes (ColdFusion)

Use o painel Componentes (Janela > Componentes) para visualizar e editar componentes ColdFusion e adicionar código na página que invoca a função quando a página CFM é solicitada.

Criar ou excluir um CFC no Dreamweaver

Você pode usar o Dreamweaver para definir visualmente um CFC e suas funções. Dreamweaver cria um arquivo .cfc e insere as tags CFML necessárias para você.

Exibir CFCs no Dreamweaver

O Dreamweaver fornece uma forma de examinar visualmente os componentes de ColdFusion (CFCs) localizados na pasta do site ou em todo o servidor. Dreamweaver lê os arquivos CFC e exibe informações sobre eles em uma visualização em árvore fácil de navegar no painel Componentes.

Dreamweaver procura pelos componentes no seu servidor de teste (veja Conectando ao banco de dados no Dreamweaver).Caso você crie CFCs ou faça alterações nos CFCs existentes, não se esqueça de carregar os arquivos CFC no servidor de teste para que eles sejam refletidos com precisão no painel Componentes.

Para exibir os componentes localizados em outro servidor, altere as configurações do servidor de teste.

Você pode exibir qualquer uma das seguintes informações sobre os componentes do CF:

• Listar todos os componentes do ColdFusion definidos no servidor.

• Caso você esteja executando o ColdFusion MX 7 ou posterior, filtre a lista para mostrar apenas os CFCs localizados na pasta do site.

• Explorar as funções e os argumentos de cada componente.

• Inspecionar as propriedades das funções que funcionam como serviços da Web.

Para exibir os CFCs no Dreamweaver, siga estas etapas:

Editar CFCs no Dreamweaver

O Dreamweaver oferece uma forma simplificada de editar o código dos componentes ColdFusion definidos para seu site.Por exemplo, você pode adicionar, alterar ou excluir qualquer função de componente sem sair do Dreamweaver.

Para usar este recurso, seu ambiente de desenvolvimento deve ser configurado da seguinte forma:

• O ColdFusion deve estar em execução localmente.

• Na caixa de diálogo Definição de local avançada no Dreamweaver, o tipo de acesso especificado na categoria Servidor de teste deve ser Local/Rede.

• Na caixa de diálogo Definição de local avançada, o caminho da sua pasta raiz local deve ser o mesmo que o caminho da pasta do servidor de teste (por exemplo, c:\Inetpub\wwwroot\cf_projects\myNewApp\). Você pode examinar e alterar esses caminhos selecionando Local > Editar locais.

• O componente deve ser armazenado na pasta do site local ou em qualquer uma de suas subpastas no disco rígido.

Abra qualquer página ColdFusion no Dreamweaver e exiba os componentes no painel Componentes.Para exibir os componentes, abra o painel Componentes (Janela > Componentes), selecione CF Components no menu pop-up do painel e clique no botão Atualizar no painel.

Como o ColdFusion está sendo executado localmente, o Dreamweaver exibe pacotes de componentes no seu disco rígido.

Use o seguinte procedimento para editar um componente.

Criar páginas da Web que usam CFCs

Uma forma de usar a função de um componente nas páginas da Web é escrever código na página que invoca a função quando a página é solicitada. Você pode usar o Dreamweaver para ajudar a escrever este código.

Definir um conjunto de registros em um CFC

O Dreamweaver pode ajudar você a definir um conjunto de registros (também conhecido como consulta do ColdFusion) em um CFC. Definindo um conjunto de registros em um CFC, você não precisa definir o conjunto de registros em todas as páginas em que ele é usado. Você define o conjunto de registros uma vez no CFC e usa o CFC em páginas diferentes.

Usar um conjunto de registros CFC como uma origem de conteúdo dinâmico

Você pode usar um componente de ColdFusion (CFC) como fonte de conteúdo dinâmico para as páginas caso o componente contenha uma função que define um conjunto de registros.

Definir conteúdo dinâmico usando um CFC

Você pode definir um conjunto de registros como uma origem de conteúdo dinâmico no Dreamweaver usando um CFC que contém uma definição de conjunto de registros.

1.Na caixa Nome, insira um nome para o conjunto de registros CFC.

Uma prática comum é adicionar o prefixo rs aos nomes de conjunto de registros para distingui-los de outros nomes de objeto no código, por exemplo: rsPressRelease.

Os nomes dos conjuntos de registros devem conter apenas caracteres alfanuméricos e sublinhados (_). Você não pode usar caracteres especiais ou espaços.

2.Selecione um pacote dos já definidos no servidor.

Caso o pacote não seja exibido no menu pop-up, você pode atualizar a lista de pacotes clicando no botão Atualizar próximo do menu pop-up.

Primeiramente, verifique se você carregou os CFCs no servidor de teste. Só são exibidos CFCs no servidor de teste.

3.Selecione um componente dos definidos no pacote selecionado atualmente.

Caso o menu pop-up Componente não contenha nenhum componente, ou caso nenhum dos componentes criados anteriormente seja exibido no menu, você deve carregar os arquivos CFC no servidor de teste.

4.(Opcional) Para criar um componente, clique no botão Criar Novo Componente.

a. Na caixa Nome, digite o nome para o novo CFC. O nome deve conter apenas caracteres alfanuméricos e sublinhados (_).

b.Na caixa Diretório do Componente, insira o local do seu CFC ou navegue para localizar a pasta.

5. No menu pop-up Função, selecione a função que contém a definição do conjunto de registros.

O menu pop-up Função contém apenas as funções definidas no componente selecionado no momento. Caso nenhuma função seja exibida no menu pop-up ou caso as alterações mais recentes não sejam refletidas nas funções listadas atualmente, verifique se as alterações foram salvas e carregadas no servidor.

6.Editar cada parâmetro (tipo, valor e valor padrão) que deve ser passado como argumento da função clicando no botão Editar.

a. Insira um valor para o parâmetro atual selecionando o tipo de valor no menu pop-up Valor e inserindo o valor na caixa à direita. O tipo de valor pode ser um parâmetro de URL, uma variável de formulário, um cookie, uma variável de sessão, uma variável de aplicativo ou um valor inserido.

b. Insira um valor padrão para o parâmetro na caixa Valor padrão. Caso nenhum valor de runtime retorne, o valor de parâmetro padrão é usado.

c.Clique em OK. 

Você não pode modificar a conexão de banco de dados e a consulta SQL do conjunto de registros. Esses campos estão sempre desativados; a conexão e a consulta SQL são exibidas para sua informação.

7. Clique em Testar para conectar-se ao banco de dados e criar uma instância do conjunto de registros.

Caso a instrução SQL contenha parâmetros de página, verifique se a coluna Valor padrão da caixa Parâmetros contém valores de teste válidos antes de clicar em Testar.

Caso a consulta tenha sido executada com êxito, uma tabela exibe o conjunto de registros. Cada linha contém um registro e cada coluna representa um campo nesse registro.

Clique em OK para limpar a Consulta do CFC.

8. Clique em OK.