HOCON’a Giriş

HOCON (İnsan Tarafından Optimize Edilmiş Konfigürasyon Nesnesi Gösterimi) kullanımı kolay bir konfigürasyon formatıdır. Sponge ve Sponge API’sini kullanan bireysel eklentiler tarafından yapılandırmak veya oynatıcı verileri gibi önemli verileri depolamak için kullanılır. HOCON dosyaları genelde .conf ekini kullanır.

Bileşenler

  • bir key bir değerden önce gelen bir dizedir.

  • value, bir key’i takip eden bir metin, dizilim ya da boolean’dır

  • bir key-value separator, anahtarları ve değerleri birbirinden ayırır ve : ya da = olabilir

  • bir comment, # ya da // ön ekine sahiptir ve tipik olarak geri bildirim ya da talimatları sunma hizmetini yürütür

Örnek:

yellow-thing: "Sponge"

Bu örnekte key, yellow-thing; value, Sponge ve key-value separator ise :’dır.

HOCON ile çalışma

HOCON, JSON (JavaScript Object Notation) formatına kıyasla daha esnektir; çünkü geçerli bir HOCON yazmanın birçok yolu vardır. Aşağıda, geçerli bir HOCON’un iki örneğini bulabilirsiniz.

Örnek #1:

player: {
    name: "Steve",
    level: 30
}

Örnek #2:

player {
    name = "Steve"
    level = 30
}

Uygulamada, düzenlemekte olduğunuz HOCON yapılandırmasının biçimlendirme teamüllerine uymak en iyi yoldur. Sponge için bir HOCON yapılandırmasını veya Sponge API’sini kullanan ayrı bir eklentiyi düzenlerken, aksi belirtilmediği sürece değerler muhtemelen değişecektir.

Yapılandırmanızdan hata ayıklayın

HOCON yapılandırması çalışmıyor gibi görünüyorsa, işte bazı ipuçları.

  • Küme parantezleri dengeli olmalıdır

  • Tırnak işaretleri dengeli olmalıdır

  • Daha sonradan , önce görünen çift tuşlar

Şartname

HOCON biçimi hakkında daha fazla bilgi burada bulunabilir ‘<https://github.com/typesafehub/config/blob/master/HOCON.md>’__.