FileHandler Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Registrazione file Handlersemplice.
[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- Ereditarietà
- Attributi
Commenti
Registrazione file Handlersemplice.
FileHandler Può scrivere in un file specificato oppure scrivere in un set di file rotante.
Per un set di file rotante, poiché ogni file raggiunge un limite di dimensioni specificato, viene chiuso, ruotato fuori e un nuovo file aperto. Successivamente, i file meno recenti vengono denominati aggiungendo "0", "1", "2" e così via nel nome file di base.
Per impostazione predefinita, il buffering è abilitato nelle librerie di I/O, ma ogni record di log viene scaricato al termine.
Per impostazione predefinita, la classe viene usata per la XMLFormatter formattazione.
<b>Configuration:</b> Per impostazione predefinita, ognuna FileHandler viene inizializzata usando le proprietà di configurazione seguenti LogManager in cui <handler-name> fa riferimento al nome completo della classe del gestore. Se le proprietà non sono definite (o hanno valori non validi), vengono usati i valori predefiniti specificati. <ul><li> < handler-name>. level specifica il livello predefinito per (l'impostazione Handler predefinita è Level.ALL). </li li><> < handler-name>. filter specifica il nome di una Filter classe da usare (il valore predefinito è no Filter). </li li><> < handler-name>. formatter specifica il nome di una Formatter classe da usare (per impostazione predefinita è java.util.logging.XMLFormatter) </li><li> < handler-name>. codificare il nome della codifica del set di caratteri da usare (il valore predefinito è la codifica della piattaforma predefinita). </li li><> < handler-name>. limit specifica un importo massimo approssimativo da scrivere (in byte) in un file. Se questo è zero, non esiste alcun limite. Per impostazione predefinita non è previsto alcun limite. </li li><> < handler-name>. count specifica il numero di file di output da scorrere (il valore predefinito è 1). </li li><> < handler-name>. pattern specifica un modello per la generazione del nome del file di output. Per informazioni dettagliate, vedi di seguito. L'impostazione predefinita è "%h/java%u.log"). </li li><> < handler-name>. append specifica se FileHandler deve essere accodato a qualsiasi file esistente (il valore predefinito è false). </li></ul>
Ad esempio, le proprietà per sarebbero: <ul><li> java.util.logging.FileHandler.level=INFO </li<>> java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter </li></ul FileHandler>
Per un gestore personalizzato, e.g. com.foo.MyHandler, le proprietà sono: ul>li com.foo.MyHandler.level=INFO </li<>> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li<>/ul><<>
Un criterio è costituito da una stringa che include i componenti speciali seguenti che verranno sostituiti in fase di esecuzione: ul>li "/" il separatore <di percorso locale /li li> "%t" la directory <temporanea di sistema /li>>< li "%h" il valore della proprietà <di sistema "user.home" /li>>< "%g" numero di generazione per distinguere i log <ruotati /li<><>> "%u" un numero univoco per risolvere i conflitti </li li>><><< "%%" si traduce in un singolo segno di percentuale "%" </li></ul> Se non è stato specificato alcun campo "%g" e il numero di file è maggiore di uno, il numero di generazione verrà aggiunto alla fine del nome file generato, dopo un punto.
Pertanto, ad esempio, un modello di "%t/java%g.log" con un conteggio pari a 2 in genere causerebbe la scrittura dei file di log in Solaris in /var/tmp/java0.log e /var/tmp/java1.log mentre in Windows 95 in genere verrebbero scritti in C:\TEMP\java0.log e C:\TEMP\java1.log
I numeri di generazione seguono la sequenza 0, 1, 2 e così via.
In genere il campo univoco "%u" è impostato su 0. Tuttavia, se FileHandler tenta di aprire il nome file e trova che il file è attualmente in uso da un altro processo, incrementerà il campo numero univoco e riprova. Questa operazione verrà ripetuta fino a FileHandler quando non viene trovato un nome di file non attualmente in uso. Se si verifica un conflitto e non è stato specificato alcun campo "%u", verrà aggiunto alla fine del nome file dopo un punto. Questo sarà dopo qualsiasi numero di generazione aggiunto automaticamente.
Pertanto, se tre processi tentavano di accedere a fred%u.%g.txt allora potrebbero finire usando fred0.0.txt, fred1.0.txt, fred2.0.txt come primo file nelle sequenze rotanti.
Si noti che l'uso di ID univoci per evitare conflitti è garantito che funzioni in modo affidabile quando si usa un file system su disco locale.
Aggiunta nella versione 1.4.
Documentazione java per java.util.logging.FileHandler.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.
Costruttori
| FileHandler() |
Costruisci un oggetto predefinito |
| FileHandler(IntPtr, JniHandleOwnership) |
Costruttore usato durante la creazione di rappresentazioni gestite di oggetti JNI; chiamato dal runtime. |
| FileHandler(String) |
Inizializzare un oggetto |
| FileHandler(String, Boolean) |
Inizializzare un |
| FileHandler(String, Int32, Int32) |
Inizializzare un oggetto |
| FileHandler(String, Int32, Int32, Boolean) |
Inizializzare un oggetto |
Proprietà
| Class |
Restituisce la classe di runtime di questo |
| Encoding |
Restituisce la codifica dei caratteri per questo |
| ErrorManager |
Recupera ErrorManager per questo gestore. -oppure- Definire un ErrorManager per questo gestore. (Ereditato da Handler) |
| Filter |
Ottiene l'oggetto corrente |
| Formatter |
Restituisce l'oggetto per l'oggetto |
| Handle |
Handle per l'istanza di Android sottostante. (Ereditato da Object) |
| JniIdentityHashCode |
Registrazione file |
| JniPeerMembers |
Registrazione file |
| Level |
Ottenere il livello di log che specifica i messaggi che verranno registrati da questo |
| PeerReference |
Registrazione file |
| ThresholdClass |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
| ThresholdType |
Questa API supporta l'infrastruttura Mono per Android e non deve essere usata direttamente dal codice. |
Metodi
| Clone() |
Crea e restituisce una copia di questo oggetto. (Ereditato da Object) |
| Close() |
Chiudere il flusso di output corrente. (Ereditato da StreamHandler) |
| Dispose() |
Registrazione file |
| Dispose(Boolean) |
Registrazione file |
| Equals(Object) |
Indica se un altro oggetto è "uguale a" questo. (Ereditato da Object) |
| Flush() |
Scarica tutti i messaggi memorizzati nel buffer. (Ereditato da StreamHandler) |
| GetHashCode() |
Restituisce un valore del codice hash per l'oggetto. (Ereditato da Object) |
| IsLoggable(LogRecord) |
Controllare se si |
| JavaFinalize() |
Chiamato dal Garbage Collector su un oggetto quando Garbage Collection determina che non sono presenti altri riferimenti all'oggetto . (Ereditato da Object) |
| Notify() |
Riattiva un singolo thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| NotifyAll() |
Riattiva tutti i thread in attesa del monitor dell'oggetto. (Ereditato da Object) |
| Publish(LogRecord) |
Formattare e pubblicare un oggetto |
| ReportError(String, Exception, Int32) |
Metodo di praticità protetto per segnalare un errore a ErrorManager di questo gestore. (Ereditato da Handler) |
| SetHandle(IntPtr, JniHandleOwnership) |
Imposta la proprietà Handle. (Ereditato da Object) |
| SetOutputStream(Stream) |
Modificare il flusso di output. (Ereditato da StreamHandler) |
| ToArray<T>() |
Registrazione file |
| ToString() |
Restituisce una rappresentazione di stringa dell'oggetto. (Ereditato da Object) |
| UnregisterFromRuntime() |
Registrazione file |
| Wait() |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo <>una notifica</em> o <em>interrotto</em>. (Ereditato da Object) |
| Wait(Int64) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
| Wait(Int64, Int32) |
Fa sì che il thread corrente attenda finché non viene risvegliato, in genere ricevendo>< una notifica</em> o <em>interrotto</em> o fino a quando non è trascorsa una determinata quantità di tempo reale. (Ereditato da Object) |
Implementazioni dell'interfaccia esplicita
| IJavaPeerable.Disposed() |
Registrazione file |
| IJavaPeerable.DisposeUnlessReferenced() |
Registrazione file |
| IJavaPeerable.Finalized() |
Registrazione file |
| IJavaPeerable.JniManagedPeerState |
Registrazione file |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Registrazione file |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Registrazione file |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Registrazione file |
Metodi di estensione
| JavaCast<TResult>(IJavaObject) |
Esegue una conversione del tipo di tipo controllato dal runtime Android. |
| JavaCast<TResult>(IJavaObject) |
Registrazione file |
| GetJniTypeName(IJavaPeerable) |
Registrazione file |