Konfigurasi Aman Tipe dengan @ConfigurationProperties
Hubungkan properti ke kelas konfigurasi bertipe.
Konfigurasi Aman Tipe dengan @ConfigurationProperties adalah pelajaran Spring Boot 4 Microservices & REST APIs gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Spring Boot 4 Microservices & REST APIs, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Spring Boot 4 Microservices & REST APIs mencakup 4 pelajaran total.
Bagian dari pelajaran ini belum diterjemahkan dan ditampilkan dalam bahasa Inggris.
Beyond @Value
Scattering dozens of @Value annotations across a feature is brittle and hard to validate. @ConfigurationProperties binds a whole group of related keys to a single strongly typed object.
You get IDE auto-completion, type safety, validation, and a clear contract for what the feature reads.
Binding a Prefix to a Class
Declare a class with a prefix; Spring maps each key under that prefix to a matching field. Relaxed binding lets max-retries in YAML map to maxRetries in Java.
@ConfigurationProperties(prefix = "app.mail")
public class MailProperties {
private String host;
private int port;
private int maxRetries;
// getters and setters
}Registering the Properties Bean
A @ConfigurationProperties class must become a bean. The cleanest way is @EnableConfigurationProperties on a configuration class, or @ConfigurationPropertiesScan on the main app.
@SpringBootApplication
@ConfigurationPropertiesScan
public class Application { }
// or explicitly:
@Configuration
@EnableConfigurationProperties(MailProperties.class)
class MailConfig { }The Backing YAML
With the prefix app.mail, these YAML keys bind to the fields. Relaxed binding accepts kebab-case keys for camelCase fields.
app:
mail:
host: smtp.example.com
port: 587
max-retries: 3Injecting the Properties
Inject the typed object anywhere like any other bean. The feature code reads structured config instead of loose strings.
@Service
public class MailService {
private final MailProperties props;
public MailService(MailProperties props) {
this.props = props;
}
void send() {
connect(props.getHost(), props.getPort());
}
}Immutable Binding with Records
Spring Boot supports constructor binding, perfect for immutable config. A Java record works directly with @ConfigurationProperties, no setters needed.
@ConfigurationProperties(prefix = "app.mail")
public record MailProperties(
String host,
int port,
int maxRetries) {
}Default Values
With records you can give defaults in a compact constructor; with classic classes you initialize the field. Defaults apply when the key is absent from the Environment.
@ConfigurationProperties(prefix = "app.mail")
public record MailProperties(String host, Integer port, Integer maxRetries) {
public MailProperties {
if (port == null) port = 587;
if (maxRetries == null) maxRetries = 3;
}
}Nested Objects
Configuration trees map to nested types. A field of a custom type binds keys one level deeper, keeping complex config organized.
@ConfigurationProperties(prefix = "app")
public class AppProperties {
private final Security security = new Security();
public Security getSecurity() { return security; }
public static class Security {
private boolean enabled;
private String issuer;
// getters/setters
}
}Lists and Maps
Collection-typed fields bind to YAML sequences and maps automatically, which is far cleaner than parsing comma-separated strings by hand.
@ConfigurationProperties(prefix = "app")
public class AppProperties {
private List<String> allowedOrigins;
private Map<String, Integer> rateLimits;
// getters/setters
}
// app.allowed-origins: [a, b]
// app.rate-limits: { read: 100, write: 20 }Validating Bound Values
Add @Validated to the properties class and JSR-380 constraints to fields. Spring validates at startup and fails fast if config is invalid, instead of erroring deep in production.
@Validated
@ConfigurationProperties(prefix = "app.mail")
public class MailProperties {
@NotBlank private String host;
@Min(1) @Max(65535) private int port;
// getters/setters
}Metadata and the Processor
Add spring-boot-configuration-processor as an annotation processor to generate metadata. Your IDE then offers auto-complete and docs for your custom keys in application.yml.
<!-- pom.xml -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-configuration-processor</artifactId>
<optional>true</optional>
</dependency>Quick Check
Test your understanding of relaxed binding.
Recap
@ConfigurationProperties gives type-safe, grouped configuration.
- Bind a
prefixto a class or record - Register via
@ConfigurationPropertiesScanor@EnableConfigurationProperties - Records enable immutable constructor binding
- Nested types, lists, and maps bind naturally
@Validatedmakes invalid config fail fast at startup
Belajar Java dengan tutor AI — gratis
Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.
- Kursus
- 24
- Pelajaran
- 93
Pertanyaan yang Sering Diajukan
Apakah pelajaran “Konfigurasi Aman Tipe dengan @ConfigurationProperties” gratis?
Ya — teks lengkap “Konfigurasi Aman Tipe dengan @ConfigurationProperties” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Spring Boot 4 Microservices & REST APIs, upgrade ke CoddyKit PRO. Kursus Spring Boot 4 Microservices & REST APIs mencakup 4 pelajaran total.
Apa yang akan aku pelajari di “Konfigurasi Aman Tipe dengan @ConfigurationProperties”?
Hubungkan properti ke kelas konfigurasi bertipe. Kamu berlatih Spring Boot 4 Microservices & REST APIs dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.
Apakah aku perlu pengalaman untuk memulai Spring Boot 4 Microservices & REST APIs?
Tidak diperlukan pengalaman sebelumnya. Spring Boot 4 Microservices & REST APIs di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.
Berapa lama pelajaran “Konfigurasi Aman Tipe dengan @ConfigurationProperties” memakan waktu?
Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.
Bisakah aku menulis dan menjalankan kode dalam pelajaran Spring Boot 4 Microservices & REST APIs ini?
Ya. Setiap pelajaran Spring Boot 4 Microservices & REST APIs menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.
Semua pelajaran dalam kursus ini
- application.properties dan YAML
- Profil untuk Lingkungan
- Konfigurasi Aman Tipe dengan @ConfigurationProperties
- Konfigurasi Eksternal dan Penimpaan