Java SJC-WC web.xml

2024-12-04

2024
92.4% (338.3/366)
December
10.8% (3.3/31)
Week 49
33.7% (2.3/7)
Day 04 Wed
36.3% (8.7/24)

目次

FrontPage
・Windows11
・Chromebook
・Random
・機械学習
・さくらVPS
・Fedora13
・SuSe10
・Docker
・Ansible
・Java
・Scala
・Python
・Ruby
・Lisp
・Computer
・GIS
・HTML
・Culture
・Link

訪問者

total: 37450
today: 1
yesterday: 1
now: 1

更新

最新の10件

人気の10件

MenuBar

Java SJC-WC試験対策資料 付録。

• 元ネタ
  • JSR-000154 JavaTM Servlet 2.4 Specification SRV.13 pp.135-1552
     
• 繰り返しの凡例
  • ◇ Mandatory Element
  • ＊ Element Occurs 0 or More
  • ？ Optional Element( 0 or 1 )
  • ＋ Element Occurs 1 or More
     
• URL指定について( <filter-mapping> / <servlet-mapping> / <jsp-config>)
  1. 相対指定
     • /hello ( = http://hondou.homedns.org/hello )
  2. URLパターン指定
     • あるPath以下のすべての資産を指す
     • /*
     • /pages/*
     • 必ず先頭に"/"をつける
     • 拡張子はつけられない
  3. 拡張子指定
     • *.do
     • 先頭に"/"をつけてはいけない
     • "."は省略できない
        
• Java SJC-WC
• Java SJC-WC デザインパターン
• Java SJC-WC JSP
• Java SJC-WC tld
• Java SJC-WC 最終確認

---

<?xml version="1.0" encoding="UTF-8"?>
<web-app
xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">

</web-app>

---

description ＊ †

1. このWebアプリの説明
2. 複数可
3. xml:lang 属性を付加可能。デフォルト値は xml:lang="en" (English)

display-name ＊ †

1. このWebアプリの説明
2. 複数可
3. xml:lang 属性を付加可能。デフォルト値は xml:lang="en" (English)

icon ＊ †

1. GUIツールで表示するためのアイコン名
2. GIFかJPEG

small-icon ？ †

large-icon ？ †

distributable ＊ †

1. このプログラムが動くJ2EEコンテナを列挙

context-param ＊ †

1. ServletContext#getInitParamter("Webmaster")でここで定義した値を取得できる

description ＊ †

• このパラメータに対する説明

param-name ◇ †

• たとえば "Webmaster"

param-value ◇ †

• たとえば "webmaster@mycorp.com"

filter ＊ †

1. ここではfilterを構成するクラスの定義
2. filter-mappingでURLと関連づけ

   <filter>
     <filter-name>CharsetEncodingFilter</filter-name>
     <filter-class>com.foo.CharsetEncodingFilter</filter-class>
     <init-param>
       <param-name>charset</param-name>
       <param-value>Shift_JIS</param-value>
     </init-param>
   </filter>

description ＊ †

• このフィルタに対する説明

display-name ＊ †

• GUIツールでweb.xmlを表示するときの表示名

icon ＊ †

• GUIツールでweb.xmlを表示するときのアイコン

filter-name ◇ †

• このフィルタの名前。filter-mappingでURLと関連づけ

filter-class ◇ †

• このフィルタ処理を行うクラスの定義

init-param ＊ †

• フィルタの初期化パラメータ

description ＊ †

• このパラメータに対する説明

param-name ◇ †

• パラメータ名

param-value ◇ †

• 値

filter-mapping ＊ †

1. ここではfilterを適用するURLの定義
2. filterでフィルタ処理を行うクラスと関連づけ

   <filter-mapping>
     <filter-name>CharsetEncodingFilter</filter-name>
     <url-pattern>/*</url-pattern>
   </filter-mapping>

filter-name ◇ †

• このフィルタの名前。filterでフィルタ処理を行うクラスと関連づけ

url-pattern or servlet-name ◇ †

• このフィルタを行うURL (cf.URL指定法)

dispatcher ０…４ †

• Servlet2.4から加わった要素
• 以下の値を設定可能

  設定値	説明
  REQUEST	通常のリクエスト時にこのフィルタを実行する
  FORWARD	forward時にこのフィルタを実行する
  INCLUDE	include時にこのフィルタを実行する
  ERROR	エラーページに遷移する場合にこのフィルタを実行する

• 何も設定しないと、REQUEST のみが設定されたと見なされる (Servlet2.3までと同じ振る舞い)
  • 何かを設定すると デフォルト設定でなくなることに注意
  • たとえば、FORWARD のみを設定すると REQUEST にはこのフィルタは適用されない

listener ＊ †

• 以下のイベント処理を行うクラスの登録

  クラス	イベント
  ServletContextListener?	ServletContext?の生成・消滅時
  ServletContextAttributeListener?	ServletContext?の属性変更
  ServletRequestListener?	ServletRequest?の生成・消滅時
  ServletRequestAttributeListener?	ServletRequest?の属性変更
  HttpSessionListener?	HttpSession?の生成・消滅時
  HttpSessionAttributeListener?	HttpSession?の属性変更

• Sessionに登録するオブジェクトが実装するオブジェクトはここには定義しないことに注意

  クラス	イベント
  HttpSessionActivationListener?	これを実装したクラスが登録されているHttpSession?が、メモリ不足によりHDDに退避(Passivate)/復活(Activate)されるとき
  HttpSessionBindingListener?	これを実装したクラスがHttpSession?に登録・削除されるとき(HttpSession?のタイムアウトによる消滅時)

description ＊ †

• このリスナの説明

display-name ＊ †

• このリスナの名前

icon ＊ †

• GUIツールでweb.xmlを表示するときのアイコン

listener-class †

• このリスナを実装するクラス

servlet ＊ †

• Servletの定義

description ＊ †

• Servletの説明

display-name ＊ †

• GUIツールでweb.xmlを表示するときの名前

icon ＊ †

• GUIツールでweb.xmlを表示するときのアイコン

servlet-name ◇ †

• このServletの名前。servlet-mappingでURLと関連づけ

servlet-class or jsp-file ◇ †

• このServletを実装するクラス

init-param ＊ †

• このServletに与えるパラメータ(ServletConfig?インタフェースからアクセスできる)

description ＊ †

• 説明

param-name †

• パラメータ名 (ServletConfig?#getInitParameter?(String name)の引数)

param-value †

• パラメータ(ServletConfig?#getInitParameter?(String name)の返値)

load-on-startup ？ †

• 0以上の値を設定。
• J2EEコンテナ起動時に、この値が小さい順にインスタンス化される
• 設定しなければ、初めて呼ばれたときにインスタンス化される

run-as ？ †

• このServletを実行する際の暗黙的なロール名。ロールのないクライアントはこのロールを使う。

security-role-ref ＊ †

• <security-role>?で定義されたロール名(role-name)をこのServletでは(role-link)として扱う

description ＊ †

• 説明

role-name ◇ †

• <security-role>?で定義されたロール名(role-name)

role-link ？ †

• このSerlvletでの別名

servlet-mapping ＊ †

• Servletの定義

servlet-name ◇ †

• このServletの名前。servletでURLと関連づけ

url-pattern ◇ †

• このServletを行うURL (cf.URL指定法)

session-config ＊ †

• Sessionタイムアウト時間の設定

session-timeout ？ †

• 「分」 であることに注意
• HttpSession#getMaxInactiveInterval() は秒を返す。

mime-mapping * †

• 拡張子とMIME型の定義。
• ServletConfig#getMimeType?(String file)でここに定義した情報にアクセス

extension †

• 拡張子

mime-type †

• MIME型

welcome-file-list ＊ †

• ファイルを指定せずにこのWEBアプリにアクセスしたときに返すファイル

welcome-file ＋ †

• /index.jsp
• /index.html

error-page ＊ †

• このWebアプリでエラーが起きたときに遷移するページ

error-code or exception-type ◇ †

• 500
• java.lang.NullPointerException? (完全修飾名)

location ◇ †

• /pages/nullpoga.jsp

jsp-config ＊ †

taglib ＊ †

1. JSP中のtaglib宣言で使用するURIと、実際のtldファイルを結びつけるモノ
   • JSP

     <%@ taglib uri="http://hondou.homedns.org/tags/snail.tld" prefix="snail"%>

   • web.xml

     <taglib>
        <taglib-uri>/http://hondou.homedns.org/tags/snail.tld</taglib-uri>
        <taglib-location>/WEB-INF/snail.tld</taglib-location>
     </taglib>

   • snail.tld

     tab定義 (cf.[[クラッシックタグハンドラ>Java SJC-WC#classicTag]]

taglib-uri †

• tldファイルの論理名（名前として利用するだけなので、実際にそのURIにtldファイルが無くてもよい）

taglib-location or taglib-uri ◇ †

• 実際にtldファイルがある場所

jsp-property-group ＊ †

• JSPに関する各種設定

descirption ＊ †

• 説明文

display-name ＊ †

• GUIツールでweb.xmlを表示するときの表示名

icon ＊ †

• GUIツールでweb.xmlを表示するときのアイコン

url-pattern ＊ †

• この jsp-property-group を適用する URL (cf.URL指定法)

el-ignored ＊ †

• EL式を無視する(デフォルトはfalse)

page-encoding ＊ †

• デフォルトの文字コードセット

scriptiong-invalid ＊ †

• スクリプトレット( <= abc > )を評価しない(デフォルトはfalse)

is-xml ＊ †

• JSP XMLシンタックス#XMLSyntax?で記述された文書か？

include-prelude ＊ †

• url-pattern で示したすべてのJSPに、ここで指定したJSPをヘッダとして挿入する

include-coda ＊ †

• url-pattern で示したすべてのJSPに、ここで指定したJSPをフッタとして挿入する

security-constraint ＊ †

display-name ＊ †

• GUIツールでweb.xmlを表示するときの表示名

web-resource-collection ＋ †

web-resource-name †

• このセキュリティ制約の名前

description ＊ †

• 説明

url-pattern ＋ †

• 適用範囲 (cf.URL指定法)

http-method ＊ †

• アクセス方法(POST,GET...)

auth-constraint ？ †

description ＊ †

• 説明

role-name ＊ †

• アクセスを許すロール

user-data-constraint ？ †

description ＊ †

• 説明

transport-guarantee †

• アクセス方法

  設定値	アクセス方法
  NONE	通信の保証が不要な場合に指定する
  INTEGRAL	通信の完全性の保証が必要(たいていのJ2EEコンテナではSSLに切り替える)
  CONFIDENTIAL	通信の秘匿性の保証が必要(たいていのJ2EEコンテナではSSLに切り替える)

login-config ＊ †

• 現在の権限外のURLを見ようとしたときに、どのように認証を行うかを定義する。
• 認証済みのユーザのロールに対してどのような権限を与えるかは、<security-constraint>で設定する

auth-method ？ †

realm-name ？ †

• レルム ⊃ ロール ⊃ ユーザ

form-login-config ？ †

• FORM認証の時に使われるJSP/HTMLの定義

form-login-page †

• login.jsp (定石)

   <%@ page contentType="text/html;charset=Shift_JIS" %>
   <html>
   <head><title>LOGIN PAGE</title></head>
   <body>
   
   <form action="j_security_check" method="POST">
   
   <h1 align="center">LOGIN PAGE</h1>
   
   <table align="center">
     <tr> 
       <td>USER ID</td>
       <td><input type="text" name="j_username"/></td>
     </tr>
     <tr>
       <td>PASSWORD</td>
       <td><input type="text" name="j_password"/></td>
     </tr>
   </table>
   
   <p align="center">
     <input type="submit" value="LOGIN"/>
     <input type="reset" value="RESET"/>
   </p>
   
   </form>
   </body>
   </html>
  

  ユーザ名	j_username
  パスワード	j_password
  Submit先	j_security_check に POST

form-error-page †

• error.jsp(定石)

   <%@ page contentType="text/html;charset=Shift_JIS" %>
   <html>
  
   <head>
   <title>LOGIN ERROR PAGE</title>
   <script language="javascript">
   <!--
   alert("ユーザ名またはパスワードが間違っています");
   document.location.href="./";
   //-->
   </script>
   </head>
  
   <body>
   <!-- Javascriptが有効でない場合に表示される -->
   ユーザ名またはパスワードが間違っています。<br/>
   ブラウザを閉じてもう一度ログインし直してください
   </body>
   
   </html>
  

1. login.jspで、認証に失敗したときに呼ばれる。
2. このJSPは、ダイアログを表示して、元の画面(ログインしようとしたURL)に戻ろうとする。
3. ところが、認証が済んでいないので、元の画面(ログインしようとしたURL)を表示する前にlogin.jspが表示される。
4. 実装はトリッキーだが、ユーザから見ると自然な画面遷移。
   • ログイン画面で認証失敗のダイアログが表示されたように見える。
   • ユーザ名・パスワードを入力し直すと、最初に表示しようとしたURLにきちんと遷移する。

security-role ＊ †

• このweb.xml内で使うロール名を列挙

description ＊ †

• 説明

role-name ◇ †

• ロール名

env-entry ＊ †

• JNDIのjava:comp/env 以下に、ここで定義したエントリを追加する

description ＊ †

env-entry-name †

env-entry-type †

env-entry-value ？ †

ejb-ref ＊ †

• EJBオブジェクトのこのWebアプリ内での別名を定義
• JNDIに"太郎"で登録されているSessionBean?を呼び出すとき
  • プログラム中は、"TARO" とハードコード

    Context ctx = getInitialContext();
    Object home = ctx.lookup("TARO");

  • J2EEコンテナ(Contextを管理している)が、ここで定義した名前で読み替えてくれる

description ＊ †

ejb-ref-name †

ejb-ref-type †

home †

remote †

ejb-link ？ †

ejb-local-ref ＊ †

• EJBローカルオブジェクトの別名を定義

description ＊ †

ejb-ref-name †

ejb-ref-type †

local-home †

local †

ejb-link ？ †

service-ref ＊ †

• WebサービスのこのWebアプリ内での別名を定義

description ＊ †

display-name ＊ †

icon ＊ †

service-ref-name †

service-interface †

wsdl-file ？ †

jaxrpc-mapping-file ？ †

service-qname ？ †

port-component-ref ＊ †

handler ＊ †

resource-ref ＊ †

• J2EEコンテナが管理する資源へのアクセス(ex.DataSource?)

  <resource-ref>
    <description>DB Connection</description>
    <res-ref-name>jdbc/TestDB</res-ref-name>
    <res-type>javax.sql.DataSource</res-type>
    <res-auth>Container</res-auth>
  </resource-ref>

• プログラム

  Context ctx = new InitialContext();
  DataSource ds = (DataSource)ctx.lookup("java:comp/env/jdbc/TestDB");
  Connection conn = ds.getConnection();
  Statement stmt = conn.createStatement();
  ResultSet rst =  stmt.executeQuery("delete from diary DY where DY.day
   in select day from memory where presence = ○○○");

description ＊ †

res-ref-name †

res-type †

res-auth †

res-sharing-scope ？ †

resource-env-ref ＊ †

• J2EEコンテナの環境変数へアクセス

description ＊ †

resource-env-ref-name †

resource-env-ref-type †

message-destination-ref ＊ †

• JMSオブジェクト(メッセージキュー)のこのWebアプリ内での別名を定義

description †

message-destination-ref-name ◇ †

message-destination-ref-type ＊ †

message-destination-ref-usage ◇ †

message-destination-link ？ †

message-destination ＊ †

• message-destination-refの説明。(泥縄拡張だ・・)

description ＊ †

display-name ＊ †

icon ＊ †

message-destination-name ◇ †

local-encoding-mapping-list ＊ †

• ロケールと文字コードの対応

  <locale-encoding-mapping-list>
    <local-encoding-mapping>
      <locale>ja</locale>
      <encoding>Shift_JIS</encoding>
    </local-encoding-mapping>
  </locale-encoding-mapping-list>

local-encoding-mapping ＋ †

locale ◇ †

encoding ◇ †

---

Java