webxml部署描述符元素.docx
- 文档编号:2532653
- 上传时间:2023-05-03
- 格式:DOCX
- 页数:21
- 大小:24.44KB
webxml部署描述符元素.docx
《webxml部署描述符元素.docx》由会员分享,可在线阅读,更多相关《webxml部署描述符元素.docx(21页珍藏版)》请在冰点文库上搜索。
webxml部署描述符元素
web.xml部署描述符元素
在每一个Web应用程序路径的WEB-INF\下和conf\下存在一个Web.xml配置文件,
用来设定Web应用程序的配置。
在Web.xml中的设定非常多,
接下来分段来说明它的各项设定:
xmlversion=1.0encoding="ISO-8859-1"?
>
DOCTYPEWeb-app
PUBLIC"-//SunMicrosystems,Inc.//DTDWebApplication2.2//EN"
"
这是一般XML所需要做的声明,包含定义XML的版本、编码格式dtd来源。
Web.xml的dtd是由SunMicrosystems公司所制定的,可以在下列的网址获得详细的信息:
下列部分描述根元素
context-param
description
display-name
distributable
ejb-ref
ejb-local-ref
env-entry
error-page
filter
filter-mapping
icon
listener
login-config
mime-mapping
resource-env-ref
resource-ref
security-constraint
security-role
Servlet
servlet-mapping
session-config
taglib
web-app
welcome-file-list
--------------------------------------------------------------------------------
icon
icon元素指定用于在GUI工具中表示Web应用程序的大小图像在Web应用程序中的位置。
(servlet元素中也有一个名为icon的元素,用于提供在GUI工具中表示servlet的图标。
)
下表描述可以在icon元素中定义的元素。
元素必需/可选描述
当前WebLogicServer尚不使用此元素。
当前WebLogicServer尚不使用此元素。
--------------------------------------------------------------------------------
display-name
可选的display-name元素指定Web应用程序的显示名称(可以由GUI工具显示的简短名称)。
元素必需/可选描述
--------------------------------------------------------------------------------
description
可选的description元素提供关于Web应用程序的描述性文本。
元素必需/可选描述
--------------------------------------------------------------------------------
distributable
WebLogicServer不使用distributable元素。
元素必需/可选描述
--------------------------------------------------------------------------------
context-param
可选的context-param元素中包含Web应用程序的Servlet上下文初始化参数的声明。
下表描述Web应用程序容器所使用的保留上下文参数,在weblogic.xml中已不赞成使用这些参数,而提供了替换参数。
不赞成使用的参数描述weblogic.xml中的替换元素weblogic.httpd.inputCharset定义非unicode操作的代码集行为。
weblogic.xml中的input-charset(在charset-param内定义)。
请参阅input-charset。
weblogic.httpd.servlet.reloadCheckSecs定义WebLogicServer检查servlet是否发生修改的频率,如果已修改,则重新加载。
值为-1则永不重新加载,值为0则始终重新加载。
默认设置为1秒。
weblogic.xml中的servlet-reload-check-secs(在container-descriptor中定义)。
请参阅container-descriptor。
weblogic.httpd.servlet.classpath设置此值后,容器会将此路径追加到Web应用程序类路径上。
不建议采用此方法,对于此方法的支持仅为向后兼容。
无替换。
使用其他方法,例如清单类路径或WEB-INF/lib或WEB-INF/classes或虚拟目录。
weblogic.httpd.defaultServlet设置Web应用程序的默认servlet。
不建议采用此方法,
对于此方法的支持仅为向后兼容。
无替换。
而是使用web.xml中的servlet和servlet-mapping元素定义默认servlet。
默认servlet的URL模式应该是“/”。
请参阅servlet-mapping。
有关servlet映射的其他示例,请参阅Servlet映射。
以下context-param参数仍有效。
元素必需/可选描述
weblogic.httpd.
clientCertProxyoptional此特性指定Web应用程序客户端的证书由代理插件或HttpClusterServlet所发送的特殊WL-Proxy-Client-Cert头提供。
如果在代理服务器上执行用户身份验证,则此设置适用–设置clientCertProxy会使代理服务器在特殊的头WL-Proxy-Client-Cert中将证书传递给群集。
WL-Proxy-Client-Cert头可以由能够访问WebLogicServer的任意客户端提供。
WebLogicServer从该头中获取证书信息,信任它来自安全来源(该插件)并使用该信息来对用户进行身份验证。
出于此原因,如果您设置clientCertProxy,请使用连接筛选器确保WebLogicServer仅接受来自正在运行该插件的计算机的连接。
除为单个Web应用程序设置此特性外,您还可以定义此特性:
在管理控制台中的“服务器”-->“配置”-->“常规”页面上,为服务器示例承载的所有Web应用程序设置该特性在“群集”-->“配置”-->“常规”页面上,为群集中服务器实例所承载的所有Web应用程序设置该特性
--------------------------------------------------------------------------------
filter
filter元素定义筛选器类及其初始化特性。
有关筛选器的详细信息,请参阅配置筛选器。
下表描述可在filter元素中定义的元素。
元素必需/可选描述
包含小图标和大图标元素。
当前WebLogicServer尚不使用此元素。
每个特性使用独立的一组
--------------------------------------------------------------------------------
filter-mapping
下表描述可在filter-mapping元素中定义的元素。
元素必需/可选描述
该名称对应于使用
将http:
//host:
port/+ContextPath之后的URL部分与WebLogic
Server的
如果模式匹配,则将调用该元素中映射的筛选器。
示例模式:
/soda/grape/*
/foo/*
/contents
*.foo
URL必须遵循Servlet2.3规范中指定的规则。
--------------------------------------------------------------------------------
listener
使用listener元素定义应用程序监听器。
元素必需/可选描述
有关详细信息,请参阅配置事件监听器类。
--------------------------------------------------------------------------------
servlet
servlet元素中包含servlet的声明性数据。
如果指定了jsp-file且存在
下表描述可在servlet元素中定义的元素。
元素必需/可选描述
包含小图标和大图标元素。
当前WebLogicServer尚不使用此元素。
file>)servlet的完全限定类名。 在servlet正文中仅使用 class>)Web应用程序中的JSP文件相对于Web应用程序根目录的完整路径。 在servlet正文中仅使用 每个特性使用独立的一组 此元素内容可选,但必须是正整数,它指明 servlet的加载顺序。 指定了低整数的servlet将于高整数servlet之前加载。 如果没有指定任何值,或如果所指定的值不是正整数,则在应用程 序启动期间,WebLogicServer可以以任意顺序加载servlet。 该元素包含可选描述和安全角色的名称。 ref>可选用于将 使用此附加提取层,可以在部署时配置Servlet,且不必更改Servlet代码。 -------------------------------------------------------------------------------- icon 这是Servlet内的元素。 icon元素指定用于在GUI工具中表示servlet的大小图像在Web应用程序中的位置。 下表描述可以在icon元素中定义的元素。 元素必需/可选描述 当前WebLogicServer尚不使用此元素。 当前WebLogicServer尚不使用此元素。 -------------------------------------------------------------------------------- init-param 这是Servlet内的元素。 可选的init-param元素中包含用作servlet的初始化特性的名/值对。 每个特性使用独立的一组init-param标记。 您可以使用javax.servlet.ServletConfig.getInitParameter()方法访问这些特性。 下表描述可在init-param元素中定义的元素。 元素必需/可选描述 -------------------------------------------------------------------------------- security-role-ref 这是Servlet内的元素。 security-role-ref元素将 使用此附加提取层,可以在部 署时配置Servlet,且不必更改Servlet代码。 下表描述可在security-role-ref元素中定义的元素。 元素必需/可选描述 -------------------------------------------------------------------------------- servlet-mapping servlet-mapping元素定义servlet和URL模式之间的映射。 下表描述可在servlet-mapping元素中定义的元素。 元素必需/可选描述 该名称对应于您在 将http: //host: port/+WebAppName之后的URL部分与WebLogicServer的 行比较。 如果模式匹配,则将调用该元素中映射的servlet。 示例模式: /soda/grape/* /foo/* /contents *.foo URL必须遵循Servlet2.3规范中指定的规则。 有关Servlet映射的其他示例,请参阅Servlet映射。 -------------------------------------------------------------------------------- session-config session-config元素为此Web应用程序定义会话特性。 下表描述可在session-config元素中定义的元素。 元素必需/可选描述 除非输入此处列出的某个特殊值,否则此元素中设置的值 将替代WebLogic特定部署描述符weblogic.xml中的 默认值: -2 最大值: Integer.MAX_VALUE? 特殊值: -2表示使用weblogic.xml的 -1表示会话永不超时。 将忽略weblogic.xml的 有关详细信息,请参阅session-descriptor。 -------------------------------------------------------------------------------- mime-mapping mime-mapping元素定义扩展名和mime类型之间的映射。 下表描述可在mime-mapping元素中定义的元素。 元素必需/可选描述 txt。 text/plain。 -------------------------------------------------------------------------------- welcome-file-list 可选的welcome-file-list元素中包含welcome-file元素的有序列表。 当URL请求是一个目录名时,WebLogicServer将提供此元素中指定的第一个文件。 如果找不到该文件,则服务器会尝试列表中的下一个文件。 有关详细信息,请参阅配置欢迎文件。 下表描述可在welcome-file-list元素中定义的元素。 元素必需/可选描述 -------------------------------------------------------------------------------- error-page 可选的error-page元素指定错误代码或异常类型与Web应用程序中资源路径之间的映射。 WebLogicServer响应HTTP请求的过程中发生错误或由于Java异常而发生错误时,WebLogicServer会返回一个HTML页面,其中显示HTTP错 误代码或包含Java错误信息的页面。 可以定义显示自己的HTML页面,而不显示这些默认错误页面,或响应Java异常。 有关详细信息,请参阅自定义HTTP错误响应。 下表描述可以在error-page元素中定义的元素。 注意: 定义 元素必需/可选描述 例如,/myErrorPg.html。 -------------------------------------------------------------------------------- taglib 可选的taglib元素描述JSP标记库。 该元素将JSP标记库描述符(TagLibraryDescriptor,简称TLD)与URI模式关联起来。 尽管您可以在相对于WEB-INF目录的JSP中指定TLD,但部署您的Web应用程序时,您仍可以使用 每个TLD使用独立的元素。 下表描述可在taglib元素中定义的元素。 元素必需/可选描述 将标记库描述符文件存储在WEB-INF目录下是一个好主意,这样可以避免通过HTTP请求公开提供该文件。 如果该URI匹配JSP页面上taglib指令中使用的URI字符串,则使用此taglib。 --------------------------------------------------------------------------------
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- webxml 部署 描述 元素