servlet3.1规范翻译:第12章 映射请求到Servlet
第12章 映射请求到Servlet
Web容器需要使用本章描述的映射技术去映射客户端请求到Servlet(该规范2.5以前的版本,使用这些映射技术是作为一个建议而不是要求,允许各个servlet容器有其不同的schema用于映射客户端请求到servlet)。
12.1 使用URL路径在收到客户端请求时,web容器确定转发到哪一个Web应用。选择的Web应用必须是具有最长的上下文路径与请求URL的开始部分匹配。当映射到Servlet时, URL的匹配部分是上下文路径。
Web容器接下来必须使用下面描述的路径匹配步骤找出servlet来处理请求。
用于映射到Servlet的路径是请求对象的请求URL减去上下文和路径参数部分。下面的URL路径映射规则按顺序使用。使用第一个匹配成功的Servlet而不会进一步尝试匹配:
1. 容器将尝试找到一个请求路径到servlet路径的精确匹配。成功匹配则选择该servlet。
2. 容器将递归地尝试匹配最长路径前缀。这是通过一次一个目录的遍历路径树完成的,使用‘/’字符作为路径分隔符。最长匹配确定选择的servlet。
3. 如果URL最后一部分包含一个扩展名(如 .jsp),servlet容器将试图匹配一个处理此扩展名请求的Servlet。扩展名定义在最后一部分的最后一个‘.’字符之后。
4. 如果前三个规则都没有产生一个servlet匹配,容器将试图为请求资源提供相关的内容。如果应用中定义了一个“默认的”servlet,它将被使用。许多容器提供了一个隐式的默认servlet用于提供内容。
容器必须使用区分大小写字符串比较匹配。
12.2 映射规范在web应用部署描述符中,以下语法用于定义映射:
■ 以‘/’字符开始、以‘/*’后缀结尾的字符串用于路径匹配。
■ 以前缀‘*.’开始的字符串用于扩展名映射。
■ 空字符串“”是一个特殊的URL模式,其精确映射到应用的上下文根,即,http://host:port/<context-root>/请求形式。在这种情况下,路径信息是‘/’且servlet路径和上下文路径是空字符串(“”)。
■ 只包含“/”字符的字符串表示应用的“默认的”servlet。在这种情况下,servlet路径是请求URL减去上下文路径且路径信息是null。
■ 所以其他字符串仅用于精确匹配。
12.2.1 隐式映射如果容器有一个内置的JSP容器,*.jsp扩展名映射到它,允许根据需要执行JSP页面。该映射被称为隐式映射。如果Web应用定义了一个*.jsp映射,它的优先级高于隐式映射。
允许servlet容器做其它的隐式映射,只要这些隐式映射具有优先级。例如,一个*.shtml隐式映射可以映射到包含在服务器上的功能。
12.2.2 示例映射集合请看下面的一组映射:
表 12-1 示例映射集合
Path Pattern
Servlet
/foo/bar/*
servlet1
/baz/*
servlet2
/catalog
servlet3
*.bop
servlet4
将产生以下行为:
表 12-2 传入路径应用于示例映射
Incoming Path
Servlet Handling Request
/foo/bar/index.html
servlet1
/foo/bar/index.bop
servlet1
/baz
servlet2
/baz/index.html
servlet2
/catalog
servlet3
/catalog/index.html
“default” servlet
/catalog/racecar.bop
servlet4
/index.bop
servlet4
请注意,在/catalog/index.html和/catalog/racecar.bop的情况下,不使用映射到“/catalog”的servlet,因为不是精确匹配的。