前言
Spire.Cloud.Excel为开发人员提供了WorksheetsApi接口用于操作Excel工作表。本文将介绍如何使用该接口来为Excel文档添加新的工作表,及隐藏、删除文档中已有的工作表。
操作步骤:
步骤一:通过冰蓝云官网(https://cloud.e-iceblue.cn/)注册账号并登陆,在"我的应用"版块创建应用程序,以获得App ID及App Key。
步骤二:点击导航栏"文档管理",上传Excel示例文档至"我的文档"。
步骤三:创建Maven应用程序,在pom.xml文件中配置 Maven 仓库路径及添加Spire.Cloud.sdk的Maven依赖。
com.e-iceblue
cloud
http://repo.e-iceblue.cn/repository/maven-public/
cloud
spire.cloud.sdk
3.5.0
io.swagger
swagger-annotations
1.5.18
com.squareup.okhttp
okhttp
2.7.5
com.squareup.okhttp
logging-interceptor
2.7.5
com.squareup.okio
okio
1.6.0
com.google.code.gson
gson
2.8.1
io.gsonfire
gson-fire
1.8.0
org.threeten
threetenbp
1.3.5
配置完成后,在 IDEA 中,点击"Import Changes"即可导入 JAR 包;在 Eclipse 中,则需点击"Save"按钮。
步骤四:在Maven程序中编写代码调用WorksheetsApi接口来添加、隐藏及删除Excel工作表。
代码示例
示例1:添加新的工作表至Excel文档
importspire.cloud.excel.sdk.*;
importspire.cloud.excel.sdk.api.WorksheetsApi;
public classAddNewWorksheet{
staticString appId= "App ID";
staticString appKey= "App Key";
staticString baseUrl= "https://api.e-iceblue.cn";
publicstatic void main(String[] args) throwsApiException {
//配置App ID和App Key
Configuration configuration = newConfiguration(appId, appKey, baseUrl);
//初始化WorksheetsApi对象
WorksheetsApi WorksheetsApi = newWorksheetsApi(configuration);
//指定示例Excel文档
String name = "AddNewWorksheet.xlsx";
//存放示例文档的文件夹,如果没有文件夹则为null
String folder = null;
//使用冰蓝云配置的2G空间存贮文档,可设置为null
String storage = null;
//设置工作表类型
String sheetType = "NormalWorksheet";//Available value: NormalWorksheet, ChartSheet
//通过索引指定添加新工作表的位置
intindex = 2;
//设置新添加工作表名称
String newSheetName = "NewWorksheet";
//调用insertNewWorksheet方法来添加新的工作表至Excel文档
WorksheetsApi.insertNewWorksheet(name, newSheetName, index,sheetType, folder, storage);
}
}
添加效果:
示例2:隐藏工作表
importspire.cloud.excel.sdk.ApiException;
importspire.cloud.excel.sdk.Configuration;
importspire.cloud.excel.sdk.api.WorksheetsApi;
public classHideWorksheet {
staticString appId= "App ID";
staticString appKey= "App Key";
staticString baseUrl= "https://api.e-iceblue.cn";
public static voidmain(String[] args) throwsApiException {
//配置App ID和App Key
Configuration configuration = newConfiguration(appId, appKey, baseUrl);
//初始化WorksheetsApi对象
WorksheetsApi WorksheetsApi = newWorksheetsApi(configuration);
//指定示例Excel文档
String name = "HideWorksheet.xlsx";
//存放示例文档的文件夹,如果没有文件夹则为null
String folder = null;
//使用冰蓝云配置的2G空间存贮文档,可设置为null
String storage = null;
//指定被隐藏的工作表
String sheetName = "Sheet1";
//设置隐藏
booleanisVisible = false;
//设置显示
//boolean isVisible = true;
//调用changeVisibilityWorksheet方法来隐藏Excel文档中的第一个工作表
WorksheetsApi.changeVisibilityWorksheet(name, sheetName, isVisible, folder, storage);
}
}
隐藏效果:
示例3:删除工作表
importspire.cloud.excel.sdk.ApiException;
importspire.cloud.excel.sdk.Configuration;
importspire.cloud.excel.sdk.api.WorksheetsApi;
public classDeleteWorksheet{
staticString appId= "App ID";
staticString appKey= "App Key";
staticString baseUrl= "https://api.e-iceblue.cn";
publicstatic void main(String[] args) throwsApiException {
//配置App ID和App Key
Configuration configuration = newConfiguration(appId, appKey, baseUrl);
//初始化WorksheetsApi对象
WorksheetsApi WorksheetsApi = newWorksheetsApi(configuration);
//指定示例Excel文档
String name = "DeleteWorksheet.xlsx";
//存放示例文档的文件夹,如果没有文件夹则为null
String folder = null;
//使用冰蓝云配置的2G空间存贮文档,可设置为null
String storage = null;
//指定需被删除的工作表
String sheetName = "Sheet2";
//调用deleteWorksheet方法来删除Excel文档中的第二个工作表
WorksheetsApi.deleteWorksheet(name, sheetName, folder, storage);
}
}
删除效果:
(本文完)