Package | mx.logging |
Classe | public class Log |
Héritage | Log Object |
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Les journaux sont des instances 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 : MiniDebugTarget
et TraceTarget
. Ces deux outils d’écriture recueillent les informations du journal actuel et les renvoient vers un dispositif d’affichage et/ou de stockage. Les cibles indiquent également quelles données de journal doivent être produites.
Méthode | Défini par | ||
---|---|---|---|
[statique]
Permet à la cible spécifiée de commencer à recevoir des notifications concernant les événements de journal. | Log | ||
[statique]
Cette méthode supprime du cache tous les journaux actifs. | Log | ||
[statique]
Renvoie le journal associé à la catégorie spécifiée. | Log | ||
[statique]
Cette méthode vérifie que la valeur de chaîne spécifiée ne contient pas de caractère non autorisé. | Log | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
[statique]
Indique si un événement de journal de niveau debug sera traité par une cible de journal. | Log | ||
[statique]
Indique si un événement de journal de niveau error sera traité par une cible de journal. | Log | ||
[statique]
Indique si un événement de journal de niveau fatal sera traité par une cible de journal. | Log | ||
[statique]
Indique si un événement de journal de niveau info sera traité par une cible de journal. | Log | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
[statique]
Indique si un événement de journal de niveau warn sera traité par une cible de journal. | Log | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
[statique]
Arrête la réception par la cible spécifiée des notifications concernant les événements de journal. | Log | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
addTarget | () | méthode |
public static function addTarget(target:mx.logging:ILoggingTarget):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Permet à la cible spécifiée de commencer à recevoir des notifications concernant les événements de journal.
Paramètres
target:mx.logging:ILoggingTarget — Cible spécifique devant collecter les événements de journal.
|
flush | () | méthode |
public static function flush():void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette méthode supprime du cache tous les journaux actifs. Les appels ultérieurs de la méthode getLogger()
renvoient de nouvelles instances des journaux et non des instances antérieures associées à la même catégorie. Cette méthode est conçue pour être utilisée uniquement à des fins de débogage.
getLogger | () | méthode |
public static function getLogger(category:String):ILogger
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Renvoie le journal associé à la catégorie spécifiée. Si la catégorie indiquée n’existe pas, une nouvelle instance du journal est renvoyée et associée à cette catégorie. Les noms des catégories doivent être composés d’au moins un caractère, mais ils ne peuvent contenir aucun espace, ni aucun des caractères suivants : []~$^&\/(){}<>+=`!#%?,:;’"@ Cette méthode renvoie une erreur InvalidCategoryError
si la syntaxe de la catégorie spécifiée n’est pas correcte.
Paramètres
category:String — Catégorie du journal à renvoyer.
|
ILogger — Instance d’un objet de journal pour le nom spécifié. Si le nom n’existe pas, une nouvelle instance portant le nom spécifié est renvoyée.
|
hasIllegalCharacters | () | méthode |
public static function hasIllegalCharacters(value:String):Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Cette méthode vérifie que la valeur de chaîne spécifiée ne contient pas de caractère non autorisé.
Paramètres
value:String — Chaîne dans laquelle les éventuels caractères non autorisés doivent être recherchés. Les caractères suivants ne sont pas valides : []~$^&\/(){}<>+=`!#%?,:;’"@
|
Boolean — true si au moins un caractère non autorisé est détecté ; false dans le cas contraire.
|
isDebug | () | méthode |
public static function isDebug():Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si un événement de journal de niveau debug sera traité par une cible de journal.
Valeur renvoyéeBoolean — true si un événement de journal de niveau debug sera consigné ; false dans le cas contraire.
|
isError | () | méthode |
public static function isError():Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si un événement de journal de niveau error sera traité par une cible de journal.
Valeur renvoyéeBoolean — true si un événement de journal de niveau error sera consigné ; false dans le cas contraire.
|
isFatal | () | méthode |
public static function isFatal():Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si un événement de journal de niveau fatal sera traité par une cible de journal.
Valeur renvoyéeBoolean — true si un événement de journal de niveau fatal sera consigné ; false dans le cas contraire.
|
isInfo | () | méthode |
public static function isInfo():Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si un événement de journal de niveau info sera traité par une cible de journal.
Valeur renvoyéeBoolean — true si un événement de journal de niveau info sera consigné ; false dans le cas contraire.
|
isWarn | () | méthode |
public static function isWarn():Boolean
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Indique si un événement de journal de niveau warn sera traité par une cible de journal.
Valeur renvoyéeBoolean — true si un événement de journal de niveau warn sera consigné ; false dans le cas contraire.
|
removeTarget | () | méthode |
public static function removeTarget(target:mx.logging:ILoggingTarget):void
Version du langage: | ActionScript 3.0 |
Version du produit: | Flex 3 |
Versions du moteur d’exécution: | Flash Player 9, AIR 1.1 |
Arrête la réception par la cible spécifiée des notifications concernant les événements de journal.
Paramètres
target:mx.logging:ILoggingTarget — Cible spécifique devant collecter les événements de journal.
|
Tue Jun 12 2018, 09:30 AM Z