محول .properties إلى JSON

حول محول Properties إلى JSON

صيغة .properties الخاصة بجافا (key=value، أو key:value، أو key value، مع تعليقات # أو !) هي الصيغة المعيارية للإعدادات وحزم موارد الترجمة (i18n) منذ واجهة java.util.Properties المبكرة. تحلّل هذه الأداة تلك الصيغة وفق قواعد الصياغة التي تحددها java.util.Properties — بما في ذلك الأسطر المستمرة بشرطة مائلة عكسية في نهاية السطر، وهروبات يونيكود \uXXXX — وتنتج JSON يمكنك فحصه أو مقارنته أو تمريره إلى خط بناء JavaScript. تداخل المفاتيح المنقطة يحوّل app.cache.ttl=60 إلى { "app": { "cache": { "ttl": 60 } } }، واستنتاج الأنواع يحوّل "false" إلى قيمة منطقية حقيقية، ومعالجة التعليقات تضع أسطر # أو ! الواقعة مباشرة فوق الخاصية في حقل $comments.

كيفية تحويل .properties إلى JSON

1. 1

   الصق محتوى ملف .properties

   انسخ محتوى ملف .properties الخاص بك إلى لوحة الإدخال، أو اضغط على أيقونة القارورة لتحميل مثال يحتوي على تعليق ومفاتيح منقطة.

2. 2

   اضبط الخيارات المتقدمة عند الحاجة

   افتح الخيارات المتقدمة لتفعيل أو إيقاف استنتاج الأنواع، وتداخل المفاتيح المنقطة (وفاصلها)، وما إذا كانت التعليقات تُحفظ كحقل $comments أو تُتجاهل.

3. 3

   اضغط على تحويل

   يقرأ المحلّل الخصائص بترتيب ظهورها في الملف، فيضم الأسطر المستمرة ويفك هروبات مثل \uXXXX، ويربط التعليق الملاصق لخاصية بمفتاحها، ثم ينتج كائن JSON. يُعاد الحساب فورًا عند تغيير أي خيار.

4. 4

   انسخ أو نزّل JSON

   انسخ JSON أو نزّله كملف .json. استخدم أيقونة تبديل الاتجاه للانتقال إلى JSON إلى Properties لإجراء التحويل العكسي.

المراجع

• Java SE — java.util.Properties

  التوثيق الرسمي لواجهة برمجة تطبيقات جافا الذي يحدّد صيغة ملف .properties، بما في ذلك صياغة التعليقات والفواصل وقواعد استمرار الأسطر التي يتبعها هذا المحلّل.

• RFC 8259 — تنسيق تبادل بيانات JSON

  مواصفة IETF لتنسيق JSON الذي تنتجه هذه الأداة.

أدوات مطورين ذات صلة

أسئلة شائعة حول Properties إلى JSON

كيف أحوّل ملف .properties الخاص بجافا إلى JSON أونلاين؟

الصق محتوى ملف .properties في لوحة الإدخال ثم اضغط على تحويل. يتحول كل سطر key=value إلى حقل JSON، وتُتداخل المفاتيح المنقطة افتراضيًا. انسخ النتيجة أو نزّلها كملف .json.

هل تقرأ هذه الأداة ملفات .properties بالطريقة نفسها التي تقرؤها بها جافا؟

في قراءة المفاتيح والقيم نعم: يمكن الفصل بينهما بـ = أو : أو مسافة، وتبدأ التعليقات بـ # أو !، وتستمر القيمة في السطر التالي بشرطة مائلة عكسية في نهاية السطر، وتُفك هروبات \uXXXX. وإذا تكرر مفتاح فالقيمة الأخيرة هي المعتمدة كما في Properties.load. لكن JSON ليس نسخة كاملة من الملف: الأسطر الفارغة والتعليقات غير الملاصقة لخاصية لا تُحفظ.

هل يُرفع ملف .properties الخاص بي إلى خادم؟

لا. يتم كل التحليل محليًا داخل متصفحك باستخدام JavaScript — لا يُرسل شيء عبر الشبكة، وهذا مهم لملفات properties التي قد تحتوي على أسماء مضيفين داخلية أو بيانات اعتماد.

هل يمكنني تحويل مفاتيح .properties المنقطة إلى كائنات JSON متداخلة؟

نعم. مع تفعيل "مفاتيح منقطة ← متداخلة" (الفاصل الافتراضي هو ".")، يتحول مفتاح مثل server.port=8080 إلى { "server": { "port": 8080 } }. عطّله للإبقاء على المفتاح المنقط المسطّح كحقل JSON واحد بدلاً من ذلك.

هل يحافظ تحويل .properties إلى JSON على التعليقات؟

تُحفظ فقط التعليقات التابعة لخاصية: كتلة أسطر # أو ! الموجودة مباشرة فوق مفتاح، دون سطر فارغ بينهما، تُخزَّن في $comments تحت المسار المنقط لذلك المفتاح. أما ترويسة الملف، والتعليق الذي يليه سطر فارغ، والتعليق في آخر الملف، والأسطر الفارغة نفسها، فلا تُحفظ. غيّر التعليقات إلى "تجاهل" في الخيارات المتقدمة للحصول على كائن JSON يحتوي على القيم فقط.

كيف تُعالَج القيم المنطقية والرقمية في .properties؟

مع تفعيل استنتاج الأنواع، لا تصبح قيمةً منطقية إلا true وfalse بالضبط، ولا تصبح رقمًا إلا الأعداد العشرية البسيطة مثل 8080 أو 0.75. أما القيم التي سيتغير شكلها عند كتابتها نصًا من جديد — مثل 1.0 و007 ورقم إصدار مثل 1.2.3 — فتبقى نصوصًا. عطّل استنتاج الأنواع للإبقاء على كل قيمة نصًا.

ما الفرق بين .properties وJSON؟

ملفات .properties الخاصة بجافا نص سطري بصيغة مفتاح-قيمة يُستخدم لإعدادات التطبيقات وحزم موارد i18n، بينما يدعم JSON البنى المتداخلة والقيم المكتوبة (typed) بشكل أصلي. يتيح لك التحويل مقارنة ملفات properties كبيانات منظمة أو استيرادها إلى أدوات JavaScript/TypeScript التي تتوقّع JSON.