"Which build tool supports the Maven dependency?"

"Maven (see *maven dependency groupdocs*)"

"Can I position QR codes on specific pages?"

"Yes, using alignment and page‑number options"

"Do I need a license for production?"

"Yes, a commercial GroupDocs license is required"

"Is the QR code scannable after signing?"

"Absolutely, when sized ≥ 100 × 100 px and placed with proper margins"

สร้าง QR code Java: คู่มือการลงลายเซ็น QR Code อย่างครบถ้วน

ในบทแนะนำนี้คุณจะได้เรียนรู้วิธี generate qr code java ลายเซ็นในเอกสาร PDF ด้วย GroupDocs.Signature for Java เราจะพาคุณผ่านการเพิ่ม QR code, การจัดตำแหน่งอย่างแม่นยำ, และการหลีกเลี่ยงข้อผิดพลาดที่มักทำให้ผู้พัฒนาตกหลุมพราง ไม่ว่าคุณจะสร้างแพลตฟอร์มการจัดการสัญญาหรือระบบใบแจ้งหนี้ที่ปลอดภัย คู่มือนี้ให้โซลูชันพร้อมใช้งานในระดับการผลิต

คำตอบด่วน

ไลบรารีใดที่เพิ่มลายเซ็น QR code ใน Java? GroupDocs.Signature for Java
เครื่องมือสร้างใดรองรับการพึ่งพา Maven? Maven (ดู maven dependency groupdocs)
ฉันสามารถจัดตำแหน่ง QR code บนหน้าที่เฉพาะได้หรือไม่? ได้ โดยใช้ตัวเลือกการจัดแนวและหมายเลขหน้า
ต้องการไลเซนส์สำหรับการผลิตหรือไม่? ต้องการไลเซนส์เชิงพาณิชย์ของ GroupDocs
QR code ยังคงสแกนได้หลังการลงลายเซ็นหรือไม่? แน่นอน หากขนาด ≥ 100 × 100 px และวางด้วยระยะขอบที่เหมาะสม

สิ่งที่คุณจะได้เรียนรู้

เมื่อจบคู่มือนี้คุณจะรู้วิธี:

ตั้งค่าการลงลายเซ็น QR code ในโครงการ Java ของคุณ (Maven, Gradle หรือดาวน์โหลดโดยตรง)
เพิ่ม QR code ลงในเอกสารที่ตำแหน่งที่แน่นอน (มุม, ศูนย์กลาง, การจัดแนวแบบกำหนดเอง)
จัดการกับปัญหาการใช้งานทั่วไปก่อนที่มันจะกลายเป็นปัญหาในระดับการผลิต
ปรับประสิทธิภาพสำหรับเวิร์กโฟลว์เอกสารที่มีการประมวลผลสูง
นำเทคนิคเหล่านี้ไปใช้ในสถานการณ์ธุรกิจจริง

ข้อกำหนดเบื้องต้น

ก่อนที่เราจะลงลึกในโค้ด โปรดตรวจสอบว่าคุณมี:

GroupDocs.Signature for Java – เวอร์ชัน 23.12 หรือใหม่กว่า (เราจะอธิบายการติดตั้งต่อไป)
Java Development Kit – JDK 8 หรือสูงกว่า (สภาพแวดล้อมการผลิตส่วนใหญ่ใช้ JDK 11+)
เครื่องมือสร้าง – Maven หรือ Gradle สำหรับการจัดการพึ่งพา
ความรู้พื้นฐาน Java – คุ้นเคยกับบล็อก try‑catch และการจัดการเส้นทางไฟล์

ไม่ต้องกังวลหากคุณยังใหม่กับ GroupDocs—เราจะอธิบายทุกขั้นตอนทีละขั้นตอน

การตั้งค่าสภาพแวดล้อมของคุณ

การนำ GroupDocs.Signature เข้ามาในโปรเจกต์ของคุณทำได้ง่าย เลือกวิธีที่สอดคล้องกับระบบการสร้างของคุณ

การใช้ Maven

เพิ่ม maven dependency groupdocs นี้ลงในไฟล์ pom.xml ของคุณ:

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


หลังจากเพิ่มแล้ว ให้รัน `mvn clean install` เพื่อดาวน์โหลดไลบรารี

### การใช้ Gradle

สำหรับโปรเจกต์ Gradle ให้เพิ่มบรรทัดนี้ลงในไฟล์ `build.gradle`:

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


จากนั้นซิงค์โปรเจกต์ด้วยคำสั่ง `gradle build`

### ตัวเลือกการดาวน์โหลดโดยตรง

ต้องการติดตั้งด้วยตนเอง? ดาวน์โหลด JAR โดยตรงจาก [GroupDocs.Signature for Java releases](https://releases.groupdocs.com/signature/java/) แล้วเพิ่มลงใน classpath ของโปรเจกต์คุณ

### การตั้งค่าไลเซนส์ (สำคัญ!)

นี่คือสิ่งที่หลายคนมองข้าม: GroupDocs ต้องการไลเซนส์สำหรับการใช้งานในระดับการผลิต ตัวเลือกมีดังนี้:

- **Free Trial** – ฟีเจอร์ครบชุด, ระยะเวลาจำกัด  
- **Temporary License** – ต้องการเวลามากกว่านี้? รับ [temporary license](https://purchase.groupdocs.com/temporary-license/) สำหรับการทดสอบต่อเนื่อง  
- **Commercial License** – สำหรับการใช้งานจริง, [purchase a license](https://purchase.groupdocs.com/buy)  

รุ่นทดลองจะใส่ลายน้ำ จึงควรวางแผนล่วงหน้าสำหรับการสาธิต

## การเริ่มต้นพื้นฐาน

`Signature` เป็นคลาสหลักที่เป็นจุดเข้าใช้งานใน GroupDocs.Signature for Java ซึ่งโหลดและจัดการเอกสารสำหรับการลงลายเซ็น หลังจากติดตั้งไลบรารีแล้ว การเริ่มต้นใช้งานก็ง่ายเพียงชี้ไปที่ไฟล์เอกสารของคุณ:

String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf";
Signature signature = new Signature(filePath);


บรรทัดนี้สร้างอ็อบเจ็กต์ `Signature` พร้อมทำงาน

## ทำความเข้าใจลายเซ็น QR Code

ลายเซ็น QR code จะฝังข้อมูลที่ตรวจสอบได้—เช่น timestamp, ตัวตนผู้ลงลายเซ็น, หรือ URL การตรวจสอบ—ลงในภาพ QR ที่สแกนได้ภายในเอกสาร เมื่อสแกน QR code จะพาผู้ใช้ไปยังพอร์ทัลตรวจสอบหรือแสดงเมตาดาต้าในตัว ช่วยให้การตรวจสอบผ่านมือถือทำได้อย่างรวดเร็วโดยไม่ต้องใช้ซอฟต์แวร์พิเศษ

**ควรใช้ลายเซ็น QR code เมื่อใด?**

- การตรวจสอบผ่านมือถืออย่างรวดเร็ว (สแกนด้วยโทรศัพท์)  
- เอกสารที่อาจพิมพ์ออกมาเป็นสำเนากระดาษ  
- ฝังลิงก์ไปยังพอร์ทัลตรวจสอบ  
- รองรับกระบวนการตรวจสอบแบบออฟไลน์  

## คู่มือการใช้งาน: การเพิ่มลายเซ็น QR Code

นี่คือส่วนที่โค้ดจะเป็นประโยชน์ เราจะลงลายเซ็น PDF ด้วย QR code ที่จัดตำแหน่งต่าง ๆ บนหน้า

### ทำไมการจัดตำแหน่งจึงสำคัญ

การจัดตำแหน่งที่เหมาะสมทำให้ QR code สแกนได้ง่าย ปฏิบัติตามมาตรฐานกฎหมาย และไม่บังเนื้อหาเอกสารสำคัญ สำหรับสัญญา ปกติวางที่มุมล่าง‑ขวา; สำหรับใบแจ้งหนี้ วางที่มุมบน‑ขวา; สำหรับใบรับรอง วางกึ่งกลางล่างเพื่อให้ดูเรียบง่าย

### การดำเนินการทีละขั้นตอน

#### 1. กำหนดเส้นทางไฟล์ของคุณ

กำหนดตำแหน่งไฟล์ต้นฉบับและที่ต้องการบันทึกไฟล์ที่ลงลายเซ็นแล้ว:

String filePath = "YOUR_DOCUMENT_DIRECTORY/sample.pdf";
String fileName = Paths.get(filePath).getFileName().toString();
String outputFilePath = new File("YOUR_OUTPUT_DIRECTORY", "SignWithAlignment/" + fileName).getPath();


**เคล็ดลับ:** ใช้ `Paths.get()` แทนการต่อสตริงเพื่อจัดการตัวคั่นของ OS อัตโนมัติ

#### 2. เริ่มต้นอ็อบเจ็กต์ Signature

ห่อการเริ่มต้นในบล็อก try‑catch เพื่อจัดการข้อผิดพลาดการเข้าถึงไฟล์:

try {
    Signature signature = new Signature(filePath);
    // Signing logic goes here...
} catch (Exception e) {
    throw new RuntimeException("Error initializing signature: " + e.getMessage(), e);
}


`RuntimeException` จะเพิ่มข้อมูลบริบทเมื่อดีบัก ช่วยประหยัดเวลาในระดับการผลิต

#### 3. กำหนดขนาดและตำแหน่งของ QR Code

`QrCodeSignOptions` กำหนดภาพ QR ที่จะวางบนเอกสาร สามารถตั้งค่าขนาด, ระยะขอบ, และการจัดแนวได้

int qrWidth = 100;
int qrHeight = 100;
List<SignOptions> listOptions = new ArrayList<>();

for (int horizontalAlignment : HorizontalAlignment.getValues()) {
    for (int verticalAlignment : VerticalAlignment.getValues()) {
        if (verticalAlignment != VerticalAlignment.None && horizontalAlignment != HorizontalAlignment.None) {
            QrCodeSignOptions options = new QrCodeSignOptions("Left-Top");
            options.setWidth(qrWidth);
            options.setHeight(qrHeight);
            options.setHorizontalAlignment(horizontalAlignment);
            options.setVerticalAlignment(verticalAlignment);
            options.setMargin(new Padding(5));
            listOptions.add(options);
        }
    }
}


ลูปนี้สร้างตัวเลือก QR code สำหรับทุกการจัดแนวแนวนอน (Left, Center, Right) และแนวตั้ง (Top, Center, Bottom) พร้อมระยะขอบ 5 พิกเซลเพื่อไม่ให้โค้ดชิดขอบหน้า

สำหรับสถานการณ์การผลิตส่วนใหญ่คุณอาจเลือกตำแหน่งเดียว เช่น ด้านล่าง‑ขวาสำหรับสัญญา:

QrCodeSignOptions options = new QrCodeSignOptions("Signature");
options.setWidth(100);
options.setHeight(100);
options.setHorizontalAlignment(HorizontalAlignment.Right);
options.setVerticalAlignment(VerticalAlignment.Bottom);
options.setMargin(new Padding(10));


#### 4. ลงลายเซ็นเอกสาร

ตอนนี้เราจะใช้ลายเซ็นทั้งหมดที่กำหนดในขั้นตอนเดียว:

SignResult signResult = signature.sign(outputFilePath, listOptions);


เมธอด `sign()` จะประมวลผล QR code ทุกตัวในรายการและบันทึกผลลัพธ์ลงใน `outputFilePath` ผลลัพธ์เป็นอ็อบเจ็กต์ `SignResult` ที่บอกจำนวนลายเซ็นที่เพิ่มสำเร็จ—เหมาะสำหรับการบันทึกล็อก

**หมายเหตุเรื่องประสิทธิภาพ:** การลงลายเซ็นเป็นแบบ synchronous หากต้องประมวลผลเอกสารหลายร้อยไฟล์ต่อชั่วโมง ควรรันในคิวงานเบื้องหลังแทนการตอบสนองต่อผู้ใช้โดยตรง

## ปัญหาที่พบบ่อยและวิธีแก้

### ปัญหา 1: ข้อผิดพลาด “File Not Found”

**อาการ:** เกิดข้อยกเว้นไฟล์ไม่พบแม้ว่าไฟล์จะมีอยู่  

**วิธีแก้:** ตรวจสอบสามอย่าง  
1. ใช้เส้นทางแบบ absolute หรือให้แน่ใจว่าไดเรกทอรีทำงานถูกต้อง  
2. ตรวจสอบสิทธิ์การอ่านของไฟล์ต้นฉบับและสิทธิ์การเขียนของโฟลเดอร์ผลลัพธ์  
3. Escape ตัวอักษรพิเศษในเส้นทาง

// Better approach: Use absolute paths
String absolutePath = new File(filePath).getAbsolutePath();
Signature signature = new Signature(absolutePath);


### ปัญหา 2: QR Codes Overlap Document Content

**อาการ:** QR code ครอบข้อความสำคัญหรือถูกตัดที่ขอบหน้า  

**วิธีแก้:** เพิ่มค่าระยะขอบและเลือกการจัดแนวที่อยู่ในพื้นที่ว่าง:

options.setMargin(new Padding(20)); // Increase from 5 to 20 pixels


### ปัญหา 3: Memory Issues with Large Documents

**อาการ:** `OutOfMemoryError` เมื่อประมวลผล PDF ขนาดเกิน 10 MB  

**วิธีแก้:** ปิดอ็อบเจ็กต์ `Signature` ทันทีและประมวลผลไฟล์ขนาดใหญ่เป็นชุด:

try (Signature signature = new Signature(filePath)) {
    // Your signing code
} // Automatically closes and releases resources


บล็อก try‑with‑resources รับประกันการทำความสะอาดแม้เกิดข้อยกเว้น

### ปัญหา 4: QR Code Content Isn’t Updating

**อาการ:** QR code ทั้งหมดแสดงข้อความเดียวแม้จะพยายามกำหนดค่าแตกต่างกัน  

**วิธีแก้:** สร้าง **QrCodeSignOptions** ใหม่สำหรับแต่ละตำแหน่ง ไม่ใช่ใช้วัตถุเดียวซ้ำหลายครั้ง:

// Wrong - reuses same object
QrCodeSignOptions options = new QrCodeSignOptions("Text");
options.setHorizontalAlignment(HorizontalAlignment.Left);
listOptions.add(options);
options.setHorizontalAlignment(HorizontalAlignment.Right); // Modifies existing!
listOptions.add(options);

// Correct - creates new object each time
listOptions.add(new QrCodeSignOptions("Left"));
listOptions.add(new QrCodeSignOptions("Right"));


## การประยุกต์ใช้งานจริง

### 1. ระบบการจัดการสัญญา

ขั้นตอน: สร้าง PDF สัญญา → เพิ่ม QR code ที่บรรจุ contract ID, timestamp, signer hash → เก็บอย่างปลอดภัย → ผู้ใช้สแกน QR → พอร์ทัลแสดงรายละเอียดสัญญา ทำให้ทีมกฎหมายตรวจสอบความถูกต้องจากสำเนาพิมพ์ได้ทันที

### 2. การทำงานอัตโนมัติของใบแจ้งหนี้

เพิ่ม QR code ที่มุมบน‑ขวาของใบแจ้งหนี้ทุกฉบับ โดยเข้ารหัสหมายเลขใบแจ้งหนี้, ID ผู้ขาย, timestamp การประมวลผล การจัดตำแหน่งสม่ำเสมอช่วยให้เครื่องสแกนอัตโนมัติค้นหาโค้ดได้เร็วขึ้น เพิ่มความเร็วในการตรวจสอบ

### 3. การรับรองเอกสาร

วาง QR code ที่ศูนย์ล่างของใบรับรอง พร้อม URL ตรวจสอบและ certificate ID ผู้รับสามารถสแกนเพื่อยืนยันความถูกต้องได้ทันที พร้อมให้ URL พิมพ์เป็นข้อความสำหรับผู้ที่ไม่มีมือถือ

### 4. การติดตามเอกสารภายใน

ในกระบวนการอนุมัติหลายขั้นตอน ฝัง QR code หลังจากแต่ละการลงนามที่บรรจุ approver ID, timestamp, version การสแกนจะแสดงประวัติการอนุมัติทั้งหมด ช่วยตอบสนองการตรวจสอบตามข้อกำหนด

## แนวทางปฏิบัติที่ดีที่สุดสำหรับการผลิต

### การจัดการทรัพยากร

ปิดอ็อบเจ็กต์ `Signature` เสมอเพื่อป้องกันการรั่วไหลของหน่วยความจำ:

try (Signature signature = new Signature(filePath)) {
    // Your code
} // Auto‑closes


พิจารณาใช้ pool การประมวลผลสำหรับเว็บแอปเพื่อจำกัดจำนวนการทำงานพร้อมกัน

### กลยุทธ์การจัดการข้อผิดพลาด

ให้ข้อมูลข้อผิดพลาดที่เป็นประโยชน์แทนการจับข้อยกเว้นแบบเงียบ:

try {
    SignResult result = signature.sign(outputFilePath, listOptions);
    if (result.getSucceeded().size() < listOptions.size()) {
        logger.warn("Only {} of {} signatures applied",
                    result.getSucceeded().size(),
                    listOptions.size());
    }
} catch (Exception e) {
    logger.error("Signature failed for document: {}", filePath, e);
    // Implement retry logic or alert mechanism
}


### การเพิ่มประสิทธิภาพ

สำหรับสภาพแวดล้อมที่ต้องประมวลผลจำนวนมาก:  

1. **Batch Processing** – ประมวลผลเอกสารเป็นกลุ่มพร้อมกัน แต่จำกัด concurrency ตาม RAM  
2. **Caching** – ใช้ `QrCodeSignOptions` เดียวกันซ้ำหลายไฟล์เมื่อค่าเหมือนกัน  
3. **Async Operations** – ย้ายการลงลายเซ็นไปยัง worker background เพื่อให้ API ตอบสนองเร็ว  
4. **Memory Monitoring** – ตั้งค่าแจ้งเตือนเมื่อใช้หน่วยความจำสูงและปรับขนาด batch ตามนั้น  

### ข้อควรพิจารณาด้านความปลอดภัย

- เก็บเอกสารที่ลงลายเซ็นแยกจากต้นฉบับ  
- บันทึกการดำเนินการลงลายเซ็นทุกครั้งเพื่อเป็น audit trail  
- กำหนดการเข้าถึงอย่างเข้มงวดรอบ endpoint ที่ทำการลงลายเซ็น  
- เข้ารหัส payload ของ QR code เมื่อจำเป็น  

## เมื่อใดควรใช้ลายเซ็น QR Code (และเมื่อไม่ควร)

**ควรใช้ลายเซ็น QR code เมื่อ:**  

- ต้องการการตรวจสอบที่เป็นมิตรกับมือถือ  
- เอกสารอาจพิมพ์และสแกนใหม่ได้  
- ต้องฝัง URL หรือ ID สำหรับการตรวจสอบ  
- มีขั้นตอนตรวจสอบแบบออฟไลน์เป็นส่วนหนึ่งของกระบวนการ  

**ไม่ควรใช้ลายเซ็น QR code เมื่อ:**  

- จำเป็นต้องมีลายเซ็น PKI ที่มีผลผูกพันตามกฎหมาย (ใช้ลายเซ็นเชิง cryptographic แทน)  
- QR code อาจเสียหายหรือถูกบังระหว่างการพิมพ์  
- ระบบตรวจสอบของคุณทำงานแบบออฟไลน์ทั้งหมด  
- ขนาดไฟล์เป็นข้อจำกัดสำคัญ (QR code เพิ่มขนาด ~5‑20 KB ต่อโค้ด)  

**แนวทางปฏิบัติที่แนะนำ:** ผสานลายเซ็น cryptographic กับ QR code เพื่อให้ได้ความถูกต้องตามกฎหมายและการตรวจสอบด้วยมือถือที่รวดเร็ว

## คู่มือการแก้ไขปัญหา

### ลายเซ็นไม่ปรากฏ

1. ตรวจสอบว่าไฟล์ผลลัพธ์ถูกสร้างจริงหรือไม่  
2. ยืนยันว่าคุณเปิดไฟล์ผลลัพธ์ที่ถูกต้อง  
3. ตรวจสอบ `SignResult` เพื่อดูจำนวนที่สำเร็จ  
4. ตรวจสอบค่าการจัดแนวและระยะขอบว่าไม่ได้ผลัก QR code ออกนอกหน้า  

### QR Code ไม่สามารถสแกนได้

- รักษาขนาด QR ≥ 100 × 100 px  
- ใช้คอนทราสต์สูง (โค้ดสีเข้มบนพื้นหลังสีอ่อน)  
- จำกัดข้อมูลที่เข้ารหัสให้ < 100 ตัวอักษรเพื่อความเสถียรในการสแกน  
- พิมพ์ที่ความละเอียด ≥ 300 dpi สำหรับสำเนากระดาษ  

### การลดประสิทธิภาพ

- ลดจำนวน QR code ต่อเอกสาร  
- ใช้ `Signature` ซ้ำเมื่อเป็นไปได้  
- ตรวจสอบการใช้หน่วยความจำ; พิจารณาประมวลผลเป็น batch เล็ก ๆ  

## คำถามที่พบบ่อย

**Q:** *Can I sign documents other than PDFs?*  
**A:** Yes. GroupDocs.Signature supports Word (DOC/DOCX), Excel (XLS/XLSX), PowerPoint (PPT/PPTX), and image formats (JPG, PNG, TIFF). The API remains consistent across all supported types.

**Q:** *How do I customize the QR code appearance?*  
**A:** Use `QrCodeSignOptions` properties such as `setForeColor()`, `setBackgroundColor()`, and `setBorder()`. Keep customizations simple to maintain scannability.

**Q:** *Can I add QR codes to specific pages in a multi‑page document?*  
**A:** Absolutely. Set the page number with `options.setPageNumber(pageNumber);`. Example:

options.setPageNumber(1); // Add to first page only


**Q:** *What data can I encode in the QR code?*  
**A:** Any text, URL, JSON, or XML—preferably under 200 characters for reliable scanning. For larger payloads, encode a short URL that points to the full data on a server.

**Q:** *How do I verify QR code signatures programmatically?*  
**A:** GroupDocs.Signature provides a `verify` method. Example:

VerificationResult result = signature.verify(verifyOptions);
if (result.isValid()) {
    // Signature is authentic
}


The `Signature` class is the main entry point for applying signatures to documents.  

**Q:** *Can I use this in a multi‑threaded environment?*  
**A:** Yes, but instantiate a separate `Signature` object per thread—instances are not thread‑safe. Use a processing queue for high‑concurrency scenarios.

**Q:** *What's the file size impact of adding QR codes?*  
**A:** Minimal—typically 5‑20 KB per QR code depending on size and content. For most PDFs this is negligible, but factor it in when signing thousands of pages in batch jobs.

---

**Last Updated:** 2026-05-21  
**Tested With:** GroupDocs.Signature 23.12 for Java  
**Author:** GroupDocs  

## แหล่งข้อมูล

- [GroupDocs.Signature for Java releases](https://releases.groupdocs.com/signature/java/)  
- [temporary license](https://purchase.groupdocs.com/temporary-license/)  
- [purchase a license](https://purchase.groupdocs.com/buy)  
- [GroupDocs documentation](https://docs.groupdocs.com/signature/java/)  
- [GroupDocs.Signature Java Docs](https://docs.groupdocs.com/signature/java/)  
- [Complete API Reference](https://reference.groupdocs.com/signature/java/)  
- [Latest Java Release](https://releases.groupdocs.com/signature/java/)  
- [Buy GroupDocs.Signature](https://purchase.groupdocs.com/buy)  
- [Start Your Free Trial](https://releases.groupdocs.com/signature/java/)  
- [Get Temporary License](https://purchase.groupdocs.com/temporary-license/)  
- [GroupDocs Forum](https://forum.groupdocs.com/c/signature/)

## บทแนะนำที่เกี่ยวข้อง

- [Java QR Code Signature Library - Complete GroupDocs Tutorial](/signature/java/qr-code-signatures/)
- [Extract QR Code Data in Java - Complete Guide with GroupDocs](/signature/java/qr-code-signatures/detect-qr-code-mecard-signatures-groupdocs-java/)
- [Remove QR Code from PDF Java - Complete Guide with GroupDocs](/signature/java/signature-management/delete-qr-code-signatures-groupdocs-java/)