DAT Java / Kotlin Library
GitHub Maven CentralInstallation
فوری آغاز
یہ مکمل flow CMS سے certificates لیتا، JSON data والا DAT بناتا اور verify کرتا ہے۔
مرحلہ وار
1. CMS سے connect کریں
Issuing service full certificates کا token استعمال کرتی ہے۔ startup پر فوراً synchronization سے certificates ملنے سے پہلے issuance نہیں ہوتا۔
2. DAT issue کریں
یہ مثال public JSON کو plain اور protected user information کو JSON کی صورت secure میں رکھتی ہے۔
3. DAT verify کریں
parse expiration اور signature check کرکے secure decrypt کرتا ہے۔ صرف successful verification کے بعد ملنے والا payload استعمال کریں۔
اہم functions
| Function | مقصد |
|---|---|
syncOrThrow() | Certificates فوراً synchronize کرکے failure بتاتا ہے۔ |
issue(plain, secure) | DAT بنا کر DatResult دیتا ہے۔ |
parse(dat) | DAT verify کرکے Payload دیتا ہے۔ |
lastError() | آخری background synchronization error دیتا ہے۔ |
Data regions
plain: signed مگر encrypted نہ ہونے والے bytes۔secure: encrypted bytes۔payload: صرفparseکامیاب ہونے کے بعد اعتماد کریں۔
JSON کے علاوہ options
مثالوں میں معروف JSON ہے۔ تیز processing کے لیے binary data، JSON serialization اور parsing سے بچ کر data size کم کر سکتا ہے۔
Simple values text کی صورت یا structured data کو Protobuf یا MessagePack جیسے binary formats میں plain اور secure میں رکھیں۔
ByteArray overload اضافی format کے بغیر bytes براہِ راست محفوظ اور حاصل کرتا ہے۔
Verify-only services
DAT issue نہ کرنے والی service verify-only option اور verify-only token استعمال کرتی اور صرف parse call کرتی ہے۔
Shutdown اور errors
DatCmsManager، AutoCloseable ہے؛ use یا close() سے بند کریں۔
Error messages کے بجائے error codes اور retry classifications استعمال کریں۔