Adicionar comportamentos de servidor personalizados no Dreamweaver

Sobre os comportamentos de servidor personalizados

O Dreamweaver vem com um conjunto de comportamentos de servidor integrados que permite adicionar facilmente recursos dinâmicos a um site.É possível estender a funcionalidade do Dreamweaver criando comportamentos de servidor para atender às necessidades de desenvolvimento ou obtendo comportamentos de servidor do site do Dreamweaver Exchange.

Antes de criar seus próprios comportamentos de servidor, verifique o site do Dreamweaver Exchange para ver se outro desenvolvedor já criou um comportamento de servidor que fornece a funcionalidade que você gostaria de adicionar ao site.Muitas vezes, um desenvolvedor de terceiros criou e testou um comportamento de servidor que atende às suas necessidades.

Acessar o Dreamweaver Exchange

Instalar um comportamento de servidor ou outra extensão no Dreamweaver

Fluxo de trabalho dos comportamentos de servidor personalizados

Se você é um desenvolvedor web experiente em ColdFusion, JavaScript, VBScript ou PHP, pode criar seus próprios comportamentos de servidor.As etapas para criar um comportamento de servidor incluem as seguintes tarefas:

• Escreva um ou mais blocos de código que executem a ação necessária.

• Especifique onde o bloco de código deve ser inserido no código HTML da página.

• Se o comportamento de servidor exigir que um Valor seja especificado para um parâmetro, crie uma caixa de diálogo que solicite ao desenvolvedor web que aplica o comportamento para fornecer um Valor apropriado.

• Teste o comportamento de servidor antes de disponibilizá-lo aos demais.

Usar o Criador de comportamentos de servidor

Use o Construtor de comportamentos de servidor para adicionar o bloco ou blocos de código que o comportamento insere em uma página.

Opções avançadas

Depois de especificar o código-fonte e o local de inserção para cada bloco de código, o comportamento do servidor está completamente definido. Na maioria dos casos, você não precisa especificar nenhuma informação adicional.

Se você é um usuário avançado, pode definir qualquer uma das seguintes opções:

Especifica se o bloco de código deve ser tratado como um identificador.

Por padrão, todos os blocos de código são identificadores. Se o Dreamweaver encontrar um bloco de código identificador em qualquer lugar de um documento, ele lista o comportamento no painel Comportamentos do servidor. Use a opção Identificador para especificar se o bloco de código deve ser tratado como um identificador.

Ao menos um dos blocos de código do comportamento do servidor deve ser um identificador. Um bloco de código não deve ser um identificador se uma das seguintes condições se aplicar: o mesmo bloco de código é usado por algum outro comportamento do servidor; ou o bloco de código é tão simples que pode ocorrer naturalmente na página.

Especifica o título do comportamento no painel Comportamentos de servidor.

Quando o designer da página clica no botão Mais (+) no painel Comportamentos do servidor, o título do novo comportamento do servidor aparece no menu pop-up. Quando um designer aplica uma instância de um comportamento do servidor a um documento, o comportamento aparece na lista de comportamentos aplicados no painel Comportamentos do servidor. Use a caixa Título do comportamento do servidor para especificar o conteúdo do menu pop-up Mais (+) e a lista de comportamentos aplicados.

O valor inicial na caixa é o nome que você forneceu na caixa de diálogo Novo comportamento do servidor. Conforme parâmetros são definidos, o nome é automaticamente atualizado para que os parâmetros apareçam entre parênteses após o nome do comportamento do servidor.

Definir variável de sessão (@@Name@@, @@Value@@)

Se o usuário aceitar o valor padrão, tudo antes dos parênteses aparece no menu pop-up Mais (+) (por exemplo, Definir variável de sessão). O nome mais os parâmetros aparecerão na lista de comportamentos aplicados—por exemplo, Definir variável de sessão ("abcd", "5").

Especifica qual bloco de código é selecionado quando o usuário seleciona o comportamento no painel Comportamentos do servidor.

Quando você aplica um comportamento do servidor, um dos blocos de código dentro do comportamento é designado como o "bloco de código a selecionar". Se você aplicar o comportamento do servidor e então selecionar o comportamento no painel Comportamentos do servidor, o bloco designado é selecionado na janela Documento.Por padrão, o Dreamweaver seleciona o primeiro bloco de código que não está acima da tag html.Se todos os blocos de código estão acima da tag html, então o primeiro é selecionado.Usuários avançados podem especificar qual bloco de código é o selecionado.

Criar blocos de código

Os blocos de código que você cria no Construtor de comportamento do servidor são encapsulados em um comportamento do servidor que aparece no painel Comportamentos do servidor.O código pode ser qualquer código de tempo de execução válido para o modelo de servidor especificado.Por exemplo, se você escolher ColdFusion como o tipo de documento para seu comportamento personalizado do servidor, o código que você escreve deve ser código ColdFusion válido que é executado em um servidor de aplicativo ColdFusion.

Você pode criar os blocos de código diretamente no Construtor de comportamento do servidor, ou pode copiar e colar o código de outras fontes.Cada bloco de código que você criar no Construtor de comportamento do servidor deve ser uma única tag ou bloco de Script.Se você deve inserir múltiplos blocos de tag, divida-os em blocos de código separados.

Condições em blocos de código

Dreamweaver permite desenvolver blocos de código que incorporam instruções de controle que são executadas de forma condicional.O Construtor de Comportamento do Servidor usa instruções if, elseif e else, e também pode conter parâmetros de comportamento do servidor.Isso permite inserir blocos de texto alternativo com base nos valores de relacionamentos OU entre parâmetros de comportamento de servidor.

O exemplo a seguir mostra as instruções if, elseif e else. Os colchetes ([ ]) indicam código opcional e o asterisco (*) indica zero ou mais instâncias. Para executar uma parte de um bloco de código ou todo o bloco de código apenas se uma determinada condição ou condições se aplicarem, use a seguinte sintaxe:

<@ if (expression1) @> conditional

text1[<@ elseif (expression2) @> conditional text2]*[<@ else @>

conditional text3]<@ endif @>

Expressões de condição podem ser qualquer expressão JavaScript que pode ser avaliada usando a função JavaScript eval(), e podem incluir um parâmetro de comportamento de servidor marcado por @@'s. (Os @@'s distinguem o parâmetro de variáveis e palavras-chave JavaScript.)

Uso efetivo de expressões condicionais

Ao usar diretivas if, else e elseif dentro da tag XML insertText, o texto participante é pré-processado para resolver as diretivas if e determinar qual texto incluir no resultado. As diretivas if e elseif recebem a expressão como argumento.A expressão de condição é a mesma das expressões de condição JavaScript, e também pode conter parâmetros de comportamento de servidor. Diretivas como esta permitem escolher entre blocos de código alternativos com base nos valores de, ou relacionamentos entre, parâmetros de comportamento do servidor.

Por exemplo, o seguinte código JSP vem de um comportamento de servidor do Dreamweaver que usa um bloco de código condicional:

@@rsName@@.close();

<@ if (@@callableName@@ != '') @>

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();<@ else @>

@@rsName@@ = Statement@@rsName@@.executeQuery();

<@ endif @>

@@rsName@@_hasData = @@rsName@@.next();

O bloco de código condicional começa com <@ if (@@callableName@@ != '') @> e termina com <@ endif @>. De acordo com o código, se o usuário inserir um valor para o parâmetro @@callableName@@ na caixa de diálogo de parâmetros do comportamento do servidor — em outras palavras, se o valor do parâmetro @@callableName@@ não for nulo, ou (@@callableName@@ != &apos;&apos;) — então o bloco de código condicional será substituído pelas seguintes instruções:

@@callableName@@.execute();

@@rsName@@ = @@callableName@@.getResultSet();

Caso contrário, o bloco de código será substituído pela seguinte instrução:

@@rsName@@ = Statement@@rsName@@.executeQuery();

Posicionar um bloco de código

Ao criar blocos de código usando o Construtor de Comportamento de Servidor, você deve especificar onde inseri-los no código HTML da página.

Por exemplo, se inserir um bloco de código acima da tag <html> de abertura, você deve especificar a posição do bloco de código em relação a outras tags, scripts e comportamentos de servidor nesta seção do código HTML da página. Exemplos típicos incluem posicionar um comportamento antes ou depois de todas as consultas de conjunto de registros que também possam existir no código de página acima da tag <html> de abertura.

Ao selecionar uma opção de posicionamento no menu pop-up Inserir Código, as opções disponíveis no menu pop-up Posição Relativa mudam para fornecer opções relevantes para essa parte da página. Por exemplo, se selecionar Acima da tag <html> no menu pop-up Inserir Código, as opções de posicionamento disponíveis no menu pop-up Posição Relativa refletem escolhas relevantes para essa parte da página.

A tabela a seguir mostra as opções de inserção de bloco de código e as opções de posicionamento relativo disponíveis para cada uma:

Para especificar uma posição personalizada, você deve atribuir um peso ao bloco de código.Use a opção Posição personalizada quando precisar inserir mais de um bloco de código em uma ordem específica.Por exemplo, para inserir uma série ordenada de três blocos de código após os blocos de código que abrem conjuntos de registros, você inseriria uma Espessura de 60 para o primeiro bloco, 65 para o segundo e 70 para o terceiro.

Por padrão, o Dreamweaver atribui um peso de 50 a todos os blocos de código de abertura de conjunto de registros inseridos acima da tag <html>.Se o peso de dois ou mais blocos coincidir, o Dreamweaver define aleatoriamente a ordem entre os blocos.

Posicionar um bloco de código (instruções gerais)

Posicionar um bloco de código relativo a outra tag na página

Posicionar um bloco de código relativo a um tag selecionado pelo designer da página

Repetir blocos de código com a diretiva de loop

Para repetir uma parte de um bloco de código ou o bloco de código inteiro várias vezes, use a seguinte sintaxe:

<@ loop (@@param1@@,@@param2@@) @> código

bloco<@ endloop @>

Ao criar comportamentos de servidor, você pode usar estruturas de repetição para repetir um bloco de código um número especificado de vezes.<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> code block <@ endloop @>A diretiva de loop aceita uma lista separada por vírgulas de matrizes de parâmetros como argumentos. Neste caso, os argumentos de matriz de parâmetros permitem que um usuário forneça vários valores para um único parâmetro.O texto repetitivo é duplicado n vezes, onde n é o comprimento dos argumentos de matriz de parâmetros. Se mais de um argumento de matriz de parâmetros for especificado, todas as matrizes devem ter o mesmo comprimento. Na iª avaliação do loop, os iésimos elementos das matrizes de parâmetros substituem as instâncias de parâmetros associadas no bloco de código.

Quando você cria uma caixa de diálogo para o comportamento do servidor, pode adicionar um controle à caixa de diálogo que permite que o designer da página crie matrizes de parâmetros.O Dreamweaver inclui um controle de matriz simples que você pode usar para criar caixas de diálogo.Este controle, chamado Text Field Comma Separated List, está disponível por meio do Server Behavior Builder.Para criar elementos de interface do usuário de maior complexidade, consulte a documentação da API para criar uma caixa de diálogo com um controle para criar matrizes (um controle de grade, por exemplo).

Você pode aninhar qualquer número de condicionais ou uma diretiva de loop dentro de uma diretiva condicional. Por exemplo, você pode especificar que, se uma expressão for verdadeira, um loop seja executado.

O exemplo a seguir mostra como esses blocos de código repetitivos podem ser usados para criar comportamentos de servidor (o exemplo é um comportamento do ColdFusion usado para acessar um procedimento armazenado):

<@ loop (@@param1@@,@@param2@@,@@param3@@,@@param_n@@) @> code block

<@ endloop @>

<CFSTOREDPROC procedure="AddNewBook"

datasource=#MM_connection_DSN#

username=#MM_connection_USERNAME#

password=#MM_connection_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryID#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

Neste exemplo, a tag CFSTOREDPROC pode incluir zero ou mais tags CFPROCPARAM. No entanto, sem suporte para a diretiva loop, não há como incluir as tags CFPROCPARAM dentro da tag CFSTOREDPROC inserida.Se isso fosse criado como um comportamento de servidor sem o uso da diretiva loop, você precisaria dividir este exemplo em dois participantes: uma tag CFSTOREDPROC principal, e uma tag CFPROCPARAM cujo tipo de participante é múltiplo.

Usando a diretiva loop, você pode escrever o mesmo procedimento da seguinte forma:

<CFSTOREDPROC procedure="@@procedure@@"

datasource=#MM_@@conn@@_DSN#

username=#MM_@@conn@@_USERNAME#

password=#MM_@@conn@@_PASSWORD#>

<@ loop (@@paramName@@,@@value@@,@@type@@) @>

<CFPROCPARAM type="IN"

dbvarname="@@paramName@@"

value="@@value@@"

cfsqltype="@@type@@">

<@ endloop @>

</CFSTOREDPROC>

Se o usuário inseriu os seguintes valores de parâmetro na caixa de diálogo Server Behavior Builder:

procedure = "proc1"

conn = "connection1"

paramName = ["@CategoryId", "@Year", "@ISBN"]

value = ["#Form.CategoryId#", "#Form.Year#", "#Form.ISBN#"]

type = ["CF_SQL_INTEGER", "CF_SQL_INTEGER", "CF_SQL_VARCHAR"]

O comportamento de servidor inseriria o seguinte código de tempo de execução na página:

<CFSTOREDPROC procedure="proc1"

datasource=#MM_connection1_DSN#

username=#MM_connection1_USERNAME#

password=#MM_connection1_PASSWORD#>

<CFPROCPARAM type="IN" dbvarname="@CategoryId" value="#Form.CategoryId#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@Year" value="#Form.Year#"

cfsqltype="CF_SQL_INTEGER">

<CFPROCPARAM type="IN" dbvarname="@ISBN" value="#Form.ISBN#"

cfsqltype="CF_SQL_VARCHAR">

</CFSTOREDPROC>

Uso das variáveis _length e _index da diretiva de loop

A diretiva loop inclui duas variáveis integradas que você pode usar para condições if incorporadas. As variáveis são: _length e _index. A variável _length corresponde ao comprimento das matrizes processadas pela diretiva loop, enquanto a variável _index corresponde ao índice atual da diretiva loop.Para garantir que as variáveis sejam reconhecidas apenas como diretivas e não como parâmetros reais a serem passados para o loop, não coloque nenhuma das variáveis entre @@s.

Um exemplo de uso de variáveis integradas é aplicá-las ao atributo import da diretiva de página. O atributo import requer separação por vírgula dos pacotes. Se a diretiva loop se estender em torno de todo o atributo import, você produziria apenas o nome do atributo import= na primeira iteração do loop—isso inclui as aspas duplas de fechamento (")—e não produziria uma vírgula na última iteração do loop. Usando a variável integrada, você pode expressar isso da seguinte forma:

<@loop (@@Import@@)@>

<@ if(_index == 0)@>import="

<@endif@>@@Import@@<@if (_index == _length-1)@>"<@else@>,

<@ endif @>

<@endloop@>

Solicitar um parâmetro para o comportamento do servidor

Comportamentos de servidor geralmente requerem que o designer da página forneça um Valor de parâmetro. Este valor deve ser inserido antes que o código do comportamento do servidor seja inserido na página.

Você cria a caixa de diálogo definindo os parâmetros fornecidos pelo designer no código. Em seguida, você gera uma caixa de diálogo para o comportamento do servidor, que solicita ao designer da página um valor de parâmetro.

Defina o parâmetro no código do comportamento do servidor

Você também pode realçar a sequência de caracteres e clicar no botão Inserir o parâmetro no bloco de código. Digite o nome de um parâmetro e clique em OK. O Dreamweaver substitui todas as instâncias da sequência de caracteres realçada pelo nome de parâmetro especificado entre marcadores de parâmetro.

O Dreamweaver usa as sequências de caracteres que você coloca entre marcadores de parâmetro para identificar os controles na caixa de diálogo gerada (consulte o seguinte procedimento). No exemplo anterior, o Dreamweaver cria uma caixa de diálogo com o seguinte rótulo:

Crie uma caixa de diálogo para o comportamento de servidor solicitando o Valor do parâmetro

Exibir a caixa de diálogo

Edite a caixa de diálogo criada para o comportamento de servidor

Editar e modificar comportamentos de servidor

Você pode editar qualquer comportamento de servidor criado com o Construtor de Comportamento de Servidor, incluindo comportamentos de servidor baixados do site Dreamweaver Exchange e outros desenvolvedores terceirizados.

Se aplicar um comportamento de servidor a uma página e depois editar o comportamento no Dreamweaver, instâncias do comportamento anterior não aparecem mais no painel Comportamentos de servidor. O painel Comportamentos de servidor pesquisa na página por código que corresponda ao código de comportamentos de servidor conhecidos.Se o código de um comportamento de servidor for alterado, o painel não reconhece versões anteriores do comportamento nessa página.

Reter as versões anterior e nova do comportamento no painel

Editar o código de um comportamento de servidor criado com o Construtor de comportamentos de servidor

Diretrizes de codificação

Em geral, o código do comportamento de servidor deve ser compacto e robusto. Desenvolvedores de aplicativo web são muito sensíveis ao código adicionado às suas páginas.Siga práticas de codificação geralmente aceitas para a linguagem do tipo de documento (ColdFusion, JavaScript, VBScript ou PHP). Ao escrever comentários, considere os diferentes públicos técnicos que podem precisar entender o código, como designers web e de interação, ou outros desenvolvedores de aplicativo web. Inclua comentários que descrevam com precisão o propósito do código e instruções especiais para incluí-lo em uma página.

Lembre-se das seguintes diretrizes de codificação ao criar comportamentos de servidor:

Um requisito importante. O código do comportamento do servidor deve tratar casos de erro de forma elegante.Tente prever todas as possibilidades. Por exemplo, e se uma solicitação de parâmetro falhar? E se nenhum registro for retornado de uma consulta?

Ajuda a garantir que o código seja claramente identificável e evite colisões de nomes com código existente. Por exemplo, se a página contém uma função chamada hideLayer() e uma variável global chamada ERROR_STRING, e o comportamento do servidor insere código que também usa esses nomes, o comportamento do servidor pode entrar em conflito com o código existente.

Permite identificar suas próprias funções de tempo de execução e variáveis globais em uma página.Uma convenção é usar as iniciais. Nunca use o prefixo MM_, pois é reservado apenas para uso do Dreamweaver. O Dreamweaver antecede todas as funções e variáveis globais com o prefixo MM_ para impedir que entrem em conflito com qualquer código que você escreva.

var MM_ERROR_STRING = "...";

function MM_hideLayer() {

para que o código que você escreva não se pareça muito com o código de outros blocos. Se um bloco de código se parece demais com outro bloco de código na página, o painel Comportamentos do servidor pode erroneamente identificar o primeiro bloco de código como uma instância do segundo bloco de código (ou vice-versa). Uma solução simples é adicionar um comentário a um bloco de código para torná-lo mais único.

Testar comportamentos de servidor

O Dreamweaver Exchange recomenda realizar os seguintes testes em cada comportamento de servidor que você criar:

• Aplique o comportamento do painel Comportamentos de servidor. Se tiver uma caixa de diálogo, insira dados válidos em cada campo e clique em OK. Verifique se não ocorre nenhum erro quando o comportamento é aplicado. Verifique se o código de tempo de execução para o comportamento do servidor aparece no inspetor de código.

• Aplique o comportamento de servidor novamente e insira dados inválidos em cada campo da caixa de diálogo. Tente deixar o campo em branco, usando números grandes ou negativos, usando caracteres inválidos (como /, ?, :, *, e assim por diante), e usando letras em campos numéricos. Você pode escrever rotinas de validação de formulário para lidar com dados inválidos (rotinas de validação envolvem codificação manual, o que está além do escopo deste livro).

  Após aplicar com sucesso o comportamento de servidor à página, verifique o seguinte:

• Verifique o painel Comportamentos do servidor para ter certeza de que o nome do comportamento de servidor aparece na lista de comportamentos adicionados à página.

• Se aplicável, verifique se os ícones de script do lado do servidor aparecem na página.Os ícones genéricos de script do servidor são escudos dourados. Para ver os ícones, habilite Elementos invisíveis (Exibir > Auxílios visuais > Elementos invisíveis).

• Na visualização Código (Exibir > Código), verifique se nenhum código inválido é gerado.

  Além disso, se o comportamento de servidor inserir código no documento estabelecendo uma conexão com um banco de dados, crie um banco de dados de teste para testar o código inserido no documento. Verifique a conexão definindo consultas que produzem diferentes conjuntos de dados e diferentes tamanhos de conjuntos de dados.

  Por fim, faça upload da página para o servidor e abra-a em um navegador. Visualize o código-fonte HTML da página e verifique se nenhum HTML inválido foi gerado pelos scripts do lado do servidor.