Interstage Application Server 移行ガイド

B.6.3.7 サーブレットの属性

　サーブレットやJSPの属性は、servletタグで定義します。

　サーブレットの属性は、エイリアス、初期化パラメタ、スタートアップを定義することができます。設定した初期化パラメタは、javax.servlet.ServletConfig.getInitParameterNames()メソッドとjavax.servlet.ServletConfig.getInitParameter()メソッドを使用して取り出します。

　JSPの属性は、スタートアップを定義することができます。

　同じサーブレットやJSPの名前、サーブレットのクラス名、JSPファイル名で複数定義した場合は、最後に指定したサーブレットの属性が有効となります。
　同じスタートアップの順番(ロードする順序)が定義された場合は、記述された順にロードします。

■記述形式

◆サーブレットを定義する場合

-------------------------------------------------------------------------------
  <servlet>
    <servlet-name>
      name
    </servlet-name>
    <servlet-class>
      class
    </servlet-class>
    <init-param>
      <param-name>
        name
      </param-name>
      <param-value>
        value
      </param-value>
    </init-param>
    <load-on-startup>
      priority
    </load-on-startup>
    <security-role-ref>
      <role-name>
        name
      </role-name>
      <role-link>
        name
      </role-link>
    </security-role-ref>
  </servlet>
-------------------------------------------------------------------------------

◆JSPファイルを定義する場合

-------------------------------------------------------------------------------
  <servlet>
    <servlet-name>
      name
    </servlet-name>
    <jsp-file>
      file-name
    </jsp-file>
    <init-param>
      <param-name>
        name
      </param-name>
      <param-value>
       value
      </param-value>
    </init-param>
    <load-on-startup>
      priority
    </load-on-startup>
    <security-role-ref>
      <role-name>
        name
      </role-name>
      <role-link>
        name
      </role-link>
    </security-role-ref>
  </servlet>
-------------------------------------------------------------------------------

■タグの内容

タグ名	説明	タグの 省略	複数の 指定
servlet-name	サーブレットやJSPの名前を定義します。 サーブレットやJSPの名前は、servletタグでサーブレットの属性を定義する場合と、servlet-mappingタグでサーブレット・マッピングを定義する場合に必要です。 サーブレットの場合は、設定した名前をエイリアス(別名)としても使用できます。 JSPの場合は、エイリアス(別名)によるWebブラウザからのアクセスはできません。 名前には、以下の文字が使用できます。 英数字、'+','-','.','_','$','%','/' 名前を省略した場合はエラーにはなりませんが、本servletタグの定義は無効となります。	×	×
servlet-class	サーブレットの完全なクラス名を定義します。 サーブレットを定義する場合は必須です。 クラス名を省略した場合は、本servletタグの定義は無効となります。	×	×
jsp-file	JSPファイル名をWebアプリケーションのルートディレクトリからの相対パスで定義します。先頭に'/'を付加します。 JSPファイルを定義する場合は必須です。 JSPファイル名を省略した場合は、本servletタグの定義は無効となります。 相対パスにディレクトリを記述する場合、ディレクトリの間は'\'でなく、'/'で区切ります。	×	×
init-param	サーブレットまたはJSPの初期化パラメタを定義します。 同じ初期化パラメタ名で複数定義した場合は、最後に指定したパラメタ値が有効となります。	○	○
param-name	サーブレットまたはJSPの初期化パラメタ名を定義します。 init-paramタグを定義する場合は必須です。 パラメタ名を必ず記述してください。	×	×
param-value	サーブレットまたはJSPの初期化パラメタに指定する値を定義します。 init-paramタグを定義する場合は必須です。	×	×
load-on-startup	サーブレット・コンテナ起動時のスタートアップを定義します。 サーブレットやJSPをロードする順序を -2147483648〜2147483647 で定義します。 小さい数から順にロードされます。 0を指定した場合は、サーブレット・コンテナ起動時にロードされません。 省略した場合は、サーブレットやJSPを呼び出したときにロードされます。	○	×
security-role-ref	サーブレットコードで使用するセキュリティロールの参照を定義します。	○	○
role-name	サーブレットコードで使用されるセキュリティロール名を指定します。 security-role-refタグを定義する場合は必須です。 javax.servlet.http.HttpServletRequest.isUserInRole()メソッドのパラメタとして利用することができます。	×	×
role-link	<security-role>で指定されたセキュリティロール名を定義します。 security-role-refタグを定義する場合は必須です。	×	×

■記述例

◆サーブレットを定義する場合

-------------------------------------------------------------------------------
  <web-app>
    <servlet>
      <servlet-name>
        Hello
      </servlet-name>
      <servlet-class>
        com.fujitsu.jservlet.xxx.HelloWorldServlet
      </servlet-class>
      <init-param>
        <param-name>
          message
        </param-name>
        <param-value>
          I'm a Hello servlet
        </param-value>
      </init-param>
      <load-on-startup>
          10
      </load-on-startup>
      <security-role-ref>
        <role-name>
          Administrator
        </role-name>
        <role-link>
          Manager
        </role-link>
      </security-role-ref>
    </servlet>
  </web-app>
-------------------------------------------------------------------------------

◆JSPファイルを定義する場合

-------------------------------------------------------------------------------
  <web-app>
    <servlet>
      <servlet-name>
        present
      </servlet-name>
      <jsp-file>
       /jsp/present.jsp
      </jsp-file>
      <init-param>
        <param-name>
          message
        </param-name>
        <param-value>
          I'm a Hello JSP
        </param-value>
      </init-param>
      <load-on-startup>
        11
      </load-on-startup>
      <security-role-ref>
        <role-name>
          Administrator
        </role-name>
        <role-link>
          Manager
        </role-link>
      </security-role-ref>
    </servlet>
  </web-app>
-------------------------------------------------------------------------------