FileHandler Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Registro de archivos Handlersimple.
[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- Herencia
- Atributos
Comentarios
Registro de archivos Handlersimple.
FileHandler puede escribir en un archivo especificado o puede escribir en un conjunto giratorio de archivos.
Para un conjunto giratorio de archivos, a medida que cada archivo alcanza un límite de tamaño determinado, se cierra, gira y se abre un nuevo archivo. Los archivos más antiguos se denominan agregando "0", "1", "2", etc. en el nombre de archivo base.
De forma predeterminada, el almacenamiento en búfer está habilitado en las bibliotecas de E/S, pero cada registro de registro se vacía cuando se completa.
De forma predeterminada, la XMLFormatter clase se usa para dar formato.
<b>Configuration:</b> De forma predeterminada, cada FileHandler uno se inicializa con las siguientes LogManager propiedades de configuración, donde <handler-name> hace referencia al nombre de clase completo del controlador. Si las propiedades no están definidas (o tienen valores no válidos), se usan los valores predeterminados especificados. <ul><li> < handler-name>. level especifica el nivel predeterminado para Handler (el valor predeterminado es Level.ALL). </li><li> < handler-name>. filter especifica el nombre de una Filter clase que se va a usar (el valor predeterminado es no Filter). </li><li> < handler-name>. formateador especifica el nombre de una Formatter clase que se va a usar (el valor predeterminado es java.util.logging.XMLFormatter) </li><li> < handler-name>. codificar el nombre de la codificación del juego de caracteres que se va a usar (el valor predeterminado es la codificación de plataforma predeterminada). </li><li> < handler-name>. limit especifica una cantidad máxima aproximada para escribir (en bytes) en cualquier archivo. Si es cero, no hay ningún límite. (El valor predeterminado es sin límite). </li><li> < handler-name>. count especifica cuántos archivos de salida se van a recorrer (el valor predeterminado es 1). </li><li> < handler-name>. pattern especifica un patrón para generar el nombre del archivo de salida. Para obtener información más detallada, vea a continuación. (El valor predeterminado es "%h/java%u.log"). </li><li> < handler-name>. append especifica si FileHandler debe anexarse a los archivos existentes (el valor predeterminado es false). </li></ul>
Por ejemplo, las propiedades de FileHandler serían: <ul><li> java.util.logging.FileHandler.level=INFO </li><li> java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter </li></ul>
Para un controlador personalizado, e.g. com.foo.MyHandler, las propiedades serían: ul>li com.foo.MyHandler.level=INFO </li<>com.foo.MyHandler.formatter>=java.util.logging.SimpleFormatter </li></ul><<>
Un patrón consta de una cadena que incluye los siguientes componentes especiales que se reemplazarán en tiempo de ejecución: <ul<>li> "/" el separador <local pathname /li><li> "%t" el directorio <temporal del sistema /li li>>< "%h" el valor de la propiedad <del sistema "user.home" /li>>< li "%g" el número de generación para distinguir los registros <rotados /li><> li "%u" un número único para resolver conflictos </li li>>< "%%" se traduce en un único signo de porcentaje "%" </li></ul> Si no se ha especificado ningún campo "%g" y el recuento de archivos es mayor que uno, el número de generación se agregará al final del nombre de archivo generado, después de un punto.
Por lo tanto, por ejemplo, un patrón de "%t/java%g.log" con un recuento de 2 normalmente provocaría que los archivos de registro se escriban en Solaris en /var/tmp/java0.log y /var/tmp/java1.log, mientras que en Windows 95 normalmente se escribirían en C:\TEMP\java0.log y C:\TEMP\java1.log
Los números de generación siguen la secuencia 0, 1, 2, etc.
Normalmente, el campo único "%u" se establece en 0. Sin embargo, si intenta FileHandler abrir el nombre de archivo y encuentra que el archivo está actualmente en uso por otro proceso, incrementará el campo número único e intentará de nuevo. Esto se repetirá hasta FileHandler que encuentre un nombre de archivo que no esté en uso actualmente. Si hay un conflicto y no se ha especificado ningún campo "%u", se agregará al final del nombre de archivo después de un punto. (Esto será después de cualquier número de generación agregado automáticamente).
Por lo tanto, si todos los procesos intentaban registrar en fred%u.%g.txt, podrían acabar usando fred0.0.txt, fred1.0.txt, fred2.0.txt como primer archivo en sus secuencias giratorias.
Tenga en cuenta que el uso de identificadores únicos para evitar conflictos solo se garantiza que funcione de forma confiable cuando se usa un sistema de archivos de disco local.
Agregado en la versión 1.4.
Documentación de Java para java.util.logging.FileHandler.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Constructores
| FileHandler() |
Construya un valor predeterminado |
| FileHandler(IntPtr, JniHandleOwnership) |
Constructor utilizado al crear representaciones administradas de objetos JNI; llamado por el tiempo de ejecución. |
| FileHandler(String) |
Inicialice un |
| FileHandler(String, Boolean) |
Inicialice un |
| FileHandler(String, Int32, Int32) |
Inicialice un |
| FileHandler(String, Int32, Int32, Boolean) |
Inicialice un |
Propiedades
| Class |
Devuelve la clase en tiempo de ejecución de este |
| Encoding |
Devuelve la codificación de caracteres para este |
| ErrorManager |
Recupera el ErrorManager para este controlador. -o bien- Defina un ErrorManager para este controlador. (Heredado de Handler) |
| Filter |
Obtenga el objeto actual |
| Formatter |
Devuelve para |
| Handle |
Identificador de la instancia de Android subyacente. (Heredado de Object) |
| JniIdentityHashCode |
Registro de archivos |
| JniPeerMembers |
Registro de archivos |
| Level |
Obtenga el nivel de registro que especifica qué mensajes registrará este |
| PeerReference |
Registro de archivos |
| ThresholdClass |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
| ThresholdType |
Esta API admite la infraestructura mono para Android y no está pensada para usarse directamente desde el código. |
Métodos
| Clone() |
Crea y devuelve una copia de este objeto. (Heredado de Object) |
| Close() |
Cierre el flujo de salida actual. (Heredado de StreamHandler) |
| Dispose() |
Registro de archivos |
| Dispose(Boolean) |
Registro de archivos |
| Equals(Object) |
Indica si algún otro objeto es "igual a" este. (Heredado de Object) |
| Flush() |
Vaciar los mensajes almacenados en búfer. (Heredado de StreamHandler) |
| GetHashCode() |
Devuelve un valor de código hash del objeto. (Heredado de Object) |
| IsLoggable(LogRecord) |
Compruebe si esto |
| JavaFinalize() |
Lo llama el recolector de elementos no utilizados en un objeto cuando la recolección de elementos no utilizados determina que no hay más referencias al objeto . (Heredado de Object) |
| Notify() |
Activa un único subproceso que está esperando en el monitor de este objeto. (Heredado de Object) |
| NotifyAll() |
Activa todos los subprocesos que están esperando en el monitor de este objeto. (Heredado de Object) |
| Publish(LogRecord) |
Dar formato y publicar un |
| ReportError(String, Exception, Int32) |
Método de conveniencia protegido para notificar un error al ErrorManager de este controlador. (Heredado de Handler) |
| SetHandle(IntPtr, JniHandleOwnership) |
Establece la propiedad Handle. (Heredado de Object) |
| SetOutputStream(Stream) |
Cambie el flujo de salida. (Heredado de StreamHandler) |
| ToArray<T>() |
Registro de archivos |
| ToString() |
Devuelve una representación de cadena del objeto. (Heredado de Object) |
| UnregisterFromRuntime() |
Registro de archivos |
| Wait() |
Hace que el subproceso actual espere hasta que se despierta, normalmente por ser em notificado/em> o <em>interrumpido</em>.<>< (Heredado de Object) |
| Wait(Int64) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
| Wait(Int64, Int32) |
Hace que el subproceso actual espere hasta que se despierte, normalmente por ser <em>notificado</em> o <em>interrumpido</em>, o hasta que haya transcurrido una cierta cantidad de tiempo real. (Heredado de Object) |
Implementaciones de interfaz explícitas
| IJavaPeerable.Disposed() |
Registro de archivos |
| IJavaPeerable.DisposeUnlessReferenced() |
Registro de archivos |
| IJavaPeerable.Finalized() |
Registro de archivos |
| IJavaPeerable.JniManagedPeerState |
Registro de archivos |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
Registro de archivos |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Registro de archivos |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
Registro de archivos |
Métodos de extensión
| JavaCast<TResult>(IJavaObject) |
Realiza una conversión de tipos comprobados en tiempo de ejecución de Android. |
| JavaCast<TResult>(IJavaObject) |
Registro de archivos |
| GetJniTypeName(IJavaPeerable) |
Registro de archivos |