FileHandler Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Journalisation Handlerde fichiers simple .
[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
- Attributs
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. <ul><li> < handler-name>. le niveau spécifie le niveau par défaut pour le Handler (valeur par défaut Level.ALL). </li><li> < handler-name>. filter spécifie le nom d’une Filter classe à utiliser (par défaut, sans Filter). </li><li> < handler-name>. formateur spécifie le nom d’une Formatter classe à utiliser (par défaut) java.util.logging.XMLFormatter</li li><> < handler-name>. encodage du nom de l’encodage du jeu de caractères à utiliser (valeur par défaut de l’encodage de plateforme par défaut). </li><li> < 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). </li><li> < handler-name>. count spécifie le nombre de fichiers de sortie à parcourir (valeur par défaut : 1). </li><li> < handler-name>. le modèle spécifie un modèle pour générer le nom du fichier de sortie. Voir les détails ci-dessous. (La valeur par défaut est « %h/java%u.log »). </li><li> < 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 au moment 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<>« >%u » un nombre unique pour résoudre les conflits </li li>><><< « %% » se traduit par un seul signe de pourcentage « % » </li></ul> Si aucun champ « %g » n’a été spécifié et que le nombre de fichiers est supérieur à un, le numéro de génération est 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 sur /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, 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.
Documentation Java pour java.util.logging.FileHandler.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.
Constructeurs
| FileHandler() |
Construisez une valeur par défaut |
| FileHandler(IntPtr, JniHandleOwnership) |
Constructeur utilisé lors de la création de représentations managées d’objets JNI ; appelée par le runtime. |
| FileHandler(String) |
Initialisez une |
| FileHandler(String, Boolean) |
Initialisez une |
| FileHandler(String, Int32, Int32) |
Initialisez a |
| FileHandler(String, Int32, Int32, Boolean) |
Initialisez a |
Propriétés
| Class |
Retourne la classe runtime de ce |
| Encoding |
Retourne l’encodage de caractères pour ce |
| ErrorManager |
Récupère le ErrorManager pour ce gestionnaire. -ou- Définissez un ErrorManager pour ce gestionnaire. (Hérité de Handler) |
| Filter |
Obtenez le courant |
| Formatter |
Retournez la |
| Handle |
Handle de l’instance Android sous-jacente. (Hérité de Object) |
| JniIdentityHashCode |
Journalisation |
| JniPeerMembers |
Journalisation |
| Level |
Obtenez le niveau de journal spécifiant les messages qui seront enregistrés par ce |
| PeerReference |
Journalisation |
| ThresholdClass |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
| ThresholdType |
Cette API prend en charge l’infrastructure Mono pour Android et n’est pas destinée à être utilisée directement à partir de votre code. |
Méthodes
| Clone() |
Crée et retourne une copie de cet objet. (Hérité de Object) |
| Close() |
Fermez le flux de sortie actuel. (Hérité de StreamHandler) |
| Dispose() |
Journalisation |
| Dispose(Boolean) |
Journalisation |
| Equals(Object) |
Indique si un autre objet est « égal à » celui-ci. (Hérité de Object) |
| Flush() |
Videz les messages mis en mémoire tampon. (Hérité de StreamHandler) |
| GetHashCode() |
Retourne une valeur de code de hachage pour l'objet. (Hérité de Object) |
| IsLoggable(LogRecord) |
Vérifiez si cela |
| JavaFinalize() |
Appelé par le garbage collector sur un objet lorsque le garbage collection détermine qu’il n’y a plus de références à l’objet. (Hérité de Object) |
| Notify() |
Réveille un thread unique qui attend le moniteur de cet objet. (Hérité de Object) |
| NotifyAll() |
Réveille tous les threads qui attendent le moniteur de cet objet. (Hérité de Object) |
| Publish(LogRecord) |
Mettre en forme et publier un |
| ReportError(String, Exception, Int32) |
Méthode pratique protégée pour signaler une erreur à ErrorManager de ce gestionnaire. (Hérité de Handler) |
| SetHandle(IntPtr, JniHandleOwnership) |
Définit la propriété Handle. (Hérité de Object) |
| SetOutputStream(Stream) |
Modifiez le flux de sortie. (Hérité de StreamHandler) |
| ToArray<T>() |
Journalisation |
| ToString() |
Retourne une représentation de chaîne de l'objet. (Hérité de Object) |
| UnregisterFromRuntime() |
Journalisation |
| Wait() |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti par em ou><em>interrompu</em>.<> (Hérité de Object) |
| Wait(Int64) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
| Wait(Int64, Int32) |
Provoque l’attente du thread actuel jusqu’à ce qu’il soit réveillé, généralement en étant <averti< par> em>ou <em>interrompu/em>,< ou jusqu’à ce qu’une certaine quantité de temps réel s’est écoulée. (Hérité de Object) |
Implémentations d’interfaces explicites
| IJavaPeerable.Disposed() |
Journalisation |
| IJavaPeerable.DisposeUnlessReferenced() |
Journalisation |
| IJavaPeerable.Finalized() |
Journalisation |
| IJavaPeerable.JniManagedPeerState |
Journalisation |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Journalisation |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Journalisation |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Journalisation |
Méthodes d’extension
| JavaCast<TResult>(IJavaObject) |
Effectue une conversion de type vérifiée par le runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Journalisation |
| GetJniTypeName(IJavaPeerable) |
Journalisation |