【Tomcat】

目錄1. Servlet 規范解讀    1.1. Use of URL Paths    1.2. Specification of Mappings2. Tomcat 源碼分析    2.1. 幾個概念    2.2. <url-pattern> 校驗規則    2.3. <url-pattern> 如何分類    2.4. <url-pattern> 分類過程    2.5. <url-pattern> 匹配過程3. 綜合示例    

1. Servlet 規范解讀

1.1. Use of URL Paths

Upon receipt of a client request, the Web container determines the Web application to which to forward it. The Web application selected must have the longest context path that matches the start of the request URL.The matched part of the URL is the context path when mapping to servlets.

The Web container next must locate the servlet to process the request using the path mapping procedure described below.

The path used for mapping to a servlet is the request URL from the request object minus the context path and the path parameters. The URL path mapping rules below are used in order. The first successful match is used with no further matches attempted:

1. The container will try to find an exact match of the path of the request to the path of the servlet. A successful match selects the servlet.
2. The container will recursively try to match the longest path-prefix. This is done by stepping down the path tree a directory at a time, using the ’/’ character as a path separator. The longest match determines the servlet selected.
3. If the last segment in the URL path contains an extension (e.g. .jsp), the servlet container will try to match a servlet that handles requests for the extension. An extension is defined as the part of the last segment after the last ’.’ character.
4. If neither of the previous three rules result in a servlet match, the container will attempt to serve content appropriate for the resource requested. If a "default" servlet is defined for the application, it will be used. Many containers provide an implicit default servlet for serving content.

The container must use case-sensitive string comparisons for matching.

1.2. Specification of Mappings

In the Web application deployment descriptor, the following syntax is used to define mappings:

• A string beginning with a ‘/’ character and ending with a ‘/*’ suffix is used for path mapping.
• A string beginning with a ‘*.’ prefix is used as an extension mapping.
• The empty string ("") is a special URL pattern that exactly maps to the application's context root, i.e., requests of the form http://host:port/<contextroot>/. In this case the path info is ’/’ and the servlet path and context path is empty string (““).
• A string containing only the ’/’ character indicates the "default" servlet of the application. In this case the servlet path is the request URI minus the context path and the path info is null.
• All other strings are used for exact matches only.

If the effective web.xml (after merging information from fragments and annotations) contains any url-patterns that are mapped to multiple servlets then the deployment must fail.

2. Tomcat 源碼分析

2.1. 幾個概念

在分析之前簡單看下tomcat源碼中的幾個概念,Context、Wrapper、Servlet:

• Servlet:這個很清楚,就是用來處理業務請求。
• Wrapper:Servlet 和映射的結合,具體點就是web.xml中配置的servlet信息。
• Context:表示一個應用,包含了 web.xml 中配置的所有信息,當一個請求到來時,它負責找到對應的Servlet,然后調用這個 Servlet 的 service 方法,執行我們所寫的業務邏輯。

2.2. <url-pattern> 校驗規則

org.apache.catalina.core.StandardContext.java:

/** * Adjust the URL pattern to begin with a leading slash, if appropriate * (i.e. we are running a servlet 2.2 application).  Otherwise, return * the specified URL pattern unchanged. * * @param urlPattern The URL pattern to be adjusted (if needed) *  and returned * @return the URL pattern with a leading slash if needed */protected String adjustURLPattern(String urlPattern) {    if (urlPattern == null)        return urlPattern;    if (urlPattern.startsWith("/") || urlPattern.startsWith("*."))        return urlPattern;    if (!isServlet22())        return urlPattern;    if(log.isDebugEnabled())        log.debug(sm.getString("standardContext.urlPattern.patternWarning",                     urlPattern));    return "/" + urlPattern;}/** * Validate the syntax of a proposed <code>&lt;url-pattern&gt;</code> * for conformance with specification requirements. * * @param urlPattern URL pattern to be validated * @return <code>true</code> if the URL pattern is conformant */private boolean validateURLPattern(String urlPattern) {    if (urlPattern == null)        return false;    if (urlPattern.indexOf('n') >= 0 || urlPattern.indexOf('r') >= 0) {        return false;    }    if (urlPattern.equals("")) {        return true;    }    if (urlPattern.startsWith("*.")) {        if (urlPattern.indexOf('/') < 0) {            checkUnusualURLPattern(urlPattern);            return true;        } else            return false;    }    if ( (urlPattern.startsWith("/")) &&            (urlPattern.indexOf("*.") < 0)) {        checkUnusualURLPattern(urlPattern);        return true;    } else        return false;}/** * Check for unusual but valid <code>&lt;url-pattern&gt;</code>s. * See Bugzilla 34805, 43079 & 43080 */private void checkUnusualURLPattern(String urlPattern) {    if (log.isInfoEnabled()) {        // First group checks for '*' or '/foo*' style patterns        // Second group checks for *.foo.bar style patterns        if((urlPattern.endsWith("*") && (urlPattern.length() < 2 ||                    urlPattern.charAt(urlPattern.length()-2) != '/')) ||                urlPattern.startsWith("*.") && urlPattern.length() > 2 &&                    urlPattern.lastIndexOf('.') > 1) {            log.info("Suspicious url pattern: "" + urlPattern + """ +                    " in context [" + getName() + "] - see" +                    " sections 12.1 and 12.2 of the Servlet specification");        }    }}

2.3. <url-pattern> 如何分類

org.apache.catalina.mapper.Mapper.java#ContextVersion

protected static final class ContextVersion extends MapElement<Context> {    public final String path;    public final int slashCount;    public final WebResourceRoot resources;    public String[] welcomeResources;    public MappedWrapper defaultWrapper = null;    public MappedWrapper[] exactWrappers = new MappedWrapper[0];    public MappedWrapper[] wildcardWrappers = new MappedWrapper[0];    public MappedWrapper[] extensionWrappers = new MappedWrapper[0];    ...}

2.4. <url-pattern> 分類過程

org.apache.catalina.mapper.Mapper.java

/** * Adds a wrapper to the given context. * * @param context The context to which to add the wrapper * @param path Wrapper mapping * @param wrapper The Wrapper object * @param jspWildCard true if the wrapper corresponds to the JspServlet *   and the mapping path contains a wildcard; false otherwise * @param resourceOnly true if this wrapper always expects a physical *                     resource to be present (such as a JSP) */protected void addWrapper(ContextVersion context, String path,        Wrapper wrapper, boolean jspWildCard, boolean resourceOnly) {    synchronized (context) {        if (path.endsWith("/*")) {            // Wildcard wrapper            String name = path.substring(0, path.length() - 2);            MappedWrapper newWrapper = new MappedWrapper(name, wrapper,                    jspWildCard, resourceOnly);            MappedWrapper[] oldWrappers = context.wildcardWrappers;            MappedWrapper[] newWrappers = new MappedWrapper[oldWrappers.length + 1];            if (insertMap(oldWrappers, newWrappers, newWrapper)) {                context.wildcardWrappers = newWrappers;                int slashCount = slashCount(newWrapper.name);                if (slashCount > context.nesting) {                    context.nesting = slashCount;                }            }        } else if (path.startsWith("*.")) {            // Extension wrapper            String name = path.substring(2);            MappedWrapper newWrapper = new MappedWrapper(name, wrapper,                    jspWildCard, resourceOnly);            MappedWrapper[] oldWrappers = context.extensionWrappers;            MappedWrapper[] newWrappers =                new MappedWrapper[oldWrappers.length + 1];            if (insertMap(oldWrappers, newWrappers, newWrapper)) {                context.extensionWrappers = newWrappers;            }        } else if (path.equals("/")) {            // Default wrapper            MappedWrapper newWrapper = new MappedWrapper("", wrapper,                    jspWildCard, resourceOnly);            context.defaultWrapper = newWrapper;        } else {            // Exact wrapper            final String name;            if (path.length() == 0) {                // Special case for the Context Root mapping which is                // treated as an exact match                name = "/";            } else {                name = path;            }            MappedWrapper newWrapper = new MappedWrapper(name, wrapper,                    jspWildCard, resourceOnly);            MappedWrapper[] oldWrappers = context.exactWrappers;            MappedWrapper[] newWrappers = new MappedWrapper[oldWrappers.length + 1];            if (insertMap(oldWrappers, newWrappers, newWrapper)) {                context.exactWrappers = newWrappers;            }        }    }}

• /* 結尾:wildcardWrappers
• *. 開頭:extensionWrappers
• /:defaultWrapper
• 其他:extractWrappers
  • 注:包含 "" -> Context Root mapping

2.5. <url-pattern> 匹配過程

org.apache.catalina.mapper.Mapper.java

/** * Wrapper mapping. * @throws IOException if the buffers are too small to hold the results of *                     the mapping. */private final void internalMapWrapper(ContextVersion contextVersion,                                      CharChunk path,                                      MappingData mappingData) throws IOException {    // ...    // Rule 1 -- Exact Match    MappedWrapper[] exactWrappers = contextVersion.exactWrappers;    internalMapExactWrapper(exactWrappers, path, mappingData);    // Rule 2 -- Prefix Match    boolean checkJspWelcomeFiles = false;    MappedWrapper[] wildcardWrappers = contextVersion.wildcardWrappers;    if (mappingData.wrapper == null) {        internalMapWildcardWrapper(wildcardWrappers, contextVersion.nesting,                                   path, mappingData);        // ...    }    // ...    // Rule 3 -- Extension Match    MappedWrapper[] extensionWrappers = contextVersion.extensionWrappers;    if (mappingData.wrapper == null && !checkJspWelcomeFiles) {        internalMapExtensionWrapper(extensionWrappers, path, mappingData,                true);    }    // Rule 4 -- Welcome resources processing for servlets    if (mappingData.wrapper == null) {        boolean checkWelcomeFiles = checkJspWelcomeFiles;        // ...    }    // ...    // Rule 7 -- Default servlet    if (mappingData.wrapper == null && !checkJspWelcomeFiles) {        if (contextVersion.defaultWrapper != null) {            mappingData.wrapper = contextVersion.defaultWrapper.object;            mappingData.requestPath.setChars                (path.getBuffer(), path.getStart(), path.getLength());            mappingData.wrapperPath.setChars                (path.getBuffer(), path.getStart(), path.getLength());            mappingData.matchType = MappingMatch.DEFAULT;        }        // ...    }    // ...}

• 規則1:精確匹配,使用 contextVersion 的 exactWrappers
• 規則2:前綴匹配,使用 contextVersion 的 wildcardWrappers
• 規則3:擴展名匹配,使用 contextVersion 的 extensionWrappers
• 規則4:歡迎頁匹配,使用 contextVersion 的welcomeResources
• 規則7:使用默認的servlet,使用contextVersion的defaultWrapper

3. 綜合示例

web.xml:

<?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"  xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"   version="2.5">  <display-name>urlpattern</display-name>  <servlet>    <servlet-name>Servlet1</servlet-name>    <servlet-class>com.Servlet1</servlet-class>  </servlet>  <servlet>    <description></description>    <servlet-name>Servlet2</servlet-name>    <servlet-class>com.Servlet2</servlet-class>  </servlet>  <servlet>    <servlet-name>Servlet3</servlet-name>    <servlet-class>com.Servlet3</servlet-class>  </servlet>  <servlet>    <servlet-name>Servlet4</servlet-name>    <servlet-class>com.Servlet4</servlet-class>  </servlet>  <servlet>    <servlet-name>Servlet5</servlet-name>    <servlet-class>com.Servlet5</servlet-class>  </servlet>  <servlet>    <servlet-name>Servlet6</servlet-name>    <servlet-class>com.Servlet6</servlet-class>  </servlet>  <servlet-mapping>    <servlet-name>Servlet1</servlet-name>    <url-pattern>/Servlet1</url-pattern>  </servlet-mapping>  <servlet-mapping>    <servlet-name>Servlet2</servlet-name>    <url-pattern>/Servlet2/*</url-pattern>  </servlet-mapping>  <servlet-mapping>    <servlet-name>Servlet6</servlet-name>    <url-pattern>/Servlet6/</url-pattern>  </servlet-mapping>  <servlet-mapping>    <servlet-name>Servlet4</servlet-name>    <url-pattern>*.foo</url-pattern>  </servlet-mapping>  <servlet-mapping>    <servlet-name>Servlet3</servlet-name>    <url-pattern>/</url-pattern>  </servlet-mapping>  <servlet-mapping>    <servlet-name>Servlet5</servlet-name>    <url-pattern></url-pattern>  </servlet-mapping></web-app>

測試url:

http://localhost:8080/urlpattern/Servlet2http://localhost:8080/urlpattern/Servlet2/a/b/c/dhttp://localhost:8080/urlpattern/Servlet1http://localhost:8080/urlpattern/Servlet6/http://localhost:8080/urlpattern/ServletX/l/m/n/x.foohttp://localhost:8080/urlpattern/http://localhost:8080/urlpatternhttp://localhost:8080/urlpattern/Servlet6http://localhost:8080/urlpattern/Servlet1/http://localhost:8080/urlpattern/ServletY/NOT/EXIST/

測試結果:

參考:

JSR-000340 JavaTM Servlet 3.1 Final Release for Evaluation:https://download.oracle.com/otndocs/jcp/servlet-3_1-fr-eval-spec/index.html