maven - 为什么不在 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

在这次提交中引入了指出“不要使用/”的 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并使用 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
...

结果: