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 文件夹下。
步骤四:在 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);
}
}