REMARQUE : les descendants doivent utiliser une autre méthode pour qu’elle soit utile.
Chaque journal appartient à une catégorie. Par convention, ces catégories sont mappées au nom qualifié complet de la classe dans laquelle le journal est utilisé. Par exemple, un journal qui consigne les messages pour la classe
Par exemple :
var traceLogger:ILoggingTarget = new TraceTarget(); traceLogger.filters = ["mx.rpc.~~", "mx.messaging.~~"]; Log.addTarget(traceLogger);
Remarque : cette méthode est appelée par la structure ; vous ne devez pas l’appeler manuellement.
Remarque : cette méthode est appelée par la structure ; vous ne devez pas l’appeler manuellement.
Chaque journal appartient à une catégorie. Par convention, ces catégories sont mappées au nom qualifié complet de la classe dans laquelle le journal est utilisé. Par exemple, un journal qui consigne les messages pour la classe
var traceLogger:ILoggingTarget = new TraceTarget(); traceLogger.filters = [ "mx.rpc.~~", "mx.messaging.~~" ]; Log.addTarget(traceLogger);
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
// Get the logger for the mx.messaging.Channel "category" // and send some data to it. var logger:ILogger = Log.getLogger("mx.messaging.Channel"); logger.debug("here is some channel info {0} and {1}", 15.4, true); // This will log the following String: // "here is some channel info 15.4 and true"
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
// Get the logger for the mx.messaging.Channel "category" // and send some data to it. var logger:ILogger = Log.getLogger("mx.messaging.Channel"); logger.error("here is some channel info {0} and {1}", 15.4, true); // This will log the following String: // "here is some channel info 15.4 and true"
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
// Get the logger for the mx.messaging.Channel "category" // and send some data to it. var logger:ILogger = Log.getLogger("mx.messaging.Channel"); logger.fatal("here is some channel info {0} and {1}", 15.4, true); // This will log the following String: // "here is some channel info 15.4 and true"
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
// Get the logger for the mx.messaging.Channel "category" // and send some data to it. var logger:ILogger = Log.getLogger("mx.messaging.Channel"); logger.info("here is some channel info {0} and {1}", 15.4, true); // This will log the following String: // "here is some channel info 15.4 and true"
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
// Get the logger for the mx.messaging.Channel "category" // and send some data to it. var logger:ILogger = Log.getLogger("mx.messaging.Channel"); logger.log(LogEventLevel.DEBUG, "here is some channel info {0} and {1}", LogEventLevel.DEBUG, 15.4, true); // This will log the following String as a DEBUG log message: // "here is some channel info 15.4 and true"
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
// Get the logger for the mx.messaging.Channel "category" // and send some data to it. var logger:ILogger = Log.getLogger("mx.messaging.Channel"); logger.warn("here is some channel info {0} and {1}", 15.4, true); // This will log the following String: // "here is some channel info 15.4 and true"
Les journaux sont des occurrences singleton créées pour une catégorie d’informations particulière. En général, la catégorie correspond au nom de package du composant souhaitant consigner des informations. La catégorie permet aux utilisateurs d’indiquer quelles informations les intéressent. Il est possible de sélectionner et d’associer plusieurs catégories à l’aide d’expressions régulières. Ainsi, l’utilisateur peut configurer la collecte d’informations de journalisation plus ou moins précises. Imaginons par exemple que vous souhaitez collecter toutes les informations de journalisation des packages « mx.messaging » et « mx.rpc » et générer la sortie de ces packages au format XML. Pour collecter toutes les informations de journalisation de la catégorie « mx.messaging », sous-packages et composants y compris, vous devez utiliser une expression générique, par exemple « mx.messaging.~~ ». Pour plus d’informations, voir l’exemple de code ci-dessous.
Les cibles fournissent le mécanisme de sortie des données consignées. En général, ce mécanisme porte sur le formatage, la transmission ou le stockage, mais toutes les possibilités offertes par la VM sont envisageables. Deux cibles sont fournies :
... import mx.logging.targets. import mx.logging. private function initLogging():void { // Create a target. var logTarget:TraceTarget = new TraceTarget(); // Log only messages for the classes in the mx.rpc.and // mx.messaging packages. logTarget.filters=["mx.rpc.,"mx.messaging.]; // Log all log levels. logTarget.level = LogEventLevel.ALL; // Add date, time, category, and log level to the output. logTarget.includeDate = true; logTarget.includeTime = true; logTarget.includeCategory = true; logTarget.includeLevel = true; // Begin logging. Log.addTarget(logTarget); } ...
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.
La chaîne spécifiée pour la journalisation peut contenir des accolades entourant un index indiquant les paramètres supplémentaires à insérer dans la chaîne avant de la consigner. Exemple : « le premier paramètre supplémentaire était {0} et le deuxième {1} » devient « le premier paramètre supplémentaire était 10 et le deuxième 15 » lors d’un appel utilisant 10 et 15 comme paramètres.