Статьи

Автономное веб-приложение с исполняемым файлом Tomcat

Когда дело доходит до развертывания вашего приложения, простота — самое большое преимущество. Вы поймете это, особенно когда проект развивается и нуждается в некоторых изменениях в среде. Упаковка всего приложения в один автономный JAR-файл кажется хорошей идеей, особенно по сравнению с установкой и обновлением Tomcat в целевой среде. В прошлом я обычно включал JARs Tomcat в свое веб-приложение и писал тонкую программу командной строки, используя Tomcat API. К счастью, есть tomcat7:exec-war maven, которая делает именно это. Он берет ваш WAR-артефакт и упаковывает его вместе со всеми зависимостями Tomcat. В конце он также включает в Tomcat7RunnerCli Main-class Tomcat7RunnerCli для манифеста.

Любопытно попробовать? Возьмите ваш существующий проект WAR и добавьте следующее в ваш pom.xml :

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
<plugin>
    <groupId>org.apache.tomcat.maven</groupId>
    <artifactId>tomcat7-maven-plugin</artifactId>
    <version>2.0</version>
    <executions>
        <execution>
            <id>tomcat-run</id>
            <goals>
                <goal>exec-war-only</goal>
            </goals>
            <phase>package</phase>
            <configuration>
                <path>/standalone</path>
                <enableNaming>false</enableNaming>
                <finalName>standalone.jar</finalName>
                <charset>utf-8</charset>
            </configuration>
        </execution>
    </executions>
</plugin>

Запустите пакет mvn , и через несколько секунд вы увидите блестящий standalone.jar в вашей целевой директории. Запустить ваше веб-приложение никогда не было так просто:

1
$ java -jar target/standalone.jar

… И вы можете просматривать localhost:8080/standalone . Хотя в документации параметра path указано (выделено мое):

Путь к контексту веб-приложения, используемый для запускаемого веб-приложения. Имя для хранения веб-приложения в exec jar. Не используйте / только между нами, <path>/</path> кажется, работает в конце концов. Оказывается, встроенный main класс на самом деле немного более гибок. Например, вы можете сказать (я надеюсь, это говорит само за себя):

1
$ java -jar standalone.jar -httpPort=7070

Этот runnable JAR файл сначала распаковывает файл WAR внутри него в некоторый каталог (. default1 по default1 ) и развертывает его в Tomcat — все необходимые JARs файлы Tomcat также включены. Пустой standalone.jar (с небольшим количеством KiB WAR внутри) весит около 8,5 MiB — не так много, если вы утверждаете, что загрузка всего Tomcat с каждым выпуском вместе с вашим приложением расточительна.

Говоря о JARs runnable Tomcat, вы должны задаться вопросом, как выбрать версию Tomcat, включенную в этот runnable ? К сожалению, я не смог найти ни одной простой опции, поэтому мы должны вернуться к явному переопределению зависимостей плагина (версия 2.0 имеет жестко закодированный 7.0.30 Tomcat). Это довольно скучно, но не так сложно и может пригодиться для дальнейшего использования:

001
002
003
004
005
006
007
008
009
010
011
012
013
014
015
016
017
018
019
020
021
022
023
024
025
026
027
028
029
030
031
032
033
034
035
036
037
038
039
040
041
042
043
044
045
046
047
048
049
050
051
052
053
054
055
056
057
058
059
060
061
062
063
064
065
066
067
068
069
070
071
072
073
074
075
076
077
078
079
080
081
082
083
084
085
086
087
088
089
090
091
092
093
094
095
096
097
098
099
100
101
102
103
104
105
106
<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <tomcat7Version>7.0.33</tomcat7Version>
</properties>
 
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.tomcat.maven</groupId>
            <artifactId>tomcat7-maven-plugin</artifactId>
            <version>2.0</version>
            <executions>
                <execution>
                    <id>tomcat-run</id>
                    <goals>
                        <goal>exec-war-only</goal>
                    </goals>
                    <phase>package</phase>
                    <configuration>
                        <path>/standalone</path>
                        <enableNaming>false</enableNaming>
                        <finalName>standalone.jar</finalName>
                        <charset>utf-8</charset>
                    </configuration>
                </execution>
            </executions>
            <dependencies>
                <dependency>
                  <groupId>org.apache.tomcat.embed</groupId>
                  <artifactId>tomcat-embed-core</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-util</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-coyote</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-api</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-jdbc</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-dbcp</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-servlet-api</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-jsp-api</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-jasper</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-jasper-el</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-el-api</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-catalina</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-tribes</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-catalina-ha</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
                <dependency>
                  <groupId>org.apache.tomcat</groupId>
                  <artifactId>tomcat-annotations-api</artifactId>
                  <version>${tomcat7Version}</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

В следующей статье мы узнаем, как приручить эти надоедливые внутренние журналы Tomcat, появляющиеся в терминале ( java.util.logging …). Тем временем я обнаружил и сообщил, что MTOMCAT-186 Закрытие исполняемого файла JAR не вызывает ServletContextListener.contextDestroyed() — have посмотрите, не нарушит ли это для вас сделку.

1 — может быть хорошей идеей указать другой каталог с помощью — extractDirectory и очищать его перед каждым перезапуском с помощью — resetExtract

Ссылка: Автономное веб-приложение с исполняемым файлом Tomcat от нашего партнера по JCG Томаша Нуркевича в блоге Java и соседях .