ตัวอย่างการทำงานเต็มรูปแบบสำหรับการลบวัตถุ Annotation จาก PDF ด้วย REST ใน Node.JS

ตัวอย่างนี้แสดงวิธีอัปโหลดไฟล์ PDF, ลบคำอธิบายทั้งหมด, และดาวน์โหลดไฟล์ที่ทำความสะอาดแล้วโดยใช้ GroupDocs.Annotation SDK.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบและอัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าขึ้นตอนที่จำเป็นทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีมสนับสนุนที่ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

ลบคำอธิบาย PDF ผ่าน REST API ด้วย cURL

ด้านล่างเป็นคำสั่ง cURL ที่ทำงานกระบวนการลบ annotation เดียวกันผ่าน REST endpoint ของ GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. ดึง annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

สำหรับรายการเต็มของ endpoint และพารามิเตอร์, โปรดดูที่ เอกสาร API อย่างเป็นทางการ

วิธีลบวัตถุ Annotation จาก PDF ด้วย REST ใน Node.JS ทำงาน

1. การตั้งค่าการรับรอง - คลาส Configuration ถูกสร้างขึ้นด้วย clientId และ clientSecret ของคุณ เพื่อสร้างบริบทที่ผ่านการรับรองสำหรับการเรียก API ทั้งหมดต่อไป

   const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
   

2. อัปโหลดไฟล์ - UploadFileRequest ส่งไบต์ PDF ที่อยู่ในเครื่องไปยังที่เก็บข้อมูลของ GroupDocs Cloud. วิธีการ storageApi.uploadFile จัดการการถ่ายโอน

   const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
       path: remoteFilePath,
       file: fileBytes
   });
   await storageApi.uploadFile(uploadRequest);
   

3. ดึงข้อมูลคำอธิบาย - GetAnnotationsRequest สร้างอ็อบเจ็กต์คำขอที่มีการอ้างอิง FileInfo. การเรียก annotationsApi.getAnnotations จะคืนคอลเลกชันของอ็อบเจ็กต์คำอธิบาย, จากนั้นดึง ID

   const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
       fileInfo: fileInfo
   });
   const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
   

4. ลบคำอธิบาย - หากมี ID ใด ๆ อยู่, DeleteAnnotationsRequest จะถูกเติมข้อมูลและส่งไปยัง annotationsApi.deleteAnnotations, ซึ่งจะลบคำอธิบายออกจาก PDF ที่จัดเก็บอย่างถาวร

   const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
       fileInfo: fileInfo,
       annotationIds: annotationIds
   });
   await annotationsApi.deleteAnnotations(deleteRequest);
   

5. ดาวน์โหลด PDF ที่สะอาด - สุดท้าย, DownloadFileRequest ดึงไฟล์ที่อัปเดต, และ fs.writeFileSync จะเขียนไฟล์นั้นลงในระบบไฟล์ของเครื่อง

   const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
       path: remoteFilePath
   });
   const fileStream = await storageApi.downloadFile(downloadRequest);
   fs.writeFileSync(localOutputPath, fileStream);
   

สำหรับการกำหนดคลาสและเมธอดโดยละเอียด โปรดดูที่ เอกสารอ้างอิง API.

การติดตั้งและกำหนดค่า GroupDocs.Annotation Cloud SDK for Node.js

SDK ถูกจัดจำหน่ายเป็นแพคเกจ npm. ติดตั้งโดยใช้คำสั่งด้านล่างและจากนั้นเรียกใช้ในโปรเจกต์ของคุณ.

npm install groupdocs-annotation-cloud

คุณยังสามารถดาวน์โหลดแพคเกจล่าสุดโดยตรงจาก หน้า releases ของ GitHub หรือจาก URL ดาวน์โหลดอย่างเป็นทางการ.

หลังจากการติดตั้ง ให้ทำการนำเข้าไลบรารีและสร้างอ็อบเจกต์การกำหนดค่า ตามที่แสดงในตัวอย่างโค้ด:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

ตรวจสอบให้แน่ใจว่าสภาพแวดล้อมการทำงานของคุณตรงตามข้อกำหนดเวอร์ชันของ Node.js และคุณมีบัญชี GroupDocs ที่ถูกต้องเพื่อรับข้อมูลประจำตัวของไคลเอนต์

ตัวเลือกและการตั้งค่าการลบคำอธิบาย

SDK เปิดเผยพารามิเตอร์หลายตัวที่คุณสามารถปรับแต่งได้:

• clientId / clientSecret - ข้อมูลประจำตัวสำหรับการตรวจสอบสิทธิ์ OAuth. ตั้งค่าเหล่านี้ในตัวสร้าง Configuration.
• fileInfo.filePath - เส้นทางของไฟล์ PDF ใน GroupDocs Cloud storage. ปรับค่านี้หากคุณเก็บไฟล์ในโฟลเดอร์อื่น.
• annotationIds - อาร์เรย์ของ ID ที่ได้รับจาก GetAnnotations. การระบุส่วนย่อยจะทำให้สามารถลบได้แบบเลือก.

การตั้งค่าเพิ่มเติม เช่น เวลาในการรอการร้องขอและการกำหนดค่าพร็อกซี มีให้ในเอกสาร SDK; ดู เอกสารอย่างเป็นทางการ สำหรับรายการทั้งหมด.

แนวทางปฏิบัติที่ดีที่สุดสำหรับการลบคำอธิบาย PDF ผ่าน REST

• ตรวจสอบ ID ของ Annotation - ควรตรวจสอบเสมอว่า ID ที่คุณต้องการลบมีอยู่จริง; การพยายามลบ ID ที่ไม่มีอยู่สามารถทำให้เกิดข้อผิดพลาด 404 ได้.
• ใช้ HTTPS - การเรียก API ทั้งหมดต้องทำผ่าน HTTPS เพื่อปกป้องข้อมูลประจำตัวและข้อมูลเอกสารของคุณ.
• จัดการไฟล์ขนาดใหญ่ด้วยการอัปโหลดแบบแบ่งส่วน - สำหรับไฟล์ PDF ที่มีขนาดใหญ่กว่า 100 MB ควรใช้ endpoint การอัปโหลดแบบ multipart เพื่อหลีกเลี่ยงการหมดเวลา.
• บันทึกการตอบสนองของ API - เก็บ ID ของคำขอและการตอบสนองเพื่อใช้เป็นบันทึกตรวจสอบและอำนวยความสะดวกในการแก้ไขปัญหา.
• ใช้ Access Token ซ้ำ - แคชโทเค็น OAuth จนกว่าจะหมดอายุเพื่อ ลดภาระการตรวจสอบสิทธิ์.

คำถามทั่วไป

• ฉันจะทำการรับรองความถูกต้องกับ GroupDocs.Annotation Cloud API อย่างไร?
  รับ client ID และ secret จากบัญชี GroupDocs ของคุณ, จากนั้นขอ access token ผ่าน OAuth endpoint. ดู เอกสารอย่างเป็นทางการ สำหรับรายละเอียด.

• ฉันสามารถลบคำอธิบายเฉพาะแทนที่จะลบทั้งหมดได้หรือไม่?
  ใช่, ให้ระบุ ID ของคำอธิบายที่คุณต้องการลบใน DeleteAnnotationsRequest. SDK จะคืนรายการของ ID คำอธิบายหลังจากการเรียก GetAnnotations.

• ฉันจะลบวัตถุ Annotation จาก PDF ด้วย REST ใน Node.JS ได้อย่างไร?
  ใช้ GroupDocs.Annotation Cloud SDK for Node.js เพื่อเรียก DeleteAnnotations endpoint หลังจากดึง ID ของ annotation แล้ว กระบวนการทำงานทั้งหมดแสดงในตัวอย่างโค้ดและส่วน cURL ของคู่มือนี้

• ต้องการใบอนุญาตอะไรสำหรับการใช้งานในสภาพแวดล้อมการผลิต?
  จำเป็นต้องมีใบอนุญาตแบบชำระเงินสำหรับการผลิต คุณสามารถรับใบอนุญาตชั่วคราวจาก หน้าใบอนุญาตชั่วคราว ในระหว่างการประเมิน

อ่านเพิ่มเติม

• ดึงหรือเอา Annotation ออกจาก PDF โดยใช้ REST API ใน Node.js
• ขีดเส้นข้อความใน PDF ด้วย Node.js และ REST API
• ลบ Annotation ออกจาก PDF โดยใช้ REST API ใน Python

ก่อนเริ่มต้น: ข้อกำหนดเบื้องต้นและการติดตั้ง

ก่อนที่คุณจะเริ่ม, ตรวจสอบให้แน่ใจว่าคุณมีสิ่งต่อไปนี้:

• Node.js 14 หรือใหม่กว่าที่ติดตั้งบนเครื่องพัฒนาของคุณ
• บัญชี GroupDocs Cloud ที่ใช้งานอยู่พร้อม client ID และ client secret
• การเข้าถึงไฟล์ PDF ที่คุณต้องการรวม ซึ่งจัดเก็บใน storage ของ GroupDocs Cloud

ติดตั้ง SDK ผ่าน npm และดาวน์โหลดแพ็กเกจล่าสุด:

npm install groupdocs-merger-cloud

คุณยังสามารถดึง SDK จากหน้าปล่อยอย่างเป็นทางการได้: ดาวน์โหลด SDK. หลังจากการติดตั้ง คุณพร้อมที่จะเริ่มเขียนโค้ดแล้ว.

คู่มือขั้นตอนการรวม PDF ใน Node.JS

ขั้นตอนที่ 1: ติดตั้ง SDK และนำเข้าคลาสที่จำเป็น

ขั้นแรก ให้นำเข้าคลาสที่คุณจะต้องใช้สำหรับการรวม PDF.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

การนำเข้านี้ทำให้คุณเข้าถึง API หลัก, วัตถุการกำหนดค่า, และตัวบ่งชี้ไฟล์ได้

ขั้นตอนที่ 2: กำหนดค่า Credentials ของ GroupDocs

สร้างอ็อบเจ็กต์การกำหนดค่าด้วยข้อมูลประจำตัวของไคลเอนต์ของคุณ.

const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

การให้ข้อมูลรับรองที่ถูกต้องทำให้ไลบรารีสามารถตรวจสอบความถูกต้องของคำขอของคุณได้.

ขั้นตอนที่ 3: กำหนดไฟล์ PDF ที่จะรวม

รายการเอกสาร PDF ที่คุณต้องการรวมเข้าด้วยกัน ขั้นตอนนี้เตรียมคุณให้สามารถรวม PDF ใน Node.JS ได้อย่างมีประสิทธิภาพ

const filesToMerge = [
    new FileInfo({ filePath: "input1.pdf" }),
    new FileInfo({ filePath: "input2.pdf" })
];

แต่ละ FileInfo ชี้ไปยังไฟล์ที่จัดเก็บในพื้นที่จัดเก็บของ GroupDocs Cloud ของคุณ.

ขั้นตอนที่ 4: ตั้งค่าตัวเลือกการรวม

กำหนดตำแหน่งที่เก็บผลลัพธ์และแนบรายการไฟล์ไปยังคำขอรวม

const mergeOptions = new MergeOptions();
mergeOptions.fileInfos = filesToMerge;
mergeOptions.outputPath = "merged_output.pdf";

การตั้งค่าเหล่านี้ควบคุมวิธีการรวม PDF ใน Node.JS และตำแหน่งที่ผลลัพธ์จะถูกบันทึก

ขั้นตอนที่ 5: ดำเนินการผสาน

สร้างอินสแตนซ์ของ API, เรียกเมธอด merge, และจัดการกับการตอบกลับ.

const mergeApi = new MergeApi(config);

try {
    const result = await mergeApi.mergeDocuments(mergeOptions);
    console.log("Merge completed. Output file stored at:", result.path);
} catch (error) {
    console.error("Error during PDF merge:", error);
}

การเรียกแบบอะซิงโครนัสจะคืนเส้นทางของเอกสารที่รวมกันหากการดำเนินการสำเร็จ

ตัวอย่างการใช้งานเต็มรูปแบบสำหรับการรวม PDF ใน Node.JS

โค้ดต่อไปนี้แสดงกระบวนการทำงานทั้งหมดตั้งแต่การกำหนดค่าไปจนถึงการจัดการผลลัพธ์.

const { MergeApi, MergeOptions, FileInfo, Configuration } = require("@groupdocs/merger-cloud");

// Configure the SDK (replace with your actual credentials)
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET"
});

async function mergePdfFiles() {
    // Initialize the Merge API
    const mergeApi = new MergeApi(config);

// Define the PDF files to be merged (must exist in GroupDocs Cloud storage)
    const filesToMerge = [
        new FileInfo({ filePath: "input1.pdf" }),
        new FileInfo({ filePath: "input2.pdf" })
    ];

// Set merge options
    const mergeOptions = new MergeOptions();
    mergeOptions.fileInfos = filesToMerge;
    mergeOptions.outputPath = "merged_output.pdf";

try {
        // Perform the merge operation
        const result = await mergeApi.mergeDocuments(mergeOptions);
        console.log("Merge completed. Output file stored at:", result.path);
    } catch (error) {
        console.error("Error during PDF merge:", error);
    }
}

// Execute the merge
mergePdfFiles();

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลักของฟังก์ชัน ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบและอัปเดตเส้นทางไฟล์และค่าการกำหนดค่าต่าง ๆ ให้ตรงกับสภาพแวดล้อมจริงของคุณ ตรวจสอบว่าการพึ่งพาที่จำเป็นทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดอ้างอิง เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ.

การรวม PDF ผ่าน REST API ด้วย cURL

หากคุณต้องการใช้วิธี REST แบบบริสุทธิ์เดียวกัน การดำเนินการเดียวกันสามารถทำได้ด้วยคำสั่ง cURL

ขั้นแรก ให้รับโทเคนการเข้าถึง:

curl -X POST "https://api.groupdocs.cloud/v2.0/oauth2/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET","grant_type":"client_credentials"}'

อัปโหลดไฟล์ PDF ต้นฉบับไปยังที่จัดเก็บของคุณ (แทนที่ YOUR_ACCESS_TOKEN ด้วยโทเคนจากขั้นตอนก่อนหน้า):

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/upload?path=input1.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/local/path/input1.pdf"

ทำซ้ำการอัปโหลดสำหรับ input2.pdf จากนั้นขอดำเนินการรวม:

curl -X POST "https://api.groupdocs.cloud/v2.0/merger/merge" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfos": [
               {"filePath":"input1.pdf"},
               {"filePath":"input2.pdf"}
           ],
           "outputPath":"merged_output.pdf"
         }'

สุดท้าย ให้ดาวน์โหลดไฟล์ที่รวมแล้ว:

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/download?path=merged_output.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o merged_output.pdf

สำหรับรายการเต็มของ endpoint และพารามิเตอร์, ดูที่ อ้างอิง API.

กำหนดค่าตัวเลือกการรวม

SDK เปิดเผยตัวเลือกหลายอย่างที่ให้คุณปรับแต่งกระบวนการรวมได้อย่างละเอียด:

• outputPath - เส้นทางปลายทางสำหรับ PDF ที่รวมกัน ปรับค่านี้เพื่อควบคุมตำแหน่งที่จัดเก็บผลลัพธ์
• fileInfos - อาร์เรย์ของอ็อบเจกต์ FileInfo ที่กำหนด PDF แหล่งที่มาและลำดับของมัน

คุณยังสามารถตั้งค่าคุณสมบัติเพิ่มเติมเช่น pages เพื่อรวมช่วงหน้าที่เฉพาะ หรือ password สำหรับไฟล์ PDF ที่เข้ารหัสได้อีกด้วย. ดูที่ เอกสารอย่างเป็นทางการ สำหรับรายการเต็มของฟิลด์ที่สามารถกำหนดค่าได้.

ข้อควรพิจารณาด้านประสิทธิภาพสำหรับการรวม PDF

เมื่อทำการรวมไฟล์ PDF ขนาดใหญ่หรือจำนวนมาก ให้คำนึงถึงเคล็ดลับต่อไปนี้:

• Use async/await เพื่อหลีกเลี่ยงการบล็อก event loop โดยเฉพาะสำหรับเอกสารขนาดใหญ่.
• Batch uploads: อัปโหลด PDF แหล่งที่มาพร้อมกันก่อนเรียกใช้การรวมเพื่อลดความหน่วงโดยรวม.
• Streamed processing: สำหรับ PDF ขนาดใหญ่มาก ให้พิจารณาเก็บผลลัพธ์ชั่วคราวในคลาวด์สตอเรจและทำการรวมเป็นส่วนย่อย ๆ.
• Encrypted PDFs: ให้รหัสผ่านในอ็อบเจ็กต์ FileInfo; การประมวลผลไฟล์ที่เข้ารหัสเพิ่มภาระงาน ดังนั้นควรรวมไฟล์หลังจากถอดรหัสเมื่อเป็นไปได้.

การใช้แนวปฏิบัติเหล่านี้ช่วยให้คุณรวม PDF ใน Node.JS อย่างมีประสิทธิภาพพร้อมลดการใช้หน่วยความจำลง

คำถามที่คุณอาจมี

• ฉันจะรวมไฟล์ PDF ใน Node.JS โดยใช้ GroupDocs ได้อย่างไร?
  ใช้ GroupDocs.Merger Cloud SDK for Node.js เพื่อสร้างอินสแตนซ์ MergeApi กำหนดค่า MergeOptions ด้วยไฟล์ PDF แหล่งที่มาของคุณ และเรียก mergeDocuments ตัวอย่างโค้ดเต็มในคู่มือนี้แสดงกระบวนการ

• ฉันสามารถรวมไฟล์ PDF ที่เข้ารหัสใน Node.JS ได้หรือไม่?
  ใช่, SDK รองรับการรวม PDF ที่เข้ารหัส. ให้ระบุรหัสผ่านที่ถูกต้องในอ็อบเจ็กต์ FileInfo ก่อนเรียก mergeDocuments. ดู เอกสารอย่างเป็นทางการ สำหรับรายละเอียด.

• ตัวเลือกการให้สิทธิ์การใช้งานสำหรับ GroupDocs.Merger มีอะไรบ้าง?
  GroupDocs มีแผนการกำหนดราคาที่ยืดหยุ่น สำหรับการทดสอบ คุณสามารถขอ ใบอนุญาตชั่วคราว เพื่อประเมินไลบรารีก่อนทำการซื้อการสมัครสมาชิกเต็มรูปแบบ

• ฉันสามารถค้นหาตัวอย่างเพิ่มเติมและการสนับสนุนได้จากที่ไหน?
  ตัวอย่างเพิ่มเติมมีให้ใน GitHub repository. สำหรับความช่วยเหลือ, เยี่ยมชม support forum.

การอ่านเพิ่มเติม

• แยก PDF เป็นหลายไฟล์ PDF ใน Node.JS
• ล็อกเอกสาร PDF ด้วยรหัสผ่านโดยใช้ REST API ใน Node.js
• วิธีรวมไฟล์ PDF ใน C# โดยใช้ REST API

เพิ่มลายน้ำรูปภาพในเอกสาร PDF ด้วย Java ใน 5 ขั้นตอน

1. เริ่มต้น API client: สร้างอินสแตนซ์ ApiClient ด้วย client ID และ secret ของคุณ.

ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
WatermarkApi watermarkApi = new WatermarkApi(apiClient);

ขั้นตอนนี้เชื่อมต่อโค้ด Java ของคุณกับบริการ GroupDocs.Watermark Cloud. ดูที่ เอกสารอ้างอิง API สำหรับรายละเอียดเพิ่มเติม.

2. ระบุไฟล์ PDF ต้นฉบับ: สร้างอ็อบเจ็กต์ FileInfo ที่ชี้ไปยัง PDF ที่คุณต้องการใส่ลายน้ำ.

FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("input.pdf");

ไฟล์ต้องอัปโหลดไปยัง GroupDocs storage ของคุณก่อนทำคำขอ.

3. กำหนดค่าตำแหน่งลายน้ำรูปภาพ: กำหนดเส้นทางของรูปภาพ, ความทึบแสง, ปัจจัยการสเกล, การหมุนและการจัดตำแหน่ง.

ImageWatermark imageWatermark = new ImageWatermark();
imageWatermark.setImagePath("watermark.png");
imageWatermark.setOpacity(0.5);
imageWatermark.setScaleFactor(0.3);
imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
imageWatermark.setMargin(new Margin(10, 10, 10, 10));

ปรับค่าต่าง ๆ เหล่านี้เพื่อให้ได้ลักษณะที่ต้องการ ความทึบแสงควบคุมความโปร่งใส, ในขณะที่ scaleFactor กำหนดขนาดสัมพันธ์กับหน้า.

4. ตั้งค่าตัวเลือกลายน้ำและเส้นทางการส่งออก: รวมข้อมูลไฟล์และลายน้ำเข้าเป็นอ็อบเจ็กต์ WatermarkOptions

   WatermarkOptions options = new WatermarkOptions();
   options.setFileInfo(fileInfo);
   options.setImageWatermark(imageWatermark);
   options.setOutputPath("output.pdf");
   

   outputPath บอกให้บริการทราบว่าควรจัดเก็บ PDF ที่ได้ที่ไหน.

5. ดำเนินการคำขอ: สร้าง AddWatermarkRequest และเรียก API. จัดการการตอบสนองที่สำเร็จหรือเกิดข้อผิดพลาด.

AddWatermarkRequest request = new AddWatermarkRequest(options);
try {
    AddWatermarkResponse response = watermarkApi.addWatermark(request);
    System.out.println("Watermark added successfully. Output file: " + response.getPath());
} catch (Exception e) {
    System.err.println("Error adding watermark: " + e.getMessage());
}

หลังจากดำเนินการเสร็จ ไฟล์ PDF ที่มีลายน้ำจะพร้อมใช้งานที่ตำแหน่งที่คุณระบุ.

ตัวอย่างโค้ดเต็ม: เพิ่มลายน้ำรูปภาพในเอกสาร PDF ด้วย Java

ตัวอย่างต่อไปนี้แสดงการดำเนินการเต็มรูปแบบตั้งแต่การเริ่มต้นไคลเอนต์จนถึงการบันทึกไฟล์ PDF ที่มีลายน้ำ

import com.groupdocs.cloud.watermark.api.WatermarkApi;
import com.groupdocs.cloud.watermark.client.ApiClient;
import com.groupdocs.cloud.watermark.model.AddWatermarkRequest;
import com.groupdocs.cloud.watermark.model.AddWatermarkResponse;
import com.groupdocs.cloud.watermark.model.FileInfo;
import com.groupdocs.cloud.watermark.model.ImageWatermark;
import com.groupdocs.cloud.watermark.model.Margin;
import com.groupdocs.cloud.watermark.model.WatermarkOptions;
import com.groupdocs.cloud.watermark.model.enums.HorizontalAlignment;
import com.groupdocs.cloud.watermark.model.enums.VerticalAlignment;

public class AddImageWatermarkExample {
    public static void main(String[] args) {
        // Initialize API client (replace with your actual credentials)
        ApiClient apiClient = new ApiClient("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");
        WatermarkApi watermarkApi = new WatermarkApi(apiClient);

// Input PDF file information
        FileInfo fileInfo = new FileInfo();
        fileInfo.setFilePath("input.pdf");

// Image watermark configuration
        ImageWatermark imageWatermark = new ImageWatermark();
        imageWatermark.setImagePath("watermark.png");          // Path to watermark image
        imageWatermark.setOpacity(0.5);                        // 50% opacity
        imageWatermark.setScaleFactor(0.3);                    // 30% of page size
        imageWatermark.setRotationAngle(0);                    // No rotation
        imageWatermark.setHorizontalAlignment(HorizontalAlignment.CENTER);
        imageWatermark.setVerticalAlignment(VerticalAlignment.CENTER);
        imageWatermark.setMargin(new Margin(10, 10, 10, 10));  // 10 points margin on all sides

// Watermark options
        WatermarkOptions options = new WatermarkOptions();
        options.setFileInfo(fileInfo);
        options.setImageWatermark(imageWatermark);
        options.setOutputPath("output.pdf"); // Resulting PDF with watermark

// Create request and call API
        AddWatermarkRequest request = new AddWatermarkRequest(options);
        try {
            AddWatermarkResponse response = watermarkApi.addWatermark(request);
            System.out.println("Watermark added successfully. Output file: " + response.getPath());
        } catch (Exception e) {
            System.err.println("Error adding watermark: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ ให้ตรวจสอบและอัปเดตเส้นทางไฟล์ (input.pdf, watermark.png, output.pdf) ให้ตรงกับตำแหน่งไฟล์จริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาทั้งหมดได้ถูกติดตั้งอย่างถูกต้อง และทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากคุณพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อ ทีมสนับสนุน เพื่อขอความช่วยเหลือ

ใช้ลายน้ำรูปภาพกับเอกสาร PDF ผ่าน cURL และ REST API

ด้านล่างเป็นคำเรียก REST ที่คุณสามารถใช้กับ cURL เพื่อให้ได้ผลลัพธ์เดียวกันโดยไม่ต้องเขียนโค้ด Java.

1. รับโทเค็นการเข้าถึง

   curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
        -H "Content-Type: application/json" \
        -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
   

   การตอบสนองจะมี access_token ที่ใช้ในการเรียกต่อไป.

2. อัปโหลดไฟล์ PDF ต้นฉบับ

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/input.pdf"
   

3. อัปโหลดภาพลายน้ำ

   curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=watermark.png" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@/path/to/watermark.png"
   

4. เพิ่มลายน้ำรูปภาพ

curl -X POST "https://api.groupdocs.cloud/v2.0/watermark/add" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.pdf" },
           "imageWatermark": {
               "imagePath": "watermark.png",
               "opacity": 0.5,
               "scaleFactor": 0.3,
               "horizontalAlignment": "Center",
               "verticalAlignment": "Center",
               "margin": { "top": 10, "right": 10, "bottom": 10, "left": 10 }
           },
           "outputPath": "output.pdf"
         }'

คำขอนี้สะท้อนตรรกะของโค้ด Java โดยใช้การตั้งค่าความทึบ, การสเกลและการจัดแนวเดียวกัน.

5. ดาวน์โหลด PDF ที่มีลายน้ำ

   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.pdf
   

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ request bodies และพารามิเตอร์ที่รองรับ ดู เอกสาร API อย่างเป็นทางการ.

การติดตั้งและกำหนดค่า GroupDocs.Watermark Cloud SDK for Java

เพิ่มการพึ่งพา Maven ลงใน pom.xml ของคุณ (หรือสคริปต์ Gradle ที่เทียบเท่า) ไลบรารีนี้โฮสต์บน Maven Central.

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-watermark-cloud</artifactId>
    <version>23.8</version>
</dependency>

คุณยังต้องมีบัญชี GroupDocs Cloud ที่ใช้งานได้. ดึง Client ID และ Client Secret ของคุณจาก GroupDocs portal. ไม่จำเป็นต้องติดตั้ง runtime เพิ่มเติมใด ๆ เนื่องจาก SDK สื่อสารกับบริการคลาวด์.

การปรับแต่งตัวเลือกลายน้ำรูปภาพสำหรับเอกสาร PDF

SDK เปิดเผยคุณสมบัติต่าง ๆ หลายอย่างที่ทำให้คุณควบคุมลักษณะการแสดงผลของลายน้ำ

ปรับความทึบแสง

imageWatermark.setOpacity(0.75); // 75% opacity for a more visible watermark

ค่าความทึบแสงอยู่ในช่วงตั้งแต่ 0.0 (โปร่งใสเต็มที่) ถึง 1.0 (ทึบเต็มที่).

เปลี่ยนปัจจัยสเกล

imageWatermark.setScaleFactor(0.5); // Watermark occupies 50% of the page width

ปัจจัยสเกลกำหนดขนาดของลายน้ำโดยอิงจากมิติของหน้า.

ตั้งค่าการจัดแนวและระยะขอบ

imageWatermark.setHorizontalAlignment(HorizontalAlignment.RIGHT);
imageWatermark.setVerticalAlignment(VerticalAlignment.BOTTOM);
imageWatermark.setMargin(new Margin(20, 20, 20, 20));

การตั้งค่านี้จะวางลายน้ำไว้ที่มุมล่าง‑ขวาพร้อมระยะขอบ 20‑จุด.

สำหรับรายการคุณสมบัติที่กำหนดค่าได้ทั้งหมด โปรดดูที่ อ้างอิง API.

สรุป

การเพิ่มลายน้ำรูปภาพลงในเอกสาร PDF ด้วย Java เป็นงานที่ทำได้อย่างง่ายดายเมื่อคุณใช้ GroupDocs.Watermark Cloud SDK for Java. SDK จัดการการปรับแต่ง PDF ระดับต่ำทั้งหมด ทำให้คุณสามารถมุ่งเน้นที่ด้านภาพเช่น ความทึบ, การปรับขนาดและการวางตำแหน่ง ไม่ว่าคุณจะชอบการใช้งานแบบ Java แท้หรือเวิร์กโฟลว์ cURL บนคลาวด์ ผลลัพธ์คุณภาพสูงเดียวกันก็สามารถทำได้โดยไม่เสียประสิทธิภาพ จำไว้ว่าต้องได้รับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในผลิตภัณฑ์; รายละเอียดราคาอยู่ในหน้าผลิตภัณฑ์และสามารถใช้ หน้าใบอนุญาตชั่วคราว สำหรับการประเมิน.

FAQs

• ฉันจะเพิ่มลายน้ำรูปภาพลงใน PDF ด้วย Java โดยไม่สูญเสียคุณภาพได้อย่างไร?
  ใช้คุณสมบัติ scaleFactor เพื่อกำหนดขนาดลายน้ำสัมพันธ์กับหน้าและรักษา DPI ดั้งเดิมของ PDF ต้นฉบับ SDK จะคงความละเอียดของ PDF ไว้ ดังนั้นลายน้ำจะแสดงคมชัดในทุกระดับการซูม

• ฉันสามารถเพิ่มลายน้ำหลายรายการใน PDF เดียวกันได้หรือไม่?
  ใช่. สร้างอ็อบเจ็กต์ ImageWatermark แยกกันด้วยการกำหนดค่าที่แตกต่างกันและเพิ่มพวกมันตามลำดับโดยเรียก addWatermark หลายครั้งหรือโดยการเพิ่มลงในรายการในคำขอ.

• รูปแบบภาพที่รองรับสำหรับลายน้ำคืออะไร?
  API รองรับประเภทภาพทั่วไปเช่น PNG, JPG, BMP, GIF และ TIFF. แนะนำให้ใช้ PNG เพื่อคุณภาพที่ไม่มีการสูญเสียและรองรับความโปร่งใส.

• มีวิธีดูตัวอย่างลายน้ำก่อนนำไปใช้หรือไม่?
  คุณสามารถใช้ GroupDocs.Watermark Cloud SDK for Java เพื่อสร้าง PDF ชั่วคราวที่มีลายน้ำและดาวน์โหลดเพื่อรีวิวได้ วิธีนี้ใช้การเรียก addWatermark เดียวกันโดยกำหนดเส้นทางเอาต์พุตไปยังตำแหน่งชั่วคราว

อ่านเพิ่มเติม

• เพิ่มลายน้ำลงในรูปภาพโดยใช้ Java
• เพิ่มลายน้ำลงใน Word ด้วย Java - Watermark Creator
• เพิ่มลายน้ำรูปภาพลงใน PDF | วิธีเพิ่มลายน้ำลงในเอกสาร PDF ด้วย .NET