JSP-Directives

JSP - Directives

JSP directives provide directions and instructions to the container, telling it how to handle certain aspects of JSP processing. A JSP directive affects the overall structure of the servlet class. It usually has the following form:

<%@ directive attribute="value" %>

Directives can have a number of attributes which you can list down as key-value pairs and separated by commas.

The blanks between the @ symbol and the directive name, and between the last attribute and the closing %>, are optional.

There are three types of directive tag:

Directive	Description
<%@ page ... %>	Defines page-dependent attributes, such as scripting language, error page, and buffering requirements.
<%@ include ... %>	Includes a file during the translation phase.
<%@ taglib ... %>	Declares a tag library, containing custom actions, used in the page

The page Directive:

The page directive is used to provide instructions to the container that pertain to the current JSP page. You may code page directives anywhere in your JSP page. By convention, page directives are coded at the top of the JSP page. Following is the basic syntax of page directive:

<%@ page attribute="value" %>

Attributes of page Directive tag:

Following is the list of attributes associated with page directive:

Attribute                                       Purpose

buffer                                            Specifies a buffering model for the output stream.

autoFlush                                     Controls the behavior of the servlet output buffer.

contentType                                  Defines the character encoding scheme.

errorPage                                     Defines the URL of another JSP that reports on Java unchecked                                                                runtime exceptions.

isErrorPage                                  Indicates if this JSP page is a URL specified by another JSP page's                                                          errorPage attribute.

extends                                         Specifies a superclass that the generated servlet must extend.

import                                          Specifies a list of packages or classes for use in the JSP as the Java                                                           import statement does for Java classes.

info                                              Defines a string that can be accessed with the servlet's getServletInfo()                                                     method.

isThreadSafe                                Defines the threading model for the generated servlet.

language                                      Defines the programming language used in the JSP page.

session                                         Specifies whether or not the JSP page participates in HTTP sessions.

isELIgnored                                 Specifies whether or not EL expression within the JSP page will be                                                           ignored.

isScriptingEnabled                       Determines if scripting elements are allowed for use.

The include Directive:

The include directive is used to includes a file during the translation phase. This directive tells the container to merge the content of other external files with the current JSP during the translation phase. You may code include directives anywhere in your JSP page. The general usage form of this directive is as follows: <%@ include file="relative url" >

The filename in the include directive is actually a relative URL. If you just specify a filename with no associated path, the JSP compiler assumes that the file is in the same directory as your JSP.

The taglib Directive:

The JavaServer Pages API allows you to define custom JSP tags that look like HTML or XML tags and a tag library is a set of user-defined tags that implement custom behavior. The taglib directive declares that your JSP page uses a set of custom tags, identifies the location of the library, and provides a means for identifying the custom tags in your JSP page. The taglib directive follows the following syntax:

<%@ taglib uri="uri" prefix="prefixOfTag" >

Where the uri attribute value resolves to a location the container understands and the prefix attribute informs a container what bits of markup are custom actions.