FileHandler Classe

Définition

[Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)]
public class FileHandler : Java.Util.Logging.StreamHandler

[<Android.Runtime.Register("java/util/logging/FileHandler", DoNotGenerateAcw=true)>]
type FileHandler = class
    inherit StreamHandler

Héritage

Object

JavaObject

Object

Handler

StreamHandler

FileHandler

Attributs

RegisterAttribute

Remarques

Journalisation Handlerde fichiers simple .

Il FileHandler peut écrire dans un fichier spécifié ou écrire dans un ensemble de fichiers pivotant.

Pour un ensemble de fichiers pivotant, à mesure que chaque fichier atteint une limite de taille donnée, il est fermé, pivoté et un nouveau fichier ouvert. Les fichiers plus anciens sont successivement nommés en ajoutant « 0 », « 1 », « 2 », etc. dans le nom de fichier de base.

Par défaut, la mise en mémoire tampon est activée dans les bibliothèques d’E/S, mais chaque enregistrement de journal est vidé lorsqu’il est terminé.

Par défaut, la classe est utilisée pour la XMLFormatter mise en forme.

<b>Configuration :</b> Par défaut, chacun FileHandler est initialisé à l’aide des propriétés de configuration suivantes LogManager , où <handler-name> fait référence au nom de classe complet du gestionnaire. Si les propriétés ne sont pas définies (ou ont des valeurs non valides), les valeurs par défaut spécifiées sont utilisées. ulli < handler-name>. le niveau spécifie le niveau par défaut pour le (valeur par défaut ). /lili < handler-name>. filter spécifie le nom d’une classe à utiliser (par défaut, sans ). /lili < handler-name>. formateur spécifie le nom d’une classe à utiliser (par défaut) /li li < handler-name>. encodage du nom de l’encodage du jeu de caractères à utiliser (par défaut pour l’encodage de plateforme par défaut). /lili < handler-name>. la limite spécifie une quantité maximale approximative d’écriture (en octets) dans un fichier. S’il s’agit de zéro, il n’y a aucune limite. (Par défaut, sans limite). /lili < handler-name>. count spécifie le nombre de fichiers de sortie à parcourir (valeur par défaut : 1). /lili < handler-name>. le modèle spécifie un modèle pour générer le nom du fichier de sortie. Pour plus d’informations, voir ci-dessous. (La valeur par défaut est «%h/java%u.log »). /lili < handler-name>. append spécifie si FileHandler doit ajouter à tous les fichiers existants (valeur par défaut false). </li></ul>

Par exemple, les propriétés pour FileHandler devront être : <ul><li java.util.logging.FileHandler.level> =INFO </li li><java.util.logging.FileHandler.formatter> =java.util.logging.SimpleFormatter </li></ul>

Pour un gestionnaire personnalisé, e.g. com.foo.MyHandler, les propriétés seraient : ul<li com.foo.MyHandler.level=INFO >/li li<>com.foo.MyHandler.formatter<=java.util.logging.SimpleFormatter >/li<>/ul<><>

Un modèle se compose d’une chaîne qui inclut les composants spéciaux suivants qui seront remplacés lors de l’exécution : ul<li « / » le séparateur >de chemin d’accès local /li li<>< "%t" le répertoire >temporaire système /li li<>< "%h" la valeur de la propriété >système « user.home » /li li<>< "%g" le numéro de génération pour distinguer les journaux >pivotés /li<>li< "%u" un nombre unique pour résoudre les conflits >/li<><><li> "%%" se traduit par un signe de pourcentage unique "%" </li></ul> Si aucun "%g" a été spécifié et le nombre de fichiers est supérieur à un, le numéro de génération sera ajouté à la fin du nom de fichier généré, après un point.

Par exemple, un modèle de «%t/java%g.log » avec un nombre de 2 entraînerait généralement l’écriture de fichiers journaux sur Solaris vers /var/tmp/java0.log et /var/tmp/java1.log alors que sur Windows 95, ils seraient généralement écrits dans C :\TEMP\java0.log et C :\TEMP\java1.log

Les numéros de génération suivent la séquence 0, 1, 2, etc.

Normalement, le champ unique «%u» est défini sur 0. Toutefois, si les FileHandler tentatives d’ouverture du nom de fichier et recherchent que le fichier est actuellement utilisé par un autre processus, il incrémente le champ numéro unique et réessaye. Cette opération est répétée jusqu’à FileHandler ce que le nom d’un fichier qui n’est pas en cours d’utilisation soit trouvé. S’il existe un conflit et qu’aucun champ «%u» n’a été spécifié, il est ajouté à la fin du nom de fichier après un point. (Cela se fera après tout numéro de génération ajouté automatiquement.)

Ainsi, si trois processus essayaient tous de se connecter à fred%u. %g.txt alors ils pourraient finir par utiliser fred0.0.txt, fred1.0.txt, fred2.0.txt comme premier fichier dans leurs séquences de rotation.

Notez que l’utilisation d’ID uniques pour éviter les conflits est garantie de fonctionner de manière fiable lors de l’utilisation d’un système de fichiers de disque local.

Ajouté dans la version 1.4.

Java documentation pour java.util.logging.FileHandler.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.