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