org.apache.poi.ss.usermodel.*
是Apache POI库中的核心包,用于读取、创建和修改Excel文件。
目录
一、导入org.apache.poi.ss.usermodel.*包
一、导入org.apache.poi.ss.usermodel.*包
org.apache.poi.ss.usermodel.*
是Apache POI库中的核心包,用于读取、创建和修改Excel文件。下面是该包中一些关键的使用方法:
-
Workbook:表示整个Excel工作簿,在一个工作簿中可以包含多个工作表(Sheet)。
Workbook workbook = WorkbookFactory.create(new File("path/to/your/excel/file.xls"))
:根据文件路径创建一个Workbook对象。Sheet sheet = workbook.getSheetAt(0)
:获取第一个工作表。Sheet sheet = workbook.getSheet("SheetName")
:根据名称获取指定的工作表。
-
Sheet:代表Excel工作表,包含行(Row)和单元格(Cell)。
Row row = sheet.getRow(rowIndex)
:获取指定索引的行。Cell cell = row.getCell(cellIndex)
:获取指定索引的单元格。
-
Row:表示Excel中的一行数据。
int lastRowNum = sheet.getLastRowNum()
:获取最后一行的索引(注意索引从0开始)。
-
Cell:代表单元格,存储在行中,并包含数据和样式信息。
String value = cell.getStringCellValue()
:获取单元格的字符串值。double value = cell.getNumericCellValue()
:获取单元格的数值。boolean value = cell.getBooleanCellValue()
:获取单元格的布尔值。
-
DataFormat:用于格式化单元格数据。
DataFormat dataFormat = workbook.createDataFormat()
:创建一个DataFormat对象。
-
CellStyle:表示单元格的样式,包括字体、背景颜色、数据格式等。
CellStyle style = workbook.createCellStyle()
:创建一个新的CellStyle对象。cell.setCellStyle(style)
:为单元格设置样式。
以上仅是org.apache.poi.ss.usermodel.*
包中的一些关键使用方法示例。根据具体需求可以进一步探索POI库提供的更多功能和方法。
二、使用步骤
1.引入库
要在Android Studio中导入org.apache.poi.ss.usermodel.*
库,你需要进行以下步骤:
-
打开你的Android Studio项目。
-
在项目的根目录下找到
build.gradle
文件,它位于模块目录的顶层(不是项目的根目录)。 -
在
dependencies
部分添加POI库的依赖项。在此处添加以下依赖:implementation 'org.apache.poi:poi:4.1.2' implementation 'org.apache.poi:poi-ooxml:4.1.2'
-
这将导入Apache POI库及其所需的相关依赖。
-
点击Android Studio工具栏上的“Sync Project with Gradle Files”按钮(或者使用快捷键Ctrl + Shift + O),以使更改生效并同步Gradle构建。
完成以上步骤后,你就可以在Android Studio中使用org.apache.poi.ss.usermodel.*
中的类和方法了。
确保在代码中正确导入所需的类,例如:
import org.apache.poi.ss.usermodel.*; // 其他必要的导入语句...
2.读入数据
代码如下(示例):
import java.io.FileInputStream;
import org.apache.poi.ss.usermodel.*;
public class ExcelReader {
public static void main(String[] args) {
try {
// 创建输入流,指定要读取的Excel文件路径
FileInputStream fis = new FileInputStream("path/to/your/excel/file.xls");
// 根据文件后缀判断Excel版本
Workbook workbook = WorkbookFactory.create(fis);
// 获取第一个工作表(通常是默认的第一个工作表),也可以根据名称获取工作表
Sheet sheet = workbook.getSheetAt(0);
// 遍历每一行
for (Row row : sheet) {
// 遍历每个单元格
for (Cell cell : row) {
// 根据单元格类型读取数据
switch (cell.getCellType()) {
case STRING:
System.out.print(cell.getStringCellValue() + "\t");
break;
case NUMERIC:
System.out.print(cell.getNumericCellValue() + "\t");
break;
case BOOLEAN:
System.out.print(cell.getBooleanCellValue() + "\t");
break;
default:
System.out.print("\t");
}
}
System.out.println();
}
// 关闭输入流
fis.close();
} catch (Exception e) {
e.printStackTrace();
}
}
}
3.详解
org.apache.poi.ss.usermodel.*
中的Sheet
接口表示Excel工作表。以下是Sheet
接口中常用的参数和方法的详解:
-
getRow(int rowIndex): Row:获取指定索引的行对象,索引从0开始。
-
createRow(int rowIndex): Row:创建并返回指定索引的行对象,如果该行已存在,则返回已存在的行对象。
-
removeRow(Row row): void:删除指定的行对象。
-
getLastRowNum(): int:获取最后一行的索引(基于0),即工作表中行的数量减1。
-
getFirstRowNum(): int:获取第一行的索引(基于0)。
-
getRowIterator(): Iterator<Row>:获取一个迭代器,在工作表的所有行上进行迭代。
-
getColumnWidth(int columnIndex): int:获取指定列的宽度(以字符数为单位)。
-
setColumnWidth(int columnIndex, int width): void:设置指定列的宽度(以字符数为单位)。
-
setDefaultColumnWidth(int width): void:设置默认列宽度(以字符数为单位)。
-
autoSizeColumn(int columnIndex): void:根据内容自适应调整指定列的宽度。
-
protectSheet(String password): void:保护工作表,并使用密码进行保护。需要提供一个密码字符串,如果不需要密码保护,则传递null或空字符串。
-
isProtected(): boolean:检查工作表是否被保护。
-
getSheetName(): String:获取工作表的名称。
-
setSheetName(String sheetName): void:设置工作表的名称。
-
getColumnStyle(int columnIndex): CellStyle:获取指定列的单元格样式。
-
setDefaultColumnStyle(int columnIndex, CellStyle style): void:为指定列设置默认的单元格样式。
-
protectSheet(String password, boolean shouldProtectObjects, boolean shouldProtectScenarios): void:保护工作表,可选择性地保护对象和场景,并提供密码进行保护。