Налаштування GroupDocs.Merger Cloud SDK for Java

Перш ніж почати кодування, переконайтеся, що у вас є наступне:

• Java Development Kit (JDK) 8 або вище.
• IDE, наприклад IntelliJ IDEA або Eclipse.
• Обліковий запис GroupDocs Cloud з client ID та client secret.

Додайте залежність Maven до вашого pom.xml:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger-cloud</artifactId>
    <version>25.11</version>
</dependency>

Завантажте останню бібліотеку з офіційної сторінки випуску: GroupDocs.Merger Cloud SDK for Java Download. Після того, як залежність буде вирішена, ви готові писати код, який об’єднує файли PowerPoint.

Створюємо крок за кроком: об’єднання та злиття Powerpoint PPT PPTX у Java

Крок 1: Ініціалізуйте клієнт API

Створіть ApiClient з вашими обліковими даними та створіть екземпляр MergerApi.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
MergerApi mergerApi = new MergerApi(apiClient);

Крок 2: Визначте вихідні файли PowerPoint

Створіть об’єкти FileInfo для кожної презентації, яку ви хочете об’єднати.

FileInfo sourceFile1 = new FileInfo();
sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
sourceFile2.setFilePath("input2.ppt"); // second PPT file

Крок 3: Встановити параметри злиття

Додайте вихідні файли до списку та вкажіть шлях виводу.

List<FileInfo> sourceFiles = new ArrayList<>();
sourceFiles.add(sourceFile1);
sourceFiles.add(sourceFile2);

MergeOptions mergeOptions = new MergeOptions();
mergeOptions.setFileInfos(sourceFiles);          // files to be merged
mergeOptions.setOutputPath("merged_output.pptx"); // result file

Крок 4: Виконати запит на злиття

Створіть MergeRequest і викличте метод merge.

MergeRequest mergeRequest = new MergeRequest(mergeOptions);
try {
    MergeResult mergeResult = mergerApi.merge(mergeRequest);
    System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
} catch (Exception e) {
    System.err.println("An error occurred during merging: " + e.getMessage());
    e.printStackTrace();
}

Вищенаведений код демонструє повний робочий процес для об’єднання та злиття Powerpoint PPT PPTX у Java за допомогою SDK.

Повний приклад коду: об’єднання та злиття файлів Powerpoint у Java

Наступний приклад збирає всі частини разом у єдину, готову‑до‑запуску програму.

import com.groupdocs.merger.cloud.ApiClient;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.MergeOptions;
import com.groupdocs.merger.cloud.model.requests.MergeRequest;
import com.groupdocs.merger.cloud.model.responses.MergeResult;

import java.util.ArrayList;
import java.util.List;

public class PowerPointMergeExample {
    public static void main(String[] args) {
        // Initialize the API client with your credentials
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        MergerApi mergerApi = new MergerApi(apiClient);

// Define the source PowerPoint files
        FileInfo sourceFile1 = new FileInfo();
        sourceFile1.setFilePath("input1.pptx"); // first PPTX file

FileInfo sourceFile2 = new FileInfo();
        sourceFile2.setFilePath("input2.ppt"); // second PPT file

List<FileInfo> sourceFiles = new ArrayList<>();
        sourceFiles.add(sourceFile1);
        sourceFiles.add(sourceFile2);

// Set merge options
        MergeOptions mergeOptions = new MergeOptions();
        mergeOptions.setFileInfos(sourceFiles);          // files to be merged
        mergeOptions.setOutputPath("merged_output.pptx"); // result file

// Create and execute the merge request
        MergeRequest mergeRequest = new MergeRequest(mergeOptions);
        try {
            MergeResult mergeResult = mergerApi.merge(mergeRequest);
            System.out.println("Merge successful. Output file stored at: " + mergeResult.getPath());
        } catch (Exception e) {
            System.err.println("An error occurred during merging: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

Примітка: Цей приклад коду демонструє основну функціональність. Перш ніж використовувати його у вашому проєкті, переконайтеся, що оновили шляхи до файлів (input1.pptx, input2.ppt, merged_output.pptx) відповідно до фактичних розташувань, перевірте, що всі необхідні залежності встановлені правильно, і ретельно протестуйте у вашому середовищі розробки. Якщо ви зіткнетеся з будь-якими проблемами, будь ласка, зверніться до офіційної документації або до команди підтримки за допомогою.

Об’єднання презентацій Powerpoint за допомогою cURL та REST API

Ви можете виконати ту ж операцію злиття без написання коду Java, викликавши REST‑конечні точки GroupDocs Merger. Нижче наведено типовий робочий процес cURL.

1. Аутентифікація та отримання токену доступу

curl -X POST "https://api.groupdocs.cloud/v2.0/authentication/token" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

Відповідь містить access_token, який ви будете використовувати у наступних викликах.

2. Завантажити вихідні файли

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -F "file=@/local/path/input1.pptx"

Повторіть команду для input2.ppt.

3. Виконати операцію злиття

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "fileInfos": [
          {"filePath": "input1.pptx"},
          {"filePath": "input2.ppt"}
        ],
        "outputPath": "merged_output.pptx"
      }'

API повертає об’єкт JSON з шляхом до об’єднаного файлу.

4. Завантажити об’єднаний файл

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pptx" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o merged_output.pptx

Для отримання докладнішої інформації перегляньте офіційну довідку API.

Параметри злиття: конфігурація та налаштування

Хоча базовий приклад працює у більшості сценаріїв, SDK пропонує додаткові параметри, які ви можете налаштувати.

Шлях виводу

Вкажіть власну папку або ім’я файлу.

mergeOptions.setOutputPath("reports/combined_presentation.pptx");

Захист паролем (за потреби)

mergeOptions.setPassword("StrongPassword123");

Зберегти оригінальне розташування

mergeOptions.setPreserveLayout(true);

Ці властивості є частиною класу MergeOptions; зверніться до довідки API для повного списку.

Висновок

Використовуючи GroupDocs.Merger Cloud SDK for Java, ви можете без зусиль поєднувати та зливати Powerpoint PPT PPTX у Java, незалежно від того, чи віддаєте перевагу нативній бібліотеці Java або підходу RESTful cURL. SDK керує зберіганням файлів, логікою злиття та генерацією вихідних даних, дозволяючи зосередитися на основних функціях вашого застосунку. Пам’ятайте отримати належну ліцензію для використання у продакшн; деталі ціноутворення доступні на сторінці продукту, а тимчасову ліцензію для оцінки можна запросити на сторінці тимчасової ліцензії. Почніть інтегрувати злиття PowerPoint вже сьогодні та оптимізуйте ваші документообігові процеси.

Питання та відповіді

• Які формати я можу об’єднувати за допомогою SDK?
  SDK підтримує як файли PPT, так і PPTX, а також багато інших типів документів, зазначених у довідці API.

• Чи потрібно конвертувати старі PPT файли перед об’єднанням?
  Конвертація не потрібна. SDK автоматично обробляє змішування джерел PPT та PPTX під час процесу злиття.

• Як SDK обробляє великі презентації?
  Об’єднання виконується на стороні сервера, тому споживання пам’яті на вашій клієнтській машині залишається низьким. Ви також можете налаштувати параметр PreserveLayout, щоб оптимізувати продуктивність.

• Чи можу я об’єднувати презентації без написання коду Java?
  Так. Використовуйте REST API з командами cURL, як показано раніше, або інтегруйте виклики в будь-яку мову, яка може виконувати HTTP‑запити.

Читати далі

• Розділити PowerPoint PPT/PPTX на окремі файли за допомогою Java
• Об’єднати та комбінувати презентації PowerPoint PPT/PPTX у C#
• Об’єднати файли PowerPoint в один у Java - Java Document Merging