การแก้ไขไฟล์ Excel ด้วยโปรแกรมเป็นความต้องการที่พบบ่อยเมื่อสร้างแอปพลิเคชัน Java ที่ขับเคลื่อนด้วยข้อมูล, โดยเฉพาะอย่างยิ่งเมื่อคุณต้องอัปเดตรายงานหรือสร้างสเปรดชีตแบบไดนามิกแบบเรียลไทม์. GroupDocs.Editor Cloud SDK for Java ให้ไลบรารีที่มีพลังบนพื้นฐาน REST ที่ช่วยให้คุณจัดการเวิร์กบุ๊ก XLSX โดยไม่ต้องทำงานกับรูปแบบไฟล์ระดับต่ำ. ในคู่มือนี้คุณจะได้เห็นตัวอย่างโค้ด Java ครบชุด, คำสั่ง cURL ที่เทียบเท่า, ขั้นตอนการติดตั้ง, และตัวเลือกการกำหนดค่าเพื่อรวมการแก้ไข Excel เข้าในโครงการ Java ของคุณ.

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

ตัวอย่างต่อไปนี้แสดงวิธีการโหลดเวิร์กบุ๊ก Excel, ทำการเปลี่ยนแปลง, และบันทึกกลับไปยังที่จัดเก็บโดยใช้ GroupDocs.Editor Cloud SDK for Java.

import com.groupdocs.cloud.editor.api.*;
import com.groupdocs.cloud.editor.client.*;
import com.groupdocs.cloud.editor.model.*;
import com.groupdocs.cloud.editor.model.requests.*;

public class EditDocument {
    public static void main(String[] args) {
        // Configure API client
        ApiClient apiClient = new ApiClient();
        apiClient.setBasePath("https://api.groupdocs.cloud");
        apiClient.setAppSid("YOUR_CLIENT_ID");
        apiClient.setAppKey("YOUR_CLIENT_SECRET");

// Create EditorApi instance
        EditorApi editorApi = new EditorApi(apiClient);

// Load document
        LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
        LoadResult loadResult = editorApi.loadDocument(loadRequest);

// Get document pages (for Excel, each sheet is a page)
        // Edit cell via editing HTML? Not sure.

// Save document
        SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
        editorApi.saveDocument(saveRequest);
    }
}

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

การแก้ไข Excel REST ด้วยคำสั่ง cURL

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

  1. รับโทเค็นการเข้าถึง
    แทนที่ YOUR_CLIENT_ID และ YOUR_CLIENT_SECRET ด้วยข้อมูลประจำตัวของคุณ.
curl -X POST "https://api.groupdocs.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. อัปโหลดไฟล์ XLSX ต้นฉบับ
curl -X PUT "https://api.groupdocs.cloud/v2.0/editor/storage/file/sample.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" \
     --data-binary @sample.xlsx
  1. โหลดเวิร์กบุ๊กเพื่อแก้ไข
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/load" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "loadOptions": {}
         }'
  1. บันทึกเวิร์กบุ๊กที่แก้ไขแล้ว
curl -X POST "https://api.groupdocs.cloud/v2.0/editor/save" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "filePath": "sample.xlsx",
           "outputPath": "output.xlsx",
           "saveOptions": {}
         }'

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

ทำความเข้าใจการแก้ไขแผ่นงาน Excel ผ่าน REST ในโค้ด Java

ด้านล่างเป็นการแยกขั้นตอนอย่างละเอียดของตัวอย่าง Java:

  1. กำหนดค่า API client - วัตถุ ApiClient จะเก็บ URL ฐานและข้อมูลประจำตัวสำหรับการตรวจสอบสิทธิ์.
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");
  1. สร้างอินสแตนซ์ของ Editor API - EditorApi มีเมธอดเช่น loadDocument และ saveDocument.
EditorApi editorApi = new EditorApi(apiClient);
  1. โหลดเวิร์กบุ๊ก Excel - LoadDocumentRequest ระบุชื่อไฟล์; การตอบสนองจะมีข้อมูลหน้า (ชีต).
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);
  1. แก้ไขเวิร์กบุ๊ก - สำหรับ Excel แต่ละแผ่นทำงานเป็นหน้า คุณสามารถจัดการการแสดงผล HTML ของหน้า หรือใช้ API การแก้ไขอื่น ๆ (ตัวอย่างนี้ทิ้งส่วนนี้เป็นตัวแทนไว้)

  2. บันทึกไฟล์ที่แก้ไขแล้ว - SaveDocumentRequest กำหนดเส้นทางต้นทางและปลายทาง.

    SaveDocumentRequest saveRequest = new SaveDocumentRequest("sample.xlsx", "output.xlsx", null);
    editorApi.saveDocument(saveRequest);
    

สำหรับรายการคลาสและคุณสมบัติทั้งหมด, ดูที่ อ้างอิง API.

เตรียมสภาพแวดล้อม

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

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-editor-cloud</artifactId>
    <version>25.7</version>
</dependency>

ข้อกำหนดเบื้องต้น: Java 8 หรือสูงกว่า, บัญชี GroupDocs Cloud, และข้อมูลรับรองของลูกค้าที่ถูกต้อง (AppSid และ AppKey). ดาวน์โหลด JARs ล่าสุดจาก download page.

การกำหนดค่าตัวเลือกการแก้ไข Excel

SDK ช่วยให้คุณปรับแต่งพฤติกรรมการโหลดและการบันทึกได้อย่างละเอียด

  1. ตัวเลือกการโหลด - ควบคุมว่าหนังสือทำงานจะถูกเปิดในโหมด read‑only หรือไม่.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
  1. ตัวเลือกการบันทึก - เลือกรูปแบบเอาต์พุต (XLSX, CSV, เป็นต้น) และกำหนดว่าจะคงสูตรไว้หรือไม่
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
  1. การตั้งค่าการรับรองความถูกต้อง - คุณสามารถตั้งค่าเวลาหมดอายุหรือพร็อกซีที่กำหนดเองได้หากต้องการ.
apiClient.setTimeout(120000); // 2 minutes

ตัวเลือกเหล่านี้จะถูกส่งไปยังวัตถุคำขอที่แสดงไว้ก่อนหน้านี้.

สรุป

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

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

  • ฉันจะแก้ไขแผ่นงาน Excel ผ่าน REST ใน Java โดยใช้ GroupDocs.Editor ได้อย่างไร?
    ใช้เมธอด loadDocument และ saveDocument ของ SDK ตามตัวอย่างโค้ดที่แสดง ไลบรารีจะจัดการการสื่อสารผ่าน REST ให้คุณทำงานกับอ็อบเจ็กต์ Java เท่านั้น

  • วิธีการตรวจสอบสิทธิ์ใดที่ REST API ต้องการ?
    API ใช้กระบวนการ OAuth2 client‑credentials. รับ access token ด้วย AppSid และ AppKey ของคุณ, จากนั้นใส่ไว้ใน header Authorization: Bearer สำหรับทุกการเรียกใช้. รายละเอียดอยู่ใน เอกสารอย่างเป็นทางการ.

  • ฉันสามารถแก้ไขหลายแผ่นงานในคำขอเดียวได้หรือไม่?
    ใช่ หลังจากโหลดเวิร์กบุ๊ก แต่ละแผ่นงานจะปรากฏเป็นหน้าแยกใน LoadResult ทำการวนซ้ำหน้าต่างๆ ใช้การเปลี่ยนแปลง และเรียก saveDocument ครั้งเดียวเพื่อบันทึกการแก้ไขทั้งหมด

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

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