Configurando a JSP Library Definition

Uma Definição de Biblioteca JSP contém recursos do projeto que são necessários para uma biblioteca de componentes e os metadados necessários para a interpretação de tags JSP. Isto o ajuda a customizar a integração de uma biblioteca de tags JSP customizada para este produto.

Procedimento

  1. Clique duas vezes em sua Definição de Biblioteca JSP para abrir o arquivo de definição de biblioteca no editor. Seu arquivo de definição de biblioteca tem uma extensão CLD.
  2. Faça as mudanças necessárias em sua definição de biblioteca. O arquivo de definição de biblioteca inclui as seções a seguir:
  3. Depois de configurar sua definição de biblioteca, salve o arquivo. A definição é atualizada.
  4. Para atualizar o arquivo, clique em Atualizar Definição da Biblioteca e, em seguida, clique em Executar atualização. O processo de atualização localizará novas tags e atributos na biblioteca de tags e os incluirá na definição de biblioteca.
    Lembre-se: Incremente a versão da definição de biblioteca após a atualização ser concluída.

Definição de Biblioteca JSP

O editor de Definição de Biblioteca JSP é usado para configurar os detalhes sobre como incorporar uma nova biblioteca JSP no projeto.

Sobre Esta Tarefa

Nome da Biblioteca
Nome da biblioteca.
Descrição
Uma descrição da biblioteca.
URI de Taglib
O URI de taglib da biblioteca de componentes.
Prefixo
O prefixo que é fornecido para as tags.
Versão
O número da versão indicará o nível da configuração na definição de biblioteca. Ele sinaliza quando recursos mais novos podem estar disponíveis para aplicativos da web existentes. Quando uma definição de biblioteca for inicialmente criada, escolha uma versão que seja significativa para a biblioteca de tags selecionada. Por exemplo, inicie com o número da liberação para bibliotecas de tags disponíveis publicamente. A forma típica do número da versão é uma sequência separada por pontos, tal como 1.2.3.4. Após a definição de biblioteca estar em uso e os recursos para uma biblioteca de tags serem instalados em um ou mais aplicativos da web, mudanças adicionais na definição poderão precisar de uma atualização da versão. Se forem feitas quaisquer mudanças na seção Configuração de Aplicativo de uma definição de biblioteca implementada, aumente o número da versão. O número da versão aumentado indica ao ambiente de trabalho que recursos mais novos ou mudanças na configuração estão disponíveis. Quaisquer projetos da web que usam a biblioteca de tags são marcados com um erro. A Correção Rápida associada a esse erro pode atualizar os projetos da web com a configuração atual.
Lembre-se: Se uma biblioteca de tags não seriver incluída em um projeto da web, o aumento do número da versão é desnecessário.
As mudanças em quaisquer áreas da Definição de Biblioteca, exceto a seção Configuração de Aplicativo, são lidas dinamicamente e, portanto, não requerem uma mudança de versão.

Configuração do Aplicativo

A seguir há detalhes de como configurar o projeto da web para usar a nova biblioteca de componentes. A configuração declara como copiar os arquivos no projeto da web e todas as mudanças na configuração que devem ser feitas para que os componentes funcionem corretamente.

Sobre Esta Tarefa

Recursos
A área de recursos é usada para definir arquivos a copiar em um projeto da web quando uma biblioteca é usada pela primeira vez. O caminho de origem é o caminho relativo para um arquivo dentro do projeto de Definições de JSP. O caminho de destino é o caminho dentro do projeto no qual a biblioteca é utilizada. Por exemplo, o arquivo a partir do caminho de origem /mystylesheet.css pode receber um destino de /theme. Esse caminho de destino resulta na colocação de uma cópia do arquivo CSS na pasta /theme do projeto da web.
Atualizações de web.xml
Esta seção contém informações sobre vários tipos de modificações que são feitas no descritor de implementação de um projeto da web no qual a biblioteca é utilizada. Novos servlets, parâmetros de contexto e filtros podem ser configurados sob as subseções correspondentes no editor.
Para incluir um servlet, parâmetro de contexto ou filtro:
  1. Selecione web.xml.
  2. Clique em Incluir e selecione o item da caixa de diálogo.
Servlet
Esta página define os parâmetros para um novo servlet a ser incluído no web.xml.
Parâmetro de Contexto
Esta seção registra os detalhes sobre como incluir um parâmetro de contexto no descritor de implementação da web. Quando a biblioteca é usada pela primeira vez em um projeto da web, o arquivo web.xml é modificado para incluir essas informações.
Filtrar
Esta seção define um novo filtro, que é incluído no arquivo web.xml. Os parâmetros de inicialização para este filtro são incluídos clicando em Incluir no editor.
Parâmetro de Inicialização
Esta página coleta dados para um parâmetro de inicialização para uma definição de filtro de web.xml.
Mapeamentos de URL
Esta seção coleta quaisquer mapeamentos baseados em URL para o filtro.
Mapeamentos de Servlet
Esta seção coleta mapeamentos de filtro que são baseados em um nome de servlet, que é definido em outro lugar em web.xml.

Biblioteca de Marcações

Esta seção lista todas as tags customizadas que compõem a biblioteca e ativam a configuração de muitos detalhes relacionados ao comportamento da ferramenta. Por exemplo, é possível especificar a aparência das tags na Paleta, os comportamentos ao soltar as tags no editor, a aparência visual dos componentes na origem da página da web e vários detalhes sobre os atributos da tag e a ligação de dados.

Sobre Esta Tarefa

Esta seção do editor é utilizada para configurar detalhes sobre as tags reais na biblioteca de componente. Quando a definição de biblioteca é gerada, ela contém todas as tags na biblioteca de componentes. É possível alterar a ordem das tags utilizando os botões Para cima e Para baixo. A ordem especificada para as tags é mostrada na aparência da biblioteca na Paleta.

Algumas informações visuais sobre a categoria da paleta de biblioteca podem ser configuradas nesta página. Configure quaisquer links de folha de estilo ou referências de JavaScript que se aplicam a todas as tags em uma biblioteca aqui. Quando uma tag é incluída a partir da paleta, as tags <link> e <script> correspondente são incluídas na página da web.

Identificação
Esta página configura a aparência da tag de componente na paleta, incluindo as informações sobre o rótulo e o ícone. A tag também pode ficar oculta, por padrão, ou removida das opções da paleta.
Propriedades de descarte
O comportamento da inserção de novas tags a partir da paleta é modificado pelos parâmetros nesta página. Se o componente for um controle semelhante ao contêiner e outros componentes forem permitidos como filhos, selecione Permite Filhos. Links de folha de estilo, as referências de JavaScript podem ser especificados tag por tag nesta página. As especificações de folha de estilo e JavaScript também podem ser feitas para a biblioteca inteira na página da Tag.
Atributos de tag padrão
Para configurar um valor de atributo padrão de uma tag, especifique o nome e o valor do atributo. Quando uma tag de componente for incluída a partir da paleta, este valor de atributo será automaticamente configurado.
Visualização
Para muitos componentes, a exibição da tag no editor de página visual é renderizada corretamente. Em alguns casos, a renderização da tag falhará inteiramente ou ela não será renderizada corretamente. Se a renderização falhar, a tag aparecerá como uma caixa cinza com o nome da tag. Quando esse problema ocorrer, é possível customizar a aparência da tag, especificando tags HTML básicas com alguns modificadores de variável. Essa tag é usada como uma visualização substituta dentro do editor de página.
Modelos de visualização de amostra estão disponíveis e incluem exemplos de como usar o modificadores de variável. Para visualizar os modelos, clique em Editar na seção Detalhes.
Saiba mais sobre as variáveis padrão de visualização:

Um padrão de visualização é usado para controlar a aparência de um componente no painel de projeto do editor da página. O padrão consiste em markup HTML e algumas variáveis de substituição para alterar dinamicamente o conteúdo da visualização. Quando um componente é arrastado em uma página, o padrão correspondente é avaliado. O editor de página usa o HTML resultante para criar uma representação de tempo de design útil. Detalhes das variáveis padrão disponíveis são mostrados na Tabela 1.

Tabela 1. Variáveis padrão de visualização. A descrição e exemplos fornecem informações sobre variáveis.
Consolidação Descrição Exemplo
${children} A variável ${children} emite todas as tags filhas da tag que está sendo visualizada, se alguma estiver presente, na posição da variável ${children} no padrão. Tags filhas são inseridas na ordem em que aparecem na página original. O editor da página calcula a visualizações para as tags filhas, pois elas também podem usar padrões. Como todas as tags filhas são inseridas no mesmo local, um padrão pode usar somente uma variável ${children}.
<div>
  ${children}
</div>
${children:row} O modificador de linha da variável ${children} emite as tags filhas em uma sequência de elementos <td> da célula de tabela HTML. Use essa variável quando você estiver organizando vários componentes horizontalmente.
<table>
  <tr>
    ${children:row}
  </tr>
</table>
${children:grid(param[,param]*)}

O modificador de grade cria um conjunto de linhas e células da tabela HTML que contêm filhos de uma tag. Filhos são incluídos da esquerda para a direita e agrupados na próxima linha quando um número especificado de colunas é atingido. A contagem de coluna padrão é 2. A lista de parâmetros separada por vírgula opcional substitui o número de colunas na grade.

As opções de parâmetro são:
attr.attrName
O valor do atributo da tag com o nome attrName. Este parâmetro deve resolver para um número inteiro.
N
Uma constante de número inteiro positivo.

Os parâmetros são examinados sequencialmente até que um valor válido seja localizado. Por exemplo, o padrão ${children:grid(attr.size, attr.numcols, 3)} utilizaria o atributo size da tag se fosse definido, caso contrário, ele utilizaria o atributo numcols, se definido. Se nenhum atributo for definido, a constante 3 será usada.

<table>
  ${children:grid(attr.columns, 2)}
</table>
${children:stack(param)} O modificador de pilha é usado em painéis com guias para criar linhas da tabela e células para preencher uma visualização de células empilhadas. Ele cria uma tabela horizontal de rótulos que pode ser clicada para cada tag filha. Clicar em um dos rótulos coloca a visualização da tag filha na parte superior da pilha. O parâmetro opcional especifica qual atributo de tag das tags filhas usar para o rótulo, utilizando a sintaxe attr.attrName.
<table>
  ${children:stack(attr.label)}
</table>
${attr:attrName} Esta variável substitui o valor de atributo de uma tag no local atual no padrão. Se o atributo não tiver um valor configurado, uma sequência de caracteres vazia será inserida.
<input type="text" value="${attr:value}" />
Atributos da Tag
Para cada tag, uma descrição de atributo e um tipo podem ser especificados. A ordem dos atributos na lista e o tipo para cada um afetará a maneira como eles são mostrados e editados na visualização Propriedades. Determinados tipos indicam um conjunto de opções disponíveis ou uma caixa de diálogo auxiliar específica para ajudar na configuração de um valor de atributo.
Visualização de Propriedades
Esta seção opcional contém elementos da interface com o usuário e informações de layout para uma página Visualização de Propriedades definida pelo usuário. Elementos-filhos aninhados podem ser incluídos abaixo da seção Visualização de Propriedades para definir o conteúdo de uma ou mais guias.
Guia
Uma guia contém outros elementos de UI dentro dela e corresponde à Visualização de Propriedades. Os nomes de guias são mostrados navisualização, com a guia principal (primeiro) exibida inicialmente. A primeira guia sempre tem o nome da tag selecionada, portanto, o valor do atributo name para a primeira guia é ignorado.
Coluna
O elemento Coluna agrupa visualmente um conjunto de outros elementos de UI em uma coluna vertical. Duas ou mais colunas são definidas dentro de um elemento Guia ou Seção e controles filhos são configurados dentro de cada coluna. Elementos que não são coluna não são suportados dentro do mesmo contêiner no qual colunas são usadas. Talvez seja necessário separar uma disposição de múltiplas colunas em sua própria região em seções.
Editor
Elementos Editor definem:
  • Quais tipos de controles da interface com o usuário são exibidos na visualização Propriedades, tal como um botão de opções.
  • Qual atributo da tag atual o controle de interface com o usuário modifica.
  • Qual etiqueta de sequência mostrar ao lado do controle de interface com o usuário.
Também é possível incluir parâmetros no elemento do editor.
Parâmetro do Editor
Alguns elementos de editor podem obter parâmetros do editor opcionais para customizar o comportamento do controle. Por exemplo, é possível configurar uma caixa de combinação e outros controles de seleção semelhantes usando o parâmetro choices que define os valores permitidos. O valor do parâmetro de opções usa a sintaxe enum{value1, value2, value3} ou, se rótulos e valores separados forem usados na caixa de combinação: enum{name1:value1, name2:value2}. A maioria dos outros parâmetros do editor predefinidos aceita os valores true ou false.
Label
O elemento Label coloca um rótulo contendo informações de texto na visualização Propriedades.
Seção
O elemento Seção é um contêiner que define uma parte autocontida da UI. Seções podem ser usadas para fornecer controle sobre o espaçamento dos controles que elas contêm. Por exemplo, uma seção pode ser configurada para estender várias colunas em um layout circundante, ou para definir uma nova estrutura de coluna para seu próprio conteúdo.
Separador
O elemento Separador usa uma regra horizontal para dividir o conteúdo da Visualização de Propriedades.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tconfiglibdefjsp.html