LogFileSaver

public class LogFileSaver
extends Object

java.lang.Object
   ↳ com.android.tradefed.result.LogFileSaver

Um auxiliar para ITestInvocationListeners que salva dados de registros em um arquivo.

Resumo

Construtores públicos

LogFileSaver(IBuildInfo buildInfo, File rootDir)

Cria uma LogFileSaver.

LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays)

Cria uma LogFileSaver.

LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays, Boolean containInvDir)

Cria uma LogFileSaver.

LogFileSaver(File rootDir)

Um construtor LogFileSaver alternativo que usa apenas o diretório fornecido como o diretório de armazenamento de registros.

Métodos públicos

File createCompressedLogFile(String dataName, LogDataType origDataType)

Cria um arquivo vazio para armazenar dados de registros compactados.

OutputStream createGZipLogStream(File logFile)

Cria um fluxo de saída para gravar dados compactados com GZIP em um arquivo.

InputStream createInputStreamFromFile(File logFile)

Método auxiliar para criar um fluxo de entrada e ler o conteúdo do arquivo de registro especificado.

TODO: considere mover esse método para outro lugar.

File getFileDir()

Recebe o diretório usado para armazenar arquivos.

List<String> getInvocationLogPathSegments()
File saveAndGZipLogData(String dataName, LogDataType dataType, InputStream dataStream)

Salve e compacte, se necessário, os dados de registro em um arquivo gzip.

File saveAndGZipLogFile(String dataName, LogDataType dataType, File fileToLog)

Salve e compacte, se necessário, os dados de registro em um arquivo gzip.

File saveLogData(String dataName, LogDataType dataType, InputStream dataStream)

Salvar os dados de registro em um arquivo

File saveLogDataRaw(String dataName, String ext, InputStream dataStream)

Salvar dados brutos em um arquivo

File saveLogFile(String dataName, LogDataType dataType, File fileToLog)

Salvar um arquivo de registro específico

Construtores públicos

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir)

Cria uma LogFileSaver.

Construa um diretório exclusivo do sistema de arquivos em rootDir/branch/build_id/uniqueDir

Parâmetros
buildInfo IBuildInfo: o IBuildInfo
rootDir File: o caminho do sistema de arquivos raiz

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays)

Cria uma LogFileSaver.

Construa um diretório exclusivo do sistema de arquivos em rootDir/branch/build_id/testTag/uniqueDir

Se a criação do diretório falhar, um diretório temporário será usado.

Parâmetros
buildInfo IBuildInfo: o IBuildInfo
rootDir File: o caminho do sistema de arquivos raiz
logRetentionDays Integer: se fornecido, um arquivo ".retention" será gravado no diretório de registros contendo um carimbo de data/hora igual à hora atual + logRetentionDays. Scripts de limpeza externos podem usar esse arquivo para determinar quando excluir diretórios de registros.

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir, 
                Integer logRetentionDays, 
                Boolean containInvDir)

Cria uma LogFileSaver.

Construa um diretório exclusivo do sistema de arquivos em rootDir/branch/build_id/testTag/uniqueDir

Se a criação do diretório falhar, um diretório temporário será usado.

Parâmetros
buildInfo IBuildInfo: o IBuildInfo
rootDir File: o caminho do sistema de arquivos raiz
logRetentionDays Integer: se fornecido, um arquivo ".retention" será gravado no diretório de registros contendo um carimbo de data/hora igual à hora atual + logRetentionDays. Scripts de limpeza externos podem usar esse arquivo para determinar quando excluir diretórios de registros.
containInvDir Boolean

LogFileSaver

public LogFileSaver (File rootDir)

Um construtor LogFileSaver alternativo que usa apenas o diretório fornecido como o diretório de armazenamento de registros.

Métodos públicos

createCompressedLogFile

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

Cria um arquivo vazio para armazenar dados de registros compactados.

Parâmetros
dataName String: um nome descritivo String dos dados a serem armazenados.
origDataType LogDataType: o tipo de LogDataType a ser armazenado
Retorna
File um File
Gera
IOException se não for possível criar o arquivo de registro

createGZipLogStream

public OutputStream createGZipLogStream (File logFile)

Cria um fluxo de saída para gravar dados compactados com GZIP em um arquivo.

Parâmetros
logFile File: o File em que gravar.
Retorna
OutputStream o OutputStream para compactar e gravar dados no arquivo. este stream quando concluído
Gera
IOException se não for possível gerar o stream

createInputStreamFromFile

public InputStream createInputStreamFromFile (File logFile)

Método auxiliar para criar um fluxo de entrada e ler o conteúdo do arquivo de registro especificado.

TODO: considere mover esse método para outro lugar. Colocado aqui por enquanto para que os usuários dessa classe possam simular.

Parâmetros
logFile File: o File de onde ler
Retorna
InputStream um InputStream em buffer para ler dados de arquivos. Os chamadores precisam chamar este fluxo quando concluído
Gera
IOException se não for possível gerar o stream

getFileDir

public File getFileDir ()

Recebe o diretório usado para armazenar arquivos.

Retorna
File o diretório File

getInvocationLogPathSegments

public List<String> getInvocationLogPathSegments ()

Retorna
List<String> os segmentos de caminho de registro de invocação exclusivos.

saveAndGZipLogData

public File saveAndGZipLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

Salve e compacte, se necessário, os dados de registro em um arquivo gzip.

Parâmetros
dataName String: um nome descritivo String dos dados.
dataType LogDataType: o LogDataType do arquivo. Dados de registro que são uma (ou seja, LogDataType.isCompressed() é true)
dataStream InputStream: o InputStream dos dados.
Retorna
File o arquivo dos dados gerados
Gera
IOException se não for possível gerar o arquivo de registro

saveAndGZipLogFile

public File saveAndGZipLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

Salve e compacte, se necessário, os dados de registro em um arquivo gzip.

Parâmetros
dataName String: um nome descritivo String dos dados.
dataType LogDataType: o LogDataType do arquivo. Dados de registro que são (ou seja, LogDataType.isCompressed() é true)
fileToLog File: o File a ser salvo
Retorna
File o arquivo dos dados gerados
Gera
IOException se não for possível gerar o arquivo de registro

saveLogData

public File saveLogData (String dataName, 
                LogDataType dataType, 
                InputStream dataStream)

Salvar os dados de registro em um arquivo

Parâmetros
dataName String: um nome descritivo String dos dados.
dataType LogDataType: o LogDataType do arquivo.
dataStream InputStream: o InputStream dos dados.
Retorna
File o arquivo dos dados gerados
Gera
IOException se não for possível gerar o arquivo de registro

saveLogDataRaw

public File saveLogDataRaw (String dataName, 
                String ext, 
                InputStream dataStream)

Salvar dados brutos em um arquivo

Parâmetros
dataName String: um nome descritivo String dos dados.
ext String: a extensão da data
dataStream InputStream: o InputStream dos dados.
Retorna
File o arquivo dos dados gerados
Gera
IOException se não for possível gerar o arquivo de registro

saveLogFile

public File saveLogFile (String dataName, 
                LogDataType dataType, 
                File fileToLog)

Salvar um arquivo de registro específico

Parâmetros
dataName String: um nome descritivo String dos dados.
dataType LogDataType: o LogDataType do arquivo.
fileToLog File: o File a ser registrado
Retorna
File o arquivo dos dados gerados
Gera
IOException se não for possível gerar o arquivo de registro