12.2 Die PageContext API

Using the PageContext API, write tag handler code to access the JSP implicit variables and access web application attributes.

PageContext ist ein Objekt, auf das man als implizite Variable mit dem Ausdruck ${pageContext} zugreifen kann.

PageContext bietet:

• eine API um Attribute in den verschiedenen Gültigkeitsbereichen (Scopes) zu lesen bzw. schreiben
• einfacher Zugriff auf öffentliche Variablen wie out,session,page,servletConfig bzw servletContext
• Ein Meachanismus um die Anfrage an weitere aktive Komponenten mit forward bzw include weiterzuleiten
• Ein Mechanismus zur Fehlerbehandlung

Hier die wichtigsten Methoden die PageContext anbietet:

public abstract class JspContext { public abstract void setAttribute(String name, Object value); // setzt Attribut im page Scope public abstract void setAttribute(String name, Object value, int scope); public abstract Object getAttribute(String name); // liest Attribut aus PageScope public abstract Object getAttribute(String name, int scope); public abstract Object findAttribute(String name); //sucht in allen Scopes public abstract void removeAttribute(String name); // löscht im PageScope public abstract void removeAttribute(String name, int scope); public abstract int getAttributesScope(String name); // Gibt scope zurück indem Attribut gefunden wurde public abstract Enumeration getAttributeNamesInScope(int scope); public abstract JspWriter getOut(); // gibt den JSP Writer der Seite zurück }

public abstract class PageContext extends JspContext { public abstract javax.servlet.http.HttpSession getSession(); public abstract java.lang.Object getPage(); public abstract javax.servlet.ServletRequest getRequest(); public abstract javax.servlet.ServletResponse getResponse(); public abstract java.lang.Exception getException(); public abstract javax.servlet.ServletConfig getServletConfig(); public abstract javax.servlet.ServletContext getServletContext(); public abstract void forward(java.lang.String relativeUrlPath) throws javax.servlet.ServletException, java.io.IOException; public abstract void include(java.lang.String relativeUrlPath) throws javax.servlet.ServletException, java.io.IOException; public abstract void handlePageException(Throwable e) // für unbehandelte Ausnahmefälle throws javax.servlet.ServletException, java.io.IOException; }

Für die verschiedenen Scopes sind in PageContext Konstanten definiert. Sie lauten