การแก้ไขไฟล์ 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. ด้านล่างเป็นขั้นตอนทั่วไป.
- รับโทเค็นการเข้าถึง
แทนที่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"
- อัปโหลดไฟล์ 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
- โหลดเวิร์กบุ๊กเพื่อแก้ไข
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": {}
}'
- บันทึกเวิร์กบุ๊กที่แก้ไขแล้ว
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:
- กำหนดค่า API client - วัตถุ
ApiClientจะเก็บ URL ฐานและข้อมูลประจำตัวสำหรับการตรวจสอบสิทธิ์.
ApiClient apiClient = new ApiClient();
apiClient.setBasePath("https://api.groupdocs.cloud");
apiClient.setAppSid("YOUR_CLIENT_ID");
apiClient.setAppKey("YOUR_CLIENT_SECRET");
- สร้างอินสแตนซ์ของ Editor API -
EditorApiมีเมธอดเช่นloadDocumentและsaveDocument.
EditorApi editorApi = new EditorApi(apiClient);
- โหลดเวิร์กบุ๊ก Excel -
LoadDocumentRequestระบุชื่อไฟล์; การตอบสนองจะมีข้อมูลหน้า (ชีต).
LoadDocumentRequest loadRequest = new LoadDocumentRequest("sample.xlsx", null);
LoadResult loadResult = editorApi.loadDocument(loadRequest);
แก้ไขเวิร์กบุ๊ก - สำหรับ Excel แต่ละแผ่นทำงานเป็นหน้า คุณสามารถจัดการการแสดงผล HTML ของหน้า หรือใช้ API การแก้ไขอื่น ๆ (ตัวอย่างนี้ทิ้งส่วนนี้เป็นตัวแทนไว้)
บันทึกไฟล์ที่แก้ไขแล้ว -
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 ช่วยให้คุณปรับแต่งพฤติกรรมการโหลดและการบันทึกได้อย่างละเอียด
- ตัวเลือกการโหลด - ควบคุมว่าหนังสือทำงานจะถูกเปิดในโหมด read‑only หรือไม่.
LoadOptions loadOptions = new LoadOptions();
loadOptions.setReadOnly(false);
- ตัวเลือกการบันทึก - เลือกรูปแบบเอาต์พุต (XLSX, CSV, เป็นต้น) และกำหนดว่าจะคงสูตรไว้หรือไม่
SaveOptions saveOptions = new SaveOptions();
saveOptions.setFormat(SaveOptions.FormatEnum.XLSX);
saveOptions.setPreserveFormulas(true);
- การตั้งค่าการรับรองความถูกต้อง - คุณสามารถตั้งค่าเวลาหมดอายุหรือพร็อกซีที่กำหนดเองได้หากต้องการ.
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ของคุณ, จากนั้นใส่ไว้ใน headerAuthorization: Bearerสำหรับทุกการเรียกใช้. รายละเอียดอยู่ใน เอกสารอย่างเป็นทางการ.ฉันสามารถแก้ไขหลายแผ่นงานในคำขอเดียวได้หรือไม่?
ใช่ หลังจากโหลดเวิร์กบุ๊ก แต่ละแผ่นงานจะปรากฏเป็นหน้าแยกในLoadResultทำการวนซ้ำหน้าต่างๆ ใช้การเปลี่ยนแปลง และเรียกsaveDocumentครั้งเดียวเพื่อบันทึกการแก้ไขทั้งหมดฉันจะหาข้อมูลการกำหนดราคาและการให้สิทธิ์ได้จากที่ไหน?
เยี่ยมชมหน้าหลักของผลิตภัณฑ์เพื่อดูแผนการสมัครสมาชิกและ หน้าใบอนุญาตชั่วคราว เพื่อรับคีย์ทดลองใช้งาน.
