Maven Shade 플러그인: Uber Jar 생성 및 패키지 이름 바꾸기

Maven Shade 플러그인은 개발자가 종속성을 포함한 아티팩트를 단일 패키지로 결합할 수 있는 강력한 도구입니다. , 포괄적인 "uber jar"입니다. 이를 통해 배포 및 배포 프로세스를 크게 단순화할 수 있습니다.

Uber Jar 이해

Maven 생태계에서 각 아티팩트는 일반적으로 자체 클래스와 리소스만 포함합니다. 프로젝트가 빌드되면 Maven은 지정된 종속성 관리를 기반으로 필요한 모든 종속성(JAR 등)을 찾습니다.

반면, uber jar는 모든 종속성을 하나의 대규모 JAR로 통합합니다. 여러 개의 작은 JAR 대신 애플리케이션을 실행하는 데 하나의 큰 JAR만 필요하므로 실행이 단순화됩니다.

Uber Jar를 만드는 이유

Uber Jar는 다음과 같은 몇 가지 장점을 제공합니다.

• 단순한 실행: 모든 것을 하나의 JAR로 패키징하면 실행이 더 쉽고 빨라집니다.
• 더 쉬운 배포: 수동 배포 또는 배포의 경우 uber jar는 여러 개의 작은 아티팩트보다 더 편리하고 관리하기 쉬운 경우가 많습니다.

패키지 재배치(이름 바꾸기)

uber jar를 만드는 것 외에도 Maven Shade는 플러그인은 "재배치"라고 알려진 종속성 패키지의 이름을 바꿀 수도 있습니다. 이 기술은 종속성 충돌을 해결하고 모듈성을 향상할 수 있습니다.

예시 시나리오

다음과 같은 가상 상황을 고려해보세요.

• Foo 라이브러리가 Bar에 의존합니다. 라이브러리 버전 1.0.
• Qux 프로젝트는 Foo 및 Bar 버전 2.0에 따라 다릅니다(1.0에서 사용할 수 없는 새로운 기능 필요).

이로 인해 종속성 충돌이 발생합니다. Qux는 Bar 1.0을 사용할 수 없습니다. (Foo의 종속성) 해당 코드에는 Bar 2.0의 기능이 필요하기 때문입니다.

이 문제를 해결하기 위해 Foo 라이브러리 개발자는 Shade 플러그인을 사용하여 Bar의 사용 위치를 변경할 수 있습니다:

• Bar 1.0의 모든 클래스 이름을 새 패키지로 바꿉니다(예: com.bar 대신 com.foo.bar).
• Foo uber jar 내에 이 "재배치된" 바코드를 삽입합니다.

Foo가 이제 다른 패키지에 자체 Bar 복사본을 가지게 되므로 Qux는 Foo의 종속성과 충돌하지 않고 안전하게 Bar 2.0을 사용할 수 있습니다.

Maven Shade 플러그인을 사용해야 하는 경우

다음과 같은 경우 Maven Shade 플러그인 사용을 고려하세요.

• 간단한 배포 또는 실행을 위해 uber jar를 생성합니다.
• 패키지를 재배치하여 종속성 충돌을 해결합니다.
• 종속성을 일관된 구조로 다시 패키징하여 모듈성을 강화합니다.