Tag Files

Page 1

Agenda

Nessa apresentação nós discutiremos:

O significado de 'Tag Files'.

Como realizar o envio de parâmetros para a página JSP, especificando 'tag attributes'.

Descrever a semântica do modelo de tag files, as instruções da aplicação web para arquivos de tag, a escrita de um 'tag file', e explicar as restrições do conteúdo JSP no corpo da tag.

Page 2

Tag File

Um arquivo de tag fará inclusão de conteúdo na página JSP de uma maneira melhor.

O arquivo a ser incluído é salvo com uma extensão *.tag.

Deve-se colocar o arquivo de tag em um local apropriado ( que será discutido mais tarde ).

A diretiva taglib será declarada no arquivo JSP com o atributo 'tagdir'.

O arquivo de tags ( tagfile ) será chamado com o valor do atributo 'prefix' definido na diretiva < %@taglib >, conforme exemplo abaixo:

Page 3

Enviando parâmetros

A saída a ser gerada incluirá o arquivo de tag processado.

Para enviar parâmetros a uma página JSP, atributos podem ser especificados em um arquivo de tag. Acompanhe o exemplo:

Page 4

Atributos de Tag

Os atributos de tag podem ser chamados pelo seguinte código na página JSP:

Atributos de tag terão 'escopo de tag', ou seja, não poderão ser acessados fora da tag! Acompanhe o exemplo:

Page 5

< jsp:doBody >

Caso o atributo de tag seja muito longo, será especificado no corpo da tag.

No arquivo *.tag especificamos:

< jsp:doBody >

Então inserimos os valores do corpo da tag aqui.

Nesse caso, a diretiva 'attribute' vista anteriormente não será mais necessária.

A página JSP utilizará a tag declarada em < %@taglib %> juntamente com um corpo de tag:

O < body-content > ou conteúdo do corpo da tag do arquivo de tag será declarado por meio da diretiva 'tag'

Page 6

< body-content >

< jsp:doBody > (2)

O conteúdo do corpo da tag < body-content > será por padrão 'scriptless', mas pode assumir dois outros valores:

tagdependant (texto puro)

empty

Page 7

Localização de Tag Files

Arquivos de tag podem ser armazenados em um desses locais:

Dentro de WEB-INF/tags

Em algum subdiretório de WEB-INF/tags

Dentro de WEB-INF/lib/JAR/META-INF/tags

Em algum subdiretório de WEB-INF/lib/JAR/META-INF/tags

Caso o arquivo de tag esteja empacotado em um arquivo *.JAR, deve haver um arquivo *.tld para o arquivo de tag.

NÃO haverá um arquivo *.tld para o arquivo de tag exceto para o caso do arquivo de tag estar empacotado em um arquivo *.JAR.

Page 8

newtag_file.tag

Vemos aqui um exemplo ilustrando um arquivo de tag chamado newtag_file.tag com a chamada a < jsp:doBody / >

A página JSP correspondente será também discutida.

Page 9

tagfile_example.jsp

Abaixo vemos exemplo de como chamar o arquivo de tag criado através de uma página JSP.

Repare como o atributo da tag 'fontSize' é utilizado e como seu valor é passado.

Repare também como o arquivo de tag é referenciado na página JSP e como é utilizado...

Referência: < %@taglib prefix="whizlabs" tagdir="/WEB-INF/tags" % >

Utilização: < whizlabs:newtag_file fontSize="10" >...

Repare também que o arquivo de tag newtag_file.tag tem um corpo definido com < %@tag body-content="tagdependant' %>

Page 10

Saída de tagfile_example.jsp

Aqui vemos a saída produzida pela página JSP que utiliza arquivo de tag definido anteriormente, que foi embutido no arquivo JSP.

Page 11

Conclusão

Discutimos nessa apresentação:

Tag Files, suas localizações, como criar atributos e especificar conteúdo para o corpo da tag.

Escrevemos um programa que insere o arquivo de tag dentro da página JSP.