Reporting pada aplikasi web, selain ke bentuk file excel biasanya ke bentuk file pdf. Pada bab ini kita akan mempelajari cara membuat file pdf di golang menggunakan gofpdf.
gofpdf adalah library yang berguna untuk membuat dokumen PDF dari golang. Penggunannya tidak terlalu sulit. Jadi mari belajar sambil praktek seperti biasanya.
Pertama go get
library-nya.
go get -u github.com/jung-kurt/gofpdf
Buat folder projek baru, isi main dengan kode berikut.
package main
import (
"github.com/jung-kurt/gofpdf"
"log"
)
func main() {
pdf := gofpdf.New("P", "mm", "A4", "")
pdf.AddPage()
pdf.SetFont("Arial", "B", 16)
pdf.Text(40, 10, "Hello, world")
pdf.Image("./sample.png", 56, 40, 100, 0, false, "", 0, "")
err := pdf.OutputFileAndClose("./file.pdf")
if err != nil {
log.Println("ERROR", err.Error())
}
}
Statement gofpdf.New()
digunakan untuk membuat objek dokumen baru. Fungsi .New()
tersebut membutuhkan 4 buah parameter.
- Parameter ke-1, orientasi dokumen, apakah portrait (
P
) atau landscape (L
). - Parameter ke-2, satuan ukuran yang digunakan,
mm
berarti milimeter. - Parameter ke-3, ukuran dokumen, kira pilih A4.
- Parameter ke-4, path folder font.
Fungsi .New()
mengembalikan objek PDF. Dari situ kita bisa mengakses banyak method sesuai kebutuhan, beberapa diantaranya adalah 4 buah method yang dicontohkan di atas.
Method ini digunakan untuk menambah halaman baru. Defaultnya, objek dokumen yang baru dibuat tidak memiliki halaman. Dengan memanggil .AddPage()
maka halaman baru dibuat.
Setelah at least satu halaman tersedia, kita bisa lanjut ke proses tulis menulis.
Method ini digunakan untuk menge-set konfigurasi font dokumen. Font Family, Font Style, dan Font Size disisipkan dalam parameter secara berurutan.
Digunakan untuk menulis text pada koordinat tertentu. Pada kode di atas, 40
artinya 40mm
dari kiri, sedangkan 10
artinya 10mm
dari atas. Satuan milimeter digunakan karena pada saat penciptaan objek dipilih mm
sebagai satuan.
Method ini melakukan penulisan text pada current page.
Digunakan untuk menambahkan image. Method ini memerlukan beberapa parameter.
- Parameter ke-1 adalah path image.
- Paraketer ke-2 adalah x offset. Nilai
56
artinya56mm
dari kiri. - Parameter ke-3 adalah y offset. Nilai
40
artinya40mm
dari atas. - Parameter ke-4 adalah width gambar. Jika diisi dengan nilai lebih dari 0 maka gambar akan di-resize secara proporsional sesuai angka. Jika di-isi
0
, maka gambar akan muncul sesuai ukuran aslinya. Pada kode di atas, gambarsample.png
digunakan, silakan gunakan gambar apa saja bebas. - Parameter ke-5 adalah height gambar.
Sebenarnya masih banyak lagi method yang tersedia, selengkapnya cek saja di https://godoc.org/github.com/jung-kurt/gofpdf#Fpdf.
Setelah selesai bermain dengan objek pdf, gunakan .OutputFileAndClose()
untuk menyimpan hasil sebagai file fisik PDF.
Coba jalankan aplikasi untuk melihat hasilnya. Buka generated file file.pdf
, isinya kurang lebih seperti gambar berikut.
- gofpdf, by Kurt Jung, MIT license