Як завантажити документ у C++

Aspose.PDF FOSS для C++ відкриває існуючий PDF за допомогою класу Document — з простого шляху до файлу, або з паролем, коли джерело зашифровано — і надає доступ до /Info метаданих файлу через DocumentInfo. Цей посібник охоплює завантаження документа, виявлення та відкриття файлів, захищених паролем, читання та оновлення метаданих назви/автора/виробника, а також збереження результату. Бібліотеку додають до проєкту за допомогою CMake; кроку встановлення через менеджер пакетів немає.

Покроковий посібник

add_subdirectory(aspose.pdf-foss-for-cpp)
target_link_libraries(your_app PRIVATE aspose_pdf_foss)

#include <aspose/pdf/document.hpp>
#include <iostream>

int main() {
    Aspose::Pdf::Document doc;
    std::cout << "Linked OK — pages: " << doc.Pages().Count() << "\n";
}

#include <aspose/pdf/document.hpp>
#include <aspose/pdf/document_info.hpp>

using namespace Aspose::Pdf;

#include <iostream>
#include <stdexcept>

try {
    Document doc("input.pdf");
    std::cout << "Pages: " << doc.Pages().Count() << "\n";
} catch (const std::runtime_error& e) {
    std::cerr << "Not a valid PDF: " << e.what() << "\n";
} catch (const std::system_error& e) {
    std::cerr << "Could not read file: " << e.what() << "\n";
}

try {
    Document doc("input.pdf", "user-password");
    if (doc.IsEncrypted()) {
        std::cout << "Opened an encrypted document.\n";
    }
} catch (const std::runtime_error& e) {
    // Thrown when /Encrypt is present and the password matches
    // neither the user nor the owner entry in the trailer.
    std::cerr << "Wrong password or unreadable /Encrypt dictionary: "
              << e.what() << "\n";
}

Document doc("input.pdf");
DocumentInfo& info = doc.Info();

std::cout << "Title: "    << info.Title()    << "\n";
std::cout << "Author: "   << info.Author()   << "\n";
std::cout << "Subject: "  << info.Subject()  << "\n";
std::cout << "Producer: " << info.Producer() << "\n";
std::cout << "Creator: "  << info.Creator()  << "\n";
std::cout << "Keywords: " << info.Keywords() << "\n";

bool builtin = DocumentInfo::IsPredefinedKey("Title");   // true
bool custom  = DocumentInfo::IsPredefinedKey("MyKey");   // false

Document doc("input.pdf");
doc.Info().Author("Report Generator");
doc.SetTitle("Quarterly Report");   // equivalent to doc.Info().Title(title)

doc.Save("output.pdf");

Document doc("input.pdf");
doc.SetTitle("Updated In Place");
doc.Save();   // writes back to "input.pdf"

Поширені проблеми та виправлення

IsEncrypted() returns false для PDF, який я знаю, захищений паролем

Конструктор Document(path) з одним аргументом ніколи не автентифікує проти словника /Encrypt файлу, тому IsEncrypted() завжди повідомляє false для документа, відкритого таким чином, незалежно від того, чи зашифровано джерело насправді. Відкрийте файл за допомогою конструктора Document(path, password) з двома аргументами — це єдиний перегружений варіант, який заповнює стан шифрування.

Конструктор з двома аргументами викидає std::runtime_error

Це означає, що у вихідного PDF у трейлері є запис /Encrypt, і вказаний пароль не збігся ні з користувацьким, ні з паролем власника, що там записані. Перехопіть std::runtime_error і запросіть правильний пароль, або підтвердіть пароль поза каналом перед повторною спробою.

Save() викидає “no source filename to save to”

Конструктор Save() без аргументів записує назад у шлях, з якого був створений документ. Document, створений за допомогою конструктора без аргументів — новий документ у пам’яті без вихідного файлу — не має шляху для запису назад, тому Save() генерує виключення. Використайте Save(outputFileName) замість цього.

Decrypt() здається, не створює незахищений файл

Decrypt() очищає у пам’яті прапорець IsEncrypted(), тому подальші читання розглядають документ як простий текст, але у поточному випуску він не переписує словник /Encrypt у трейлері і не перекодує зашифровані рядки та потоки. Виклик Save() після Decrypt() все ще записує оригінальні байти, включаючи початкове шифрування — цей метод ще не створює копію простого тексту на диску.

Title/Author/тощо. виводяться порожніми рядками

DocumentInfo аксесори повертають порожній рядок, а не помилку, коли відповідний /Info ключ відсутній у вихідному PDF. Порожній результат означає, що поле ніколи не було встановлене в цьому документі, а не те, що читання не вдалося.

Поширені запитання

Чи працює Document(path) з зашифрованим PDF?

Зазвичай вона аналізує дерево сторінок без виключень, але ніколи не автентифікує пароль і завжди залишає IsEncrypted() у false. Використовуйте конструктор з двома аргументами, коли джерело може бути зашифровано.

Чи безпечно передавати пароль у Document(path, password) для файлу, який виявився незашифрованим?

Так. Коли у трейлері відсутній запис /Encrypt, аргумент пароля ігнорується, і документ відкривається так само, як і при використанні конструктора з одним аргументом.

Як розрізнити користувацький /Info ключ від вбудованого?

Викличте статичний DocumentInfo::IsPredefinedKey(key). Він повертає true для Title, Author, Subject, Keywords, Creator, Producer і Trapped, а false — для будь-якого іншого.

Чи можу я перезаписати файл, який щойно завантажив, замість запису в новий шлях?

Так — викличте Save() без аргументів на Document, який був створений з шляху до файлу; він записує назад у той самий шлях джерела. Він генерує виключення для документів, створених за допомогою конструктора без параметрів, які не мають шляху до джерела.

Чи видаляє збереження після Decrypt() захист PDF паролем?

Ні, не в поточному випуску — дивіться Common Issues вище. Decrypt() впливає лише на стан у пам’яті, який використовується читачами вмісту; файл, записаний за допомогою Save(), все ще містить оригінальний словник /Encrypt.

Дивіться також

• Документ, Сторінка та Основи рендерингу (Посібник розробника)
• Посібник з встановлення
• API Reference
• Репозиторій GitHub
• Aspose.PDF for C++ — Enterprise Knowledge Base