CBOR - CBOR - Wikipedia

CBOR
Dosya adı uzantısı
.cbor
İnternet medya türü
uygulama / cbor
Biçim türüVeri değişimi
StandartRFC  8949
Açık format ?Evet
İnternet sitesicbor.io

Kısa İkili Nesne Gösterimi (CBOR) ikili bir veridir serileştirme temel alan gevşek format JSON. JSON gibi, içeren veri nesnelerinin iletilmesine izin verir. ad-değer çiftleri ama daha özlü bir şekilde. Bu, işleme ve aktarım hızlarını maliyetine insan tarafından okunabilirlik. IETF'de tanımlanmıştır RFC  8949.[1]

Diğer kullanımlar arasında, veri serileştirme katmanı için tavsiye edilen CoAP Nesnelerin İnterneti protokol paketi[2][başarısız doğrulama ] ve hangi veri formatı COSE mesajlara dayanmaktadır. Ayrıca, İstemciden Kimlik Doğrulayıcıya Protokolü (CTAP) FIDO2 projesi kapsamında.[3]

CBOR kodlamasının özellikleri

CBOR kodlu veriler, veri öğeleri akışı olarak görülür. Örneğin.

CBOR verileriVeri öğesi 1Veri öğesi 2Veri öğesi X ...
Bayt sayısı1 bayt (CBOR veri öğesi başlığı)DeğişkenDeğişken1 bayt (CBOR veri öğesi başlığı)DeğişkenDeğişkenvb...
YapısıBaşlıca türüEk bilgiYük uzunluğu (isteğe bağlı)Veri yükü (isteğe bağlı)Başlıca türüEk bilgiYük uzunluğu (isteğe bağlı)Veri yükü (isteğe bağlı)vb...
Bit sayısı3 Bit5 Bit8 Bit × değişken8 Bit × değişken3 Bit5 Bit8 Bit × değişken8 Bit × değişkenvb..

Her veri öğesinde ana tür ve ek tür işleme

Her veri öğesi davranışı, ana tür ve ek tür ile tanımlanır. Ana tür, her veri öğesinin ana davranışını veya türünü seçmek için kullanılır.

Ek tür, tam davranışı ana tür değerine bağlı olan ek bilgilerdir.

CBOR veri öğesi alan kodlaması

Küçük Alan Kodlaması

Bayt sayısı1 bayt (CBOR veri öğesi başlığı)
YapısıBaşlıca türüEk bilgiler (Değer)
Bit sayısı3 Bit5 Bit

Kısa Alan Kodlaması

Bayt sayısı1 bayt (CBOR veri öğesi başlığı)Değişken
YapısıBaşlıca türüEk bilgiDeğer
Bit sayısı3 Bit5 Bit8 Bit × (Value_Field_Byte_Count)

Uzun Alan Kodlama

Bayt sayısı1 bayt (CBOR veri öğesi başlığı)DeğişkenDeğişken
YapısıBaşlıca türüEk bilgi (Uzunluk Alanının Boyutu)Yük uzunluğu (Değer Alanının Uzunluğu)Değer
Bit sayısı3 Bit5 Bit8 Bit × (Uzunluk_Field_Byte_Count)8 Bit × (Value_Field_Byte_Count)

CBOR veri öğesi başlığı

Aşağıdaki tablo, CBOR veri öğesi başlığının nasıl çalıştığını göstermektedir.

Başlıca türüAna tür değeriEk tür değeri (işaretsiz)Ek tip anlamıBayt Cinsinden Öğe BoyutuAlan Kodlama Tipi
Pozitif / İşaretsiz tamsayı00b0005 bitlik ek bilgi ya tamsayının kendisi (0'dan 23'e kadar ek bilgi değerleri için) ya da ek verilerin uzunluğudur.
0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan veri değeri olarak kullanılır. Böylece kompakt bir boyutta kalır.1Çok küçük
24Sonraki bayt, veri değeri bölümünde uint8_t'dir2Kısa
25Veri değeri bölümünde sonraki 2 bayt uint16_t3Kısa
26Sonraki 4 bayt, veri değeri bölümünde uint32_t5Kısa
27Sonraki 8 bayt, veri değeri bölümünde uint64_t9Kısa
............
31.........
Negatif tam sayı10b001Kodlama, işaretsiz tamsayılar (majör tip 0) kurallarını izler, tek fark değerin -1 eksi kodlanmış işaretsiz tamsayı olmasıdır.
0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan veri değeri olarak kullanılır. Böylece kompakt bir boyutta kalır.1Çok küçük
24Sonraki bayt, veri değeri bölümünde uint8_t'dir2Kısa
25Veri değeri bölümünde sonraki 2 bayt uint16_t3Kısa
26Sonraki 4 bayt, veri değeri bölümünde uint32_t5Kısa
27Sonraki 8 bayt, veri değeri bölümünde uint64_t9Kısa
............
31.........
Bayt dizesi20b010Dizenin bayt cinsinden uzunluğu, pozitif tamsayılar için kurallara göre temsil edilir (ana tür 0).
0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan veri uzunluğu belirleyicisi olarak kullanılır. Böylece kompakt bir boyutta kalır.1 + 23'e kadarKısa
24Sonraki bayt, yük uzunluğu için uint8_t'diren çok 2 + 2 ^ 8-1Uzun
25Sonraki 2 bayt uint16_t yük uzunluğu için3 + 2 ^ 16-1'e kadarUzun
26Sonraki 4 bayt, yük uzunluğu için uint32_t'dir5 + 2 ^ 32-1'e kadarUzun
27Sonraki 8 bayt, yük uzunluğu için uint64_t'diren çok 9 + 2 ^ 64-1Uzun
............
31Belirsiz Dize Başlangıcı: Bir sonraki karşılık gelen "Kesme" Koduna kadar belirli uzunlukta dizelerin birleştirilmesi.1Çok küçük
Metin dizesi30b011Bir metin dizesi, özellikle UTF-8 [RFC3629] olarak kodlanmış bir Unicode karakter dizesi.
0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan veri uzunluğu belirleyicisi olarak kullanılır. Böylece kompakt bir boyutta kalır.1 + 23'e kadarKısa
24Sonraki bayt, yük uzunluğu için uint8_t'diren çok 2 + 2 ^ 8-1Uzun
25Sonraki 2 bayt uint16_t yük uzunluğu için3 + 2 ^ 16-1'e kadarUzun
26Sonraki 4 bayt, yük uzunluğu için uint32_t'dir5 + 2 ^ 32-1'e kadarUzun
27Sonraki 8 bayt, yük uzunluğu için uint64_t'diren çok 9 + 2 ^ 64-1Uzun
............
31Belirsiz Dizenin Başlangıcı: Belirli uzunluktaki dizelerin, bir sonraki karşılık gelen "Kesme" Koduna kadar birleştirilmesi.1Çok küçük
Veri öğeleri dizisi40b100Diziler ayrıca listeler, diziler veya tuple olarak adlandırılır. Uzunluk, bayt uzunluğundan ziyade dizideki veri öğelerinin sayısını gösterir.
0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan öğe sayısı belirticisi olarak kullanılır. Böylece kompakt bir boyutta kalır.1Çok küçük
24Sonraki bayt, yük uzunluğu için uint8_t'dir2Kısa
25Sonraki 2 bayt uint16_t yük uzunluğu için3Kısa
26Sonraki 4 bayt, yük uzunluğu için uint32_t'dir5Kısa
27Sonraki 8 bayt, yük uzunluğu için uint64_t'dir9Kısa
............
31Bir sonraki karşılık gelen "Break" Koduna kadar Belirsiz Dizinin başlangıcı.1Çok küçük
Veri öğesi çiftlerinin haritası50b101Veri öğesi çiftlerinin bir haritası. Haritalara ayrıca tablolar, sözlükler, karmalar veya nesneler (JSON'da) adı verilir.

Uzunluk, bayt uzunluğundan ziyade veri öğesi çiftlerinin sayısını gösterir.

Her harita girişi, sıralı sırada iki veri öğesi, bir anahtar veri öğesi ve bir değer veri öğesi alır.

0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan öğe sayısı belirticisi olarak kullanılır. Böylece kompakt bir boyutta kalır.1Çok küçük
24Sonraki bayt, yük uzunluğu için uint8_t'dir2Kısa
25Sonraki 2 bayt uint16_t yük uzunluğu için3Kısa
26Sonraki 4 bayt, yük uzunluğu için uint32_t'dir5Kısa
27Sonraki 8 bayt, yük uzunluğu için uint64_t'dir9Kısa
............
31Bir sonraki karşılık gelen "kırılma" koduna kadar belirsiz haritanın başlangıcı.1Çok küçük
Anlamsal etiket60b110Diğer ana türlerin isteğe bağlı anlamsal etiketlemesi için kullanılır
Değer Alanı, Etiket Kimliğini temsil eder: Bkz. https://www.iana.org/assignments/cbor-tags/cbor-tags.xhtml her etiketin anlamsal anlamı için.
0 - 23 (0x0 - 0x17) (0b00000 - 0b10111)Doğrudan veri değeri olarak kullanılır. Böylece kompakt bir boyutta kalır.1Çok küçük
24Sonraki bayt, veri değeri bölümünde uint8_t'dir2Kısa
25Veri değeri bölümünde sonraki 2 bayt uint16_t3Kısa
26Sonraki 4 bayt, veri değeri bölümünde uint32_t5Kısa
27Sonraki 8 bayt, veri değeri bölümünde uint64_t9Kısa
............
31...1...
İlkeller

Örneğin. kırmak

şamandıra

basit değerler

70b111kayan nokta sayıları ve içeriğe ihtiyaç duymayan basit veri türleri ile "kesme" durdurma kodu[4]
0..19(Atanmamış)1Çok küçük
20Yanlış1Çok küçük
21Doğru1Çok küçük
22Boş1Çok küçük
23Tanımsız1Çok küçük
24Sonraki Bayt, Basit değer olarak uint8_t'dir (değer 32..255)2Kısa
25Sonraki 2 Bayt uint16_t olarak IEEE 754 yarı hassasiyetli kayan nokta3Kısa
26Sonraki 4 Bayt, IEEE 754 tek duyarlıklı kayan nokta olarak uint32_t'dir5Kısa
27Sonraki 8 Bayt, IEEE 754 çift duyarlıklı kayan nokta olarak uint64_t olur9Kısa
28Atanmamış
29
30
31belirsiz uzunluktaki öğeler için "break" durdurma kodu1Çok küçük
  • Bayt = 8 bit

İlkeller (Ana tür = 7)

Temel türlerin ana tür değeri 7'dir. Basit veri türleri, yaygın karmaşık kayan nokta türleri ve kontrol kodu için kullanılır.

Başlıca türüEk değerEkstra baytlar (gerekirse)
Bayt012345678
Bit boyutu3 bit5 bit88888888
Basit değer 0 ila 23 (X değeri)7X = 0 ... 23Kullanılmamış
Basit değer 24-255 (X değeri)724X = 32 ... 255Kullanılmamış
IEEE 754 yarı hassas şamandıra (16 bit takip eder)72516 bit IEEE 754Kullanılmamış
IEEE 754 tek hassasiyetli şamandıra (32 bit takip eder)72632 bit IEEE 754Kullanılmamış
IEEE 754 çift hassasiyetli şamandıra (64 bit takip eder)72764 bit IEEE 754
Belirsiz dizi veya haritadan kopma731Kullanılmamış

Kırılma kontrol kodu (Ek tip değeri = 31)

Bu, belirsiz uzunluk moduna ayarlanmış diziler ve haritalarla birlikte kullanılan bir meta değerdir. Bu, CBOR ayrıştırıcısına karşılık gelen haritayı veya dizi düzeyini kapatmasını belirtir.

IEEE 754 Kayan (Ek tür değeri = 25 veya 26 veya 27)

Bu, IEEE 754 kayan değer olarak kodlanmış kayan sayıların depolanmasına izin verir.

Basit değer

Çoğu basit değer atanmamış veya gelecekteki iyileştirmeler için ayrılmıştır.

Ancak bunlar tanımlanmıştır.

Basit değerAnlamsal
20Boolean false
21Doğru Boole
22Boş
23Tanımsız

Anlamsal Etiket Kaydı

IANA, şurada bulunan CBOR etiketleri kaydını oluşturdu https://www.iana.org/assignments/cbor-tags/cbor-tags.xhtml . Kayıt bu şablonu içermelidir.

Anlamsal etiket türüAralıkŞablon
Veri öğesiAnlamsal açıklama (Kısa Form)Bağlantı noktasıAnlambilimin açıklaması (URL)
Standart eylemler0–23gereklidirgereklidirYokYok
Şartname gerekli24–255gereklidirgereklidirYokYok
Önce Önce Servis Yapılır256–18446744073709551615gereklidirgereklidirgereklidirAçıklama isteğe bağlıdır.

URL, bir İnternet Taslağına veya bir web sayfasına işaret edebilir.

https://www.rfc-editor.org/rfc/rfc8949.html#name-cbor-tags-registry

Uygulamalar

İsimBirincil yazarDilLisansKaynakUyarılar
cbor-jsPatrick GanstererJavaScriptMIThttps://github.com/paroga/cbor-js
düğüm-cborJoe HildebrandJavaScriptMIThttps://github.com/hildjj/node-cbor
CBOREncodePavel GulbinPHPPHPhttps://github.com/2tvenom/CBOREncode
cborFaye AmackerGitMIThttps://github.com/fxamacker/cborGüvenli ve hızlı, CBOR etiketleri, float64 / 32/16, yinelenen eşleme anahtarı algılama, API kodlama / json + dizi ve keyasint yapı etiketleri, Canonical CBOR, CTAP2, fuzz test edildi.
cborPavel GulbinGitWTFPLhttps://github.com/2tvenom/cbor
cbor_goBrian OlsonGitAPL 2.0https://github.com/brianolson/cbor_go
go codec bileşeniUgorji NwokeGitMIThttps://godoc.org/github.com/ugorji/go/codecAyrıca JSON, MsgPack ve BinC'yi de işler.
serde_cborPyfischPas, paslanmaMIT veya APL 2.0https://github.com/pyfisch/cbor
cbor-codec bileşeniToralf WittnerPas, paslanmaMPL 2.0https://twittner.gitlab.io/cbor-codec/cbor/
SwiftCBOR[email protected]SwiftLisanssızhttps://github.com/myfreeweb/SwiftCBOR
CBOR.jlSaurav SachidanandJuliaMIThttps://github.com/saurvs/CBOR.jl
Lua-CBORKim AlvefurLuaMIThttps://www.zash.se/lua-cbor.html
org.conman.cborSean ConnerLuaLGPL-3https://github.com/spc476/CBOR
cbor_pyBrian OlsonPythonAPL 2.0https://github.com/brianolson/cbor_py
FlynnFritz Conrad GrimpenPythonMIThttps://github.com/fritz0705/flynn
cbor2Alex GrönholmPythonMIThttps://github.com/agronholm/cbor2
CBOR :: ÜcretsizFelipe GasperPerlSanatsal ve GPLhttps://metacpan.org/pod/CBOR::Free
CBOR :: PPFelipe GasperPerlSanatsal ve GPLhttps://metacpan.org/pod/CBOR::PP
CBOR :: XSMarc LehmannPerlGPL-3https://metacpan.org/pod/CBOR::XS
cbor-yakutSadayuki Furuhashi

Carsten Bormann

YakutAPL 2.0https://github.com/cabo/cbor-ruby
libcbor-rubyPavel KalvodaYakutMIThttps://github.com/PJK/libcbor-rubyLibcbor'a bağlanıyor.
cbor-erlangJihyun YuErlangBSD-3 maddesihttps://github.com/yjh0502/cbor-erlang
ExcborCarsten Bormannİksirbelirtilmemiş,

yazara sor

https://github.com/cabo/excbor
CBORR. Kyle MurphyHaskellLGPL-3https://github.com/orclev/CBOR
BorcJoe Hildebrand

Friedel Ziegelmayer

JavaScriptMIThttps://github.com/dignifiedquire/borcÇatal düğüm-cbor.
Borc-refsJoe Hildebrand

Friedel Ziegelmayer

Sandro Hawke

JavaScriptMIThttps://github.com/sandhawke/borc-refsBorc çatalı.
CBORPeter OccilC #Kamuya açık yazılımhttps://github.com/peteroupc/CBORAyrıca JSON'u da işler.
Dahomey.CborMichaël CatanzaritiC #MIT Lisansıhttps://github.com/dahomey-technologies/Dahomey.Cbor
JacksonTatu SalorantaJavaAPL-2.0https://github.com/FasterXML/jackson-dataformats-binary/tree/master/cborDiğer formatları da işler.
cbor-javaConstantin RafıJavaAPL-2.0https://github.com/c-rack/cbor-java
JacobJ.W. JanssenJavaAPL-2.0https://github.com/jawi/jacob
kotlinx.serializationJetBrainsKotlinAPL-2.0https://github.com/Kotlin/kotlinx.serializationÇapraz platformu destekler
cn-cborJoe Hildebrand

Carsten Bormann

CMIThttps://github.com/cabo/cn-cbor
cbor-cppStanislav OvsyannikovC ++APL-2.0https://github.com/naphaso/cbor-cpp
cppborDavid PreeceC ++BSDhttps://github.com/rantydave/cppborC ++ 17 varyantlarını kullanır.
libcborPavel KalvodaCMIThttps://github.com/PJK/libcbor
TinycborIntelCMIThttps://github.com/01org/tinycbor
NanoCBORKoen ZandbergCLGPLhttps://github.com/bergzand/NanoCBORTarafından kullanılan RIOT-OS
cbor-dAndrey PenechkoD1.0 Boosthttps://github.com/MrSmith33/cbor-d
clj-cborGreg LookClojureLisanssızhttps://github.com/greglook/clj-cbor
Modern C ++ için JSONNiels LohmannC ++MIThttps://github.com/nlohmann/jsonAyrıca JSON ve MsgPack'i de işler.
Bora BoraChristoph EngelbertJavaAPL-2.0https://github.com/noctarius/borabora
lua-ConciseSerializationFrançois PerradLuaMIThttps://web.archive.org/web/20170322112326/https://fperrad.github.io/lua-ConciseSerialization/
FlunnFritz Conrad Grimpen

Sokolov Yura

PythonMIThttps://pypi.python.org/pypi/flunn
cbor-qtAnton DutovC ++Kamu malıhttps://github.com/anton-dutov/cbor-qt
QCborValueQt ProjesiC ++LGPLhttps://doc.qt.io/qt-5/qcborvalue.htmlBir bölümü Qt sürüm 5.12'den beri çerçeve
cbor11Jakob Varmose BentzenC ++Kamu malıhttps://github.com/jakobvarmose/cbor11
cborcppAlex NekipelovC ++MIThttps://github.com/nekipelov/cborcpp
Akvaryum balığıVincent LascauxC ++MIThttps://github.com/OneNoteDev/GoldFish
Kütüphane-Arduino-CborJuanjo TaraC ++APL-2.0https://github.com/jjtara/Library-Arduino-Cbor
cborgDuncan CouttsHaskellBSD-3 maddesihttps://github.com/well-typed/cborg
cborSteve HamblettDart oyunuMIThttps://github.com/shamblett/cbor
deliciMathias DoenitzScalaMPL 2.0https://github.com/sirthias/borerAyrıca JSON'u da işler.
nim_cborZımpara HemingwayNimMIThttps://git.sr.ht/~ehmry/nim_cbor
ciboriumNathaniel McCallum

Mark Bestavros

Enarx Ekibi

Pas, paslanmaApache 2.0https://github.com/enarx/ciborium

Ayrıca bakınız

Referanslar

Dış bağlantılar