Name

<servlet>

Synopsis

The <servlet> element defines servlet class or JSP page details.

Syntax

<servlet>
  [<description [xml:lang="lang"]>description</description>]*
  [<display-name [xml:lang="lang"]>displayName</display-name>]*
  [<icon [xml:lang="lang"]>
     [<small-icon>iconPath</small-icon>]
     [<large-icon>iconPath</large-icon>]
   </icon>]*
  <servlet-name>servletName</servlet-name>
  <servlet-class>className</servlet-class> |
    <jsp-file>jspPath</jsp-file>
  [<init-param>
     [<description [xml:lang="lang"]>description</description>]*
     <param-name>paramName</param-name>
     <param-value>paramValue</param-value>
   </init-param>]*
  [<load-on-startup>startupValue</load-on-startup>]
  [<run-as>roleName</run-as>]
  [<security-role-ref>
    [<description [xml:lang="lang">description</description>]*
    <role-name>internalRoleName</role-name>
    [<role-link>roleName</role-link>]
   </security-role-ref>]*
</servlet>

Most commonly, this element just associates a servlet or JSP page with a short name and specifies initialization parameters:

<servlet>
  <servlet-name>
    purchase
  </servlet-name>
  <servlet-class>
    com.mycorp.servlets.PurchaseServlet
  </servlet-class>
  <init-param>
    <param-name>maxAmount</param-name>
    <param-value>500.00</param-value>
  </init-param>
</servlet>
<servlet>
  <servlet-name>
    order-form
  </servlet-name>
  <jsp-file>
    /po/orderform.jsp
  </jsp-file>
  <init-param>
    <param-name>bgColor</param-name>
    <param-value>blue</param-value>
  </init-param>
</servlet>

The same servlet class (or JSP page) can be defined with multiple names, typically ...

Get JavaServer Faces now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.