هذا هو الأمر japize الذي يمكن تشغيله في موفر الاستضافة المجاني OnWorks باستخدام إحدى محطات العمل المجانية المتعددة عبر الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
japize - قم بإنشاء قائمة بواجهة برمجة التطبيقات (API) بتنسيق يمكن قراءته آليًا.
موجز
japize [فك الضغط] [مثل ] أبيس العجل المقدس عند الفراعن | +|-
الوصف
japize هو جزء من japitools ، المصمم لاختبار التوافق بين واجهات برمجة تطبيقات Java.
لقد تم تصميمها في الأصل لاختبار التطبيقات المجانية لـ Java نفسها
التوافق مع JDK الخاص بشركة Sun، ولكن يمكن استخدامها أيضًا لاختبار التوافق مع الإصدارات السابقة
بين إصدارات أي API.
الأدوات هي japize وjapicompat. Japize هو برنامج Java يصدر قائمة بملفات
API بتنسيق يمكن قراءته آليًا. تقوم Japicompat بعد ذلك بأخذ قائمتين من هذا القبيل ومقارنتها
لهم من أجل التوافق الثنائي، كما هو محدد بواسطة Sun في مواصفات لغة Java.
واحد + على الأقل مطلوب. سيتم إلحاق ".japi" و/أو ".gz" باسم
المناسبة.
يمكن استبدال كلمة "apis" بكلمة "صراحة" أو "بالاسم" أو "الحزم" أو "الفئات". هؤلاء
تشير الخيارات إلى ما إذا كان ينبغي التعامل مع شيء من النموذج "abC" كفئة أو فئة
طَرد. يمكنك تحديد ذلك بشكل لا لبس فيه باستخدام أحد النماذج "abcpackage" أو
"أب، سي كلاس".
OPTIONS
بفك تعطيل ضغط الإخراج باستخدام gzip. يوصى بشدة بضغط الإخراج
لأنه يوفر كميات هائلة من المساحة. المواقف الوحيدة التي قد لا تريدها
لاستخدام ضغط gzip عندما يكون استخدام الذاكرة ووحدة المعالجة المركزية ضيقًا للغاية أو إذا كان
لا يقوم JVM الخاص بك بتنفيذ GZIPOutputStream بشكل صحيح (وفي هذه الحالة يمكنك
لا تزال ترغب في ضغط الملف الناتج يدويًا).
as
تحديد هذا الخيار يخبر japize بكتابة مخرجاته إلى ملف بامتداد
الاسم المحدد. عند الكتابة إلى ملف باستخدام خيار "as"، يصر japize على ذلك
الكتابة إلى اسم ملف ينتهي بـ .japi.gz للملفات المضغوطة، أو .japi لـ
ملفات غير مضغوطة. إذا كان اسم الملف الذي حددته لا يحتوي على الامتداد الصحيح،
سوف يقوم japize بإضافة أجزاء إليه للتأكد من ذلك.
إذا تم حذف الخيار "as"، فسوف يكتب japize إلى الإخراج القياسي. في هذه الحالة
ليس لدى japize أي سيطرة على اسم الملف الذي تستخدمه، ولكن يوصى بشدة بذلك
استخدم اسم ملف بالامتداد الصحيح (".japi.gz" ما لم يكن خيار "unzip" موجودًا
محدد). إذا كنت تستخدم أي امتداد آخر، فقد يكون japicompat والأدوات الأخرى كذلك
غير قادر على التعرف على الشكل.
أبيس العجل المقدس عند الفراعن | صراحة | بالاسم | حزم | فصول
هذا الخيار له دور مزدوج: فهو يشير إلى الحدود بين خيارات japize
(فك الضغط، as) والوسائط الأخرى (الملفات والحزم)، ولكنه يخبر أيضًا japize بكيفية القيام بذلك
التعامل مع الحجج المحددة بشكل غامض. راجع "+|- "أدناه للحصول على تفاصيل حول
سلوك كل خيار. إذا لم تكن متأكدًا مما يجب تحديده، فإن "apis" يعد مكانًا آمنًا
الاختيار.
أبيس العجل المقدس عند الفراعن
تمت تجربة abc كحزمة وفئة. هذا سوف يفعل دائما ما تريد
(وهذا هو سبب وصف واجهة برمجة التطبيقات بأنها الإعداد الافتراضي الآمن) ولكن على حساب احتمال
القيام بمعالجة إضافية غير ضرورية في محاولة للعثور على الشيء الخطأ.
صراحة
مسارات pkg للنموذج abc غير قانونية - يجب عليك استخدام النموذج الصريح.
بالاسم
ستتم معالجة abc كحزمة إذا كان "c" يبدأ بحرف صغير، أو كـ a
فئة إذا كانت تبدأ بحرف كبير. هذا عادة ما يفعل ما تريد لكنه يفشل
على أشياء مثل org.omg.CORBA.
حزم
ستتم معالجة abc كحزمة. إذا كانت هناك حاجة إلى معالجة لفئة ما، فيجب ذلك
أن يتم تحديدها صراحة.
فصول
ستتم معالجة ABC كفئة. إذا كانت هناك حاجة إلى معالجة الحزمة، فيجب ذلك
أن يتم تحديدها صراحة.
|
أي وسيطات بعد "apis" لا تبدأ بـ "+" أو "-" تعتبر كذلك
ملفات zip أو الدلائل. يجب أن يتم تحديدها تمامًا كما ستضعها فيها
CLASSPATH الخاص بك (باستثناء الفصل بمسافات بدلاً من النقطتين). أي شيء هذا أ
من المفترض أن يكون الملف ملفًا مضغوطًا (أو jar)، لذا لا يمكنك تحديد ملف .class
مباشرة - إذا كنت بحاجة إلى القيام بذلك فيجب عليك تحديد المجلد الذي يحتوي عليه و
ثم قم بتسمية الفصل للمعالجة.
+|-
لتحديد الفئات المضمنة، استخدم +pkgpath لإضافة pkgpaths المراد فحصها
و -pkgpath لاستبعاد المسارات الفرعية منها. يجب عليك تحديد واحد على الأقل
خيار +pkgpath لتحديد المسار الذي سيتم تضمينه، وإلا يمكن لـ Japize أن يسعد
قم بمسح جميع الملفات المضغوطة والأدلة ولكن لا تقوم فعليًا بمعالجة أي من ملفات
الطبقات. نظرًا لأن ذلك سيكون أمرًا عديم الفائدة، فإن japize يعطي خطأً بدلاً من ذلك.
يشير "pkgpath" إما إلى حزمة (والتي تتضمن، ضمنيًا، كافة العناصر الفرعية)
حزم منه) أو فئة واحدة. يبدو pkgpath للحزمة
"com.foo.pkg.sub"، ويبدو مسار pkg للفصل الدراسي مثل "com.foo.pkg,Cls". ال
يشير وجود الفاصلة وموضعها بشكل لا لبس فيه إلى نوع المسار
معد.
ومع ذلك، في معظم الأحيان، يكون من المؤلم وضع فواصل بين الأسماء
تعرف على النقاط بدلاً من ذلك، واحصل على موضع الفاصلة بشكل صحيح تمامًا. لهذا
لسبب ما، يقبل japize مسارات pkg التي تحتوي على نقاط فقط، ويتيح لك إخباره بما يريده
جعل من تلك الأسماء. يعتمد تفسير "abc" كمسار pkg على ما إذا كان
لقد حددت واجهة برمجة التطبيقات، بشكل صريح، بالاسم، أو الحزم، أو الفئات.
مثال
يتضمن Sun's JDK 1.1 فئات في java.awt.peer وفي java.text.resources التي ليست كذلك
جزء من واجهة برمجة التطبيقات العامة، على الرغم من أنها فئات عامة؛ ومع ذلك، كل فئة أخرى في
يعد التسلسل الهرمي لحزمة java.* جزءًا من واجهة برمجة التطبيقات العامة. بناء الجملة لبناء مفيدة
وبالتالي فإن jdk11.japi.gz سيكون:
$ japize كـ jdk11 apisclasses.zip +java -java.awt.peer -java.text.resources
لاحظ أنه نظرًا لأن جميع وسيطات pkgpath هنا عبارة عن حزم، فيمكنك حفظ كمية صغيرة منها
المعالجة عن طريق القيام بذلك بدلاً من ذلك:
$ japize كحزم jdk11classes.zip +java -java.awt.peer -java.text.resources
أو حتى هذا:
$ japize كـ jdk11 بشكل صريح Class.zip +java، -java.awt.peer، -java.text.resources،
استخدم japize عبر الإنترنت باستخدام خدمات onworks.net
