WAR ve Uygulama Sunucusu — Tomcat'te Çalışan, WildFly'da Neden Açılmadı?

Yeni bir eve taşınıyorsun. Eşyalı dairede buzdolabı zaten vardır; kendi buzdolabını da getirirsen mutfağa sığmaz. Eşyasız dairede ise buzdolabını sen getirmezsen hiç olmaz.

WAR bir misafirdir

Spring Boot uygulaması çoğu zaman kendi Tomcat’ini içinde taşıyan çalıştırılabilir bir JAR’dır. Bir WAR ise bir sunucuya yüklenir ve o sunucunun içinde çalışır.

Bu yüzden WAR iki soruya cevap vermelidir: sunucuyla aynı paket adlarını mı konuşuyor, ve hangi kütüphaneleri sunucu, hangilerini WAR getiriyor?

javax mı, jakarta mı?

Java EE, Jakarta EE?Terimin tanımını açJakarta EEJava EE'nin yeni adı. Paket adları javax.* yerine jakarta.* oldu; Tomcat 10, güncel WildFly ve Spring Boot 3 jakarta kullanır.Sözlükte gör → adını aldığında paket adları da javax.* yerine jakarta.* oldu. Tomcat 9 javax.servlet konuşur; Tomcat 10 ve güncel WildFly jakarta.servlet konuşur.

javax.servlet ile derlenmiş bir WAR, Tomcat 10’a konulduğunda sunucu onun servlet’lerini tanımaz. Spring Boot 3 de jakarta.* kullandığı için, bu geçiş çoğu zaman sürüm yükseltmesiyle birlikte gelir.

Kim neyi getirir?

Tomcat bir servlet kapsayıcısıdır?Terimin tanımını açservlet kapsayıcısıYalnızca web katmanını (servlet) çalıştıran sunucu, örneğin Tomcat. JPA gibi kurumsal kütüphaneleri getirmez; tam uygulama sunucusu (WildFly) getirir.Sözlükte gör →: yalnızca web katmanını verir, JPA vermez. WildFly tam bir uygulama sunucusudur ve JPA’yı kendi Hibernate’iyle getirir. Sunucunun getirdiği kütüphane Maven’da provided olarak işaretlenir ve WAR’a girmez.

Kendin gör

1. Varsayılanla oynat. javax ile derlenmiş WAR Tomcat 10’a yüklenmedi.
2. Paketleri jakarta, Hibernate’i WAR içinde yap. Tomcat 10’da açıldı.
3. Sunucuyu WildFly yap. İki Hibernate kopyası çakıştı. Sonra “Hibernate WAR içinde”yi kapat: açıldı.

Tuzaklar

Gizli gelen kopya. Hibernate’i sen eklemesen de başka bir kütüphane onu geçişli olarak getirebilir. mvn dependency:tree ile WAR’a neyin girdiğine bak.

Gömülü Tomcat’i unutmak. Spring Boot uygulamasını WAR olarak bir sunucuya koyarken gömülü Tomcat’i provided yap. Yoksa WAR’ın içinde ikinci bir sunucu taşırsın.

Sunucunun kütüphanesini istemeden ezmek. Kendi sürümünü kullanmak zorundaysan, WildFly’da bunu jboss-deployment-structure.xml ile açıkça söyle. Kazara olan bir çakışma, açılışta değil gece yarısı patlayabilir.

Aşağıda WildFly’a giden bir Spring Boot rapor uygulamasının WAR ayarı var: servlet katmanı ve JPA sunucudan gelir.

1
<project>
2
  <modelVersion>4.0.0</modelVersion>
3
  <parent>
4
    <groupId>org.springframework.boot</groupId>
5
    <artifactId>spring-boot-starter-parent</artifactId>
6
    <version>3.3.4</version>
7
  </parent>
8
  <groupId>com.bank.custody</groupId>
9
  <artifactId>report</artifactId>
10
  <version>2.0.0</version>
11
  <packaging>war</packaging>
12

13
  <dependencies>
14
    <dependency>
15
      <groupId>org.springframework.boot</groupId>
16
      <artifactId>spring-boot-starter-web</artifactId>
17
    </dependency>
18
    <!-- The server is the servlet container: no embedded Tomcat inside the WAR. -->
19
    <dependency>
20
      <groupId>org.springframework.boot</groupId>
21
      <artifactId>spring-boot-starter-tomcat</artifactId>
22
      <scope>provided</scope>
23
    </dependency>
24
    <dependency>
25
      <groupId>org.springframework.boot</groupId>
26
      <artifactId>spring-boot-starter-data-jpa</artifactId>
27
      <exclusions>
28
        <!-- WildFly brings its own Hibernate. -->
29
        <exclusion>
30
          <groupId>org.hibernate.orm</groupId>
31
          <artifactId>hibernate-core</artifactId>
32
        </exclusion>
33
      </exclusions>
34
    </dependency>
35
    <dependency>
36
      <groupId>org.hibernate.orm</groupId>
37
      <artifactId>hibernate-core</artifactId>
38
      <scope>provided</scope>
39
    </dependency>
40
  </dependencies>
41
</project>

1
package com.bank.custody.report;
2

3
import org.springframework.boot.SpringApplication;
4
import org.springframework.boot.autoconfigure.SpringBootApplication;
5
import org.springframework.boot.builder.SpringApplicationBuilder;
6
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
7

8
@SpringBootApplication
9
public class ReportApplication extends SpringBootServletInitializer {
10

11
    /** Called by the application server when it deploys the WAR. */
12
    @Override
13
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
14
        return builder.sources(ReportApplication.class);
15
    }
16

17
    /** Still runnable on its own for local development. */
18
    public static void main(String[] args) {
19
        SpringApplication.run(ReportApplication.class, args);
20
    }
21
}

1
spring:
2
  datasource:
3
    jndi-name: java:jboss/datasources/CustodyDS   # defined on the server, not in the WAR
4
  jpa:
5
    open-in-view: false

Kendini sına