تسجيل أباتشي كومنز
أباتشي كومنز لوجينج (المعروف سابقًا باسم جاكرتا كومنز لوجينج أو JCL ) هو أداة تسجيل بيانات مبنية على لغة جافا ، ونموذج برمجي لتسجيل البيانات ولأدوات أخرى. يوفر واجهات برمجة تطبيقات (APIs) وتطبيقات تسجيل بيانات، بالإضافة إلى تطبيقات تغليف لبعض الأدوات الأخرى. [ 1 ] [ 2 ] [ 3 ]
مستوى التسجيل
يوضح الجدول التالي مستويات التسجيل والرسائل في نظام تسجيل Apache Commons Logging، مرتبة تنازليًا حسب درجة الخطورة. يسرد العمود الأيسر رمز مستوى التسجيل، بينما يقدم العمود الأيمن وصفًا موجزًا لكل مستوى.
| مستوى | وصف |
|---|---|
| مميت | أخطاء جسيمة تؤدي إلى إنهاء مبكر. من المتوقع أن تظهر هذه الأخطاء فورًا على شاشة الحالة. |
| خطأ | أخطاء أخرى أثناء التشغيل أو ظروف غير متوقعة. من المتوقع أن تظهر هذه الأخطاء فورًا على شاشة الحالة. |
| تحذير | استخدام واجهات برمجة التطبيقات القديمة، وسوء استخدام واجهات برمجة التطبيقات، والأخطاء "شبه" واردة، وغيرها من حالات التشغيل غير المرغوب فيها أو غير المتوقعة، ولكنها ليست بالضرورة "خاطئة". توقع أن تظهر هذه الأمور فورًا على لوحة التحكم. |
| معلومات | أحداث وقت التشغيل المهمة (بدء التشغيل/إيقاف التشغيل). من المتوقع أن تظهر هذه الأحداث فورًا على وحدة التحكم، لذا كن حذرًا واحرص على تقليلها قدر الإمكان. |
| تصحيح الأخطاء | معلومات تفصيلية حول تدفق البيانات عبر النظام. من المتوقع أن تُسجل هذه المعلومات في سجلات النظام فقط. |
| يتعقب | معلومات مفصلة للغاية. من المتوقع أن تُكتب هذه المعلومات في سجلات النظام فقط. |
[ 3 ] [ 4 ]
إعدادات
يتم استخدام مفهومين أساسيين للتجريد، وهما Log و LogFactory، في Apache Commons Logging. [ 3 ]
مثال
قد يبدو نموذج الكود كما يلي:
الحزمة com.cascadetg.ch09 ؛استيراد org.apache.commons.logging.Log ؛ استيراد org.apache.commons.logging.LogFactory ؛ استيراد org.apache.commons.logging.impl.Jdk14Logger ؛public class LogGenerator { // لاحظ أنك تمرر نسخة من هذه الفئة إلى // مولد السجلات. هذا يسمح لك بالعثور على الرسائل // التي تم إنشاؤها بواسطة هذه الفئة. private static Log log = LogFactory.getLog ( LogGenerator.class ) ;public static void configJDKLogger ( ) { try { ( ( Jdk14Logger ) log ) .getLogger ( ) . setLevel ( java.util.logging.Level.ALL ) ; ( ( Jdk14Logger ) log ) .getLogger ( ) . addHandler ( ( java.util.logging.FileHandler ) Class.forName ( " java.util.logging.FileHandler " ) . newInstance ( ) ) ;System.out.println ( " تمت إضافة معالج ملفات JDK 1.4" ) ; } catch ( Exception e ) { System.out.println ( " تعذر تحميل تسجيل JDK 1.4. " ) ; e.printStackTrace ( ) ; } }public static void main ( String [] args ) { configJDKLogger (); System . setErr ( System . out );System.out.println ( ) ; System.out.println ( " Test fatal log " ) ;حاول { سلسلة نصية foo = null ؛ عدد صحيح x = 0 / ( عدد صحيح جديد ( foo )). intValue ()؛ } أمسك ( استثناء e ) { سجل . خطأ فادح ( e . getMessage (), e )؛ }System.out.println ( ) ; System.out.println ( " سجل أخطاء الاختبار " ) ;حاول { الكائن foo = null ؛ foo.toString ( ) ؛ } catch ( استثناء e ) { log.error ( e.getMessage ( ) , e ) ؛ }System.out.println ( ); System.out.println ( " Test warn log" ) ; try { Class.forName ( " com.cascadetg.NonexistentClass " ) ; } catch ( Exception e ) { log.warn ( " Ca n't find a nonexistent class!" ) ; }System.out.println ( ) ; System.out.println ( " سجل معلومات الاختبار " ) ;log.info ( "جاري تشغيل التطبيق!" ) ; log.info ( " جاري إغلاق التطبيق! " ) ;System.out.println ( ) ; System.out.println ( " سجل تصحيح الأخطاء للاختبار " ) ;إذا كان ( 1 > 2 ) { log.debug ( " 1 > 2 تم تقييمه بشكل صحيح" ); إذا كان ( 10 % 2 == 0 ) log.debug ( "10 % 2 يساوي 0" ) ; وإلا log.debug ( " 10 % 2 لا يساوي 0" ); } وإلا { log.debug ( " 1 > 2 تم تقييمه بشكل خاطئ" ) ; }System.out.println ( ) ; System.out.println ( " سجل تتبع الاختبار " ) ;log.trace ( " استدعاء دالة التتبع." ) ; log.trace ( " استدعاء دالة التتبع."); log.trace("استدعاء دالة التتبع . " ) ; log.trace("استدعاء دالة التتبع . " ) ; log.trace ( " استدعاء دالة التتبع . " ) ;System.out.println ( ) ; System.out.println ( " اكتمل اختبار السجل . " ) ; } }[ 4 ]
انظر أيضاً
- log4j
- برنامج عرض ملفات السجل (Chainsaw)
- مكتبة commons-logging على GitHub
مراجع
- ↑ "تسجيل البيانات المشتركة" . Apache.org . Apache . تم الاطلاع عليه بتاريخ 12 فبراير 2016 .
- ↑ زافالا، د.أ.؛ لاو، ي.س. (2004). دمج نظام تسجيل جاكرتا كومنز مع خادم تطبيقات آي بي إم ويب سفير الإصدار 5. شركة آي بي إم. ص 2.
- 1 2 3 "المحتويات" . Apache.org . Apache . تم الاسترجاع في 12 فبراير 2016 .
- 1 2 إيفرسون، دبليو. (2005). أباتشي جاكرتا كومنز - مكونات جافا قابلة لإعادة الاستخدام . كروفوردسفيل، إنديانا، الولايات المتحدة الأمريكية: بيرسون إديوكيشن، إنك. ص 120-122 .
روابط خارجية
فئات :
- مؤسسة برمجيات أباتشي
- برنامج مجاني مكتوب بلغة جافا
- تنسيقات ملفات السجل
- برنامج يستخدم ترخيص أباتشي
- أباتشي كومنز
