Interface de saída do Aspose.TeX | Java

Consulte Aspose.TeX para java Referência da API para obter definições formais de implementação de E/S.

Os exemplos de sistema de arquivos, ZIP e terminal compõem hello-world.tex em XPS. Defina inputDirectory como uma pasta com o arquivo TeX e outputDirectory como uma pasta de saída existente. Para saída ZIP, outputZip deve ser um java.nio.file.Path em uma pasta existente. Importe as classes Aspose.TeX usadas no exemplo escolhido, com.aspose.tex.rendering.XpsDevice e as classes necessárias de java.io e java.nio.file. O método chamador deve tratar ou declarar as exceções. Aplique uma licença conforme o guia de licenciamento para evitar as restrições de avaliação.

O conceito de diretório de saída

Como as primitivas de E/S do idioma TEX só podem lidar com nomes de arquivos, Aspose.TeX define um diretório como um mapeamento entre nomes e volumes de dados. Os ma tetos de dados devem ser arquivos, fluxos, matrizes ou qualquer outra coisa. A API nos permite especificar os diretórios de trabalho de entrada e saída separadamente. Ele fornece a interface Geral ioutputworkingDirectory para a saída, que o usuário pode implementar para seus próprios propósitos. Ele também fornece suas próprias implementações, que serão discutidas abaixo. A interface estende iInputWorkingDirectory, pois o mecanismo pode primeiro criar e escrever um arquivo e depois leia -o novamente. O próprio método da interface getouputfile() retorna o fluxo para gravar, em oposição ao fluxo para ler retornado por getfile().

Escrevendo a saída do arquivo no sistema de arquivos de disco

Como mencionamos acima, o valor mais comum para o outputWorkingDirectory provavelmente seria uma instância da classe outputFilesystemDirectory.

Aqui está como nós o definiríamos:

// inputDirectory contains hello-world.tex; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectTeX());
InputFileSystemDirectory input = new InputFileSystemDirectory(inputDirectory);
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setInputWorkingDirectory(input);
options.setOutputWorkingDirectory(output);
options.setInteraction(Interaction.NonstopMode);
options.setTerminalOut(new OutputMemoryTerminal());

XpsDevice device = new XpsDevice();
TeXJobResult result;
try {
    result = new TeXJob("hello-world", device, options).run();
} finally {
    device.dispose();
    output.close();
    input.close();
}

Este caso de uso é bastante simples, por isso não vamos nos debruçar por um longo tempo.

Escrevendo a saída do arquivo em um arquivo zip

Também podemos criar um arquivo (ou fluxo) e deixar o mecanismo TEX usá -lo como um arquivo zip para armazenar os arquivos de saída. Aqui está:

// Store the XPS document and TeX transcript in a ZIP archive.
// inputDirectory contains hello-world.tex; outputZip is the java.nio.file.Path to create.
TeXJobResult result;
try (OutputStream zipStream = Files.newOutputStream(outputZip)) {
    TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectTeX());
    InputFileSystemDirectory input = new InputFileSystemDirectory(inputDirectory);
    OutputZipDirectory output = new OutputZipDirectory(zipStream);
    options.setInputWorkingDirectory(input);
    options.setOutputWorkingDirectory(output);
    options.setInteraction(Interaction.NonstopMode);
    options.setTerminalOut(new OutputMemoryTerminal());
    XpsDevice device = new XpsDevice();
    try {
        result = new TeXJob("hello-world", device, options).run();
        // Finalize the archive while its underlying stream is still open.
        output.finish();
    } finally {
        device.dispose();
        output.close();
        input.close();
    }
}

Primeiro, criamos um fluxo de saída para o arquivo zip. Então, depois de criar as opções de conversão, definimos a opção OutputWorkingDirectory para ser uma instância da classe outputzipDirectory. O exemplo armazena hello-world.xps e hello-world.log no arquivo. Após o trabalho, chame finish() no diretório de saída antes de fechar o fluxo subjacente. Os exemplos mantêm seus fluxos e diretórios de trabalho abertos até o término do trabalho e depois os fecham.

O conceito do terminal de saída

Há outra parte importante da saída-a saída do terminal. Quanto a este, Aspose.TeX para java define a interface Geral ioutputTerminal como tendo dois métodos. Um deles retorna uma instância BufferWriter. Outro retorna uma instância outputStream como o fluxo subjacente. As implementações fornecidas da interface são discutidas abaixo.

Escrevendo saída do terminal para o console

Para fazer isso, precisamos definir a opção Terminalout para ser uma instância da classe outputConsoleterminal.

// inputDirectory contains hello-world.tex; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectTeX());
InputFileSystemDirectory input = new InputFileSystemDirectory(inputDirectory);
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setInputWorkingDirectory(input);
options.setOutputWorkingDirectory(output);
options.setInteraction(Interaction.NonstopMode);
// This is also the default output terminal.
options.setTerminalOut(new OutputConsoleTerminal());

XpsDevice device = new XpsDevice();
TeXJobResult result;
try {
    result = new TeXJob("hello-world", device, options).run();
} finally {
    device.dispose();
    output.close();
    input.close();
}

OutputConsoleTerminal é o valor padrão desta opção. O exemplo o seleciona explicitamente e escreve a saída do terminal no console durante a conversão. Os quatro exemplos são executados sem interação; os exemplos de sistema de arquivos e ZIP capturam a saída do terminal na memória.

Escrevendo a saída do terminal em um arquivo

Ao contrário do terminal de entrada, Aspose.TeX para Java fornece uma implementação do ioutputMerminal, que nos permite gravar a saída do terminal em um arquivo em algum diretório de saída.

// inputDirectory contains hello-world.tex; outputDirectory is an existing output folder.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectTeX());
InputFileSystemDirectory input = new InputFileSystemDirectory(inputDirectory);
OutputFileSystemDirectory output = new OutputFileSystemDirectory(outputDirectory);
options.setInputWorkingDirectory(input);
options.setOutputWorkingDirectory(output);
options.setInteraction(Interaction.NonstopMode);
// Set the output directory first: the terminal writes <job_name>.trm there.
options.setTerminalOut(new OutputFileTerminal(options.getOutputWorkingDirectory()));

XpsDevice device = new XpsDevice();
TeXJobResult result;
try {
    result = new TeXJob("hello-world", device, options).run();
} finally {
    device.dispose();
    output.close();
    input.close();
}

Defina o diretório de trabalho de saída antes de criar OutputFileTerminal. Ele escreve a saída do terminal em <job_name>.trm, aqui hello-world.trm, nesse diretório. Esse arquivo do terminal é separado da transcrição TeX hello-world.log. Para escrever a saída do terminal em outro local, passe ao construtor outra implementação de IOutputWorkingDirectory.