What are the Jsp Page Directives?
>> Wednesday, June 15, 2011
Defines attributes that apply to an entire JSP page.
The
You can use the
No matter where you position the
ATTRIBUTES:
JSP Syntax
<%@ pageDescription:
[ language="java" ]
[ extends="package.class" ]
[ import="{package.class | package.*}, ..." ]
[ session="true | false" ]
[ buffer="none | 8kb | sizekb" ]
[ autoFlush="true | false" ]
[ isThreadSafe="true | false" ]
[ info="text" ]
[ errorPage="relativeURL" ]
[ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ]
[ isErrorPage="true | false" ]
%>
The
<%@ page %>
directive applies to an entire JSP file and any of its static include files, which together are called a translation unit. A static include file is a file whose content becomes part of the calling JSP file. The <%@ page %>
directive does not apply to any dynamic include files; see <jsp:include>
for more information. You can use the
<%@ page %>
directive more than once in a translation unit, but you can only use each attribute, except import
, once. Because the import
attribute is similar to the import
statement in the Java programming language, you can use a <%@ page %>
directive with import
more than once in a JSP file or translation unit. No matter where you position the
<%@ page %>
directive in a JSP file or included files, it applies to the entire translation unit. However, it is often good programming style to place it at the top of the JSP file.ATTRIBUTES:
- language="java" The scripting language used in scriptlets, declarations, and expressions in the JSP file and any included files. In this release, the only allowed value is
java
.
- extends="package.class" The fully qualified name of the superclass of the Java class file this JSP file will be compiled to. Use this attribute cautiously, as it can limit the JSP container's ability to provide a specialized superclass that improves the quality of the compiled file.
- import="{package.class | package.* }, ..." A comma-separated list of Java packages that the JSP file should import. The packages (and their classes) are available to scriptlets, expressions, and declarations within the JSP file. If you want to import more than one package, you can specify a comma-separated list after
import
or you can useimport
more than once in a JSP file.
The following packages are implicitly imported, so you don't need to specify them with theimport
attribute:
java.lang.*
javax.servlet.*
javax.servlet.jsp.*
javax.servlet.http.*
You must place theimport
attribute before the element that calls the imported class.
- session="true | false" Whether the client must join an HTTP session in order to use the JSP page. If the value is
true
, thesession
object refers to the current or new session.
If the value isfalse
, you cannot use thesession
object or a<jsp:useBean>
element withscope=session
in the JSP file. Either of these usages would cause a translation-time error.
The default value istrue
.
- buffer="none | 8kb | sizekb" The buffer size in kilobytes used by the
out
object to handle output sent from the compiled JSP page to the client Web browser. The default value is8kb
. If you specify a buffer size, the output is buffered with at least the size you specified.
- autoFlush="true | false" Whether the buffered output should be flushed automatically when the buffer is full. If set to
true
(the default value), the buffer will be flushed. If set tofalse
, an exception will be raised when the buffer overflows. You cannot setautoFlush
tofalse
whenbuffer
is set tonone
.
- isThreadSafe="true | false" Whether thread safety is implemented in the JSP file. The default value is
true
, which means that the JSP container can send multiple, concurrent client requests to the JSP page. You must write code in the JSP page to synchronize the multiple client threads. If you usefalse
, the JSP container sends client requests one at a time to the JSP page.
- info="text" A text string that is incorporated verbatim into the compiled JSP page. You can later retrieve the string with the
Servlet.getServletInfo()
method.
- errorPage="relativeURL" A pathname to a JSP file that this JSP file sends exceptions to. If the pathname begins with a /, the path is relative to the JSP application's document root directory and is resolved by the Web server. If not, the pathname is relative to the current JSP file.
- isErrorPage="true | false" Whether the JSP file displays an error page. If set to
true
, you can use theexception
object in the JSP file. If set tofalse
(the default value), you cannot use theexception
object in the JSP file.
- contentType="mimeType [ ;charset=characterSet ]" | "text/html;charset=ISO-8859-1" The MIME type and character encoding the JSP file uses for the response it sends to the client. You can use any MIME type or character set that are valid for the JSP container. The default MIME type is
text/html
, and the default character set isISO-8859-1
.
0 comments:
Post a Comment