BodyTag-Schnittstelle  
 
Schnittstellenname:

javax.servlet.jsp.tagext.BodyTag

 
Erweitert:

javax.servlet.jsp.tagext.Tag

 
Implementiert von:

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

 
Beschreibung

Die Schnittstelle BodyTag muss von Tag-Prozedurklassen implementiert werden, die Zugriff auf den Body-Inhalt des entsprechenden benutzerdefinierten Aktionselements benötigen, um beispielsweise eine Transformation des Inhalts vorzunehmen, bevor er in die Antwort aufgenommen wird. Diese Schnittstelle muss auch von Tag-Prozeduren implementiert werden, die den Body eines benutzerdefinierten Aktionselements durchlaufen müssen.

doAfterBody()  
public int doAfterBody() throws JspException

Führt Aktionen aus, nachdem der Body ausgewertet wurde. Diese Methode wird nach jeder Body-Auswertung aufgerufen. Wenn diese Methode EVAL_BODY_TAG zurückgibt, wird der Body erneut ausgewertet, normalerweise nachdem die Werte der verwendeten Variablen geändert wurden. Bei Rückgabe von SKIP_BODY wird die Verarbeitung mit einem Aufruf von doEndTag() fortgesetzt.

Diese Methode wird nicht aufgerufen, wenn der Element-Body leer ist oder wenn doStartTag() den Wert SKIP_BODY zurückgibt.

doInitBody()  
public void doInitBody() throws JspException

Bereitet die Body-Auswertung vor. Diese Methode wird von der Seitenimplementierung einmal für jeden Aktionsaufruf aufgerufen, nachdem ein neues Objekt BodyContent abgerufen und für die Tag-Prozedur mit der Methode setBodyContent() festgelegt wurde und bevor die Body-Auswertung des Elements erfolgt.

Diese Methode wird nicht aufgerufen, wenn der Element-Body leer ist oder wenn doStartTag() den Wert SKIP_BODY zurückgibt.

setBodyContent()  
public void setBodyContent(BodyContent b)

Legt das Objekt BodyContent fest, das für diese Tag-Prozedur erstellt wurde. Diese Methode wird nicht aufgerufen, wenn der Element-Body leer ist oder wenn doStartTag() den Wert SKIP_BODY zurückgibt.