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
, birkey
’i takip eden bir metin, dizilim ya da boolean’dırbir
key-value separator
, anahtarları ve değerleri birbirinden ayırır ve:
ya da=
olabilirbir
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>’__.