Properties va environment — konfiguratsiya

~20 daq · Java · Tarmoq va xizmat sozlamalari

Muammodan boshlaylik

Server manzili va ish rejimini har deployda kodni tahrirlab o‘zgartirish noqulay.

Tushunib olamiz

Environment jarayon tashqarisidan qiymat beradi, Properties esa kalit-qiymat faylini o‘qiydi. Standart qiymat, foydalanuvchi qiymati va noto‘g‘ri qiymat uchun ustuvorlikni oldindan tanlang. Maxfiy kalitni commit yoki logga yozmang. Noto‘g‘ri konfiguratsiyani ish boshida aniqlash keyingi yashirin xatodan yaxshiroq.

Misolni bajaramiz

Java 21+ ishlating. Alohida ko‘rsatilmagan mustaqil misolni Main.javaga saqlang: javac -encoding UTF-8 Main.java va java Main. Maven, test va JDBC darslaridagi maxsus talablarni natija izohida bajaring.

public class Main {
  public static void main(String[] args) throws Exception {
    String matn = System.getenv().getOrDefault("APP_PORT", "8080");
    int port = Integer.parseInt(matn);
    if (port < 1 || port > 65535) throw new IllegalArgumentException("Port xato");
    System.out.println("Port: " + port);
  }
}

Natija va izoh

Environment berilmasa Port: 8080. PowerShell’da $env:APP_PORT="9090" bersangiz 9090 ishlatiladi. Bo‘sh yoki harfli qiymat boshqariladigan konfiguratsiya xatosi bo‘lsin.

[!WARNING] Environmentdan kelgan qiymat String bo‘lgani uchun ishonchli deb qabul qilmang. Null, bo‘shlik va diapazonni tekshiring.

Mustaqil mashq

APP_MODE faqat dev/test/prod qiymatlarini qabul qilsin.

Avval kodni mustaqil o‘zgartiring. Oddiy holatdan tashqari bo‘sh qiymat, noto‘g‘ri kirish yoki resurs mavjud bo‘lmagan vaziyatni ham sinang. Natijani taxmin qilib, haqiqiy natija bilan solishtiring.

Yechim va tekshirish yo‘li

Set.of bilan ruxsat etilgan qiymatlar to‘plamini yarating, normalizatsiya siyosatini belgilang va noma’lum qiymatda ishni tushunarli xabar bilan to‘xtating.

Xulosa

Environment jarayon tashqarisidan qiymat beradi, Properties esa kalit-qiymat faylini o‘qiydi.

Bu usulni avvalgi katalog loyihasiga alohida bosqich sifatida qo‘shing: ishlayotgan qismini saqlab, yangi talab uchun kichik tekshiruv yozing. Xato holatidagi xulqni ham hujjatlashtiring; muvaffaqiyatli namunaning o‘zi yetarli emas.

Keyingi dars: Logging — daraja, kontekst va maxfiylik.

Rasmiy manba: Dev.java, Maven, JUnit