مدقق UUID

عند النجاح يعيد الصيغة القياسية الموحدة بالحروف الصغيرة، والمتغير المشفر في بتات تسلسل الساعة، والإصدار المسجل داخل UUID. يقبل الحروف السداسية الكبيرة والصغيرة، لكنه لا يقبل بصمت الأقواس أو السلاسل المختصرة أو الفواصل الموضوعة خطأ أو المحارف غير السداسية، ولذلك يفيد في فحص المعرفات قبل إدخالها إلى API أو قاعدة بيانات أو سجل.

ما الذي يفحصه مدقق UUID هذا

يتكون UUID من 128 بت، لكن الأشخاص والأنظمة يتبادلونه عادة في صورة 36 محرفا ظاهرا موزعة على خمس مجموعات: ثمانية محارف سداسية، ثم أربع وأربع وأربع واثنا عشر، تفصل بينها شرطات. يفحص هذا المدقق ذلك التمثيل تحديدا. فهو يتحقق من الطول الكلي، ويؤكد وجود كل فاصل في موضعه الصحيح، ويرفض أي محرف ليس رقما سداسيا أو شرطة. يمكن كتابة الحروف السداسية كبيرة أو صغيرة لأن حالة الحرف لا تغير البتات الأساسية. ولا يحذف المدقق بصمت المسافات أو الأقواس أو بادئة URN أو القيم المختصرة ذات 32 محرفا أو علامات الترقيم اللاحقة. يفيد هذا الحد الصارم عند اختبار عقد API أو حقل في قاعدة بيانات: فإما أن يطابق الإدخال صيغة UUID النصية الموثقة، وإما أن تظهر علة تحدد المشكلة البنيوية. تتضمن الاستجابة الناجحة valid بقيمة صحيحة، وتقدم قيمة قياسية بالحروف الصغيرة تصلح للمقارنات الثابتة ومفاتيح التخزين المؤقت وبيانات الاختبار والسجلات. يعمل التحقق بصورة حتمية، ولا يستعلم من سجل خارجي، ولا ينشئ معرفا بديلا، ولا يزعم وجود UUID في أي نظام آخر.

كيفية فك المتغير والإصدار

تكون بيانات UUID الوصفية مشفرة داخل المعرف نفسه ولا تحتاج إلى بحث خارجي. الإصدار هو الرقم السداسي في بداية المجموعة الثالثة؛ يحوله المدقق إلى عدد صحيح من 0 إلى 15 ويعيده مباشرة. تشمل الإصدارات المعينة الشائعة الإصدار 1 المعتمد على الوقت، والإصدارين 3 و5 المعتمدين على الاسم، والإصدار 4 العشوائي، والإصدار 6 ذي الوقت المعاد ترتيبه، والإصدار 7 المعتمد على وقت Unix، والإصدار 8 المخصص. أما المتغير فيأتي من البتات الأولى في المجموعة الرابعة. إذا كان البت الأول صفرا تظهر القيمة ncs؛ ويظهر النمط 10 باسم rfc_4122، وهي العائلة المستخدمة في تنسيقات UUID الحديثة؛ ويظهر 110 باسم microsoft؛ و111 باسم future. الإبلاغ عن البتات لا يعني فرض ملف تطبيقي معين. فقد يحمل UUID الصحيح بنيويا إصدارا محجوزا أو متغيرا قديما. لذلك تصف الأداة ما يشفره الإدخال بدلا من افتراض أن كل قيمة سليمة يجب أن تكون من الإصدار 4. وبعد ذلك يمكن لتطبيقكم تطبيق سياسته الخاصة على الحقول المعادة.

التوحيد والأخطاء والاستخدام العملي

لا يغير التوحيد سوى حالة الحروف السداسية: تبقى المجموعات الخمس وكل الأرقام كما هي، بينما تتحول الحروف من A إلى F إلى حروف صغيرة. وهكذا تنتج كتابتان مقبولتان للقيمة ذاتها المؤلفة من 128 بت السلسلة القياسية نفسها تماما. لا يزيل المدقق المسافات ولا يصلح قيمة تكاد تكون صحيحة، لأن التنظيف التلقائي قد يخفي خللا عند حدود التسلسل. وبدلا من ذلك، تنتج القيمة الفارغة، والقيمة غير النصية، وعدد المحارف الخاطئ، والشرطات المزاحة، والمحارف الممنوعة رسائل تفسيرية مختلفة. يجعل هذا السلوك القدرة مناسبة لبوابات الاستيراد وتشخيص النماذج وبيانات الاختبار وأدوات الدعم التي يكون فيها السبب مهما بقدر نتيجة القبول أو الرفض. أرسلوا القيمة المرشحة في الحقل text؛ كما يقبل الاسمان البديلان uuid وvalue لتسهيل التكامل. تكلف العملية $0.002 لكل عنصر عبر API، وتعمل من دون شبكة أو عشوائية أو ساعة أو نموذج أو تخزين دائم. وهي تفحص البنية والبيانات الوصفية المضمنة فقط؛ فلا تحدد التفرد أو الملكية أو الوجود في قاعدة بيانات أو جودة التوليد أو الملاءمة لبروتوكول بعينه.