首页 > 解决方案 > 为什么不在 maven tomcat 中使用 / 作为上下文路径?

问题描述

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

相关问题:使用 Maven 时如何在 Tomcat 7.0 中将上下文路径设置为 root(“/”)

为什么不在maven tomcat中使用/作为路径?

标签: maventomcattomcat7

解决方案


在此提交中引入了指出“不要使用 /”的 JavaDoc:

(MTOMCAT-102) 添加一个 mojo 来构建一个独立的 jar 来运行一个 web 应用程序:使用 path 字段来存储 webapp,使其具有比 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 文档所述,空上下文路径(又名“/”)的基本文件名应该是ROOT您最好的选择,即选择<path>ROOT<path>实现所需的结果。

编辑:

为了重现这一点,我检查了tomcat-maven-plugin.git并使用了他们的集成测试。在从他们的 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
...

结果:

在此处输入图像描述


推荐阅读