Зачем нужен профиль в Maven?

Профили в Maven

Профиль в Maven — это набор конфигурационных параметров, которые позволяют настраивать процесс сборки проекта для различных окружений и сценариев. Профили обеспечивают гибкость при работе с разными условиями развёртывания и тестирования.

Назначение профилей

Профили решают следующие задачи:

• Адаптация сборки под разные окружения (development, staging, production)
• Условное подключение зависимостей
• Изменение пути к ресурсам для разных целей
• Выбор различных плагинов и конфигураций
• Настройка параметров компиляции (версия Java, уровень оптимизации)
• Работа с разными базами данных для тестирования

Структура и определение профилей

Профили определяются в файле pom.xml внутри секции <profiles>:

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.example</groupId>
    <artifactId>myapp</artifactId>
    <version>1.0.0</version>
    
    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>
    
    <profiles>
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <environment>development</environment>
                <database.url>jdbc:mysql://localhost:3306/myapp_dev</database.url>
            </properties>
        </profile>
        
        <profile>
            <id>prod</id>
            <properties>
                <environment>production</environment>
                <database.url>jdbc:mysql://prod-server:3306/myapp</database.url>
            </properties>
        </profile>
    </profiles>
</project>

Активация профилей

Профили можно активировать несколькими способами:

1. Через командную строку:

mvn clean install -Pprod
mvn clean install -Pdev,test

2. Активация по умолчанию:

<profile>
    <id>dev</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
</profile>

3. По свойствам системы:

<profile>
    <id>windows</id>
    <activation>
        <os>
            <family>windows</family>
        </os>
    </activation>
</profile>

4. По наличию файла:

<profile>
    <id>with-config</id>
    <activation>
        <file>
            <exists>config/custom.properties</exists>
        </file>
    </activation>
</profile>

5. По версии Java:

<profile>
    <id>java11plus</id>
    <activation>
        <jdk>[11,)</jdk>
    </activation>
</profile>

Практический пример

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.mycompany</groupId>
    <artifactId>app</artifactId>
    <version>1.0.0</version>
    
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>2.7.0</version>
        </dependency>
    </dependencies>
    
    <profiles>
        <!-- Профиль разработки -->
        <profile>
            <id>dev</id>
            <activation>
                <activeByDefault>true</activeByDefault>
            </activation>
            <properties>
                <spring.profiles.active>dev</spring.profiles.active>
                <log.level>DEBUG</log.level>
            </properties>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-surefire-plugin</artifactId>
                        <version>2.22.2</version>
                        <configuration>
                            <skipTests>false</skipTests>
                        </configuration>
                    </plugin>
                </plugins>
            </build>
        </profile>
        
        <!-- Профиль тестирования -->
        <profile>
            <id>test</id>
            <properties>
                <spring.profiles.active>test</spring.profiles.active>
                <log.level>INFO</log.level>
            </properties>
        </profile>
        
        <!-- Профиль production -->
        <profile>
            <id>prod</id>
            <properties>
                <spring.profiles.active>prod</spring.profiles.active>
                <log.level>WARN</log.level>
            </properties>
            <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-shade-plugin</artifactId>
                        <version>3.2.4</version>
                        <executions>
                            <execution>
                                <phase>package</phase>
                                <goals>
                                    <goal>shade</goal>
                                </goals>
                            </execution>
                        </executions>
                    </plugin>
                </plugins>
            </build>
        </profile>
    </profiles>
</project>

Использование профилей с зависимостями

<dependencies>
    <!-- Всегда подключается -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.13</version>
        <scope>test</scope>
    </dependency>
</dependencies>

<profiles>
    <profile>
        <id>with-h2</id>
        <dependencies>
            <dependency>
                <groupId>com.h2database</groupId>
                <artifactId>h2</artifactId>
                <version>1.4.200</version>
                <scope>test</scope>
            </dependency>
        </dependencies>
    </profile>
    
    <profile>
        <id>with-postgresql</id>
        <dependencies>
            <dependency>
                <groupId>org.postgresql</groupId>
                <artifactId>postgresql</artifactId>
                <version>42.3.1</version>
                <scope>runtime</scope>
            </dependency>
        </dependencies>
    </profile>
</profiles>

Проверка активных профилей

mvn help:active-profiles
mvn help:all-profiles

Преимущества использования профилей

• Гибкость — одна кодовая база для разных окружений
• Безопасность — разные конфигурации для dev/prod
• Переиспользование — избежание дублирования pom.xml файлов
• Автоматизация — CI/CD легко выбирает нужный профиль
• Изоляция — разные зависимости для тестирования и production

Профили — мощный инструмент, который делает Maven проект более гибким и удобным в поддержке