Buat tanda tangan barcode java – perbarui barcode PDF

Saat Anda perlu memindahkan posisi barcode pada ribuan label pengiriman atau menyesuaikan lokasi barcode setelah redesain template, melakukannya secara manual rawan kesalahan dan memakan waktu. Dalam panduan ini Anda akan belajar cara membuat barcode signature java dan kemudian memodifikasi posisi, ukuran, serta properti lainnya secara programatis dengan GroupDocs.Signature untuk Java. Pendekatan ini bekerja untuk PDF, Word, Excel, PowerPoint, dan file gambar, memberikan Anda satu API konsisten untuk semua skenario otomasi dokumen Anda.

Jawaban cepat

  • Apa arti “create barcode signature”? Itu berarti menghasilkan objek BarcodeSignature yang dapat ditempatkan, dipindahkan, atau diedit di dalam dokumen melalui API.
  • Bisakah saya mengubah ukuran barcode setelah dibuat? Ya – gunakan setWidth/setHeight atau sesuaikan koordinat Left/Top‑nya.
  • Apakah saya memerlukan lisensi untuk memperbarui barcode? Versi percobaan dapat digunakan untuk pengembangan; lisensi penuh diperlukan untuk produksi.
  • Apakah ini hanya bekerja dengan PDF? Tidak – kode yang sama bekerja dengan Word, Excel, PowerPoint, dan format gambar umum.
  • Berapa banyak dokumen yang dapat saya proses sekaligus? Pemrosesan batch didukung; cukup kelola memori dengan try‑with‑resources.

Apa itu create barcode signature java?

Create barcode signature java adalah proses menginstansiasi objek BarcodeSignature yang mewakili barcode yang disematkan sebagai tanda tangan digital di dalam dokumen. Menggunakan API GroupDocs.Signature, Anda dapat secara programatis menambahkan barcode baru, menemukan yang sudah ada, atau memodifikasi properti seperti posisi, ukuran, dan teks yang dienkode, semuanya tanpa membuka file di editor visual.

Mengapa menggunakan GroupDocs.Signature untuk Java?

GroupDocs.Signature mendukung lebih dari 50 format input dan output—termasuk PDF, DOCX, XLSX, PPTX, dan tipe gambar umum—dan dapat memproses PDF beratus‑ratus halaman sambil menjaga penggunaan memori di bawah 100 MB. API batch‑nya menangani hingga 10.000 dokumen per run pada server standar, menjadikan pembaruan skala besar dapat dilakukan.

Prasyarat

  • GroupDocs.Signature untuk Java ≥ 23.12 (rilis sebelumnya tidak memiliki metode pembaruan yang digunakan di sini).
  • Java Development Kit 8 atau lebih tinggi.
  • IDE seperti IntelliJ IDEA, Eclipse, atau VS Code.
  • Pengetahuan dasar Java (kelas, objek, penanganan pengecualian).

Perpustakaan yang diperlukan

Tambahkan GroupDocs.Signature ke proyek Anda dengan alat build pilihan.

Maven

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-signature</artifactId>
    <version>23.12</version>
</dependency>

Gradle

implementation 'com.groupdocs:groupdocs-signature:23.12'

Unduhan langsung – dapatkan JAR terbaru dari GroupDocs.Signature for Java releases dan tambahkan ke classpath Anda.

Akuisisi lisensi

GroupDocs.Signature bekerja dengan lisensi percobaan maupun lisensi penuh:

  • Percobaan gratis – ideal untuk bukti konsep.
  • Lisensi sementara – untuk evaluasi lanjutan pada proyek tertentu.
  • Lisensi penuh – menghapus watermark dan batas penggunaan untuk produksi.

Tips profesional: Mulailah dengan percobaan gratis, lalu tingkatkan setelah Anda memvalidasi alur kerja.

Cara membuat barcode signature java

Langkah 1: inisialisasi instance signature

Signature adalah kelas utama yang memuat dokumen dan menyediakan metode untuk mencari, menambah, dan memperbarui tanda tangan.

Jawaban langsung

Buat objek Signature dengan memberikan path dokumen yang ingin Anda edit; ini akan memuat file ke memori dan menyiapkannya untuk operasi barcode. Kelas Signature adalah pintu gerbang ke semua aksi terkait tanda tangan. Ia membaca file dan menyediakan metode untuk mencari, menambah, atau memperbarui tanda tangan.

import com.groupdocs.signature.Signature;
import java.nio.file.Paths;

String filePath = "YOUR_DOCUMENT_DIRECTORY/your_document.pdf";

Signature signature = new Signature(filePath);

Tips profesional: Validasi path file sebelum membuat instance Signature untuk menghindari FileNotFoundException.

Langkah 2: cari tanda tangan barcode

BarcodeSearchOptions mendefinisikan kriteria yang digunakan saat memindai dokumen untuk tanda tangan barcode.

Jawaban langsung

Gunakan BarcodeSearchOptions bersama metode search untuk mendapatkan daftar semua tanda tangan barcode dalam dokumen. Anda tidak dapat memperbarui apa yang tidak dapat Anda temukan. GroupDocs.Signature menyediakan API pencarian yang kuat yang menyaring tanda tangan berdasarkan tipe, nomor halaman, atau format barcode.

import com.groupdocs.signature.options.search.BarcodeSearchOptions;
import com.groupdocs.signature.domain.signatures.BarcodeSignature;
import java.util.List;

BarcodeSearchOptions options = new BarcodeSearchOptions();

List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

Sekarang Anda memiliki daftar objek BarcodeSignature, masing‑masing menampilkan properti seperti Left, Top, Width, Height, Text, dan EncodeType.

Catatan kinerja: Untuk PDF yang sangat besar, batasi pencarian ke halaman atau tipe barcode tertentu untuk mempercepat eksekusi.

Langkah 3: perbarui properti barcode

BarcodeSignature mewakili satu barcode yang disematkan dalam dokumen dan menyediakan setter untuk atribut visualnya.

Jawaban langsung

Modifikasi Left, Top, Width, dan Height dari BarcodeSignature yang telah diambil dan panggil signature.update untuk menulis perubahan ke file baru. Ini memungkinkan Anda mengubah ukuran barcode atau memindahkannya ke posisi yang diinginkan, sementara file sumber tetap tidak tersentuh.

import java.io.File;
import com.groupdocs.signature.exception.GroupDocsSignatureException;

String fileName = Paths.get(filePath).getFileName().toString();
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY/UpdateBarcode/" + fileName).getPath();
checkDir(outputFilePath);

if (signatures.size() > 0) {
    BarcodeSignature barcodeSignature = signatures.get(0);
    
    // Update the barcode's position and size
    barcodeSignature.setLeft(100);
    barcodeSignature.setTop(100);
    
    // Apply the changes to the document
    boolean result = signature.update(outputFilePath, barcodeSignature);
    
    if (result) {
        System.out.println("Signature with Barcode '" +
            barcodeSignature.getText() + "' and encode type '"+
            barcodeSignature.getEncodeType().getTypeName() + "' was updated in the document ['" +
            fileName + "'].");
    }
} catch (GroupDocsSignatureException e) {
    System.err.println("Error updating signature: " + e.getMessage());
}

Poin penting

  • setLeft / setTop memindahkan barcode (koordinat diukur dari sudut kiri‑atas).
  • update menulis file baru; file asli tetap tidak berubah.
  • Bungkus pemanggilan dalam blok try‑catch untuk menangani kemungkinan GroupDocsSignatureException.

Kapan Anda harus memperbarui tanda tangan barcode?

Anda harus memperbarui tanda tangan barcode setiap kali tata letak dokumen berubah, persyaratan regulasi bergeser, atau Anda perlu memproses batch file yang ada setelah migrasi data. Memperbarui secara programatis menghindari pengeditan manual, mengurangi tingkat kesalahan, dan memastikan penempatan konsisten di ribuan file.

Masalah umum & solusi

Masalah 1: “Tidak ada tanda tangan barcode ditemukan”

Gejala: Pencarian mengembalikan daftar kosong meskipun barcode terlihat di PDF.

Penyebab yang mungkin

  • Barcode disematkan sebagai gambar atau field formulir, bukan sebagai objek tanda tangan.
  • Dokumen dilindungi kata sandi.
  • Anda memfilter tipe barcode tertentu yang tidak cocok.

Solusi

BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setAllPages(true); // Search all pages, not just the first
List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

if (signatures.isEmpty()) {
    System.out.println("No barcode signatures found. The barcodes might be images, not signature objects.");
}

Masalah 2: Dokumen yang diperbarui tampak rusak

Gejala: PDF tidak dapat dibuka setelah pembaruan.

Penyebab yang mungkin

  • Ruang disk tidak cukup.
  • Direktori output tidak ada.
  • Izin sistem file menghalangi penulisan.

Solusi

File outputDir = new File("YOUR_OUTPUT_DIRECTORY/UpdateBarcode/");
if (!outputDir.exists()) {
    outputDir.mkdirs(); // Create directories if they don't exist
}

// Check write permissions
if (!outputDir.canWrite()) {
    throw new IOException("Cannot write to output directory: " + outputDir.getAbsolutePath());
}

Masalah 3: Penurunan kinerja dengan dokumen besar

Gejala: Proses melambat secara dramatis untuk PDF lebih dari ~50 halaman.

Solusi

BarcodeSearchOptions options = new BarcodeSearchOptions();
options.setPageNumber(1); // Start with page 1
options.setPagesSetup(new PagesSetup());
options.getPagesSetup().setFirstPage(true);
options.getPagesSetup().setLastPage(false);

Tips optimalisasi kinerja

Manajemen memori untuk operasi batch

Proses satu dokumen pada satu waktu dan biarkan Java membersihkan sumber daya secara otomatis:

List<String> documentPaths = getDocumentList();
for (String path : documentPaths) {
    try (Signature sig = new Signature(path)) {
        // Process one document at a time
        // Signature instance is auto‑closed after each iteration
    }
}

Caching hasil pencarian

Jika Anda perlu mengubah beberapa properti pada barcode yang sama, lakukan pencarian sekali dan gunakan kembali daftar tersebut:

List<BarcodeSignature> signatures = signature.search(BarcodeSignature.class, options);

// Update multiple properties
for (BarcodeSignature barcode : signatures) {
    barcode.setLeft(100);
    barcode.setTop(100);
    barcode.setWidth(200);
    barcode.setHeight(50);
}

// Single update call with all changes
signature.update(outputPath, signatures);

Pemrosesan paralel untuk batch masif

Manfaatkan stream Java untuk mempercepat pemrosesan ribuan dokumen:

documentPaths.parallelStream().forEach(path -> {
    try (Signature sig = new Signature(path)) {
        List<BarcodeSignature> barcodes = sig.search(BarcodeSignature.class, new BarcodeSearchOptions());
        if (!barcodes.isEmpty()) {
            BarcodeSignature barcode = barcodes.get(0);
            barcode.setLeft(50);  // New position for smaller boxes
            barcode.setTop(10);
            sig.update(generateOutputPath(path), barcode);
        }
    } catch (Exception e) {
        logError(path, e);
    }
});

Aplikasi praktis

Kasus penggunaan 1: pembaruan label logistik otomatis

Sebuah perusahaan pengiriman mengubah dimensi kotak, memerlukan pemindahan barcode pada 50.000 label yang ada. Potongan kode pemrosesan paralel di atas mengurangi pekerjaan dari hari menjadi beberapa jam.

Kasus penggunaan 2: standarisasi template kontrak

Konsultan hukum mewajibkan lokasi barcode tetap untuk pemindaian. Dengan mencari dan memperbarui semua PDF kontrak dalam satu batch, tim menghindari pencetakan manual yang mahal.

Kasus penggunaan 3: integrasi sistem inventaris

Setelah upgrade ERP, barcode produk perlu diselaraskan dengan printer label baru. Memperbarui ukuran dan posisi barcode secara programatis menghemat waktu dan biaya material.

Daftar periksa pemecahan masalah

Sebelum menghubungi dukungan, periksa hal‑hal berikut:

  • Path file sudah benar dan file tersebut ada.
  • Izin baca/tulis sudah diberikan untuk sumber dan tujuan.
  • Versi GroupDocs.Signature adalah 23.12 atau lebih baru.
  • Lisensi telah dikonfigurasi dengan benar (jika menggunakan lisensi penuh).
  • Direktori output ada atau dibuat secara programatis.
  • Ruang disk cukup untuk file output.
  • Tidak ada proses lain yang mengunci file sumber.
  • Penanganan pengecualian sudah diterapkan untuk menangkap error.

Pertanyaan yang sering diajukan

T: Bisakah saya memperbarui kode barcode Java untuk beberapa barcode dalam satu dokumen?
J: Tentu saja. Iterasi melalui List<BarcodeSignature> yang dikembalikan oleh pencarian dan panggil signature.update() untuk masing‑masing, atau kirim seluruh daftar ke satu panggilan update.

T: Tipe barcode apa yang didukung oleh GroupDocs.Signature?
J: Puluhan tipe, termasuk Code 128, QR Code, EAN‑13, UPC‑A, DataMatrix, PDF417, dan lainnya. Gunakan barcodeSignature.getEncodeType() untuk memeriksa tipe.

T: Bisakah saya mengubah konten aktual barcode (data yang dienkode)?
J: Ya, lewat setText(), tetapi ingat untuk menghasilkan ulang barcode visual agar pemindai dapat membacanya dengan benar.

T: Bagaimana menangani dokumen dengan barcode di beberapa halaman?
J: Setiap BarcodeSignature memiliki getPageNumber(). Filter atau proses barcode per halaman sesuai kebutuhan.

T: Apa yang terjadi pada dokumen asli setelah pembaruan?
J: File sumber tetap tidak berubah. GroupDocs menulis perubahan ke jalur output yang Anda tentukan, menjaga original untuk keamanan.

T: Bisakah saya memperbarui barcode pada PDF yang dilindungi kata sandi?
J: Ya. Gunakan overload LoadOptions pada konstruktor Signature untuk menyertakan kata sandi.

T: Bagaimana cara memproses batch ribuan dokumen secara efisien?
J: Gabungkan parallel streams dengan try‑with‑resources (seperti contoh pemrosesan paralel) dan pantau penggunaan memori.

T: Apakah ini bekerja dengan format selain PDF?
J: Ya. API yang sama bekerja dengan Word, Excel, PowerPoint, gambar, dan banyak format lain yang didukung oleh GroupDocs.Signature.

Kesimpulan

Anda kini memiliki panduan lengkap dan siap produksi untuk create barcode signature java serta memperbarui posisi, ukuran, dan properti lainnya. Kami telah membahas inisialisasi, pencarian, modifikasi, pemecahan masalah, dan penyetelan kinerja untuk skenario dokumen tunggal maupun batch berskala besar.

Langkah selanjutnya

  • Bereksperimenlah dengan memperbarui properti tambahan seperti rotasi atau opasitas dalam satu pass.
  • Bungkus logika dalam layanan REST untuk mengekspos pembaruan barcode sebagai endpoint API.
  • Jelajahi tipe tanda tangan lain (teks, gambar, digital) menggunakan pola yang sama untuk mengotomatisasi alur kerja dokumen Anda secara menyeluruh.

Sumber daya

Terakhir diperbarui: 2026-08-19
Diuji dengan: GroupDocs.Signature 23.12
Penulis: GroupDocs

Tutorial terkait