Häufige Anwendungsfälle für Aspose.PDF FOSS for Go

Aspose.PDF FOSS für Go ist ein reines Go-Modul für die Verwaltung von PDF-Dokumenten. Dieser Artikel behandelt die am häufigsten benötigten Vorgänge unter Verwendung der Document, Form, EncryptionOptions, Table und OutlineItemCollection Typen.

go get github.com/aspose-pdf-foss/aspose-pdf-foss-for-go

Schritt-für-Schritt-Anleitung

go get github.com/aspose-pdf-foss/aspose-pdf-foss-for-go

import (
    "fmt"
    pdf "github.com/aspose-pdf-foss/aspose-pdf-foss-for-go"
)

doc, err := pdf.Open("report.pdf")
if err != nil {
    panic(err)
}
pages, _ := doc.Split()
for i, p := range pages {
    p.Save(fmt.Sprintf("report_page_%03d.pdf", i+1))
}
fmt.Printf("Split %d pages\n", len(pages))

base, _ := pdf.Open("intro.pdf")
chapter1, _ := pdf.Open("chapter1.pdf")
chapter2, _ := pdf.Open("chapter2.pdf")
appendix, _ := pdf.Open("appendix.pdf")

base.Append(chapter1)
base.Append(chapter2)
base.Append(appendix)
base.Save("full_document.pdf")

doc, _ := pdf.Open("contract.pdf")
doc.SetEncryption(pdf.EncryptionOptions{
    UserPassword:  "clientpass",
    OwnerPassword: "adminpass",
    Permissions:   &pdf.Permissions{AllowPrint: true, AllowCopy: false},
})
doc.Save("contract_protected.pdf")

doc, _ := pdf.OpenWithPassword("contract_protected.pdf", "clientpass")
doc.RemoveEncryption()
doc.Save("contract_decrypted.pdf")

doc, _ := pdf.Open("application_form.pdf")

name := doc.Form().Field("applicant_name").(*pdf.TextBoxField)
name.SetValue("Jane Doe")

agree := doc.Form().Field("terms_accepted").(*pdf.CheckboxField)
agree.SetChecked(true)

country := doc.Form().Field("country").(*pdf.ComboBoxField)
country.SetSelected(0)

doc.Save("application_filled.pdf")

doc, _ := pdf.Open("invoice_template.pdf")
page, _ := doc.Page(1)

tbl := pdf.NewTable()
tbl.SetColumnWidths([]float64{200, 80, 100})

header := tbl.AddRow()
header.AddCell("Description")
header.AddCell("Qty")
header.AddCell("Amount")

row := tbl.AddRow()
row.AddCell("PDF Processing Service")
row.AddCell("1")
row.AddCell("$500.00")

page.AddTable(tbl, pdf.Rectangle{LLX: 72, LLY: 100, URX: 540, URY: 700})
doc.Save("invoice.pdf")

doc, _ := pdf.Open("manual.pdf")
page1, _ := doc.Page(1)
page2, _ := doc.Page(2)

ch1 := pdf.NewOutlineItemCollection(doc)
ch1.SetTitle("Introduction")
ch1.SetBold(true)
ch1.SetDestination(pdf.NewDestinationXYZ(page1, 0, 792, 1.0))
doc.Outlines().Add(ch1)

ch2 := pdf.NewOutlineItemCollection(doc)
ch2.SetTitle("Configuration")
ch2.SetDestination(pdf.NewDestinationFit(page2))
doc.Outlines().Add(ch2)

doc.Save("manual_bookmarked.pdf")

Häufige Probleme und Lösungen

pdf.Open gibt einen Fehler für gültige PDF-Dateien zurück Stellen Sie sicher, dass der Dateipfad korrekt ist und die Datei nicht in einem anderen Prozess geöffnet ist. Unter Windows kann Dateisperrung das Lesen verhindern.

Panik bei Typassertion beim Zugriff auf Formularfelder Verwenden pdf.FieldType(f) oder einen type switch, um den Feldtyp vor der Assertion zu prüfen. Ein *pdf.TextBoxField Assertion auf einem CheckboxField wird panic auslösen.

go get schlägt fehl mit “module not found” Ensure GOPROXY ist auf einen erreichbaren Proxy eingestellt (z. B. GOPROXY=direct) und dass Ihr Netzwerk erreichen kann github.com. In luftisolierten Umgebungen verwenden Sie GONOSUMCHECK oder einen lokalen Modulspiegel.

SaveTo schlägt nach OpenWithPassword Wenn Sie aufrufen Save after OpenWithPassword ohne aufzurufen RemoveEncryption, wird die Ausgabe mit dem ursprünglichen Passwort erneut verschlüsselt. Dies ist das erwartete Verhalten — rufen Sie RemoveEncryption explizit, um eine Klartextkopie zu erstellen.

Seitenanzahl des zusammengeführten Dokuments ist falsch Append ändert den Empfänger in-Place. Stellen Sie sicher, dass Sie nicht aufrufen Append auf einem Dokument, das bereits gespeichert wurde; öffnen Sie das Basisdokument erneut, wenn Sie mehrere zusammengeführte Ausgaben erstellen müssen.

Häufig gestellte Fragen

Kann ich PDFs verarbeiten, ohne sie auf die Festplatte zu schreiben?

Document.WriteTo akzeptiert ein io.Writer, sodass Sie in einen Puffer, Netzwerkstream oder Response-Writer schreiben können, ohne eine temporäre Datei zu erstellen.

Ist es sicher, Aspose.PDF FOSS für Go gleichzeitig zu verwenden?

Jede *Document-Instanz ist nicht goroutine-sicher. Verwenden Sie ein Document pro Goroutine oder schützen Sie gemeinsam genutzte Instanzen mit einem Mutex.

Wie lese ich Feldwerte aus einem ausgefüllten Formular zurück?

Verwenden Sie Field.Value() für jedes Feld oder führen Sie eine Typassertion durch, um typenspezifische Zugriffe wie CheckboxField.Checked() oder ComboBoxField.SelectedIndex() zu nutzen.

Kann ich ein PDF von Grund auf neu erstellen, ohne eine vorhandene Vorlage?

Ja. pdf.NewDocument() erstellt ein leeres Dokument. Rufen Sie AddBlankPageFromFormat(pdf.PageFormatA4) auf, um eine leere Seite anzuhängen, und fügen Sie anschließend Inhalte (Tabellen, Anmerkungen usw.) hinzu, bevor Sie speichern.

Was ist der Unterschied zwischen Document.Save und Document.WriteTo?

Save(path string) schreibt in einen Dateipfad. WriteTo(w io.Writer) schreibt in jede io.Writer — nützlich für HTTP-Antworten, Puffer oder Stream-Pipelines.

Siehe auch

• FAQ
• Installationsanleitung
• Funktionen des Entwicklerhandbuchs
• API Reference
• GitHub-Repository
• Aspose.PDF — Enterprise Knowledge Base