LogFileSaver

public class LogFileSaver
extends Object

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

---

Um auxiliar para ITestInvocationListeners que salva dados de registro em um arquivo

Resumo

Construtores públicos
LogFileSaver(IBuildInfo buildInfo, File rootDir) Cria um LogFileSaver.
LogFileSaver(IBuildInfo buildInfo, File rootDir, Integer logRetentionDays) Cria um 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 registro 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 para ler o conteúdo de um determinado arquivo de registro TODO: considere mover esse método para outro lugar.
File	getFileDir() Acessa o diretório usado para armazenar arquivos.
	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 determinado arquivo de registro

Construtores públicos

LogFileSaver

public LogFileSaver (IBuildInfo buildInfo, 
                File rootDir)

Cria um LogFileSaver.

Criar um diretório de sistema de arquivos exclusivo 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 um LogFileSaver.

Criar um diretório de sistema de arquivos exclusivo 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 registro contendo um carimbo de data/hora igual ao tempo atual + logRetentionDays. Os scripts de limpeza externa podem usar esse arquivo para determinar quando excluir diretórios de registro.

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

createComPressLogFile

public File createCompressedLogFile (String dataName, 
                LogDataType origDataType)

Cria um arquivo vazio para armazenar dados de registro 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 ERROR(/File)

Gera
	se o arquivo de registro não puder ser criado

createGZipLogStream

public OutputStream createGZipLogStream (File logFile)

Cria um stream de saída para gravar dados compactados por GZIP em um arquivo

Parâmetros
logFile	File: o ERROR(/File) para gravar

Retorna
OutputStream	o ERROR(/OutputStream) para compactar e gravar dados no arquivo. este stream quando terminar

Gera
	se não for possível gerar o stream

createInputStreamFromFile

public InputStream createInputStreamFromFile (File logFile)

Método auxiliar para criar um stream de entrada e ler o conteúdo de determinado log fi

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

Parâmetros
logFile	File: o ERROR(/File) em que a leitura será feita.

Retorna
InputStream	um ERROR(/InputStream) em buffer para ler dados de arquivo. Os autores de chamadas precisam chamar esse stream quando ele for concluído.

Gera
	se não for possível gerar o stream

getFileDir

public File getFileDir ()

Receba o diretório usado para armazenar arquivos.

Retorna
File	o diretório ERROR(/File)

getInvocationLogPathSegments

public  getInvocationLogPathSegments ()

Retorna
	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 um (ou seja, LogDataType#isCompressed() é true)
dataStream	InputStream: o ERROR(/InputStream) dos dados.

Retorna
File	o arquivo dos dados gerados

Gera
	se o arquivo de registro não puder ser gerado

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 de String dos dados.
dataType	LogDataType: o LogDataType do arquivo. Dados de registro que são um (ou seja, LogDataType.isCompressed() é true)
fileToLog	File: o ERROR(/File) a ser salvo.

Retorna
File	o arquivo dos dados gerados

Gera
	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 de String dos dados.
dataType	LogDataType: o LogDataType do arquivo.
dataStream	InputStream: o ERROR(/InputStream) dos dados.

Retorna
File	o arquivo dos dados gerados

Gera
	se o arquivo de registro não puder ser gerado

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 ERROR(/InputStream) dos dados.

Retorna
File	o arquivo dos dados gerados

Gera
	se o arquivo de registro não puder ser gerado

saveLogFile

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

Salvar um determinado arquivo de registro

Parâmetros
dataName	String: um nome descritivo String dos dados.
dataType	LogDataType: o LogDataType do arquivo.
fileToLog	File: o ERROR(/File) que será registrado

Retorna
File	o arquivo dos dados gerados

Gera
	se o arquivo de registro não puder ser gerado