Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
mx.logging 

AbstractTarget  - AS3 Flex

Packagemx.logging
Classepublic class AbstractTarget
HéritageAbstractTarget Inheritance Object
Implémente ILoggingTarget, IMXMLObject
Sous-classes LineFormattedTarget

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Cette classe fournit la fonctionnalité de base requise par la structure de journalisation d’une implémentation cible. Elle gère la validation des expressions de filtrage et fournit une propriété de niveau par défaut. Aucune implémentation de la méthode logEvent() n’est fournie.



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
  filters : Array
Les filtres sont utilisés conjointement avec le paramètre level pour fournir un mappage pseudo-hiérarchique permettant de traiter uniquement les événements d’une certaine catégorie.
AbstractTarget
  id : String
[lecture seule] Permet d’accéder à l’ID de cette cible.
AbstractTarget
  level : int
Permet d’accéder au niveau actuel de cette cible.
AbstractTarget
Méthodes publiques
 MéthodeDéfini par
  
Constructeur.
AbstractTarget
  
Configure le journal spécifié pour cette cible
AbstractTarget
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
  
Appelé une fois que l’objet d’implémentation a été créé et que toutes les propriétés spécifiées sur la balise ont été affectées.
AbstractTarget
 Inherited
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
  
Cette méthode traite un événement LogEvent issu d’un journal associé.
AbstractTarget
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
  
Arrête la réception par cette cible des événements du journal spécifié.
AbstractTarget
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
Détails de la propriété

filters

propriété
filters:Array

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Les filtres sont utilisés conjointement avec le paramètre level pour fournir un mappage pseudo-hiérarchique permettant de traiter uniquement les événements d’une certaine catégorie.

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 mx.rpc.soap.WebService utilise "mx.rpc.soap.WebService" comme paramètre de l’appel de méthode Log.getLogger(). Lorsque des messages sont envoyés dans cette catégorie, seules les cibles dont le filtre correspond à la catégorie reçoivent une notification concernant ces événements. Les expressions de filtrage peuvent inclure un caractère de correspondance générique, indiqué par un astérisque. Le caractère générique doit être le caractère le plus à droite dans l’expression. Exemple : rpc*, mx.* ou *. Si une expression non valide est spécifiée, une erreur InvalidFilterError est renvoyée. Si les valeurs null ou [] sont spécifiées, les filtres prennent par défaut la valeur ["*"].

Par exemple :

               var traceLogger:ILoggingTarget = new TraceTarget();
               traceLogger.filters = ["mx.rpc.*", "mx.messaging.*"];
               Log.addTarget(traceLogger);
         



Implémentation
    public function get filters():Array
    public function set filters(value:Array):void

id

propriété 
id:String  [lecture seule]

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Permet d’accéder à l’ID de cette cible. L’ID est affecté au moment de l’exécution par le compilateur mxml s’il est utilisé comme balise mxml ou en interne s’il est utilisé dans un bloc de script.



Implémentation
    public function get id():String

level

propriété 
level:int

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Permet d’accéder au niveau actuel de cette cible. Valeurs valides :

  • LogEventLevel.FATAL (1000) désigne les événements dangereux qui provoquent au final un échec de l’application.
  • LogEventLevel.ERROR (8) désigne les événements d’erreur susceptibles de permettre la poursuite de l’exécution de l’application.
  • LogEventLevel.WARN (6) désigne les événements susceptibles d’empêcher le bon fonctionnement de l’application.
  • LogEventLevel.INFO (4) désigne les messages d’information indiquant la progression générale de l’application.
  • LogEventLevel.DEBUG (2) désigne les messages d’information détaillés, qui sont particulièrement utiles lors du débogage d’une application.
  • LogEventLevel.ALL (0) permet de forcer une cible à traiter tous les messages.



Implémentation
    public function get level():int
    public function set level(value:int):void
Détails du constructeur

AbstractTarget

()Constructeur
public function AbstractTarget()

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Constructeur.

Détails de la méthode

addLogger

()méthode
public function addLogger(logger:ILogger):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Configure cette cible de sorte qu’elle utilise le journal spécifié. Permet à cette cible de recevoir les événements consignés du journal spécifié.

Paramètres

logger:ILogger — Journal ILogger devant être écouté par cette cible.

initialized

()méthode 
public function initialized(document:Object, id:String):void

Version du langage: ActionScript 3.0
Version du produit: Flex 3
Versions du moteur d’exécution: Flash Player 9, AIR 1.1

Appelé une fois que l’objet d’implémentation a été créé et que toutes les propriétés spécifiées sur la balise ont été affectées.

Paramètres

document:Object — Document MXML qui a créé cet objet.
 
id:String — Utilisé par le document pour faire référence à cet objet. Si l’objet est une propriété profonde du document, la valeur de l’ID est null.

logEvent

()méthode 
public function logEvent(event:LogEvent):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 traite un événement LogEvent issu d’un journal associé. Une cible utilise cette méthode pour convertir l’événement au format adapté à la transmission, au stockage ou à l’affichage. Cette méthode est appelée uniquement si le niveau de l’événement est dans la zone de portée du niveau de la cible.

REMARQUE : les descendants doivent utiliser une autre méthode pour qu’elle soit utile.

Paramètres

event:LogEvent — Evénement issu d’un journal associé.

removeLogger

()méthode 
public function removeLogger(logger:ILogger):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 cette cible des événements du journal spécifié.

Paramètres

logger:ILogger — Journal ILogger devant être ignoré par cette cible.





[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.