Spire.Cloud.Excel 保护和取消保护工作表

 

Spire.Cloud.Excel提供的WorksheetsApi接口用于操作Excel中的工作表,本文介绍如何使用该接口加密工作表或者移除工作表的密码保护。

步骤一:创建一个Maven程序,通过Maven仓库安装Spire.Cloud.SDK,详细步骤可参考这篇文章

步骤二:通过冰蓝云官网(https://cloud.e-iceblue.cn/)注册账号并登陆,在“我的应用”版块创建应用程序,获得App ID及App Key。

步骤三:上传Excel文档至冰蓝云官网的“文档管理”版块。为了便于文档管理,您也可以先创建“input”文件夹,然后将需要编辑的Excel文档上传至该文件夹下。本教程将示例文档(sample.xlsx)上传到了input文件夹下。

Spire.Cloud.Excel 保护和取消保护工作表

步骤四:在Maven程序中编写测试类操作input文件夹下的文档。

示例1、加密工作表

import spire.cloud.excel.sdk.ApiException;
import spire.cloud.excel.sdk.Configuration;
import spire.cloud.excel.sdk.api.WorksheetsApi;
import spire.cloud.excel.sdk.model.ProtectSheetParameter;

public class ProtectWorksheet {

    static String appId = "App ID";
    static String appKey = "App Key";
    static String baseUrl = "https://api.e-iceblue.cn";

    //配置App ID和App Key
    static Configuration configuration = new Configuration(appId, appKey, baseUrl);

    //初始化WorksheetsApi对象
    static WorksheetsApi worksheetsApi = new WorksheetsApi(configuration);

    public static void main(String[] args) throws ApiException {

        //指定源文档名称
        String name = "sample.xlsx";

        //指定要保护的工作表
        String sheetName = "Sheet1";

        //创建ProtectSheetParameter对象
        ProtectSheetParameter protectParameter = new ProtectSheetParameter();

        //指定保护密码
        protectParameter.setPassword("abc-123");

        //指定源文档的存放文件夹
        String folder = "input";

        //指定存储空间,使用冰蓝云默认存储空间,设置为null
        String storage = null;

        //调用protectWorksheet方法加密文档并保存到原路径
        worksheetsApi.protectWorksheet(name, sheetName, protectParameter, folder, storage);
    }
}

示例2、取消保护工作表

import spire.cloud.excel.sdk.ApiException;
import spire.cloud.excel.sdk.Configuration;
import spire.cloud.excel.sdk.api.WorksheetsApi;
import spire.cloud.excel.sdk.model.ProtectSheetParameter;

public class ProtectWorksheet {

    static String appId = "App Id";
    static String appKey = "App Key";
    static String baseUrl = "https://api.e-iceblue.cn";

    //配置App ID和App Key
    static Configuration configuration = new Configuration(appId, appKey, baseUrl);

    //初始化WorksheetsApi对象
    static WorksheetsApi worksheetsApi = new WorksheetsApi(configuration);

    public static void main(String[] args) throws ApiException {

        //指定源文档名称
        String name = "sample.xlsx";

        //指定要保护的工作表名
        String sheetName = "Sheet1";

        //创建ProtectSheetParameter对象
        ProtectSheetParameter protectParameter = new ProtectSheetParameter();

        //指定工作表的原密码
        protectParameter.setPassword("abc-123");

        //指定源文档的存放文件夹
        String folder = "input";

        //指定存储空间,使用冰蓝云默认存储空间,设置为null
        String storage = null;

        //调用unprotectWorksheet方法接触文档密码并保存到原路径
        worksheetsApi.protectWorksheet(name, sheetName, protectParameter, folder, storage);
    }
}