<servlet-name>,<servlet-class>,<servlet-mapping>,<url-pattern>,这些各表示啥，请详细说明，

Posted 2023-03-17

参考技术A 首先这四个都是注册一个servlet组件必须的四个节点
<servlet-name> 这个是我们要注册servlet的名字,一般跟Servlet类名有关
<servlet-class> 这个就是指向我们要注册的servlet 的类地址, 要带包路径
以上两个包在一个servlet 节点之下.

<servlet-mapping> 是用来配置我们注册的组件的访问路径,里面包括两个节点
一个是 <servlet-name> 这个要与 前面写的servlet那么一直
另一个是 <url-pattern> 配置这个组件的访问路径

举个例子
<servlet>
<servlet-name>LoginServlet</servlet-name>
<servlet-class>com.breeze.servlet.LoginServlet</servlet-class>
</servlet>

<servlet-mapping>
<servlet-name>LoginServlet</servlet-name> 与上面的 <servlet-name> 要一致
<url-pattern>/servlet/LoginServlet</url-pattern>
</servlet-mapping>

java.lang.IllegalArgumentException：过滤器映射必须指定 <url-pattern> 或 <servlet-name>

【中文标题】java.lang.IllegalArgumentException：过滤器映射必须指定 <url-pattern> 或 <servlet-name>

【英文标题】：java.lang.IllegalArgumentException: Filter mapping must specify either a <url-pattern> or a <servlet-name>

【发布时间】：2012-01-24 18:57:15

【问题描述】：

我用下一个 web.xml 创建了非常简单的 REST 应用程序：

<context-param>
    <param-name>resteasy.scan</param-name>
<param-value>true</param-value>
</context-param>

<listener>
    <listener-class>org.jboss.resteasy.plugins.server.servlet.ResteasyBootstrap</listener-class>
</listener>

<servlet>
    <servlet-name>Resteasy</servlet-name>
    <servlet-class>org.jboss.resteasy.plugins.server.servlet.HttpServletDispatcher</servlet-class>
</servlet>

<servlet-mapping>
    <servlet-name>Resteasy</servlet-name>
    <url-pattern>/rest/*</url-pattern>
</servlet-mapping>

我正在使用 servlet 3.0 规范和 Tomcat 7.0.23。不幸的是，它总是失败：

Caused by: java.lang.IllegalArgumentException: Filter mapping must specify either a <url-pattern> or a <servlet-name>
    at org.apache.catalina.core.StandardContext.validateFilterMap(StandardContext.java:2995)
    at org.apache.catalina.core.StandardContext.addFilterMap(StandardContext.java:2954)

我不知道问题出在哪里...我的代码中没有使用过滤器，我该如何解决？

【参考方案1】：

这与RESTEasy issue 577 有关。要解决此问题，您需要将 metadata-complete="true" 添加到您的 /WEB-INF/web.xml 的 <web-app> 根声明中。

<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_3_0.xsd"
    version="3.0" metadata-complete="true">

    <!-- Config here. -->

</web-app>

这样 Tomcat 将假定 /WEB-INF/web.xml 是完整的，并且不会扫描 JAR 以获取 web.xml 片段中的其他元数据信息，如果 RESTEasy 显然包含错误/不完整声明的过滤器。

【参考方案2】：

当然，添加 'metadata-complete="true"' 将阻止任何其他 jar 对 web.xml 做出贡献，包括 RichFaces 和 Seam。最好从部署中排除有问题的 JAR 文件。就我而言，是 async-http-servlet-3.0-2.3.3.Final.jar 得罪了。

【参考方案3】：

这是 Tomcat 7（版本 that reply 的类似问题和linked Tomcat 7 bugzilla ticket。