Interfaz de salida de Aspose.TeX | Java

Consulte Aspose.TeX para Java referencia de API para obtener definiciones formales de implementación de E/S.

Los ejemplos de sistema de archivos, ZIP y terminal componen hello-world.tex en XPS. Establezca inputDirectory en una carpeta con el archivo TeX y outputDirectory en una carpeta de salida existente. Para la salida ZIP, outputZip debe ser un java.nio.file.Path en una carpeta existente. Importe las clases Aspose.TeX usadas en el ejemplo seleccionado, com.aspose.tex.rendering.XpsDevice y las clases necesarias de java.io y java.nio.file. El método que llama al ejemplo debe gestionar o declarar las excepciones. Aplique una licencia según la guía de licencias para evitar las restricciones de evaluación.

El concepto del directorio de salida.

Dado que las primitivas de E/S del lenguaje TeX sólo pueden tratar con nombres de archivos, Aspose.TeX define un directorio como un mapeo entre nombres y grandes cantidades de datos. Se supone que la gran cantidad de datos son archivos, secuencias, matrices o cualquier otra cosa. La API nos permite especificar los directorios de trabajo de entrada y salida por separado. Proporciona la interfaz general IOutputWorkingDirectory para la salida, que el usuario puede implementar para sus propios fines. También proporciona sus propias implementaciones, que se analizarán a continuación. La interfaz extiende IInputWorkingDirectory, ya que el motor puede primero crear y escribir un archivo y luego volver a leerlo. El método propio de la interfaz getOuputFile() devuelve la secuencia para escribir, a diferencia de la secuencia para leer devuelta por getFile().

Escribir la salida del archivo en el sistema de archivos del disco

Como mencionamos arriba, el valor más común para OutputWorkingDirectory probablemente sería una instancia de la clase OutputFileSystemDirectory.

Así es como lo configurarí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 es bastante simple, por lo que no nos detendremos en él por mucho tiempo.

Escribir la salida del archivo en un archivo ZIP

También podemos crear un archivo (o secuencia) y dejar que el motor TeX lo use como un archivo ZIP para almacenar los archivos de salida. Aquí lo tienes:

// 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();
    }
}

Primero, creamos un flujo de salida para el archivo ZIP. Luego, después de crear las opciones de conversión, configuramos la opción OutputWorkingDirectory para que sea una instancia de la clase OutputZipDirectory. El ejemplo almacena hello-world.xps y hello-world.log en el archivo. Después del trabajo, llame a finish() en el directorio de salida antes de cerrar el flujo subyacente. Los ejemplos mantienen abiertos sus flujos y directorios de trabajo hasta que termina el trabajo y después los cierran.

El concepto de terminal de salida.

Hay otra parte importante de la salida: la salida del terminal. En cuanto a este, Aspose.TeX para Java define la interfaz general IOutputTerminal con dos métodos. Uno de ellos devuelve una instancia BufferedWriter. Otro devuelve una instancia OutputStream como flujo subyacente. Las implementaciones proporcionadas de la interfaz se analizan a continuación.

Escribir la salida del terminal en la consola

Para hacer esto, necesitamos configurar la opción TerminalOut para que sea una instancia de la clase 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 es el valor predeterminado de esta opción. El ejemplo lo selecciona explícitamente y escribe la salida del terminal en la consola durante la conversión. Los cuatro ejemplos se ejecutan sin interacción; los ejemplos de sistema de archivos y ZIP capturan la salida del terminal en memoria.

Escribir la salida del terminal en un archivo

A diferencia del terminal de entrada, Aspose.TeX para Java proporciona una implementación de IOutputTerminal, que nos permite escribir la salida del terminal en un archivo en algún directorio de salida.

// 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();
}

Establezca el directorio de trabajo de salida antes de crear OutputFileTerminal. Escribe la salida del terminal en <job_name>.trm, aquí hello-world.trm, en ese directorio. Este archivo del terminal es independiente de la transcripción TeX hello-world.log. Para escribir la salida del terminal en otro lugar, pase al constructor otra implementación de IOutputWorkingDirectory.