Adicionar comportamentos de servidor personalizados no Dreamweaver

O Dreamweaver acompanha um conjunto de comportamentos de servidor incorporados que permite adicionar recursos dinâmicos a um site com facilidade. Você pode estender a funcionalidade do Dreamweaver criando comportamentos de servidor para atender às suas necessidades de desenvolvimento ou obtendo comportamentos de servidor no site do Dreamweaver Exchange.

Antes de criar comportamentos de servidor próprios, você deve visitar o site do Dreamweaver Exchange para ver se alguma outra parte já criou um comportamento de servidor que fornece a funcionalidade que você gostaria de adicionar ao site. Em geral, um desenvolvedor de outro fabricante já criou e testou um comportamento de servidor que atenderá à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

Caso seja um desenvolvedor proficiente em ColdFusion, JavaScript, VBScript ou PHP, você pode escrever seus próprios comportamentos de servidor. Entre as etapas para criar um comportamento de servidor estão as seguintes tarefas:

• Escreva um ou mais blocos de código que realizem a ação obrigatória.

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

• Caso o comportamento de servidor exija que um valor seja especificado para um parâmetro, crie uma caixa de diálogo que solicite ao desenvolvedor que está aplicando o comportamento fornecer um valor apropriado.

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

Usar o Criador de comportamentos de servidor

Use o Criador de comportamentos de servidor para adicionar o(s) bloco(s) de código que o comportamento insere em uma página.

Opções avançadas

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

Caso seja um usuário avançado, você pode definir 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. Caso o Dreamweaver localize um bloco de código identificador em qualquer lugar de um documento, ele listará o comportamento no painel Comportamentos de servidor. Use a opção Identificador para especificar se o bloco de código deve ser tratado como um identificador.

 Pelo menos um dos blocos de código do comportamento de servidor deve ser identificador. Um bloco de código não deve ser um identificador caso uma das seguintes condições se aplique: o mesmo bloco de código é usado por outro comportamento de servidor, ou o bloco é 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 clicar no botão de adição (+) no painel Comportamentos de servidor, o título do novo comportamento de servidor será exibido no menu pop-up. Quando um designer aplica uma ocorrência de um comportamento de servidor a um documento, o comportamento é exibido na lista de comportamentos aplicados no painel Comportamentos de servidor. Use a caixa Título do comportamento de servidor para especificar o conteúdo do menu pop-up de adição (+) e a lista dos comportamentos aplicados.

 O valor inicial da caixa é o nome que você forneceu na caixa de diálogo Novo comportamento de servidor. À medida que os parâmetros são definidos, o nome é atualizado automaticamente para que os parâmetros sejam exibidos entre parênteses depois do nome do comportamento de servidor.

Caso o usuário aceite o valor padrão, tudo o que estiver antes dos parênteses é exibido no menu pop-up de adição (+) (por exemplo, Definir variável de sessão). O nome mais os parâmetros serão exibidos na lista dos comportamentos aplicados, por exemplo, Definir variável de sessão ("abcd", "5").

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

 Quando você aplica um comportamento de servidor, um dos blocos de código do comportamento é designado como sendo o “bloco de código a ser selecionado”. Caso você aplique o comportamento de servidor e, em seguida, selecione o comportamento no painel Comportamentos de servidor, o bloco designado é selecionado na janela Documento. Por padrão, o Dreamweaver seleciona o primeiro bloco de código que não esteja acima da tag html. Caso todos os blocos de código estejam acima da tag html, é selecionado o primeiro. Os usuários avançados podem especificar qual é o bloco de código selecionado.

Criar blocos de código

Os blocos de código que você cria no Criador de comportamentos de servidor são integrados em um comportamento de servidor exibido no painel Comportamentos de servidor. O código pode ser qualquer código de runtime válido para o modelo de servidor especificado. Por exemplo, caso você escolha ColdFusion como o tipo de documento para o comportamento de servidor personalizado, o código que você escreve deve ser um código do ColdFusion válido em execução em um servidor de aplicativo do ColdFusion.

Você pode criar os blocos de código diretamente no Criador de comportamentos de servidor ou copiar e colar o código de outras fontes. Cada bloco de código que você cria no Criador de comportamentos de servidor deve ser um bloco com tag ou script único. Caso você insira vários blocos de tag, divida-os em blocos de código separados.

Condições em blocos de código

O Dreamweaver permite que você desenvolva blocos de código que incorporam instruções de controle executadas periodicamente. O Criador de comportamentos de servidor usa as instruções if, elseif e else, podendo conter parâmetros do comportamento de servidor. Isso permite inserir blocos de texto alternativos com base nos valores das relações OR entre os parâmetros de comportamento do servidor.

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

As expressões de condição podem ser qualquer expressão JavaScript que possa ser avaliada com o uso da função eval() do JavaScript, podendo incluir um parâmetro do comportamento de servidor marcado por @@s. (Os @@s diferenciam o parâmetro das variáveis e palavras-chave do JavaScript.)

Uso efetivo de expressões condicionais

Durante o uso das diretivas if, else e elseif dentro da tag XML insertText, o texto participante é pré-processado para resolver as diretivas if e determinar o texto a ser incluído no resultado. As diretivas if e elseif usam a expressão como um argumento. A expressão de condição é igual às expressões de condição JavaScript, também podendo conter parâmetros do comportamento de servidor. Diretivas como essa permitem optar por blocos de código alternativos baseados nos valores ou nas relações entre parâmetros do comportamento de servidor.

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

O bloco de código convencional começa com <@ if (@@callableName@@ != '') @> e termina com <@ endif @>. De acordo com o código, caso o usuário digite um valor para o parâmetro @@callableName@@ na caixa de diálogo Parâmetro do comportamento de servidor, em outras palavras, caso o valor de parâmetro @@callableName@@ não seja nulo ou (@@callableName@@ != ''), o bloco de código condicional é substituído pelas seguintes instruções:

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

Posicionar um bloco de código

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

Por exemplo, caso insira um bloco de código acima da tag de abertura <html>, você deve especificar a posição do bloco em relação às demais tags, scripts e comportamentos de servidor na seção do código HTML da página. Entre os exemplos típicos estão o posicionamento de um comportamento antes ou depois de qualquer consulta ao conjunto de registros que também possa existir no código da página acima da tag de abertura <html>.

Quando você seleciona 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 a essa parte da página. Por exemplo, caso você selecione 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 opções relevantes à parte da página.

A seguinte tabela mostra as opções de inserção do bloco de código, além das opções de posicionamento relativo disponíveis a 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 somente quando você quiser inserir mais de um bloco de código em uma determinada ordem. Por exemplo, para inserir uma série ordenada dos três blocos de código após os blocos de código que abrem os conjuntos de registros, você inseriria um peso 60 para o primeiro bloco, 65 para o segundo e 70 para o terceiro.

Por padrão, o Dreamweaver atribui um peso 50 a todos os blocos de código que abrem o conjunto de registros inseridos acima da tag <html>. Caso o peso de dois ou mais blocos seja o mesmo, o Dreamweaver definirá 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 uma tag selecionada 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 todo o bloco algumas vezes, use a seguinte sintaxe:

Ao criar comportamentos de servidor, você pode usar construtos de loop 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 de matrizes de parâmetros separados por vírgulas como argumentos. Nesse caso, os argumentos da matriz de parâmetros permitem ao usuário fornecer vários valores para um único parâmetro. O texto repetitivo é duplicado n vezes, em que n é o comprimento dos argumentos da matriz de parâmetros. Caso seja especificado mais de um argumento de matriz de parâmetros, todas as matrizes devem ter o mesmo comprimento. Na enésima avaliação do loop, o enésimo elemento da matriz de parâmetros substitui as instâncias do parâmetro associado no bloco de códigos.

Ao criar uma caixa de diálogo para o comportamento de servidor, você pode adicionar um controle à caixa de diálogo que permite ao designer da página criar matrizes de parâmetros. O Dreamweaver inclui um controle de matriz simples que você pode usar para criar caixas de diálogo. Esse controle, chamado Lista separada por vírgula do campo de texto, está disponível no Criador de comportamentos de servidor. Para criar elementos de interface de usuário mais complexos, consulte a documentação da API para criar uma caixa de diálogo com um controle de criação de matrizes (um controle de grade, por exemplo).

Você pode aninhar qualquer número de condicionais ou diretivas de loop em uma diretiva condicional. Por exemplo, você pode especificar se uma expressão é verdadeira para executar um loop.

O seguinte exemplo mostra como 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):

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

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

Caso o usuário tenha inserido os seguintes valores de parâmetro na caixa de diálogo Criador de comportamentos de servidor:

O comportamento de servidor inseriria o seguinte código de runtime na página:

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

A diretiva de loop inclui duas variáveis incorporadas que você pode usar em condições if incorporadas. As variáveis são: _length e _index. A variável _length avalia o comprimento das matrizes processadas pela diretiva de loop, enquanto a variável _index avalia o índice atual da diretiva de loop. Para garantir que as variáveis só sejam reconhecidas 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 das variáveis incorporadas é aplicá-las ao atributo import da diretiva de página. O atributo import exige a separação dos pacotes por vírgulas. Caso a diretiva loop se estenda por todo o atributo import, você obtém apenas o nome de atributo import= na primeira iteração do loop, incluindo as aspas de fechamento ("), e não uma vírgula na última iteração do loop. Usando a variável incorporada, você pode expressar isso da seguinte forma:

Solicitar um parâmetro para o comportamento de servidor

Os comportamentos de servidor normalmente exigem que o designer da página forneça um valor de parâmetro. Esse valor deve ser inserido antes do código do comportamento de servidor ser 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 de servidor, que solicita ao designer da página um valor de parâmetro.

Definir o parâmetro no código do comportamento de 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:

Criar uma caixa de diálogo para o comportamento de servidor a fim de solicitar o valor de parâmetro

Exibir a caixa de diálogo

Editar a caixa de diálogo que você criou para o comportamento de servidor

Editar e modificar comportamentos de servidor

Você pode editar qualquer comportamento de servidor criado com o Criador de comportamentos de servidor, inclusive comportamentos de servidor que você baixa no site do Dreamweaver Exchange e de desenvolvedores de outros fabricantes.

Caso você aplique um comportamento de servidor a uma página e, em seguida, edite o comportamento no Dreamweaver, as instâncias do comportamento antigo deixarão de ser exibidas no painel Comportamentos de servidor. O painel Comportamentos de servidor pesquisa a página em busca do código correspondente ao código dos comportamentos de servidor conhecidos. Caso o código de um comportamento de servidor seja alterado, o painel não reconhece as versões anteriores do comportamento na página.

Manter as versões anteriores e novas do comportamento no painel

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

Diretrizes de codificação

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

Não se esqueça das seguintes diretrizes de codificação quando você criar comportamentos de servidor:

Um requisito importante. O código do comportamento de servidor deve lidar tranquilamente com casos de erro. Tente prever todas as possibilidades. Por exemplo, e se uma solicitação de parâmetro falha? E se nenhum registro retornar de uma consulta?

Ajude a garantir que o código seja claramente identificável e evite diferenças de nome em relação ao código existente. Por exemplo, caso a página contenha uma função chamada hideLayer() e uma variável global chamada ERROR_STRING e o comportamento de servidor insira um código que também usa esses nomes, o comportamento de servidor pode entrar em conflito com o código existente.

Eles permitem que você identifique funções de runtime próprias e variáveis globais em uma página. Uma convenção é usar as iniciais. Nunca use o prefixo MM_ porque ele está reservado apenas para uso do Dreamweaver. O Dreamweaver precede todas as funções e variáveis globais com o prefixo MM_ para impedir que elas entrem em conflito com qualquer código que você escreva.

para que o código que você escreve não seja muito semelhante ao código em outros blocos. Caso um bloco de código seja muito semelhante a outro bloco de código na página, o painel Comportamentos de servidor pode identificar por engano o primeiro bloco de código como uma ocorrência do segundo (ou o inverso). Uma solução simples é adicionar um comentário a um bloco de código para torná-lo exclusivo.

Testar comportamentos de servidor

O Dreamweaver Exchange recomenda a realização dos seguintes testes em todos os comportamentos de servidor que você cria:

• Aplique o comportamento do painel Comportamentos de servidor. Caso haja uma caixa de diálogo, insira dados válidos nos campos e clique em OK. Verifique se não ocorre nenhum erro quando o comportamento é aplicado. Verifique se o código de runtime do comportamento de servidor é exibido no Inspetor de código.

• Aplique o comportamento de servidor novamente e digite os dados inválidos em todos os campos da caixa de diálogo. Tente deixar o campo em branco usando números grandes ou negativos, caracteres inválidos (como, por exemplo, /, ?, :, * etc.) e 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 vai além do escopo deste livro).

  Depois de aplicar o comportamento de servidor à página, verifique o seguinte:

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

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

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

  Além disso, caso o comportamento de servidor insira código no documento que estabelece uma conexão com um banco de dados, crie um banco de dados de teste e teste o código inserido no documento. Verifique a conexão definindo as consultas que produzem conjuntos de dados diferentes e tamanhos de conjuntos de dados diferentes.

  Por fim, carregue a página no servidor e a abra em um navegador. Veja o código-fonte HTML da página e verifique se nenhum HTML inválido foi gerado pelos scripts do servidor.