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);
}
}