แก้ไขแผ่น 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"

2. อัปโหลดไฟล์ 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

3. โหลดเวิร์กบุ๊กเพื่อแก้ไข

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": {}
         }'

4. บันทึกเวิร์กบุ๊กที่แก้ไขแล้ว

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");

2. สร้างอินสแตนซ์ของ Editor API - EditorApi มีเมธอดเช่น loadDocument และ saveDocument.

EditorApi editorApi = new EditorApi(apiClient);

3. โหลดเวิร์กบุ๊ก Excel - LoadDocumentRequest ระบุชื่อไฟล์; การตอบสนองจะมีข้อมูลหน้า (ชีต).

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

4. แก้ไขเวิร์กบุ๊ก - สำหรับ Excel แต่ละแผ่นทำงานเป็นหน้า คุณสามารถจัดการการแสดงผล HTML ของหน้า หรือใช้ API การแก้ไขอื่น ๆ (ตัวอย่างนี้ทิ้งส่วนนี้เป็นตัวแทนไว้)

5. บันทึกไฟล์ที่แก้ไขแล้ว - 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);

2. ตัวเลือกการบันทึก - เลือกรูปแบบเอาต์พุต (XLSX, CSV, เป็นต้น) และกำหนดว่าจะคงสูตรไว้หรือไม่

SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);

3. การตั้งค่าการรับรองความถูกต้อง - คุณสามารถตั้งค่าเวลาหมดอายุหรือพร็อกซีที่กำหนดเองได้หากต้องการ.

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 ครั้งเดียวเพื่อบันทึกการแก้ไขทั้งหมด

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

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

• แก้ไขไฟล์ PowerPoint ด้วย Java Library
• แก้ไขเอกสาร Word หรือ Excel ด้วย REST API
• แก้ไขแผ่น Excel ด้วย REST API ใน Python