- java.lang.Object
-
- javax.servlet.jsp.JspFactory
-
public abstract class JspFactory extends Object
The JspFactory is an abstract class that defines a number of factory methods available to a JSP page at runtime for the purposes of creating instances of various interfaces and classes used to support the JSP implementation.
A conformant JSP Engine implementation will, during it's initialization instantiate an implementation dependent subclass of this class, and make it globally available for use by JSP implementation classes by registering the instance created with this class via the static
setDefaultFactory()
method.The only implementation-dependent classes that can be created from the factory are: PageContext, JspEngineInfo, and JspApplicationContext.
With the exception of JspApplicationContext, JspFactory objects should not be used by JSP application developers.
-
-
Constructor Summary
Constructors Constructor and Description JspFactory()
Sole constructor.
-
Method Summary
All Methods Static Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method and Description static JspFactory
getDefaultFactory()
Returns the default factory for this implementation.abstract JspEngineInfo
getEngineInfo()
called to get implementation-specific information on the current JSP engine.abstract JspApplicationContext
getJspApplicationContext(ServletContext context)
Obtains theJspApplicationContext
instance associated with the web application for the givenServletContext
.abstract PageContext
getPageContext(Servlet servlet, ServletRequest request, ServletResponse response, String errorPageURL, boolean needsSession, int buffer, boolean autoflush)
obtains an instance of an implementation dependent javax.servlet.jsp.PageContext abstract class for the calling Servlet and currently pending request and response.abstract void
releasePageContext(PageContext pc)
called to release a previously allocated PageContext object.static void
setDefaultFactory(JspFactory deflt)
set the default factory for this implementation.
-
-
-
Constructor Detail
-
JspFactory
public JspFactory()
Sole constructor. (For invocation by subclass constructors, typically implicit.)
-
-
Method Detail
-
setDefaultFactory
public static void setDefaultFactory(JspFactory deflt)
set the default factory for this implementation. It is illegal for any principal other than the JSP Engine runtime to call this method.
- Parameters:
deflt
- The default factory implementation
-
getDefaultFactory
public static JspFactory getDefaultFactory()
Returns the default factory for this implementation.- Returns:
- the default factory for this implementation
-
getPageContext
public abstract PageContext getPageContext(Servlet servlet, ServletRequest request, ServletResponse response, String errorPageURL, boolean needsSession, int buffer, boolean autoflush)
obtains an instance of an implementation dependent javax.servlet.jsp.PageContext abstract class for the calling Servlet and currently pending request and response.
This method is typically called early in the processing of the _jspService() method of a JSP implementation class in order to obtain a PageContext object for the request being processed.
Invoking this method shall result in the PageContext.initialize() method being invoked. The PageContext returned is properly initialized.
All PageContext objects obtained via this method shall be released by invoking releasePageContext().
- Parameters:
servlet
- the requesting servletrequest
- the current request pending on the servletresponse
- the current response pending on the servleterrorPageURL
- the URL of the error page for the requesting JSP, or nullneedsSession
- true if the JSP participates in a sessionbuffer
- size of buffer in bytes, JspWriter.NO_BUFFER if no buffer, JspWriter.DEFAULT_BUFFER if implementation default.autoflush
- should the buffer autoflush to the output stream on buffer overflow, or throw an IOException?- Returns:
- the page context
- See Also:
PageContext
-
releasePageContext
public abstract void releasePageContext(PageContext pc)
called to release a previously allocated PageContext object. Results in PageContext.release() being invoked. This method should be invoked prior to returning from the _jspService() method of a JSP implementation class.
- Parameters:
pc
- A PageContext previously obtained by getPageContext()
-
getEngineInfo
public abstract JspEngineInfo getEngineInfo()
called to get implementation-specific information on the current JSP engine.
- Returns:
- a JspEngineInfo object describing the current JSP engine
-
getJspApplicationContext
public abstract JspApplicationContext getJspApplicationContext(ServletContext context)
Obtains theJspApplicationContext
instance associated with the web application for the givenServletContext
.- Parameters:
context
- TheServletContext
for the web application the desiredJspApplicationContext
is associated with.- Returns:
- The
JspApplicationContext
associated with the web application. - Since:
- 2.1
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 18:30:08 Cette version de la page est en cache (à la date du 21/08/2025 18:30:08) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 24/12/2007, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/servlet/jsp/JspFactory.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.