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

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

หากต้องการทำงานกับเมตาดาต้า PDF คุณต้องมี Java 8 หรือสูงกว่าและติดตั้ง Maven บนเครื่องพัฒนาของคุณ ดาวน์โหลดเวอร์ชันล่าสุดจาก หน้านี้.

เพิ่ม SDK ไปยังโครงการ Maven ของคุณ:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-metadata-cloud</artifactId>
    <version>23.9</version>
</dependency>

หรือทำการติดตั้งผ่านบรรทัดคำสั่ง:

mvn install com.groupdocs:groupdocs-metadata-cloud

สร้างไฟล์การกำหนดค่า (หรือกำหนดตัวแปรสภาพแวดล้อม) พร้อมกับ client ID และ client secret ของคุณที่ได้จากแดชบอร์ด GroupDocs Cloud ไม่จำเป็นต้องใช้รหัสใบอนุญาตสำหรับตัวอย่างนี้; สามารถขอรับใบอนุญาตชั่วคราวได้จาก license page.

ทำความเข้าใจเมตาดาต้า PDF

ไฟล์ PDF มีชุดคุณสมบัติมาตรฐาน (Title, Author, Subject, Keywords) และอนุญาตให้ใช้คู่คีย์‑ค่าแบบกำหนดเอง คุณสมบัติเหล่านี้ถูกจัดเก็บในพจนานุกรมเมตาดาต้าของเอกสารและสามารถอ่านหรือแก้ไขได้โดยไม่ต้องเปลี่ยนแปลงเนื้อหาภาพของไฟล์

คุณลักษณะสำคัญของ GroupDocs.Metadata Cloud SDK for Java

  • อ่านเมตาดาต้าที่มีอยู่จาก PDF, DOCX, XLSX, และรูปแบบอื่น ๆ อีกหลายรูปแบบ.
  • อัปเดตคุณสมบัติมาตรฐาน เช่น Title, Author, Creator, และ Producer.
  • เพิ่ม, แก้ไข หรือ ลบคุณสมบัติที่กำหนดเองโดยใช้อินเทอร์เฟซแผนที่แบบง่าย.
  • บันทึกการเปลี่ยนแปลงกลับไปยังไฟล์ต้นฉบับหรือไปยังตำแหน่งออกใหม่.

การแก้ไขคุณสมบัติมาตรฐานของเอกสาร PDF

SDK เปิดเผยคลาส MetadataInfo ซึ่งให้ตัว getter และ setter สำหรับฟิลด์มาตรฐานทั้งหมด คุณยังสามารถเข้าถึงคอลเลกชัน CustomProperties เพื่อทำงานกับรายการที่กำหนดโดยผู้ใช้ได้

การเพิ่มฟิลด์เมตาดาต้ากำหนดเอง

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

ขั้นตอนการแก้ไขเมตาดาต้า PDF ใน Java

  1. เริ่มต้นไคลเอนต์ API: สร้างอ็อบเจกต์ Configuration ด้วยข้อมูลประจำตัวของคุณและสร้างอินสแตนซ์ของ MetadataApi.
  2. อัปโหลดไฟล์ PDF ต้นฉบับ: ใช้ StorageApi เพื่อวางไฟล์ในที่เก็บข้อมูล GroupDocs Cloud ของคุณ.
  3. โหลดเมตาดาต้า PDF: เรียก metadataApi.getMetadataInfo เพื่อดึงอ็อบเจกต์ MetadataInfo.
  4. อัปเดตฟิลด์: ตั้งค่าคุณสมบัติมาตรฐาน (เช่น setTitle, setAuthor) และเพิ่มรายการกำหนดเองผ่าน getCustomProperties().put("MyKey", "MyValue").
  5. บันทึกการเปลี่ยนแปลง: เรียก metadataApi.updateMetadataInfo เพื่อเขียนเมตาดาต้าที่แก้ไขกลับไปยังไฟล์.

สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับคลาสที่ใช้ โปรดดูที่ อ้างอิง API

แก้ไขเมตาดาต้า PDF ใน Java - ตัวอย่างโค้ดเต็ม

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

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

แก้ไขเมตาดาต้า PDF ผ่าน REST API ด้วย cURL

หากคุณไม่ต้องการใช้ไลบรารี Java การดำเนินการเดียวกันสามารถทำได้ผ่าน GroupDocs Metadata Cloud REST API.

  1. รับโทเค็นการเข้าถึง
curl -X POST "https://api.groupdocs.cloud/v2.0/oauth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'
  1. อัปโหลดไฟล์ PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/octet-stream" \
     --data-binary "@C:/files/sample.pdf"
  1. อัปเดตเมตาดาต้า
   curl -X POST "https://api.groupdocs.cloud/v2.0/metadata/pdf/sample.pdf/metadata" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -H "Content-Type: application/json" \
        -d '{
              "title":"New Document Title",
              "author":"John Doe",
              "subject":"Updated Subject",
              "customProperties":{"Project":"Alpha","ReviewedBy":"Jane Smith"}
            }'
  1. ดาวน์โหลด PDF ที่อัปเดตแล้ว
   curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/sample.pdf" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o "C:/files/updated_sample.pdf"

คำสั่งเหล่านี้ช่วยให้คุณรวมการแก้ไขเมตาดาต้า PDF เข้าไปในสคริปต์, พายป์ไลน์ CI/CD, หรือสภาพแวดล้อมใด ๆ ที่การติดตั้งไลบรารี Java ไม่เป็นไปได้อย่างจริงจัง. สำหรับรายการเต็มของ endpoint, ดูที่ เอกสาร API.

สรุป

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

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

ฉันจะแก้ไขเมตาดาต้า PDF ใน Java โดยใช้ GroupDocs.Metadata Cloud SDK ได้อย่างไร?
ใช้ SDK เพื่อโหลด PDF, แก้ไขคุณสมบัติ MetadataInfo แล้วบันทึกไฟล์ ดูเอกสาร GroupDocs.Metadata Cloud SDK for Java สำหรับรายละเอียด

ฉันสามารถเพิ่มคู่คีย์-ค่าแบบกำหนดเองลงในเมตาดาต้าของ PDF ได้หรือไม่?
ใช่, SDK อนุญาตให้เพิ่มรายการแบบกำหนดเองผ่านเมธอด setCustomProperties. ดูที่ API reference สำหรับตัวอย่าง.

ใบอนุญาตชั่วคราวเพียงพอสำหรับการพัฒนาหรือไม่?
ใบอนุญาตชั่วคราวจาก หน้าใบอนุญาต จะช่วยให้คุณทดสอบ SDK ได้ สำหรับการใช้งานจริง ให้ซื้อใบอนุญาตเต็มรูปแบบ.

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

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