การซ่อนข้อมูลที่ละเอียดอ่อนในเวิร์กบุ๊ก Excel เป็นความต้องการทั่วไปสำหรับองค์กรที่แชร์รายงานภายในหรือกับพันธมิตร. GroupDocs.Merger Cloud SDK for Java ช่วยให้ผู้พัฒนาสามารถเพิ่มการป้องกันด้วยรหัสผ่านให้กับไฟล์ XLSX ผ่าน REST API อย่างง่าย. ในคู่มือนี้คุณจะได้เรียนรู้วิธีการ password Protect Excel via REST in Java, ดูตัวอย่าง Java แบบเต็ม, และเรียกใช้คำสั่ง cURL ที่เทียบเท่าสำหรับการผสานรวมกับคลาวด์.
ข้อกำหนดเบื้องต้นและการตั้งค่า
ก่อนที่คุณจะเริ่มต้น โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้:
- ติดตั้ง Java 8 หรือเวอร์ชันที่สูงกว่า
- Maven หรือ Gradle สำหรับการจัดการ dependencies
- บัญชี GroupDocs Cloud พร้อม client ID และ client secret
- เข้าถึงที่เก็บข้อมูลคลาวด์ที่ไฟล์ Excel จะถูกเก็บไว้
เพิ่มการพึ่งพา Maven ลงในไฟล์ pom.xml ของคุณ (หรือสแนปเพล็ต Gradle ที่เทียบเท่า):
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-merger-cloud</artifactId>
<version>25.11</version>
</dependency>
คุณสามารถดาวน์โหลด JAR ล่าสุดได้จาก หน้าดาวน์โหลด. หลังจากเพิ่ม dependency แล้ว ให้สร้างวัตถุการกำหนดค่าด้วยข้อมูลประจำตัวของคุณ:
String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";
Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);
เมื่อไคลเอนต์พร้อมแล้ว คุณสามารถดำเนินการต่อไปยังขั้นตอนการปกป้องด้วยรหัสผ่านจริงได้
ปกป้องไฟล์ Excel ด้วยรหัสผ่านผ่าน REST ใน Java: คู่มือแบบขั้นตอนต่อขั้นตอน
ขั้นตอนที่ 1: โหลดเอกสารต้นทาง
กำหนดตำแหน่งของไฟล์ XLSX ต้นฉบับในคลาวด์สตอเรจของคุณ.
FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx"); // source Excel file
ขั้นตอนที่ 2: ตั้งค่าเส้นทางปลายทาง
ระบุที่ตั้งที่ต้องการบันทึกเวิร์กบุ๊กที่ได้รับการป้องกัน
String outputPath = "output_protected.xlsx"; // destination file
ขั้นตอนที่ 3: กำหนดค่าตัวเลือกการป้องกันด้วยรหัสผ่าน
สร้างอ็อบเจ็กต์ ProtectOptions แล้วแนบข้อมูลไฟล์, เส้นทางออก, และรหัสผ่านที่ต้องการ.
ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password
ขั้นตอน 4: สร้างคำขอปกป้องเอกสาร
ห่อหุ้มตัวเลือกใน ProtectDocumentRequest
ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);
ขั้นตอนที่ 5: ดำเนินการคำขอและจัดการการตอบกลับ
เรียกใช้เมธอด API และจัดการข้อผิดพลาดใด ๆ
try {
mergerApi.protectDocument(request);
System.out.println("Excel file has been password protected successfully.");
System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
System.err.println("Error while protecting the Excel file:");
System.err.println("Status Code: " + e.getCode());
System.err.println("Message: " + e.getMessage());
}
สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับแต่ละคลาส โปรดดูที่ อ้างอิง API.
ตัวอย่างการทำงานเต็มสำหรับการป้องกันด้วยรหัสผ่าน Excel ผ่าน REST ใน Java
โค้ดต่อไปนี้แสดงกระบวนการทั้งหมดตั้งแต่เริ่มต้นจนจบ.
import com.groupdocs.merger.cloud.ApiException;
import com.groupdocs.merger.cloud.Configuration;
import com.groupdocs.merger.cloud.api.MergerApi;
import com.groupdocs.merger.cloud.model.FileInfo;
import com.groupdocs.merger.cloud.model.ProtectOptions;
import com.groupdocs.merger.cloud.model.requests.ProtectDocumentRequest;
public class ProtectExcelExample {
public static void main(String[] args) {
// Replace with your actual client credentials
String clientId = "YOUR_CLIENT_ID";
String clientSecret = "YOUR_CLIENT_SECRET";
// Initialize the API configuration
Configuration config = new Configuration(clientId, clientSecret);
MergerApi mergerApi = new MergerApi(config);
// Define input and output file locations (relative to the storage root)
FileInfo inputFile = new FileInfo();
inputFile.setFilePath("input.xlsx"); // source Excel file
String outputPath = "output_protected.xlsx"; // destination file
// Set password protection options
ProtectOptions protectOptions = new ProtectOptions();
protectOptions.setFileInfo(inputFile);
protectOptions.setOutputPath(outputPath);
protectOptions.setPassword("MySecretPassword"); // desired password
// Build the request
ProtectDocumentRequest request = new ProtectDocumentRequest(protectOptions);
try {
// Execute the password protection operation
mergerApi.protectDocument(request);
System.out.println("Excel file has been password protected successfully.");
System.out.println("Protected file stored at: " + outputPath);
} catch (ApiException e) {
System.err.println("Error while protecting the Excel file:");
System.err.println("Status Code: " + e.getCode());
System.err.println("Message: " + e.getMessage());
}
}
}
หมายเหตุ: ตัวอย่างโค้ดนี้แสดงการทำงานหลัก ก่อนนำไปใช้ในโครงการของคุณ โปรดตรวจสอบให้แน่ใจว่าได้อัปเดตเส้นทางไฟล์ (
input.xlsx,output_protected.xlsx) ให้ตรงกับตำแหน่งไฟล์จริงของคุณ ตรวจสอบว่าขึ้นตอนการพึ่งพาทั้งหมดได้ติดตั้งอย่างถูกต้องและทำการทดสอบอย่างละเอียดในสภาพแวดล้อมการพัฒนา หากพบปัญหาใด ๆ โปรดดูที่ เอกสารอย่างเป็นทางการ หรือ ติดต่อทีม ทีมสนับสนุน เพื่อขอความช่วยเหลือ.
ปกป้องเวิร์กบุ๊ก Excel ผ่าน REST API ด้วย cURL
ต่อไปนี้เป็นชุดคำสั่ง cURL ที่ทำการป้องกันด้วยรหัสผ่านเดียวกันโดยตรงกับ endpoint ของ REST
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. อัปโหลดไฟล์ XLSX ต้นฉบับ
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary @input.xlsx
3. ขอการป้องกันด้วยรหัสผ่าน
curl -X POST "https://api.groupdocs.cloud/v2.0/merger/protect" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"fileInfo": { "filePath": "input.xlsx" },
"outputPath": "output_protected.xlsx",
"password": "MySecretPassword"
}'
4. ดาวน์โหลดเวิร์กบุ๊กที่ได้รับการป้องกัน
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output_protected.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output_protected.xlsx
คำสั่งเหล่านี้ช่วยให้คุณรวมกระบวนการปกป้องเข้าไปในสคริปต์หรือไพป์ไลน์ CI ได้ สำหรับรายละเอียดเพิ่มเติม โปรดดูที่ เอกสาร API อย่างเป็นทางการ.
สรุป
การใช้งาน password Protect Excel via REST in Java ทำได้อย่างง่ายดายด้วย GroupDocs.Merger Cloud SDK for Java. โดยทำตามขั้นตอนข้างต้น คุณสามารถปกป้องเวิร์กบุ๊ก Excel, ทำกระบวนการอัตโนมัติในแอปพลิเคชันฝั่งเซิร์ฟเวอร์, และรักษาข้อมูลที่สำคัญให้ปลอดภัย. อย่าลืมรับใบอนุญาตที่เหมาะสมสำหรับการใช้งานในผลิตภัณฑ์; ข้อมูลราคาอยู่ในหน้าผลิตภัณฑ์และคุณสามารถเริ่มต้นด้วย ใบอนุญาตชั่วคราว เพื่อประเมินไลบรารี. ขอให้สนุกกับการเขียนโค้ด!
คำถามที่พบบ่อย
การป้องกันด้วยรหัสผ่าน Excel ผ่าน REST ใน Java แตกต่างจากการเข้ารหัสแบบโลคัลอย่างไร?
API บนคลาวด์ทำการเข้ารหัสบนเซิร์ฟเวอร์ ดังนั้นคุณไม่จำเป็นต้องจัดการไลบรารีการเข้ารหัสแบบคริปโตกราฟิกในเครื่อง SDK จะจัดการการสร้างคำขอและการแยกผลตอบกลับ ทำให้การรวมระบบง่ายขึ้นสามารถตั้งค่าตัวเลือกการป้องกันเพิ่มเติม เช่น โหมดอ่าน‑อย่าง‑เดียวได้หรือไม่?
คลาสProtectOptionsปัจจุบันมุ่งเน้นที่การป้องกันด้วยรหัสผ่าน สำหรับคุณลักษณะความปลอดภัยขั้นสูงกว่า ให้ดูที่ API reference เพื่อดูพารามิเตอร์ใหม่ ๆรูปแบบไฟล์ใดบ้างที่รองรับการป้องกันด้วยรหัสผ่าน?
API ของ Merger ปัจจุบันรองรับ XLSX, DOCX, PPTX, และ PDF สำหรับการเข้ารหัส. ดูที่ เอกสารอย่างเป็นทางการ เพื่อดูรายการทั้งหมด.ฉันต้องการใบอนุญาตเพื่อรันตัวอย่างในสภาพแวดล้อมการพัฒนาหรือไม่?
การพัฒนาและการทดสอบสามารถทำได้ด้วยใบอนุญาตชั่วคราว การปรับใช้ในสภาพแวดล้อมการผลิตต้องการใบอนุญาตที่ต้องชำระเงิน ซึ่งคุณสามารถซื้อได้ผ่านหน้าผลิตภัณฑ์
