pageContext  
 
Variablenname:

pageContext

 
Klassenname:

javax.servlet.jsp.PageContext

 
Erweitert:

Keine

 
Implementiert:

Keine

 
Implementiert von:

Eine konkrete Unterklasse dieser abstrakten Klasse ist als interne containerabhängige Klasse verfügbar.

 
JSP-Seitentyp:

Verfügbar in regulären JSP-Seiten und Fehlerseiten

 
Beschreibung

Eine Instanz von PageContext ermöglicht den Zugriff auf alle JSP-Ebenen und mehrere page-Attribute. Außerdem bietet sie eine Ebene oberhalb der Containerimplementierungsdetails, damit Container portable JSP-Implementierungsklassen generieren können. Die Ebene von JSP-Seiten wird von PageContext-Attributen dargestellt. Für jede Anforderung erstellt der Webcontainer eine eindeutige Instanz dieses Objekts und weist sie der Variablen pageContext zu.

 
Konstanten
public static final int PAGE_SCOPE = 1;
public static final int REQUEST_SCOPE = 2;
public static final int SESSION_SCOPE = 3;
public static final int APPLICATION_SCOPE = 4;
findAttribute()  
public abstract Object findAttribute(String name)

Sucht das benannte Attribut nacheinander in der Seite, Anforderung, Sitzung (falls gültig) und der Anwendungsebene und gibt den zugehörigen Wert zurück. Wenn das Attribut nicht gefunden wird, lautet die Rückgabe null.

forward()  
public abstract void forward(String relativeUrlPath)
  throws ServletException, java.io.IOException

Leitet die aktuelle Anforderung an eine andere aktive Komponente in der Anwendung weiter, wie beispielsweise ein Servlet oder eine JSP-Seite. Wenn der angegebene URI-Pfad mit einem Schrägstrich beginnt, wird er als kontextbezogen interpretiert, andernfalls als seitenbezogen.

Die Antwort darf nach einem Aufruf dieser Methode nicht mehr geändert werden, da sie übernommen wird, bevor die Methode eine Rückgabe liefert.

getAttribute()  
public abstract Object getAttribute(String name)

Gibt das Object zurück, das dem angegebenen Attributnamen auf Seitenebene zugeordnet ist. Wenn das Attribut nicht gefunden wird, lautet die Rückgabe null.

getAttribute()  
public abstract Object getAttribute(String name, int scope)

Gibt das Object zurück, das dem angegebenen Attributnamen auf der angegebenen Ebene zugeordnet ist. Wenn das Attribut nicht gefunden wird, lautet die Rückgabe null. Das Argument scope muss einer der int-Werte sein, die von den statischen Ebenenvariablen PageContext angegeben werden.

getAttributeNamesInScope()  
public abstract java.util.Enumeration getAttributeNamesInScope(int scope)

Gibt eine Enumeration mit String-Objekten zurück, die alle Attributnamen für die angegebene Ebene enthalten. Das Argument scope muss einer der int-Werte sein, die von den statischen Ebenenvariablen PageContext angegeben werden.

getAttributesScope()  
public abstract int getAttributesScope(String name)

Gibt einen der int-Werte zurück, die von den statischen Ebenenvariablen PageContext für die Ebene des Objekts angegeben werden, das dem angegebenen Attributnamen zugeordnet ist. Wenn das Attribut nicht gefunden wird, lautet die Rückgabe 0.

getException()  
public abstract Exception getException()

Gibt die Ausnahme Exception zurück, die den Aufruf der aktuellen Seite verursacht hat, wenn das Attribut isErrorPage der Direktive page auf true eingestellt ist.

getOut()  
public abstract JspWriter getOut()

Gibt das aktuelle Objekt JspWriter für die Seite zurück. Wenn diese Methode von einer Tag-Prozedur aufgerufen wird, die BodyTag implementiert, oder im Body eines anderen Aktionselements verschachtelt ist, kann es sich bei dem zurückgegebenen Objekt um eine Instanz der Unterklasse BodyContent handeln.

getPage()  
public abstract Object getPage()

Gibt das Object zurück, das die Instanz der JSP-Seitenimplementierungsklasse darstellt, der dieses Objekt PageContext zugeordnet ist.

getRequest()  
public abstract ServletRequest getRequest()

Gibt das aktuelle Anforderungsobjekt ServletRequest zurück.

getResponse()  
public abstract ServletResponse getResponse()

Gibt das aktuelle Anwortobjekt ServletResponse zurück.

getServletConfig()  
public abstract ServletConfig getServletConfig()

Gibt das Objekt ServletConfig für diese Instanz der JSP-Seitenimplementierungsklasse zurück.

getServletContext()  
public abstract ServletContext getServletContext()

Gibt das Objekt ServletContext für diese Instanz der JSP-Seitenimplementierungsklasse zurück.

getSession()  
public abstract HttpSession getSession()

Gibt das aktuelle Sitzungsobjekt HttpSession zurück. Wenn das Attribut session der Direktive page auf false eingestellt ist, lautet die Rückgabe null.

handlePageException()  
public abstract void handlePageException(Exception e)
  throws ServletException, java.io.IOException

Diese Methode soll von der JSP-Implementierungsklasse nur zu dem Zweck aufgerufen werden, nicht verarbeitete Ausnahmen zu verarbeiten. Dazu wird die Anforderungsausnahme an die Fehlerseite weitergeleitet, die vom Attribut errorPage der Direktive page angegeben wird, oder es wird eine implementierungsabhängige Aktion ausgeführt (wenn keine Fehlerseite angegeben ist).

include()  
public abstract void include(String relativeUrlPath)
  throws ServletException, java.io.IOException

Bewirkt, dass die angegebene Ressource als Teil der aktuellen Anforderung verarbeitet wird. Das aktuelle Objekt JspWriter wird geleert, bevor die Zielressource aufgerufen wird. Die Ausgabe, die bei der Anforderungsverarbeitung durch die Zielressource entsteht, wird direkt in das Schreibobjekt des aktuellen Objekts ServletResponse geschrieben. Wenn der angegebene URI-Pfad mit einem Schrägstrich beginnt, wird er als kontextbezogen interpretiert, andernfalls als seitenbezogen.

initialize()  
public abstract void initialize(Servlet servlet, ServletRequest request, ServletResponse response, String errorPageURL, boolean needsSession, int bufferSize, boolean autoFlush)
  throws java.io.IOException, IllegalStateException, IllegalArgumentException

Diese Methode wird aufgerufen, um ein Objekt PageContext zu initialisieren, damit es von einer JSP-Implementierungsklasse verwendet werden kann, um eine eingehende Anforderung zu beantworten. Normalerweise wird diese Methode von der Methode JspFactory.getPageContext() aufgerufen.

popBody()  
public JspWriter popBody()

Diese Methode soll von der JSP-Seitenimplementierungsklasse nur zu dem Zweck aufgerufen werden, das vorherige Objekt JspWriter, das von der zugehörigen Methode pushBody() gespeichert wurde, als aktuelles Objekt JspWriter neu zuzuweisen.

pushBody()  
public BodyContent pushBody()

Diese Methode soll von der JSP-Seitenimplementierungsklasse nur zu dem Zweck aufgerufen werden, ein neues Objekt BodyContent abzurufen und das aktuelle Objekt JspWriter im internen Stack des Objekts PageContext zu speichern.

release()  
public abstract void release()

Setzt den internen Status eines Objekts PageContext zurück. Dabei werden alle internen Verweise freigegeben, und das Objekt PageContext wird für eine eventuelle Wiederverwendung durch einen späteren Aufruf von initialize() vorbereitet. Normalerweise wird diese Methode von der Methode JspFactory.releasePageContext() aufgerufen.

removeAttribute()  
public abstract void removeAttribute(String name)
public abstract void removeAttribute(String name, int scope)

Entfernt den Objektverweis, der dem angegebenen Attributnamen zugeordnet ist, aus der Seitenebene oder der angegebenen Ebene. Das Argument scope muss einer der int-Werte sein, die von den statischen Ebenenvariablen PageContext angegeben werden.

setAttribute()  
public abstract void setAttribute(String name, Object attribute)
public abstract void setAttribute(String name, Object o, int scope)

Speichert den angegebenen Attributnamen und das angegebene Objekt in der Seitenebene oder in der angegebenen Ebene. Das Argument scope muss einer der int-Werte sein, die von den statischen Ebenenvariablen PageContext angegeben werden.

PageContext()  
public PageContext()

Erstellt eine Instanz der Klasse PageContext. Normalerweise wird die Instanz von der Klasse JspFactory erstellt und initialisiert.