Для чего нужен файл application.properties в Spring?

application.properties в Spring Boot: Конфигурация приложения

application.properties — это главный конфигурационный файл Spring Boot, где определяются все параметры приложения. Это текстовый файл в формате "ключ=значение", который позволяет управлять поведением приложения без изменения кода.

Основное назначение

application.properties нужен для:

• Конфигурации базы данных (URL, username, пароль)
• Настройки сервера (порт, контекст приложения)
• Логирования (уровни, формат)
• Управления профилями (dev, test, prod)
• Интеграции с внешними сервисами (API ключи, URL)
• JPA/Hibernate параметры (dialect, show_sql, ddl-auto)
• Настройки безопасности (CORS, JWT secret)

Типичный файл application.properties

# Сервер
server.port=8080
server.servlet.context-path=/api/v1
server.error.include-message=always
server.error.include-stacktrace=on_param

# База данных
spring.datasource.url=jdbc:postgresql://localhost:5432/mydb
spring.datasource.username=postgres
spring.datasource.password=secret
spring.datasource.driver-class-name=org.postgresql.Driver

# JPA/Hibernate
spring.jpa.hibernate.ddl-auto=validate
spring.jpa.show-sql=false
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQL10Dialect
spring.jpa.properties.hibernate.jdbc.batch_size=20
spring.jpa.properties.hibernate.order_inserts=true
spring.jpa.properties.hibernate.order_updates=true

# Логирование
logging.level.root=INFO
logging.level.com.myapp=DEBUG
logging.level.org.hibernate.SQL=DEBUG
logging.level.org.hibernate.type.descriptor.sql.BasicBinder=TRACE
logging.pattern.console=%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n

# Приложение
app.name=My Awesome App
app.version=1.0.0
app.jwt.secret=my-super-secret-key-that-should-be-in-env
app.jwt.expiration=86400000

# Кэширование
spring.cache.type=redis
spring.redis.host=localhost
spring.redis.port=6379

Структура файла

# Это комментарий
# Параметры группируются по категориям

# Секция: Server
server.port=8080
server.servlet.context-path=/api

# Секция: Database
spring.datasource.url=jdbc:mysql://localhost/mydb

# Секция: JPA
spring.jpa.show-sql=true

Как Spring загружает конфигурацию

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
        // Spring автоматически загружает application.properties
        // из classpath (обычно src/main/resources/)
    }
}

Порядок загрузки (от приоритета выше к ниже):

1. Command line arguments (--server.port=9000)
2. System properties (-Dserver.port=9000)
3. Environment variables (SERVER_PORT=9000)
4. Файлы конфигурации по профилям (application-prod.properties)
5. Основной файл (application.properties)

Использование значений из application.properties в коде

1. Через @Value

@Component
public class AppConfig {
    @Value("${app.jwt.secret}")
    private String jwtSecret;
    
    @Value("${server.port:8080}")  // значение по умолчанию
    private int serverPort;
    
    public void printConfig() {
        System.out.println("JWT Secret: " + jwtSecret);
        System.out.println("Port: " + serverPort);
    }
}

2. Через @ConfigurationProperties

@Configuration
@ConfigurationProperties(prefix = "app")
public class AppProperties {
    private Jwt jwt;
    private String name;
    private String version;
    
    // Getters & Setters
    public static class Jwt {
        private String secret;
        private long expiration;
        // ...
    }
}

// Использование
@Service
public class AuthService {
    @Autowired
    private AppProperties appProperties;
    
    public String getJwtSecret() {
        return appProperties.getJwt().getSecret();
    }
}

**3. Через Environment

@Component
public class MyComponent {
    @Autowired
    private Environment env;
    
    public void loadConfig() {
        String dbUrl = env.getProperty("spring.datasource.url");
        int port = env.getProperty("server.port", Integer.class, 8080);
    }
}

Профили конфигурации

Для разных окружений (dev, test, prod) создаёшь отдельные файлы:

src/main/resources/
├── application.properties          # Общие параметры
├── application-dev.properties      # Для разработки
├── application-test.properties     # Для тестов
└── application-prod.properties     # Для production

# application-dev.properties
spring.jpa.show-sql=true
logging.level.root=DEBUG
spring.h2.console.enabled=true

# application-prod.properties
spring.jpa.show-sql=false
logging.level.root=WARN
server.compression.enabled=true
server.servlet.session.timeout=30m

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

# Через переменную окружения
export SPRING_PROFILES_ACTIVE=prod

# Через system property
java -Dspring.profiles.active=prod -jar app.jar

# Через command line
java -jar app.jar --spring.profiles.active=prod

Переменные окружения вместо файла

Для production рекомендуется использовать переменные окружения, а не properties:

# Вместо hardcodе в application.properties
export SPRING_DATASOURCE_URL="jdbc:postgresql://prod-db:5432/mydb"
export SPRING_DATASOURCE_USERNAME="dbuser"
export SPRING_DATASOURCE_PASSWORD="secure-password"

java -jar app.jar

Spring автоматически привяжет переменные окружения к параметрам.

YAML вместо properties

Современный Spring часто использует YAML (более читаемый):

# application.yml
server:
  port: 8080
  servlet:
    context-path: /api/v1

spring:
  datasource:
    url: jdbc:postgresql://localhost/mydb
    username: postgres
    password: secret
  jpa:
    show-sql: false
    hibernate:
      ddl-auto: validate

logging:
  level:
    root: INFO
    com.myapp: DEBUG

Best Practices

1. НИКОГДА не коммити пароли и секреты

# ❌ ОПАСНО
spring.datasource.password=my-real-password
app.jwt.secret=super-secret

# ✅ ПРАВИЛЬНО
# В application.properties пусто или плейсхолдер
spring.datasource.password=${DB_PASSWORD}
app.jwt.secret=${JWT_SECRET}

# Передаёшь через переменные окружения
export DB_PASSWORD="actual-password"
export JWT_SECRET="actual-secret"

2. Группируй параметры логически

# Хорошо читается
app.feature.caching.enabled=true
app.feature.caching.ttl=3600
app.feature.analytics.endpoint=https://analytics.com

# Используй в коде
@ConfigurationProperties(prefix = "app.feature")
public class FeatureProperties { ... }

3. Документируй параметры

# Размер пула соединений к БД (default: 10)
spring.datasource.hikari.maximum-pool-size=20

# Время жизни JWT токена в миллисекундах
app.jwt.expiration=86400000

4. Используй типизированные конфигурационные классы

// Вместо @Value с magicstrings везде
@ConfigurationProperties(prefix = "app")
@Validated
public class AppProperties {
    @NotBlank
    private String name;
    
    @Min(1) @Max(65535)
    private int port;
    
    // Автоматическая валидация и type conversion
}

Приоритет загрузки конфигурации

Spring загружает конфигурацию в следующем порядке (по приоритету):

1. Command line arguments → java -jar app.jar --server.port=9000
2. Environment variables → SERVER_PORT=9000
3. System properties → -Dserver.port=9000
4. application-{profile}.properties → для активного профиля
5. application.properties → базовые параметры
6. @PropertySource → явно загруженные файлы
7. Default values в коде

Валидация конфигурации при старте

@Component
public class ConfigValidator {
    @Autowired
    private AppProperties appProperties;
    
    @PostConstruct
    public void validateConfig() {
        if (appProperties.getJwt().getExpiration() <= 0) {
            throw new IllegalArgumentException(
                "JWT expiration must be positive"
            );
        }
    }
}

Заключение

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