Tutorial na užívateľských tagov JSP

Vlastné značky v JSP ( JSP ) sú XML tagy, ktoré vytvoríte vykonávať vlastné akcie v JSP stránke . Vlastné značky oddeliť dizajn a rozvrhnutie stránky JSP z kódu v jazyku Java , ktorý riadi akciu . Použitie vlastných značiek je vaše JSP stránky čitateľnejší , umožňuje znovu použiť kód , a je vaše aplikácie lepšie spravovateľný . Web dizajnéri môžu použiť kód , bez toho aby vedel niečo o Jave jednoducho pomocou vlastné tagy, ktoré sú navrhnuté v svojich stránkach JSP . Vlastné Tag Štruktúra

Vlastné značky sa riadi pravidlami XML syntaxe , po nasledujúce základné štruktúru : tela < /prefix : tagName >

najzákladnejšie vlastnú značku , tzv jednoduchý tag , nemá telo a nevyžaduje atribúty . Vlastná značka obsahujúca telo sa nazýva tag telo . Vlastné značky môžu byť vnorené . Hodnoty atribútov môžu byť nastavené pomocou JSP výrazy . Existujú dva základné komponenty , stavať vytvoriť vlastnú značku : Tag Library Descriptor súborov a psovod tag Java triedy . Tieto komponenty sú registrované servlet kontajnera vo web.xml súboru vašej aplikácie .
Vytvorte Tag Library Descriptor File

Tag Library Descriptor file ( TLD ) je XML súbor obsahujúci metadáta definovanie vlastných tagov . Napríklad, nasledujúci súbor TLD definuje jednoduchý tag s názvom " myTag " s jedným atribútom , " maxvalue , " a žiadne telo . Je nutné atribút maxvalue , a hodnota môže byť nastavená pomocou runtime výraz ( nastavenú rtexprvalue prvok ) , ktoré musia vrátiť celé číslo .

< ? Xml version = " 1.0 " encoding = " ISO - " ? > < DOCTYPE taglib PUBLIC " 8859-1 - //Sun Microsystems , Inc //DTD JSP TagLibrary 1.2 //EN " štítok tag sa
Vytvorte Tag Handler

Každý vlastná značka má tag handler , ktorý stanovuje , a dostane jeho atribúty , spracováva telo , a implementuje akciu . Psovod tag je trieda , ktorá implementuje Java javax.servlet.jsp.tagext.Tag alebo , ešte lepšie , rozširuje podtriedou Tag . Psovod Tag triedy majú prístup k rovnakým implicitných objektov , ako sú JSP stránky , ako je napríklad požiadavka , odpoveď , a zasadnutia .

Vytvorenie jednoduchej obslužnej rutiny tag triedu rozšírením javax.servlet.jsp.tagext.TagSupport . Vykonávať doStartTag , doEndTag a metódy uvoľnenia . DoStartTag sa vykonáva, keď je počiatočná značka stretol , a vykonáva hlavnú činnosť tagu, ako je vykonávanie výpočtov a tlač výsledkov .

Public int doStartTag ( ) throws JspException { try { ... váš kód ... } catch ( Exception ex ) { ... spracovanie chýb ... } return SKIP_BODY ; }

metóda doEndTag sa vykonáva, keď je koncová značka stretol . Návrat EVAL_PAGE v prípade , že zvyšok JSP stránky sa hodnotí . Spôsob uvoľňovanie by malo vyčistiť a uvoľniť všetky prostriedky používané triedy obslužné rutiny tag .

Ak váš vlastný tag má atribúty , sú členské premenné a implementovať sadu a dostať metódy pre každý atribút . Ak nie je povinnosť atribút , nastaviť predvolenú hodnotu . Pre požadovanú maxvalue atribútu :

private int maxvalue ;

public void setMaxValue ( int val ) { maxvalue = val ; } public int getMaxValue ( ) { return maxvalue ; }

Telo tag manipulátory , ktoré nie sú v interakcii s obsahom v tagu body predĺžiť javax.servlet.jsp.tagext.TagSupport . Vykonávať rovnaké metódy ako pre jednoduchú značku . Tiež implementovať metódu doAfterBody analyzovať a použiť obsah tela . Pre telo tag manipulátory , ktoré potrebujú k interakcii s obsahom v tagu tela , rozšíriť javax.servlet.jsp.tagext.BodyTagSupport a ako doInitBody a doAfterBody metódy .
Aktualizácia web.xml

Akonáhle ste vytvorili súbor TLD a značky psovoda triedu , upravte súbor web.xml zaregistrovať svoj ​​nový knižnicu tagov s servlet kontajnera . Pridať sekciu taglib na konci pred koncovú značku
Use Your Vlastné značky

V súbore JSP , ktorý bude používať vlastné značky , použiť direktívu taglib uviesť knižnicu tagov , ktoré budete používať a prefix budete používať odkazovať sa na vašej knižnice . Môžete buď odkazovať na vašej knižnice URI pomocou cesty :

< % @ taglib uri = " /WEB-INF/exampletaglib.tld " prefix = " , napr " % >

alebo názov ste zadali v web.xml ako taglib - uri :

< % @ taglib uri = " mytags " prefix = " , napr " % >

Použite svoj ​​vlastný značku vo vašom JSP , kde chcete akcia sa stane , pomocou predpony , ktoré ste poskytli na smernicu taglib :

• Predchádzajúca strana: Jednoduchá Vysvetlenie Java applety 
• Ďalšia strana: Java applety Tutorial