<?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">
<!-- icon元素指出IDE和GUI工具用來表示W(wǎng)eb應(yīng)用的一個(gè)和兩個(gè)圖像文件的位置 -->
<icon>
<small-icon>/images/small.gif</small-icon><!-- 16*16 -->
<large-icon>/images/large.jpg</large-icon><!-- 32*32 -->
</icon>
<!-- display-name元素提供GUI工具可能會(huì)用來標(biāo)記這個(gè)特定的Web應(yīng)用的一個(gè)名稱 -->
<display-name>The applicaiton name</display-name>
<!-- description元素給出與此有關(guān)的說明性文本 -->
<description>A longer description of the application</description><!-- 用于告知Web容器: 應(yīng)用設(shè)計(jì)為在分布式Web容器中運(yùn)行. -->
<distributable /><!-- context-param元素聲明應(yīng)用范圍內(nèi)的所有組件(servlet和JSP頁面)都可用的上下文參數(shù) -->
<context-param>
<!-- 參數(shù)名稱 -->
<param-name>Support</param-name>
<!-- 參數(shù)值 -->
<param-value>xihaikun@eays.net</param-value>
</context-param><!-- 注冊一個(gè)過濾器組件 -->
<filter>
<!-- 描述 -->
<description></description>
<!-- 名稱 -->
<display-name></display-name>
<icon></icon>
<!-- 過濾器名稱 -->
<filter-name>filtername</filter-name>
<!-- 具體類 -->
<filter-class>com.ebuilds.Filter</filter-class>
<!-- 初始化參數(shù) -->
<init-param>
<param-name></param-name>
<param-value></param-value>
</init-param>
</filter><!-- 將過濾器映像至一個(gè)URI模式, 或者映像至一個(gè)Servlet. -->
<filter-mapping>
<filter-name>filtername</filter-name>
<url-pattern></url-pattern>
</filter-mapping>
<filter-mapping>
<filter-name>filtername</filter-name>
<servlet-name>servletName</servlet-name>
</filter-mapping><!-- 注冊一個(gè)監(jiān)聽器 -->
<listener>
<listener-class>com.ebuilds.ajax.TaskListener</listener-class>
</listener><!-- 定義了Servlet或JSP頁面的細(xì)節(jié). 最常見的情況是, 此元素僅把一個(gè)Servlet或JSP頁面與一個(gè)短名相關(guān)聯(lián), 并指定初始化參數(shù): -->
<servlet>
<!-- servlet-name元素用來定義servlet的名稱,該名稱在整個(gè)應(yīng)用中必須是惟一的 -->
<servlet-name>TimeServlet</servlet-name>
<!-- 用來指定servlet的完全限定的名稱 -->
<servlet-class>com.ebuilds.ajax.TimeServlet</servlet-class>
<!-- 元素用來指定應(yīng)用中JSP文件的完整路徑。這個(gè)完整路徑必須由/開始,不能和<servlet-class>元素同時(shí)出現(xiàn) -->
<!-- <jsp-file>/index.jsp</jsp-file> -->
<init-param>
<param-name>count</param-name>
<param-value>1</param-value>
</init-param>
<!--當(dāng)啟動(dòng)Web容器時(shí),用load-on-startup元素自動(dòng)將servlet加入內(nèi)存。
加載servlet就意味著實(shí)例化這個(gè)servlet,并調(diào)用它的init方法??梢允褂眠@個(gè)元素來避免第一個(gè)servlet請求的響應(yīng)因?yàn)閟ervlet載入內(nèi)存所導(dǎo)致的任何延遲。
如果load-on-startup元素存在,而且也指定了jsp-file元素,則JSP文件會(huì)被重新編譯成servlet,同時(shí)產(chǎn)生的servlet也被載入內(nèi)存。
load-on-startup元素的內(nèi)容可以為空,或者是一個(gè)整數(shù)。這個(gè)值表示由Web容器載入內(nèi)存的順序。舉個(gè)例子,如果有兩個(gè)servlet元素都含有l(wèi)oad-on-startup子元素,
則load-on-startup子元素值較小的servlet將先被加載。如果load-on-startup子元素值為空或負(fù)值,
則由Web容器決定什么時(shí)候加載servlet。如果兩個(gè)servlet的load-on-startup子元素值相同,
則由Web容器決定先加載哪一個(gè)servlet -->
<load-on-startup>1</load-on-startup>
<!-- 如果定義了run-as元素,它會(huì)重寫用于調(diào)用Web應(yīng)用中servlet所設(shè)定的Enterprise JavaBean(EJB)的安全身份。-->
<run-as>
<!-- Role-name是為當(dāng)前Web應(yīng)用定義的一個(gè)安全角色的名稱 -->
<role-name></role-name>
</run-as>
<!-- security-role-ref元素定義一個(gè)映射,該映射在servlet中用isUserInRole (String name)調(diào)用的角色名與為Web應(yīng)用定義的安全角色名之間進(jìn)行 -->
<security-role-ref>
<role-name></role-name>
<!-- role-link元素用來將安全角色引用鏈接到已定義的安全角色。role-link元素必須含有已經(jīng)在security-role元素中定義的一個(gè)安全角色的名稱 -->
<role-link></role-link>
</security-role-ref>
</servlet><!-- 元素將一個(gè)Servlet或JSP頁面映像至一個(gè)URL模式. -->
<!-- 路徑前綴模式: -->
<servlet-mapping>
<servlet-name>purchase</servlet-name>
<url-pattern>/po/*</url-pattern>
</servlet-mapping>
<!-- 完全匹模模工: -->
<servlet-mapping>
<servlet-name>sales-report</servlet-name>
<url-pattern>/report</url-pattern>
</servlet-mapping>
<!-- 擴(kuò)展名映像模式: -->
<servlet-mapping>
<servlet-name>XMLProcessor</servlet-name>
<url-pattern>*.xml</url-pattern>
</servlet-mapping><!-- 定制會(huì)話處理屬性.在一個(gè)部署描述文件中只能使用一個(gè)此類元素 -->
<session-config>
<!--設(shè)置會(huì)話過期時(shí)間 -->
<session-timeout>180</session-timeout>
</session-config><!-- 如果Web應(yīng)用具有想到特殊的文件,希望能保證給他們分配特定的MIME類型,則mime-mapping元素提供這種保證 -->
<mime-mapping>
<extension></extension>
<mime-type></mime-type>
</mime-mapping><!--定義要在目錄中查找并提供索引文件的有序表.如果使用了多個(gè)此類元素, 容器會(huì)將其合并. -->
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
<welcome-file>index.html</welcome-file>
</welcome-file-list><!--指定錯(cuò)誤的頁面 -->
<error-page>
<!-- 指出在給定的HTTP錯(cuò)誤代碼出現(xiàn)時(shí)使用的URL -->
<error-code>404</error-code>
<location>/NotFound.jsp</location>
</error-page><error-page>
<!-- 指出在出現(xiàn)某個(gè)給定的Java異常但未捕捉到時(shí)使用的URL -->
<exception-type>exception.ServletNotFound</exception-type>
<location>/sorry.jsp</location>
</error-page><jsp-config>
<jsp-property-group>
<!-- 設(shè)定的說明 -->
<description>
Special property group for JSP Configuration JSP
example.
</description>
<!-- 設(shè)定名稱 -->
<display-name>JSPConfiguration</display-name>
<!-- 設(shè)定值所影響的范圍 -->
<url-pattern>/jsp/*</url-pattern>
<!--允許或者禁止EL語言 若為true,表示不支持EL 語法 -->
<el-ignored>true</el-ignored>
<!-- 設(shè)定JSP 網(wǎng)頁的編碼 -->
<page-encoding>GB2312</page-encoding>
<!-- 若為true,表示不支持<% scripting %>語法 -->
<scripting-invalid>true</scripting-invalid>
<!-- 設(shè)置JSP 網(wǎng)頁的頭,擴(kuò)展名為.jspf -->
<include-prelude>/include/prelude.jspf</include-prelude>
<!-- 設(shè)置JSP 網(wǎng)頁的結(jié)尾,擴(kuò)展名為.jspf -->
<include-coda>/include/coda.jspf</include-coda>
</jsp-property-group>
</jsp-config><!-- 聲明對于受保護(hù)資源使用何種鑒別方法.在一個(gè)部署描述文件中只能使用一個(gè)此類元素 -->
<login-config>
<auth-method>FORM</auth-method>
<form-login-config>
<form-login-page>/login/login.html</form-login-page>
<form-error-page>/login/error.html</form-error-page>
</form-login-config>
</login-config><!-- resource-env-ref元素聲明與資源相關(guān)的一個(gè)管理對象。 -->
<resource-env-ref>
<resource-env-ref-name>/jms/StockQueue</resource-env-ref-name>
<resource-env-ref-type>/javax.jms.Queue</resource-env-ref-type>
</resource-env-ref><!-- 為應(yīng)用對象定義了JNDI可訪問對象工廠 -->
<resource-ref>
<res-ref-name>/jms/Production</res-ref-name>
<res-type>/javax.sql.DataSource</res-type>
<res-auth>Container</res-auth>
</resource-ref><!-- 用于定義應(yīng)用所用的角色名 -->
<security-role>
<role-name>admin</role-name>
</security-role><!-- 定義可由應(yīng)用通過JNDI訪問的簡單對象, 如String 或 Boolean -->
<env-entry>
<env-entry-name>maxConnection</env-entry-name>
<env-entry-type>java.lang.Integer</env-entry-type>
<env-entry-value>100</env-entry-value>
</env-entry><!-- 通常用于聲明應(yīng)用所用的一個(gè)遠(yuǎn)程EJB引用. -->
<ejb-ref>
<ejb-ref-name>ejb/Payroll</ejb-ref-name>
<ejb-ref-type>Session</ejb-ref-type>
<home>com.mycomp.PayrollHome</home>
<remote>com.mycomp.Payroll</remote>
</ejb-ref><!-- 聲明應(yīng)用所用的一個(gè)本地EJB引用 -->
<ejb-local-ref>
<ejb-ref-name>ejb/Payroll</ejb-ref-name>
<ejb-ref-type>Session</ejb-ref-type>
<local-home>com.mycomp.PayrollHome</local-home>
<local>com.mycomp.Payroll</local>
</ejb-local-ref><!-- 聲明應(yīng)用所用Web服務(wù)的一個(gè)引用 -->
<service-ref>
<service-ref-name></service-ref-name>
<service-interface></service-interface>
</service-ref><!-- 為應(yīng)用所用的一個(gè)JMS消息目標(biāo)聲明一個(gè)邏輯名 -->
<message-destination>
<description>aaa</description>
<display-name>aaa</display-name>
<icon></icon>
<message-destination-name></message-destination-name>
</message-destination><!-- 聲明應(yīng)用所用的JMS消息和目標(biāo)引用 -->
<message-destination-ref>
<!-- 在企業(yè) Bean 代碼中用作消息目標(biāo)(相對于 java:comp/env)的環(huán)境名稱 -->
<message-destination-ref-name>
jms/StockQueue
</message-destination-ref-name>
<!-- 被引用目標(biāo)的預(yù)期類型 -->
<message-destination-type></message-destination-type>
<!-- 指定消息是在目標(biāo)使用的還是為目標(biāo)生成的,或是用于這兩者 Produces/Consumes/ConsumesProduces -->
<message-destination-usage>Produces</message-destination-usage>
<!-- 將消息目標(biāo)引用鏈接到實(shí)際消息目標(biāo)。此值必須與 weblogic-ejb-jar.xml 中的 message-destination-name 所定義的目標(biāo)匹配 -->
<message-destination-link></message-destination-link>
</message-destination-ref><!-- 定義網(wǎng)站的字符編碼方式 -->
<locale-encoding-mapping-list>
<locale-encoding-mapping>
<locale>zh</locale>
<encoding>gb2312</encoding>
</locale-encoding-mapping>
</locale-encoding-mapping-list>
</web-app>