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