Page Directive

Defines attributes that apply to an entire JSP page.

Syntax

<%@ page  

	[ 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" ]

%>

Examples

<%@ page import="java.util.*, java.lang.*" %>

<%@ page buffer="5kb" autoFlush="false" %>

<%@ page errorPage="error.jsp" %>

Description

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 use import more than once in a JSP file.

  The following packages are implicitly imported, so you don't need to specify them with the import attribute:

  java.lang.*
javax.servlet.*
javax.servlet.jsp.*
javax.servlet.http.*

  You must place the import 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, the session object refers to the current or new session.

  If the value is false, you cannot use the session object or a <jsp:useBean> element with scope=session in the JSP file. Either of these usages would cause a translation-time error.

  The default value is true.

• 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 is 8kb. 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 to false, an exception will be raised when the buffer overflows. You cannot set autoFlush to false when buffer is set to none.

• 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 use false, 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 the exception object in the JSP file. If set to false (the default value), you cannot use the exception 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 is ISO-8859-1.

Tip

• If you need to include a long list of packages or classes in more than one JSP file, you can create a separate JSP file with a <%@ page %> directive that contains the import list and include that file in the main JSP file.