DAT
दस्तावेज़

DAT Java / Kotlin लाइब्रेरी

GitHub Maven Central

इंस्टॉलेशन

xml
kts

त्वरित शुरुआत

यह पूरा प्रवाह CMS से सर्टिफिकेट प्राप्त करता है, JSON डेटा वाला DAT बनाता है और उसका सत्यापन करता है।

kts

चरणबद्ध उपयोग

1. CMS से कनेक्ट करें

जारीकर्ता सेवा पूर्ण सर्टिफिकेट के लिए टोकन का उपयोग करती है। स्टार्टअप पर तुरंत सिंक्रनाइज़ करने से सर्टिफिकेट उपलब्ध होने से पहले जारीकरण रुकता है।

kts

2. DAT जारी करें

इस उदाहरण में सार्वजनिक JSON को plain में और संरक्षित उपयोगकर्ता जानकारी को JSON के रूप में secure में रखा गया है।

kts

3. DAT सत्यापित करें

parse समाप्ति और हस्ताक्षर की जाँच करता है, फिर secure को डिक्रिप्ट करता है। केवल सफल सत्यापन के बाद मिले payload का उपयोग करें।

kts

प्रमुख फ़ंक्शन

फ़ंक्शनउद्देश्य
syncOrThrow()सर्टिफिकेट को तुरंत सिंक्रनाइज़ करके विफलता बताता है।
issue(plain, secure)DAT बनाकर DatResult लौटाता है।
parse(dat)DAT सत्यापित करके Payload लौटाता है।
lastError()अंतिम background synchronization error लौटाता है।

डेटा क्षेत्र

  • plain: हस्ताक्षरित, लेकिन एन्क्रिप्ट न किए गए बाइट्स।
  • secure: एन्क्रिप्ट किए गए बाइट्स।
  • payload: इस पर केवल parse के सफल होने के बाद ही भरोसा करें।

JSON के अलावा विकल्प

उदाहरण परिचित JSON का उपयोग करते हैं। तेज़ प्रसंस्करण के लिए बाइनरी डेटा JSON serialization और parsing को हटाकर डेटा का आकार भी घटा सकता है।

सरल मानों को text के रूप में रखें, या Protobuf और MessagePack जैसे बाइनरी प्रारूपों में संरचित डेटा को plain और secure में रखें।

kts

ByteArray overload बिना किसी अतिरिक्त प्रारूप के bytes को सीधे रखता और निकालता है।

केवल-सत्यापन सेवाएँ

DAT जारी न करने वाली सेवा verify-only विकल्प और verify-only टोकन का उपयोग करती है और केवल parse कॉल करती है।

शटडाउन और त्रुटियाँ

DatCmsManager, AutoCloseable है; इसे use या close() से बंद करें।

त्रुटि संदेशों के बजाय त्रुटि कोड और पुनःप्रयास वर्गीकरण का उपयोग करें।