Vanliga användningsfall för Aspose.PDF FOSS for Go

Aspose.PDF FOSS för Go är en ren-Go-modul för PDF-dokumenthantering. Denna artikel täcker de mest frekvent behövda operationerna med Document, Form, EncryptionOptions, Table och OutlineItemCollection typerna.

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

Steg-för-steg guide

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")

Vanliga problem och lösningar

pdf.Open returnerar ett fel för giltiga PDF-filer Kontrollera att filsökvägen är korrekt och att filen inte är öppen i en annan process. På Windows kan fillåsning förhindra läsningar.

Typassertion panic när du får åtkomst till formulärfält Använd pdf.FieldType(f) eller en typväxling för att inspektera fälttypen innan du påstår. En *pdf.TextBoxField assertion på en CheckboxField kommer att panikera.

go get misslyckas med “module not found” Ensure GOPROXY är inställd på en nåbar proxy (t.ex. GOPROXY=direct) och att ditt nätverk kan nå github.com. I luftisolerade miljöer, använd GONOSUMCHECK eller en lokal modulspegel.

SaveTo misslyckas efter OpenWithPassword Om du anropar Save after OpenWithPassword utan att anropa RemoveEncryption, utdata återkrypteras med det ursprungliga lösenordet. Detta är förväntat beteende — anropa RemoveEncryption explicit för att producera en klartextkopia.

Det sammanslagna dokumentets sidantal är fel. Append modifierar mottagaren på plats. Se till att du inte anropar Append på ett dokument som redan har sparats; öppna om basdokumentet om du behöver skapa flera sammanslagna utdata.

Vanliga frågor

Kan jag bearbeta PDF-filer utan att skriva till disk?

Document.WriteTo accepterar en io.Writer, så att du kan skriva till en buffer, nätverksström eller response writer utan att skapa en temporär fil.

Är det säkert att använda Aspose.PDF FOSS för Go parallellt?

Varje *Document-instans är inte goroutine-säker. Använd en Document per goroutine, eller skydda delade instanser med en mutex.

Hur läser jag tillbaka fältvärden från ett ifyllt formulär?

Använd Field.Value() på vilket fält som helst eller gör en type-assert för att komma åt typ-specifika åtkomstmetoder såsom CheckboxField.Checked() eller ComboBoxField.SelectedIndex().

Kan jag skapa en PDF från grunden utan en befintlig mall?

Ja. pdf.NewDocument() skapar ett tomt dokument. Anropa AddBlankPageFromFormat(pdf.PageFormatA4) för att lägga till en tom sida, och lägg sedan till innehåll (tabeller, annotationer osv.) innan du sparar.

Vad är skillnaden mellan Document.Save och Document.WriteTo?

Save(path string) skriver till en filväg. WriteTo(w io.Writer) skriver till vilken io.Writer som helst — användbart för HTTP-svar, buffertar eller strömpipelines.

Se även

• FAQ
• Installationsguide
• Funktioner i utvecklarguiden
• API Reference
• GitHub-arkiv
• Aspose.PDF — Enterprise Knowledge Base