<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" id="WebApp_ID" version="3.0"> <!-- context-param元素聲明應用范圍內的初始化參數。--> <context-param> <param-name>contextConfigLocation</param-name> <param-value> classpath:/spring/spring.xml, classpath:/spring/spring-mybatis.xml </param-value> </context-param> <!-- <listener> <listener-class>com.ane.aneweb.util.SysContextListener </listener-class> </listener> --> <listener> <description>spring監聽器</description> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <!-- 防止spring內存溢出監聽器 --> <!-- <listener> <listener-class>org.springframework.web.util.IntrospectorCleanupListener</listener-class> </listener> --> <!-- 攔截未登錄 --> <!-- <filter> <filter-name>sessionFilter</filter-name> <filter-class>com.ane.online.util.SessionFilter</filter-class> </filter> <filter-mapping> <filter-name>sessionFilter</filter-name> <url-pattern>/user/*</url-pattern> <url-pattern>/order/*</url-pattern> <url-pattern>/excel/*</url-pattern> <url-pattern>/payee/*</url-pattern> </filter-mapping> --> <!--字符集過濾器 --> <filter> <description>字符集過濾器</description> <filter-name>encodingFilter</filter-name> <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class> <init-param> <description>字符集編碼</description> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>encodingFilter</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> <servlet> <servlet-name>ImageServlet</servlet-name> <servlet-class>com.pda.common.servlet.ImageServlet</servlet-class> <init-param> <param-name>width</param-name> <param-value>65</param-value> </init-param> <init-param> <param-name>height</param-name> <param-value>26</param-value> </init-param> <init-param> <param-name>codeCount</param-name> <param-value>4</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>ImageServlet</servlet-name> <url-pattern>/ImageServlet</url-pattern> </servlet-mapping> <!-- spring mvc servlet --> <servlet> <description>spring mvc servlet</description> <servlet-name>springMvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <description>spring mvc</description> <param-name>contextConfigLocation</param-name> <param-value>classpath:/spring/springmvc.xml</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>springMvc</servlet-name> <url-pattern>/</url-pattern> </servlet-mapping> <servlet> <servlet-name>CXFServlet</servlet-name> <servlet-class> org.apache.cxf.transport.servlet.CXFServlet </servlet-class> <load-on-startup>2</load-on-startup> </servlet> <servlet-mapping> <servlet-name>CXFServlet</servlet-name> <url-pattern>/webservice/*</url-pattern> </servlet-mapping> <servlet> <servlet-name>log4j-init</servlet-name> <servlet-class>com.pda.thread.Log4jInit</servlet-class> <init-param> <param-name>log4j-init-file</param-name> <param-value>/WEB-INF/classes/log4j.properties</param-value> </init-param> <load-on-startup>3</load-on-startup> </servlet> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <session-config> <session-timeout>30</session-timeout> </session-config> </web-app>
2 Web.xml常用元素 3 <web-app> 4 <display-name></display-name>定義了WEB應用的名字 5 <description></description> 聲明WEB應用的描述信息 6 7 <context-param></context-param> context-param元素聲明應用范圍內的初始化參數。 8 <filter></filter> 過濾器元素將一個名字與一個實現<a href="http://www.cnblogs.com/bukudekong/archive/2011/12/26/2302183.html">javax.servlet.Filter</a>接口的類相關聯。 9 <filter-mapping></filter-mapping> 一旦命名了一個過濾器,就要利用filter-mapping元素把它與一個或多個servlet或JSP頁面相關聯。 10 <listener></listener>servlet API的版本2.3增加了對事件監聽程序的支持,事件監聽程序在建立、修改和刪除會話或servlet環境時得到通知。 11 Listener元素指出事件監聽程序類。 12 <servlet></servlet> 在向servlet或JSP頁面制定初始化參數或定制URL時,必須首先命名servlet或JSP頁面。Servlet元素就是用來完成此項任務的。 13 <servlet-mapping></servlet-mapping> 服務器一般為servlet提供一個缺省的URL:http://host/webAppPrefix/servlet/ServletName。 14 <span style="color: #008000;"> 但是,常常會更改這個URL,以便servlet可以訪問初始化參數或更容易地處理相對URL。</span>在更改缺省URL時,使用servlet-mapping元素。 15 16 <session-config></session-config> 如果某個會話在一定時間內未被訪問,服務器可以拋棄它以節省內存。 17 可通過使用HttpSession的setMaxInactiveInterval方法明確設置單個會話對象的超時值,或者可利用session-config元素制定缺省超時值。 18 19 <mime-mapping></mime-mapping>如果Web應用具有想到特殊的文件,希望能保證給他們分配特定的MIME類型,則mime-mapping元素提供這種保證。 20 <welcome-file-list></welcome-file-list> 指示服務器在收到引用一個目錄名而不是文件名的URL時,使用哪個文件。 21 <error-page></error-page> 在返回特定HTTP狀態代碼時,或者特定類型的異常被拋出時,能夠制定將要顯示的頁面。 22 <taglib></taglib> 對標記庫描述符文件(Tag Libraryu Descriptor file)指定別名。此功能使你能夠更改TLD文件的位置, 23 而不用編輯使用這些文件的JSP頁面。 24 <resource-env-ref></resource-env-ref>聲明與資源相關的一個管理對象。 25 <resource-ref></resource-ref> 聲明一個資源工廠使用的外部資源。 26 <security-constraint></security-constraint> 制定應該保護的URL。它與login-config元素聯合使用 27 <login-config></login-config> 指定服務器應該怎樣給試圖訪問受保護頁面的用戶授權。它與sercurity-constraint元素聯合使用。 28 <security-role></security-role>給出安全角色的一個列表,這些角色將出現在servlet元素內的security-role-ref元素 29 的role-name子元素中。分別地聲明角色可使高級IDE處理安全信息更為容易。 30 <env-entry></env-entry>聲明Web應用的環境項。 31 <ejb-ref></ejb-ref>聲明一個EJB的主目錄的引用。 32 < ejb-local-ref></ ejb-local-ref>聲明一個EJB的本地主目錄的應用。 33 </web-app> 34 35 36 web.xml元素介紹 37 每一個站的WEB-INF下都有一個web.xml的設定文件,它提供了我們站台的配置設定. 38 39 復制代碼 40 1.<?xml version="1.0" encoding="ISO-8859-1"?> 41 部署描述符文件就像所有XML文件一樣,必須以一個XML頭開始。這個頭聲明可以使用的XML版本並給出文件的字符編碼。 42 2.<web-app xmlns="http://java.sun.com/xml/ns/j2ee" 43 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 44 xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd" 45 version="2.4"> 46 <web-app> 47 這是一般在寫XML時所做的聲明,定義了XML的版本,編碼格式,還有重要的指明schema的來源,為http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd. 48 3.<description>站台描述</discription>對站台做出描述. 49 4.<display-name>站台名稱</display-name>定義站台的名稱. 50 <icon>icon元素包含small-icon和large-icon兩個子元素.用來指定web站台中小圖標和大圖標的路徑. 51 <small-icon>/路徑/smallicon.gif</small-icon> 52 small-icon元素應指向web站台中某個小圖標的路徑,大小為16 X 16 pixel,但是圖象文件必須為GIF或JPEG格式,擴展名必須為:.gif或.jpg. 53 <large-icon>/路徑/largeicon-jpg</large-icon> 54 large-icon元素應指向web站台中某個大圖表路徑,大小為32 X 32 pixel,但是圖象文件必須為GIF或JPEG的格式,擴展名必須為; gif或jpg. 55 范例: 56 <display-name>Develop Example</display-name> 57 <description>JSP 2.0 Tech Book's Examples</description> 58 <icon> 59 <small-icon>/images/small.gif</small-icon> 60 <large-icon>/images/large.gir</large-icon> 61 </icon> 62 5.<distributable> 63 distributable 元素為空標簽,它的存在與否可以指定站台是否可分布式處理.如果web.xml中出現這個元素,則代表站台在開發時已經 64 被設計為能在多個JSP Container 之間分散執行. 65 范例: 66 6.<context-param> 67 context-param 元素用來設定web站台的環境參數(context),它包含兩個子元素: 68 param-name和param-value. 69 <param-name>參數名稱</param-name> 70 設定Context名稱 71 <param-value>值</param-value> 72 設定Context名稱的值 73 </context-param> 74 范例: 75 <context-param> 76 <param-name>param_name</param-name> 77 <param-value>param_value</param-value> 78 </context-param> 79 此所設定的參數,在JSP網頁中可以使用下列方法來取得: 80 ${initParam.param_name} 81 若在Servlet可以使用下列方法來獲得: 82 String param_name=getServletContext().getInitParamter("param_name"); 83 7.<filter> 84 filter元素用來聲明filter的相關設定.filter元素除了下面介紹的的子元素之外,還包括<servlet>介紹過的<icon>,<display-name> 85 ,<description>,<init-param>,其用途一樣. 86 <filter-name>Filter的名稱</filter-name> 87 定義Filter的名稱. 88 <filter-class>Filter的類名稱</filter-class> 89 定義Filter的類名稱.例如:com.foo.hello 90 </filter> 91 范例: 92 <filter> 93 <filter-name>setCharacterEncoding</filter-name> 94 <filter-class>coreservlet.javaworld.CH11.SetCharacterEncodingFilter</filter-class> 95 <init-param> 96 <param-name>encoding</param-name> 97 <param-value>GB2312</param-value> 98 </init-param> 99 </filter> 100 8.<filter-mapping> 101 <filter-mapping> 102 filter-mapping 元素的兩個主要子元素filter-name和url-pattern.用來定義Filter所對應的URL. 103 <filter-name>Filter的名稱</filter-name> 104 定義Filter的名稱. 105 <url-pattern>URL</url-pattern> 106 Filter所對應的RUL.例如:<url-pattern>/Filter/Hello</url-pattern> 107 9.<servlet-name>Servlet的名稱<servlet-name> 108 定義servlet的名稱. 109 <dispatcher>REQUEST|INCLUDE|FORWARD|ERROR</disaptcher> 110 設定Filter對應的請求方式,有RQUEST,INCLUDE,FORWAR,ERROR四種,默認為REQUEST. 111 </filter-mapping> 112 范例: 113 <filter-mapping> 114 <filter-name>GZIPEncoding</filter-name> 115 <url-pattern>/*</url-pattern> 116 </filter-mapping> 117 10.<listener> 118 listener元素用來定義Listener接口,它的主要子元素為<listener-class> 119 <listen-class>Listener的類名稱</listener-class> 120 定義Listener的類名稱.例如: com.foo.hello 121 <listener> 122 范例: 123 <listener> 124 <listener-class>coreservlet.javaworld.CH11.ContenxtListener</listener-class> 125 </listener> 126 11.<servlet-mapping> 127 servlet-mapping元素包含兩個子元素servlet-name和url-pattern.用來定義servlet所對應URL. 128 <servlet-name>Servlet的名稱</servlet-name> 129 定義Servlet的名稱. 130 <url-pattern>Servlet URL</url-pattern> 131 定義Servlet所對應的RUL.例如:<url-pattern>/Servlet/Hello</url-pattern> 132 </servlet-mapping> 133 范例: 134 <servlet-mapping> 135 <servlet-name>LoginChecker</servlet-name> 136 <url-pattern>/LoginChecker</url-pattern> 137 </servlet-mapping> 138 12.<session-cofing> 139 session-config包含一個子元素session-timeout.定義web站台中的session參數. 140 <session-timeout>分鍾</session-timeout> 141 定義這個web站台所有session的有效期限.單位為分鍾. 142 </session-config> 143 范例: 144 <session-config> 145 <session-timeout>20</session-timeout> 146 </session-config> 147 13.<mime-mapping> 148 mime-mapping包含兩個子元素extension和mime-type.定義某一個擴展名和某一MIME Type做對映. 149 <extension>擴展名名稱</extension> 150 擴展名稱 151 <mime-type>MIME格式</mime-type> 152 MIME格式. 153 </mime-mapping> 154 范例: 155 <mime-mapping> 156 <extension>doc</extension> 157 <mime-type>application/vnd.ms-word</mime-type> 158 </mime-mapping> 159 <mime-mapping> 160 <extension>xls</extension> 161 <mime-type>application/vnd.ms-excel</mime-type> 162 </mime-mapping> 163 <mime-mapping> 164 <extension>ppt</extesnion> 165 <mime-type>application/vnd.ms-powerpoint</mime-type> 166 </mime-mapping> 167 14.<welcome-file-list> 168 welcome-file-list包含一個子元素welcome-file.用來定義首頁列單. 169 <welcome-file>用來指定首頁文件名稱</welcome-flie> 170 welcome-file用來指定首頁文件名稱.我們可以用<welcome-file>指定幾個首頁,而服務器會依照設定的順序來找首頁. 171 范例: 172 <welcome-file-list> 173 <welcome-file>index.jsp</welcome-file> 174 <welcome-file>index.htm</welcome-file> 175 </welcome-file-list> 176 15.<error-page> 177 error-page元素包含三個子元素error-code,exception-type和location.將錯誤代碼(Error Code)或異常(Exception)的種類對應 178 到web站台資源路徑. 179 <error-code>錯誤代碼</error-code> 180 HTTP Error code,例如: 404 181 <exception-type>Exception</exception-type> 182 一個完整名稱的Java異常類型 183 <location>/路徑</location> 184 在web站台內的相關資源路徑 185 </error-page> 186 范例: 187 <error-page> 188 <error-code>404</error-code> 189 <location>/error404.jsp</location> 190 </error-page> 191 <error-page> 192 <exception-type>java.lang.Exception</exception-type> 193 <location>/except.jsp</location> 194 </error-page> 195 16.<jsp-config> 196 jsp-config元素主要用來設定JSP的相關配置,<jsp:config>包括<taglib>和<jsp-property-group>兩個子元素.其中<taglib>元素在JSP 1.2時就已經存在了;而<jsp-property-group>是JSP 2.0新增的元素. 197 <taglib> 198 taglib元素包含兩個子元素taglib-uri和taglib-location.用來設定JSP網頁用到的Tag Library路徑. 199 <taglib-uri>URI</taglib-uri> 200 taglib-uri定義TLD文件的URI,JSP網頁的taglib指令可以經由這個URI存取到TLD文件. 201 <taglib-location>/WEB-INF/lib/xxx.tld</taglib-laction> 202 TLD文件對應Web站台的存放位置. 203 </taglib> 204 <jsp-property-group> 205 jsp-property-group元素包含8個元素,分別為: 206 <description>Description</descrition> 207 此設定的說明 208 <display-name>Name</display-name> 209 此設定的名稱 210 <url-pattern>URL</url-pattern> 211 設定值所影響的范圍,如:/CH2 或者/*.jsp 212 <el-ignored>true|false</el-ignored> 213 若為true,表示不支持EL語法. 214 <scripting-invalid>true|false</scripting-invalid> 215 若為true表示不支持<%scription%>語法. 216 17.<page-encoding>encoding</page-encoding> 217 設定JSP網頁的編碼 218 18.<include-prelude>.jspf</include-prelude> 219 設置JSP網頁的抬頭,擴展名為.jspf 220 JSP segments(以前版本稱為JSP fragments)即jspf文件是不完整的JSPs,是用來被其他的JSP來包含的。 221 19.<include-coda>.jspf</include-coda> 222 設置JSP網頁的結尾,擴展名為.jspf 223 </jsp-property-group> 224 </jsp-config> 225 范例: 226 <jsp-config> 227 <taglib> 228 <taglib-uri>Taglib</taglib-uri> 229 <taglib-location>/WEB-INF/tlds/MyTaglib.tld</taglib-location> 230 </taglib> 231 <jsp-property-group> 232 <description> 233 Special property group for JSP Configuration JSP example. 234 </description> 235 <display-name>JSPConfiguration</display-name> 236 <uri-pattern>/*</uri-pattern> 237 <el-ignored>true</el-ignored> 238 <page-encoding>GB2312</page-encoding> 239 <scripting-inivalid>true</scripting-inivalid> 240 ............ 241 </jsp-property-group> 242 </jsp-config> 243 20.<resource-ref> 244 resource-ref元素包括五個子元素description,res-ref-name,res-type,res-auth,res-sharing-scope.利用JNDI取得站台可 245 利用資源. 246 <description>說明</description> 247 資源說明 248 <rec-ref-name>資源名稱</rec-ref-name> 249 資源名稱 250 <res-type>資源種類</res-type> 251 資源種類 252 <res-auth>Application|Container</res-auth> 253 資源由Application或Container來許可 254 <res-sharing-scope>Shareable|Unshareable</res-sharing-scope> 255 資源是否可以共享.默認值為 Shareable 256 范例: 257 <resource-ref> 258 <description>JNDI JDBC DataSource of JSPBook</description> 259 <res-ref-name>jdbc/sample_db</res-ref-name> 260 <res-type>javax.sql.DataSoruce</res-type> 261 <res-auth>Container</res-auth> 262 </resource-ref>