小記javaWeb的web.xml

1. 概念

web.xml文件是servlet規(guī)定的啟動配置文件,目前主流的javaWeb容器都是基于servlet的,所以理解web.xml文件是必須的必。 web.xml完整的名字叫部署描述文件,當容器啟動的時候就會去讀取改文件,然后加載相關(guān)配置。該文件通常在 /WEB_INF 文件夾下。

tomcat或者jetty在讀取web.xml文件時候,會讀取<listener>和<context-param>兩個節(jié)點,然后緊接著創(chuàng)建一個ServletContext(servlet上下文),這個web項目共享這個上下文。容器創(chuàng)建<listener>中的類實例,創(chuàng)建監(jiān)聽器。

context-param -> listener -> filter -> servlet

2. 標簽詳解

web.xml文件主要有三部分:xml頭,DOCTYPE申明和<web-app>包。

<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">  
<web-app>  
</web-app>

可寫成:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://java.sun.com/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/javaee     
         http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
         version="2.5">
</web-app>

這里的xmlnsXHTML namespace的縮寫。由于xml允許你自己定義自己的標識,你定義的標識和其他人定義的標識有可能相同,但表示不同的意義。當文件交換或者共享的時候就容易產(chǎn)生錯誤。為了避免這種錯誤發(fā)生,XML采用名字空間聲明,允許你通過一個網(wǎng)址指向來識別你的標識。比方說上面的命名空間就是:http://java.sun.com/xml/ns/javaee.

2.1 icon

指出IDE和GUI工具用來表示W(wǎng)eb應(yīng)用的大圖標和小圖標:

<icon>
    <small-icon>/images/app_small.gif</small-icon>
    <large-icon>/images/app_large.gif</large-icon>
</icon>
2.2 display-name

提供GUI工具可能會用來標記這個特定的Web應(yīng)用的一個名稱:

<display-name>
    Tomcat Example
</display-name>
2.3 context-param

聲明應(yīng)用范圍內(nèi)的初始化參數(shù)。它用于向 ServletContext提供鍵值對,即應(yīng)用程序上下文信息:

<context-param>
    <param-name>ContextParameter</para-name>
    <param-value>test</param-value>
    <description>It is a test parameter.</description>
</context-param>
2.4 context-param

將一個名字與一個實現(xiàn)javaxs.servlet.Filter接口的類相關(guān)聯(lián):

<filter>
    <filter-name>setCharacterEncoding</filter-name>
    <filter-class>com.myTest.setCharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
2.5 listener 監(jiān)聽器

listener元素用來定義Listener接口,它的主要子元素為<listener-class>
<listen-class>Listener的類名稱</listener-class>
定義Listener的類名稱:

<listener> 
    <listerner-class>com.listener.SessionListener</listener-class> 
</listener>
2.6 servlet

<servlet></servlet> 用來聲明一個servlet的數(shù)據(jù),主要有以下子元素:

<servlet-name></servlet-name> 指定servlet的名稱
<servlet-class></servlet-class> 指定servlet的類名稱
<jsp-file></jsp-file> 指定web站臺中的某個JSP網(wǎng)頁的完整路徑
<init-param></init-param> 用來定義參數(shù),可有多個init-param。在servlet類中通過getInitParamenter(String name)方法訪問初始化參數(shù)
<load-on-startup></load-on-startup>指定當Web應(yīng)用啟動時,裝載Servlet的次序。當值為正數(shù)或零時:Servlet容器先加載數(shù)值小的servlet,再依次加載其他數(shù)值大的servlet。當值為負或未定義:Servlet容器將在Web客戶首次訪問這個servlet時加載它。
<servlet-mapping></servlet-mapping> 用來定義servlet所對應(yīng)的URL,包含兩個子元素
<servlet-name></servlet-name> 指定servlet的名稱
<url-pattern></url-pattern> 指定servlet所對應(yīng)的URL:

<!-- 基本配置 -->
<servlet>
    <servlet-name>snoop</servlet-name>
    <servlet-class>SnoopServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>snoop</servlet-name>
    <url-pattern>/snoop</url-pattern>
</servlet-mapping>
<!-- 高級配置 -->
<servlet>
    <servlet-name>snoop</servlet-name>
    <servlet-class>SnoopServlet</servlet-class>
    <init-param>
        <param-name>foo</param-name>
        <param-value>bar</param-value>
    </init-param>
    <run-as>
        <description>Security role for anonymous access</description>
        <role-name>tomcat</role-name>
    </run-as>
</servlet>
<servlet-mapping>
    <servlet-name>snoop</servlet-name>
    <url-pattern>/snoop</url-pattern>
</servlet-mapping>
3. Mapping規(guī)則

當一個請求到達servlet容器時,容器先將請求的url減除當前上下文的路徑作為servlet的映射url,比如我訪問的是http://localhost/AAA/bbb.html,我的應(yīng)用上下文是AAA,容器會將http://localhost/AAA去掉,剩下的/bbb.html部分拿來做servlet的映射匹配。這個映射匹配過程是有順序的,而且當有一個servlet匹配成功以后,就不會去理會剩下的servlet了。

其匹配規(guī)則和順序如下:

  1. 精確路徑匹配。例子:比如servletA 的url-pattern為 /AAA,servletB的url-pattern為 /* ,這個時候,如果我訪問的url為http://localhost/AAA ,這個時候容器就會先 進行精確路徑匹配,發(fā)現(xiàn)/AAA正好被servletA精確匹配,那么就去調(diào)用servletA,也不會去理會其他的servlet了。

  2. 最長路徑匹配。例子:servletA的url-pattern為/AAA/,而servletB的url-pattern為/AAA/a/,此時訪問http://localhost/AAA/a時,容器會選擇路徑最長的servlet來匹配,也就是這里的servletB。

  3. 擴展匹配,如果url最后一段包含擴展,容器將會根據(jù)擴展選擇合適的servlet。例子:servletA的url-pattern:*.action

    以”/’開頭和以”/”結(jié)尾的是用來做路徑映射的。以前綴”.”開頭的是用來做擴展映射的。所以,為什么定義”/*.action”這樣一個看起來很正常的匹配會錯?因為這個匹配即屬于路徑映射,也屬于擴展映射,導(dǎo)致容器無法判斷。

3.散記錄:

springMVC接收前端參數(shù)的方式:

  1. 使用HttpServletRequest方式獲取,這種方法最為原始的一種方式,但這種方式有個弊端:參數(shù)比較多的時候,取參數(shù)的代碼非常冗長。
public String login(HttpServletRequest request){  
    String name = request.getParameter("name")  
    String pass = request.getParameter("pass")  
    String author = request.getParameter("author")  
      ... ...
} 
  1. 使用@RequestParam注解,同樣面臨一個問題就是取參數(shù)不方便
  2. springMVC支持將前端提交的表單自動映射到一個具體的類上。假設(shè)前端表單:
<form action="******" method="post">  
    id:<input type="text" name="id">  
    name:<input type="text" name="name">  
    age:<input type="text" name="age">  
    province:<input type="text" name="address.province">  
    city:<input type="city" name="address.city">  
    <input type="submit" value="submit">  
</form>  

定義Student類和Address類,springMVC會幫我們自定完成參數(shù)填充。

public class Student { 

    private String id;  
    private String name;  
    private String age;  
    private Address address;  
      
    public String getId() {  
        return id;  
    }  
    public void setId(String id) {  
        this.id = id;  
    }  
    public String getName() {  
        return name;  
    }  
    public void setName(String name) {  
        this.name = name;  
    }  
    public String getAge() {  
        return age;  
    }  
    public void setAge(String age) {  
        this.age = age;  
    }  
    public Address getAddress() {  
        return address;  
    }  
    public void setAddress(Address address) {  
        this.address = address;  
    }  
    @Override  
    public String toString() {  
        return "Student [id=" + id + ", name=" + name + ", age=" + age  
                + ", address=" + address + "]";  
    } 
}  

public class Address {  
  
    private String province;  
    private String city;  
    public String getProvince() {  
        return province;  
    }  
    public void setProvince(String province) {  
        this.province = province;  
    }  
    public String getCity() {  
        return city;  
    }  
    public void setCity(String city) {  
        this.city = city;  
    }  
    @Override  
    public String toString() {  
        return "Address [province=" + province + ", city=" + city + "]";  
    }  
}  
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 本章聊一聊ServletContext 3.0規(guī)范中定義的注解以及在web應(yīng)用中使用的框架和庫的可插拔性的提升。 ...
    Lucky_Micky閱讀 6,185評論 0 3
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,697評論 19 139
  • Spring Boot 參考指南 介紹 轉(zhuǎn)載自:https://www.gitbook.com/book/qbgb...
    毛宇鵬閱讀 47,288評論 6 342
  • 0 系列目錄# WEB請求處理 WEB請求處理一:瀏覽器請求發(fā)起處理 WEB請求處理二:Nginx請求反向代理 本...
    七寸知架構(gòu)閱讀 14,250評論 22 189
  • 春分以來,數(shù)陰數(shù)雨,昨日乃霽,空氣清新,天光晴好,故欣然出游,路遇美景甚眾,無奈手機內(nèi)存有限、文章篇幅亦有限、加之...
    愛碼愛自由閱讀 387評論 2 11

友情鏈接更多精彩內(nèi)容