部署描述符須遵循 XML 標準:XML 標頭 → DOCTYPE → <web-app> 根元素。元素大小寫敏感且順序敏感,錯誤順序導致不可移植。
web-app 直屬子元素標準順序(26項)
- icon
- display-name
- description
- distributable
- context-param
- filter
- filter-mapping
- listener
- servlet
- servlet-mapping
- session-config
- mime-mapping
- welcome-file-list
- error-page
- taglib
- resource-env-ref
- resource-ref
- security-constraint
- login-config
- security-role
- env-entry
- ejb-ref
- ejb-local-ref
- jsp-config
(JSP 2.0 新增,位置可能不同)
所有元素皆為可選,但不可打亂順序。完整掌握順序與功能,才能撰寫標準、可移植的 web.xml。