JavaDoc, указывающий на «Не использовать /», был представлен в этом коммите:
(MTOMCAT-102) Добавьте mojo для создания автономного jar-файла для запуска веб-приложения: используйте поле path для хранения веб-приложения, чтобы иметь более подходящее имя, чем 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», так как имя файла выглядит более законным, но все же не очень желательно imho.
В документации Tomcat 7 указано базовое имя файла для пустого пути к контексту.
(aka "/") должно быть ROOT
. Лучше всего выбрать <path>ROOT<path>
для достижения желаемого результата.
Edit:
Для воспроизведения этого я проверил 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
...
И результат:
![enter image description here](https://i.stack.imgur.com/2KOMo.png)