FileHandler Classe

Definição

[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

Herança

Object

Object

Handler

StreamHandler

FileHandler

Atributos

RegisterAttribute

Comentários

Registro simples de arquivos Handler.

O FileHandler pode gravar em um arquivo especificado ou pode gravar em um conjunto rotativo de arquivos.

Para um conjunto rotativo de arquivos, à medida que cada arquivo atinge um determinado limite de tamanho, ele é fechado, girado para fora e um novo arquivo aberto. Arquivos sucessivamente mais antigos são nomeados adicionando "0", "1", "2", etc. no nome do arquivo base.

Por padrão, o buffer é habilitado nas bibliotecas de E/S, mas cada registro de log é liberado quando é concluído.

Por padrão, a XMLFormatter classe é usada para formatação.

<b>Configuração:/b> Por padrão,< cada uma FileHandler é inicializada usando as seguintes LogManager propriedades de configuração, onde <handler-name> se refere ao nome de classe totalmente qualificado do manipulador. Se as propriedades não estiverem definidas (ou tiverem valores inválidos), os valores padrão especificados serão usados. <><UL LI> < nome-do-manipulador>. level especifica o nível padrão para o Handler (padrão para Level.ALL). </li><li> < nome-do-manipulador>. filter especifica o nome de uma Filter classe a ser usada (o padrão é não Filter). </li><li> < nome-do-manipulador>. formatador especifica o nome de uma Formatter classe a ser usada (padrão para java.util.logging.XMLFormatter) </li><li> < nome-do-manipulador>. Codificação O nome da codificação do conjunto de caracteres a ser usado (o padrão é a codificação de plataforma padrão). </li><li> < nome-do-manipulador>. limit especifica uma quantidade máxima aproximada para gravar (em bytes) em qualquer arquivo. Se isso é zero, então não há limite. (O padrão é sem limite). </li><li> < nome-do-manipulador>. count especifica quantos arquivos de saída devem ser percorridos (o padrão é 1). </li><li> < nome-do-manipulador>. pattern especifica um padrão para gerar o nome do arquivo de saída. Confira os detalhes abaixo. (O padrão é "%h/java%u.log"). </li><li> < nome-do-manipulador>. append especifica se o FileHandler deve anexar a quaisquer arquivos existentes (o padrão é false). </li></ul>

Por exemplo, as propriedades para FileHandler seriam: <ul<>li> java.util.logging.FileHandler.level=INFO </li<>> li java.util.logging.FileHandler.formatter=java.util.logging.SimpleFormatter </li></ul>

Para um manipulador personalizado, e.g. com.foo.MyHandler, as propriedades seriam: <ul><li> com.foo.MyHandler.level=INFO </li<>li> com.foo.MyHandler.formatter=java.util.logging.SimpleFormatter </li></ul>

Um padrão consiste em uma cadeia de caracteres que inclui os seguintes componentes especiais que serão substituídos em tempo de execução: ul>li "/" o separador <de nome de caminho local /li><li> "%t" o diretório <temporário do sistema /li><li> "%h" o valor da propriedade <do sistema "user.home" /li<>li> "%g" o número de geração para distinguir logs rotacionados </li><li> "%u" um número exclusivo para resolver conflitos </li li>><><< "%%" é convertido em um único sinal de porcentagem "%" </li></ul> Se nenhum campo "%g" tiver sido especificado e a contagem de arquivos for maior que um, o número de geração será adicionado ao final do nome do arquivo gerado, após um ponto.

Assim, por exemplo, um padrão de "%t/java%g.log" com uma contagem de 2 normalmente faria com que os arquivos de log fossem gravados no Solaris em /var/tmp/java0.log e /var/tmp/java1.log enquanto no Windows 95 eles seriam normalmente gravados em C:\TEMP\java0.log e C:\TEMP\java1.log

Os números de geração seguem a sequência 0, 1, 2, etc.

Normalmente, o campo exclusivo "%u" é definido como 0. No entanto, se o FileHandler tentar abrir o nome do arquivo e descobrir que o arquivo está atualmente em uso por outro processo, ele incrementará o campo de número exclusivo e tentará novamente. Isso será repetido até FileHandler encontrar um nome de arquivo que não esteja em uso no momento. Se houver um conflito e nenhum campo "%u" tiver sido especificado, ele será adicionado no final do nome do arquivo após um ponto. (Isso ocorrerá após qualquer número de geração adicionado automaticamente.)

Assim, se três processos estivessem todos tentando registrar em fred%u.%g.txt então eles poderiam acabar usando fred0.0.txt, fred1.0.txt fred2.0.txt como o primeiro arquivo em suas sequências rotativas.

Observe que o uso de ids exclusivos para evitar conflitos só é garantido para funcionar de forma confiável ao usar um sistema de arquivos de disco local.

Adicionado em 1.4.

Documentação Java para java.util.logging.FileHandler.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.

Construtores

Propriedades

Métodos

Implantações explícitas de interface

Métodos de Extensão

Aplica-se a