Tag-Schnittstelle  
 
Schnittstellenname:

javax.servlet.jsp.tagext.Tag

 
Erweitert:

Keine

 
Implementiert von:

Tag-Prozedurklassen für benutzerdefinierte Aktionen und javax.servlet.jsp.tagext.TagSupport

 
Beschreibung

Die Schnittstelle Tag sollte von Tag-Prozedurklassen implementiert werden, die keinen Zugriff auf den Body-Inhalt des entsprechenden benutzerdefinierten Aktionselements benötigen und die den Body-Teil eines benutzerdefinierten Aktionselements nicht durchlaufen müssen.

doEndTag()  
public int doEndTag() throws JspException

Führt Aktionen aus, wenn das Schluss-Tag auftritt. Wenn diese Methode SKIP_PAGE zurückgibt, wird die Ausführung der restlichen Seite abgebrochen, und die Methode _jspService() der JSP-Seitenimplementierungsklasse liefert eine Rückgabe. Bei Rückgabe von EVAL_PAGE wird der Code ausgeführt, der in der Methode _jspService() auf die benutzerdefinierte Aktion folgt.

doStartTag()  
public int doStartTag() throws JspException

Führt Aktionen aus, wenn das Anfangs-Tag auftritt. Diese Methode wird vom Webcontainer aufgerufen, nachdem alle Methoden zum Einstellen von Eigenschaften aufgerufen wurden. Der Rückgabewert steuert, wie der Body der Aktion, falls vorhanden, verarbeitet wird. Bei Rückgabe von EVAL_BODY_INCLUDE wertet der Webcontainer den Body aus und verarbeitet eventuell vorhandene JSP-Elemente. Das Ergebnis der Auswertung wird der Antwort hinzugefügt. Bei Rückgabe von SKIP_BODY wird der Body ignoriert.

Eine Tag-Prozedurklasse, die die Schnittstelle BodyTag implementiert (Erweiterung der Schnittstelle Tag) kann EVAL_BODY_TAG anstelle von EVAL_BODY_INCLUDE zurückgeben. Der Webcontainer erstellt dann eine Instanz von BodyContent und stellt sie der Tag-Prozedur zur besonderen Verarbeitung zur Verfügung.

getParent()  
public Tag getParent()

Gibt das übergeordnete Element der Tag-Prozedur zurück (die Instanz Tag für das umschließende Aktionselement, falls vorhanden). Wenn die Tag-Prozedur kein übergeordnetes Element hat, lautet die Rückgabe null.

release()  
public void release()

Entfernt die Verweise auf alle Objekte, die in dieser Instanz enthalten sind.

setPageContext()  
public void setPageContext(PageContext pc)

Speichert einen Verweis auf das aktuelle Objekt PageContext.

setParent()  
public void setParent(Tag t)

Speichert einen Verweis auf das übergeordnete Element der Tag-Prozedur (die Instanz Tag für das umschließende Aktionselement).