Інтерфейс виводу Aspose.TeX | Java

Будь ласка, зверніться до Aspose.TeX для Java посилання на API, щоб отримати формальні визначення реалізації введення/виведення.

Приклади файлової системи, ZIP і терміналів набирають hello-world.tex у XPS. Укажіть у inputDirectory папку з файлом TeX, а в outputDirectory — наявну папку виведення. Для виведення в ZIP задайте outputZip як java.nio.file.Path у наявній папці. Імпортуйте класи Aspose.TeX із вибраного прикладу, com.aspose.tex.rendering.XpsDevice і потрібні класи java.io та java.nio.file. Метод виклику має обробляти або оголошувати винятки. Застосуйте ліцензію згідно з посібником із ліцензування, щоб уникнути обмежень ознайомлювальної версії.

Поняття вихідного каталогу

Оскільки примітиви вводу-виводу мови TeX можуть мати справу лише з іменами файлів, Aspose.TeX визначає каталог як відображення між іменами та масивами даних. Маси даних мають бути файлами, потоками, масивами або будь-яким іншим. API дозволяє нам окремо вказувати вхідні та вихідні робочі каталоги. Він надає загальний інтерфейс IOutputWorkingDirectory для виведення, який користувач може реалізувати для власних цілей. Він також надає власні реалізації, які будуть розглянуті нижче. Інтерфейс розширює IInputWorkingDirectory, оскільки механізм може спочатку створити та записати файл, а потім прочитати його назад. Власний метод інтерфейсу getOuputFile() повертає потік для запису, на відміну від потоку для читання, який повертає getFile().

Запис вихідного файлу у файлову систему диска

Як ми згадували вище, найпоширенішим значенням для OutputWorkingDirectory буде екземпляр класу OutputFileSystemDirectory.

Ось як ми це встановимо:

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

Цей варіант використання досить простий, тому ми не будемо на ньому довго зупинятися.

Запис вихідного файлу в ZIP-архів

Ми також можемо створити файл (або потік) і дозволити механізму TeX використовувати його як ZIP-архів для зберігання вихідних файлів. Ось воно:

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

Спочатку ми створюємо вихідний потік для файлу ZIP. Потім, після створення параметрів перетворення, ми встановлюємо параметр OutputWorkingDirectory як екземпляр класу OutputZipDirectory. Приклад зберігає hello-world.xps і hello-world.log в архіві. Після завдання викличте finish() для папки виведення до закриття базового потоку. Приклади тримають потоки й робочі папки відкритими до завершення завдання, потім закривають їх.

Поняття про вихідний термінал

Є ще одна важлива частина виводу — вихід терміналу. Що стосується цього, Aspose.TeX для Java визначає загальний інтерфейс IOutputTerminal як такий, що має два методи. Один із них повертає екземпляр BufferedWriter. Інший повертає екземпляр OutputStream як базовий потік. Надані реалізації інтерфейсу обговорюються нижче.

Запис виводу терміналу на консоль

Для цього нам потрібно встановити параметр TerminalOut як екземпляр класу 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 — значення цього параметра за замовчуванням. Приклад явно вибирає його та записує виведення термінала в консоль під час перетворення. Усі чотири приклади виконуються без взаємодії з користувачем; приклади файлової системи та ZIP зберігають виведення термінала в пам’яті.

Запис вихідних даних терміналу у файл

На відміну від вхідного терміналу, Aspose.TeX для Java забезпечує реалізацію IOutputTerminal, яка дозволяє нам записувати вихідні дані терміналу у файл у деякому вихідному каталозі.

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

Задайте робочу папку виведення до створення OutputFileTerminal. Він записує виведення термінала в <job_name>.trm, у цьому прикладі — hello-world.trm, у вказаній папці. Цей файл термінала відокремлений від журналу TeX hello-world.log. Для запису виведення термінала в інше місце передайте конструктору іншу реалізацію IOutputWorkingDirectory.