Interface de sortie d'Aspose.TeX | Java

Veuillez vous référer à Aspose.TeX for Java Référence API pour les définitions formelles de l’implémentation des E/S.

Les exemples de système de fichiers, ZIP et terminal composent hello-world.tex en XPS. Définissez inputDirectory sur un dossier contenant le fichier TeX et outputDirectory sur un dossier de sortie existant. Pour la sortie ZIP, outputZip doit être un java.nio.file.Path dans un dossier existant. Importez les classes Aspose.TeX utilisées dans l’exemple choisi, com.aspose.tex.rendering.XpsDevice et les classes nécessaires de java.io et java.nio.file. La méthode appelante doit gérer ou déclarer les exceptions. Appliquez une licence conformément au guide des licences pour éviter les restrictions d’évaluation.

Le concept du répertoire de sortie

Étant donné que les primitives d’E/S du langage TeX ne peuvent traiter que les noms de fichiers, Aspose.TeX définit un répertoire comme un mappage entre les noms et les lots de données. Les masses de données sont censées être des fichiers, des flux, des tableaux ou quoi que ce soit d’autre. L’API nous permet de spécifier séparément les répertoires de travail d’entrée et de sortie. Il fournit l’interface générale IOutputWorkingDirectory pour la sortie, que l’utilisateur peut implémenter à ses propres fins. Il fournit également ses propres implémentations, qui seront discutées ci-dessous. L’interface étend IInputWorkingDirectory, puisque le moteur peut d’abord créer et écrire un fichier, puis le relire. La propre méthode de l’interface getOuputFile() renvoie le flux dans lequel écrire, par opposition au flux à lire renvoyé par getFile().

Écriture de la sortie du fichier sur le système de fichiers du disque

Comme nous l’avons mentionné ci-dessus, la valeur la plus courante pour OutputWorkingDirectory serait probablement une instance de la classe OutputFileSystemDirectory.

Voici comment nous le définirions :

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

Ce cas d’utilisation est assez simple, nous ne nous y attarderons donc pas longtemps.

Écriture de la sortie du fichier dans une archive ZIP

Nous pouvons également créer un fichier (ou un flux) et laisser le moteur TeX l’utiliser comme archive ZIP pour stocker les fichiers de sortie. C’est ici:

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

Tout d’abord, nous créons un flux de sortie pour le fichier ZIP. Ensuite, après avoir créé les options de conversion, nous définissons l’option OutputWorkingDirectory comme étant une instance de la classe OutputZipDirectory. L’exemple stocke hello-world.xps et hello-world.log dans l’archive. Après le travail, appelez finish() sur le répertoire de sortie avant de fermer le flux sous-jacent. Les exemples gardent leurs flux et répertoires de travail ouverts jusqu’à la fin du travail, puis les ferment.

Le concept du terminal de sortie

Il y a une autre partie importante de la sortie : la sortie du terminal. Quant à celui-ci, Aspose.TeX for Java définit l’interface générale IOutputTerminal comme ayant deux méthodes. L’un d’eux renvoie une instance de BufferedWriter. Un autre renvoie une instance OutputStream comme flux sous-jacent. Les implémentations fournies de l’interface sont décrites ci-dessous.

Écriture de la sortie du terminal sur la console

Pour ce faire, nous devons définir l’option TerminalOut pour qu’elle soit une instance de la 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 est la valeur par défaut de cette option. L’exemple le sélectionne explicitement et écrit la sortie du terminal dans la console pendant la conversion. Les quatre exemples s’exécutent sans interaction ; les exemples de système de fichiers et ZIP capturent la sortie du terminal en mémoire.

Écrire la sortie du terminal dans un fichier

Contrairement au terminal d’entrée, Aspose.TeX pour Java fournit une implémentation de IOutputTerminal, qui nous permet d’écrire la sortie du terminal dans un fichier dans un répertoire de sortie.

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

Définissez le répertoire de travail de sortie avant de créer OutputFileTerminal. Il écrit la sortie du terminal dans <job_name>.trm, ici hello-world.trm, dans ce répertoire. Ce fichier du terminal est distinct de la transcription TeX hello-world.log. Pour écrire la sortie du terminal ailleurs, transmettez au constructeur une autre implémentation de IOutputWorkingDirectory.