Το εργαλείο ανάλυσης αρχείων καταγραφής και ιχνηλασίας παρέχει υποστήριξη ανεξάρτητων και πρόσθετων λειτουργιών για τα ακόλουθα βοηθητικά προγράμματα καταγραφής:
Η υποστήριξη περιλαμβάνει:
Αυτή η υποστήριξη παρέχεται από τις ακόλουθες πρόσθετες λειτουργίες:
Βοηθητικό πρόγραμμα καταγραφής |
JAR πρόσθετων λειτουργιών |
---|---|
Καταγραφή Java (JSR-047) |
org.eclipse.hyades.logging.core\hl14.jar |
Καταγραφή Apache Jakarta Commons |
org.eclipse.hyades.logging.core\hlcommons.jar |
Καταγραφή Apache Jakarta Log4J |
org.eclipse.hyades.logging.core\hllog4j.jar |
EMF Common Base Event V1.0.1 |
org.eclipse.hyades.logging.core\hlcbe101.jar |
Στις παρακάτω ενότητες περιγράφονται οι λεπτομέρειες κάθε είδους υποστήριξης βοηθητικού προγράμματος καταγραφής και παρέχονται δείκτες για δείγματα του τρόπου χρήσης τους.
Μια επέκταση της κλάσης java.util.logging.LogRecord κάτω από το πακέτο org.eclipse.hyades.logging.java14 σας επιτρέπει να δημιουργήσετε μια προσαρμοσμένη εγγραφή αρχείου καταγραφής για την καταγραφή ενός org.eclipse.hyades.logging.events.cbe.CommonBaseEvent σε μια java.util.logging.LogRecord. Το πακέτο org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord επεκτείνει την κλάση java.util.logging.LogRecord και περιέχει παραπομπή σε ένα org.eclipse.hyades.logging.events.cbe.CommonBaseEvent. Όλες οι ιδιότητες java.util.logging.LogRecord αντιστοιχούνται σε μία ή περισσότερες ιδιότητες Common Base Event για τη διατήρηση ανακλαστικής ιδιότητας για ρουτίνες χειρισμού και λειτουργίες μορφοποίησης που δεν αφορούν Common Base Event.
Μια υλοποίηση της διεπαφής java.util.logging.Filter κάτω από το πακέτο org.eclipse.hyades.logging.java14 μόνο επιτρέπει την επιτυχή καταγραφή των org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord.
Μια επέκταση της αφηρημένης κλάσης java.util.logging.Formatter κάτω από το πακέτο org.eclipse.hyades.logging.java14 σας επιτρέπει να ρυθμίσετε τις ρουτίνες χειρισμού για τη μορφοποίηση των μηνυμάτων καταγραφής org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord και java.util.logging.LogRecord σε XML. Η λειτουργία μορφοποίησης org.eclipse.hyades.logging.java14.XmlFormatter μετατρέπει το μήνυμα καταγραφής org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ή java.util.logging.LogRecord σε XML με βάση το σχήμα Common Base Event v1.0.1. Κατά τη μορφοποίηση, το μήνυμα καταγραφής ελέγχεται αν υλοποιεί τη διεπαφή org.eclipse.hyades.logging.core.IExternalizableToXml (π.χ. org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord). Αν ναι, καλείται το ΑΡΙ externalizeCanonicalXmlString() στη θέση της τοποθέτησης σε σειριακή διάταξη XML. Διαφορετικά, το μήνυμα καταγραφής java.util.logging.LogRecord μετατρέπεται σε αντικείμενο Common Base Event χρησιμοποιώντας την ίδια αντιστοίχιση όπως το org.eclipse.hyades.logging.events.cbe.CommonBaseEvent και τοποθετείται σε σειριακή διάταξη XML καλώντας το ΑΡΙ externalizeCanonicalXmlString().
Μια επέκταση της αφηρημένης κλάσης java.util.logging.Handler κάτω από το πακέτο org.eclipse.hyades.logging.java σας επιτρέπει να ρυθμίσετε τις λειτουργίες για την καταγραφή των μηνυμάτων org.eclipse.hyades.logging.events.cbe.CommonBaseEvent και java.util.logging.LogRecord σε μια ρουτίνα καταγραφής.
Η ρουτίνα χειρισμού org.eclipse.hyades.logging.java.LoggingAgentHandler ελέγχει αν το μήνυμα καταγραφής org.eclipse.hyades.logging.java14.CommonBaseEventLogRecord ή java.util.logging.LogRecord που έχει καταγραφεί σε μια λειτουργία μπορεί να καταγραφεί με βάση το φίλτρο της λειτουργίας και της ρουτίνας χειρισμού, και το επίπεδο καταγραφής. Αν το μήνυμα πρέπει να καταγραφεί, αναλύεται μια ρουτίνα καταγραφής με το ίδιο όνομα όπως και η λειτουργία που καταγράφει το μήνυμα. Διαφορετικά, μπορείτε να χρησιμοποιήσετε τη ρουτίνα χειρισμού org.eclipse.hyades.logging.java.SingleLoggingAgentHandler, η οποία δημιουργεί μια ρουτίνα καταγραφής, με το όνομα Logging Agent Handler. Το μήνυμα είναι μορφοποιημένο σε XML χρησιμοποιώντας org.eclipse.hyades.logging.java.XmlFormatter και γραμμένο σε ρουτίνα καταγραφής.
Χαρακτηριστικό δείγμα
Παρέχεται ένα δείγμα το οποίο μπορείτε να δείτε πώς ενισχύεται η υποστήριξη για καταγραφή Java JSR-047. Στο δείγμα φαίνεται η απαιτούμενη ρύθμιση και ενοργάνωση για τους νέους και απαιτούμενους χρήστες της υποστήριξης ανεξάρτητων και πρόσθετων λειτουργιών για καταγραφή JSR-047. Για περισσότερες πληροφορίες, ανατρέξτε στο σχετικό δείγμα επιλέγοντας Αρχείο > Δημιουργία > Παράδειγμα... > Δείγμα καταγραφής JSR-047.
Η υλοποίηση της διεπαφής org.apache.commons.logging.Log κάτω από το πακέτο org.eclipse.hyades.logging.commons σας επιτρέπει να δημιουργήσετε μια λειτουργία για την καταγραφή των μηνυμάτων org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object και java.lang.Throwable. Αυτή η org.eclipse.hyades.logging.commons.Logger ελέγχει να δει αν το μήνυμα καταγραφής org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Objectή java.lang.Throwable που καταγράφεται σε μια λειτουργία μπορεί να καταγραφεί στο επίπεδο καταγραφής της λειτουργίας. Αν το μήνυμα πρέπει να καταγραφεί, τα μηνύματα org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ή java.lang.Throwable μορφοποιούνται και καταγράφονται. Παρέχεται μια υλοποίηση της αφηρημένης κλάσης org.apache.commons.logging.LogFactory που αναπαριστά μια μέθοδο κατασκευής ενδιάμεσου εξυπηρετητή για χρήσεις org.eclipse.hyades.logging.commons.Logger. Αυτή η μέθοδος κατασκευής ενδιάμεσου εξυπηρετητή org.eclipse.hyades.logging.commons.LoggerFactory προορίζεται για χρήση σε πολλαπλά περιβάλλοντα φορτωτή κλάσεων όπου απαιτούνται ένα ή περισσότερα διαφορετικά είδη λειτουργιών καταγραφής και οι μέθοδοι κατασκευής τους για κάθε ξεχωριστό φορτωτή κλάσεων, το σύνολο των οποίων χρησιμοποιεί τα ίδια δυαδικά Apache Commons.
Η org.eclipse.hyades.logging.commons.Logger μορφοποιεί τα μηνύματα καταγραφής org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object και java.lang.Throwable σε XML με βάση το σχήμα Common Base Event v1.0.1. Κατά τη μορφοποίηση, το μήνυμα καταγραφής ελέγχεται αν υλοποιεί τη διεπαφή org.eclipse.hyades.logging.core.IExternalizableToXml (για παράδειγμα, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Αν ναι, καλείται το ΑΡΙ externalizeCanonicalXmlString() στη θέση της τοποθέτησης σε σειριακή διάταξη XML. Διαφορετικά, το μήνυμα καταγραφής java.lang.Object ή java.lang.Throwable μετατρέπεται σε αντικείμενο Common Base Event χρησιμοποιώντας τις μεθόδους org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() και τοποθετείται σε σειριακή διάταξη XML καλώντας το ΑΡΙ externalizeCanonicalXmlString().
Η org.eclipse.hyades.logging.commons.Logger καταγράφει τα μηνύματα org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object και java.lang.Throwable σε μια ρουτίνα καταγραφής. Αν το μήνυμα πρέπει να καταγραφεί, αναλύεται μια ρουτίνα καταγραφής με το ίδιο όνομα όπως και η λειτουργία που καταγράφει το μήνυμα. Το μήνυμα μορφοποιείται σε XML και γράφεται στη ρουτίνα καταγραφής.
Η υλοποίηση της διεπαφής org.apache.commons.logging.Log κάτω από το πακέτο org.eclipse.hyades.logging.commons σας επιτρέπει να δημιουργήσετε μια λειτουργία για την καταγραφή των μηνυμάτων org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object και java.lang.Throwable σε τοπικό αρχείο. Αυτή η org.eclipse.hyades.logging.commons.FileLogger ελέγχει να δει αν το μήνυμα καταγραφής org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Objectή java.lang.Throwable που καταγράφεται σε μια λειτουργία μπορεί να καταγραφεί στο επίπεδο καταγραφής της λειτουργίας. Αν το μήνυμα πρέπει να καταγραφεί, τα μηνύματα org.eclipse.hyades.logging.events.cbe.CommonBaseEvent, java.lang.Object ή java.lang.Throwable μορφοποιούνται σε XML και καταγράφονται σε τοπικό αρχείο. Παρέχεται μια υλοποίηση της αφηρημένης κλάσης org.apache.commons.logging.LogFactory που αναπαριστά μια μέθοδο κατασκευής ενδιάμεσου εξυπηρετητή για χρήσεις org.eclipse.hyades.logging.commons.FileLogger. Αυτή η μέθοδος κατασκευής ενδιάμεσου εξυπηρετητή org.eclipse.hyades.logging.commons.FileLoggerFactory προορίζεται για χρήση σε πολλαπλά περιβάλλοντα φορτωτή κλάσεων όπου απαιτούνται ένα ή περισσότερα διαφορετικά είδη λειτουργιών καταγραφής και οι μέθοδοι κατασκευής τους για κάθε ξεχωριστό φορτωτή κλάσεων, το σύνολο των οποίων χρησιμοποιεί τα ίδια δυαδικά Apache Commons.
Χαρακτηριστικό δείγμα
Παρέχεται ένα δείγμα το οποίο μπορείτε να δείτε πώς ενισχύεται η υποστήριξη για καταγραφή Apache Jakarta Commons. Στο δείγμα φαίνεται η απαιτούμενη ρύθμιση και ενοργάνωση για τους νέους και απαιτούμενους χρήστες της υποστήριξης ανεξάρτητων και πρόσθετων λειτουργιών για καταγραφή Apache Jakarta Commons. Για περισσότερες πληροφορίες, ανατρέξτε στο χαρακτηριστικό δείγμα επιλέγοντας Αρχείο > Δημιουργία > Παράδειγμα... > Δείγμα καταγραφής Apache Commons.
Η ιδιότητα του μηνύματος καταγραφής org.apache.log4j.spi.LoggingEvent σας επιτρέπει να καταγράψετε ένα org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Μια επέκταση της αφηρημένης κλάσης org.apache.log4j.spi.Filter κάτω από το πακέτο org.eclipse.hyades.logging.log4j επιτρέπει μόνο την επιτυχή καταγραφή των org.eclipse.hyades.logging.events.cbe.CommonBaseEvent.
Μια επέκταση της αφηρημένης κλάσης org.apache.log4j.Layout κάτω από το πακέτο org.eclipse.hyades.logging.log4j σας επιτρέπει να ρυθμίσετε τις λειτουργίες προσάρτησης για τη μορφοποίηση των μηνυμάτων καταγραφής org.eclipse.hyades.logging.events.cbe.CommonBaseEvent και org.apache.log4j.spi.LoggingEvent σε XML. Η λειτουργία μορφοποίησης org.eclipse.hyades.logging.log4j.XmlLayout μετατρέπει τα μηνύματα καταγραφής org.eclipse.hyades.logging.events.cbe.CommonBaseEvent ή org.apache.log4j.spi.LoggingEvent σε XML με βάση το σχήμα Common Base Event v1.0.1. Κατά τη μορφοποίηση, το μήνυμα καταγραφής ελέγχεται αν η ιδιότητα μηνύματος του org.apache.log4j.spi.LoggingEvent υλοποιεί τη διεπαφή org.eclipse.hyades.logging.core.IExternalizableToXml (για παράδειγμα, org.eclipse.hyades.logging.events.cbe.CommonBaseEvent). Αν ναι, καλείται το ΑΡΙ externalizeCanonicalXmlString() στη θέση της τοποθέτησης σε σειριακή διάταξη XML. Διαφορετικά, το μήνυμα καταγραφής org.apache.log4j.spi.LoggingEvent μετατρέπεται σε αντικείμενο Common Base Event χρησιμοποιώντας τις μεθόδους org.eclipse.hyades.logging.events.cbe.util.EventHelpers.convertObjectToCommonBaseEvent() και τοποθετείται σε σειριακή διάταξη XML καλώντας το ΑΡΙ externalizeCanonicalXmlString().
Μια επέκταση της αφηρημένης κλάσης org.apache.log4j.AppenderSkeleton κάτω από το πακέτο org.eclipse.hyades.logging.log4j επιτρέπει τη ρύθμιση των λειτουργιών για την καταγραφή των μηνυμάτων org.eclipse.hyades.logging.events.cbe.CommonBaseEvent και org.apache.log4j.spi.LoggingEvent σε μια ρουτίνα καταγραφής.
Η λειτουργία προσάρτησης org.eclipse.hyades.logging.log4j.LoggingAgentAppender ελέγχει αν τα μηνύματα καταγραφής org.eclipse.hyades.logging.events.cbe.CommonBaseEvent και org.apache.log4j.spi.LoggingEvent που έχουν καταγραφεί σε μια λειτουργία καταγραφής μπορούν να καταγραφούν με βάση το φίλτρο της λειτουργίας και της λειτουργίας προσάρτησης, και το επίπεδο καταγραφής. Αν το μήνυμα πρέπει να καταγραφεί, αναλύεται μια ρουτίνα καταγραφής με το ίδιο όνομα όπως και η λειτουργία που καταγράφει το μήνυμα. Διαφορετικά, μπορείτε να χρησιμοποιήσετε τη λειτουργία προσάρτησης org.eclipse.hyades.logging.java.SingleLoggingAgentAppender, η οποία δημιουργεί μια ρουτίνα καταγραφής, με το όνομα Logging Agent Appender. Το μήνυμα είναι μορφοποιημένο σε XML χρησιμοποιώντας org.eclipse.hyades.logging.log4j.XmlLayout και γραμμένο στη ρουτίνα καταγραφής.
Χαρακτηριστικό δείγμα
Παρέχεται ένα δείγμα το οποίο μπορείτε να δείτε πώς ενισχύεται η υποστήριξη για καταγραφή Apache Jakarta Log4J. Στο δείγμα φαίνεται η απαιτούμενη ρύθμιση και ενοργάνωση για τους νέους και απαιτούμενους χρήστες της υποστήριξης ανεξάρτητων και πρόσθετων λειτουργιών για καταγραφή Apache Jakarta Log4J. Για περισσότερες πληροφορίες, ανατρέξτε στο χαρακτηριστικό δείγμα επιλέγοντας Αρχείο > Δημιουργία > Παράδειγμα... > Δείγμα καταγραφής Apache Log4J.
Χαρακτηριστικό δείγμα
Παρέχεται ένα δείγμα το οποίο μπορείτε να δείτε πώς μπορείτε να ενισχύσετε την υποστήριξη για το EMF Common Base Events με τη δημιουργία και τη ρύθμιση Common Base Events με τη χρήση της μεθόδου κατασκευής συμβάντων του προτύπου αρχείου XML Common Base Event. Για περισσότερες πληροφορίες, ανατρέξτε στο χαρακτηριστικό δείγμα επιλέγοντας Αρχείο > Δημιουργία > Παράδειγμα... > Δείγμα EMF Common Base Event v1.0.1.
Σχετικές έννοιες
Μοντέλο Common Base Event
(C) Copyright IBM Corporation 2000, 2006. Με την επιφύλαξη παντός δικαιώματος.