การซ่อนข้อมูลที่ละเอียดอ่อนในเวิร์กบุ๊ก 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 สำหรับการเข้ารหัส. ดูที่ เอกสารอย่างเป็นทางการ เพื่อดูรายการทั้งหมด.

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

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