为什么不在 Maven tomcat 中使用 / 作为上下文路径？

Question

我正在使用 Maven tomcat 插件来部署应用程序。如果我将路径设置为 <path>/<path>，它确实部署在根上下文中，但我想知道它是否会导致任何问题，因为 the docs 明确表示“ 不要使用 /” .

相关问题：How to set context path to root(“/”) in Tomcat 7.0 when using Maven

为什么不在 Maven 中使用 / 作为路径 tomcat？

Answer 1

本次提交中引入了指向 "Do not use /" 的 JavaDoc：

(MTOMCAT-102) Add a mojo to build a standalone jar to run a web application: use path field to store webapp to have a more nice name than projet.build.finalName

向下滚动提交时，您会看到 path 属性值用于创建 JarArchiveEntry:

os.putArchiveEntry( new JarArchiveEntry( path + ".war" ) );

对于已配置的 <path>/<path> 将转换为“/.war”的文件名，看起来有些无效。另一方面，这可能会在提取时产生“.war”文件名。

今天，对于 2.2 版，这段代码看起来像这样更改了错误 MTOMCAT-103：

os.putArchiveEntry( 
    new JarArchiveEntry( 
        StringUtils.removeStart( path, "/" ) + ".war" 
    ) 
);

对于配置的 <path>/<path> 将转换为“.war”，因为文件名看起来更合法但仍然不是真正理想的恕我直言。

因为 Tomcat 7 Documentation 声明了空上下文路径的基本文件名（又名“/”）应该是 ROOT 您最好的选择是选择 <path>ROOT<path> 以获得所需的结果。

编辑：

为了重现这个，我查看了 tomcat-maven-plugin.git and used their integration test。在从他们的 server.xml 中删除一些东西并将 tomcat7-maven-plugin 版本更改为 2.1 之后，我根本无法获得功能性构建：

这是应用于他们的集成测试应用程序的差异：

diff --git a/tomcat7-maven-plugin/src/it/simple-war-exec-project/pom.xml b/tomcat7-maven-plugin/src/it/simple-war-exec-project/pom.xml
index 8ce51b7..e00f0ea 100644
--- a/tomcat7-maven-plugin/src/it/simple-war-exec-project/pom.xml
+++ b/tomcat7-maven-plugin/src/it/simple-war-exec-project/pom.xml
@@ -42,7 +42,7 @@
         <plugin>
           <groupId>org.apache.tomcat.maven</groupId>
           <artifactId>tomcat7-maven-plugin</artifactId>
-          <version>@pom.version@</version>
+          <version>2.1</version>
         </plugin>
       </plugins>
     </pluginManagement>
@@ -65,7 +65,7 @@
             </goals>
             <phase>package</phase>
             <configuration>
-              <path>foo</path>
+              <path>ROOT</path>
               <serverXml>src/main/tomcatconf/server.xml</serverXml>
             </configuration>
           </execution>
diff --git a/tomcat7-maven-plugin/src/it/simple-war-exec-project/src/main/tomcatconf/server.xml b/tomcat7-maven-plugin/src/it/simple-war-exec-project/src/main/tomcatconf/server.xml
index 76ab562..de086fc 100644
--- a/tomcat7-maven-plugin/src/it/simple-war-exec-project/src/main/tomcatconf/server.xml
+++ b/tomcat7-maven-plugin/src/it/simple-war-exec-project/src/main/tomcatconf/server.xml
@@ -19,14 +19,7 @@

 <Server port="8010" shutdown="SHUTDOWN">

-  <GlobalNamingResources>
-    <!-- Used by Manager webapp -->
-    <Resource name="UserDatabase" auth="Container"
-              type="org.apache.catalina.UserDatabase"
-       description="User database that can be updated and saved"
-           factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
-          pathname="conf/tomcat-users.xml" />
-  </GlobalNamingResources>
+  

   <Service name="Catalina">
     <Connector port="8080" keepAliveTimeout="1800000" maxKeepAliveRequests="30000" maxThreads="300" />
@@ -34,8 +27,6 @@
     <Engine name="Catalina" defaultHost="localhost">
       <Valve className="org.apache.catalina.valves.AccessLogValve" 
              resolveHosts="false" pattern="%t-ip:%a-protocol:%H-localPort:%p-path:%U-time:%D ms"/> 
-      <Realm className="org.apache.catalina.realm.UserDatabaseRealm"
-             resourceName="UserDatabase" />
       <Host name="localhost" appBase="webapps" />
     </Engine>

然后从文件夹 /tomcat-maven-plugin/tomcat7-maven-plugin/src/it/simple-war-exec-project 我做了：

$ mvn clean package
...
[INFO] BUILD SUCCESS
...
$ cd target/
$ java -jar simple-war-exec-project-1.0-SNAPSHOT-war-exec.jar
...
INFORMATION: Deploying web application archive C:\Temp\tomcat-maven-plugin\tomcat7-maven-plugin\src\it\simple-war-exec-project\target\.extract\webapps\ROOT.war
...

结果：

为什么不在 Maven tomcat 中使用 / 作为上下文路径？

Why not to use / as a context path in maven tomcat?

tomcat

maven

tomcat7