# excel2json

**Repository Path**: youngbo/excel2json

## Basic Information

- **Project Name**: excel2json
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-21
- **Last Updated**: 2025-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Excel2Json 工具

一个将 Excel 文件转换为 JSON 格式的 Java 工具类。

## 功能特点

- 支持 Excel 文件格式：.xlsx
- 支持合并单元格
- 支持多种数据类型：文本、数字、日期、布尔值、公式
- 自动美化 JSON 输出格式
- 内置日志功能，可追踪转换过程

## 使用要求

1. Excel 文件格式要求：
   - 第一行必须是表头
   - 表头将作为 JSON 对象的键名
   - 支持合并单元格的内容读取

2. 输出格式：
   - 生成的 JSON 为数组格式
   - 每行数据对应一个 JSON 对象
   - 使用美化格式输出，便于阅读

## 使用方法

### 基本用法

```java
import xyz.yb.util.Excel2Json;

try {
    String excelFile = "path/to/your/excel/file.xlsx";
    String jsonFile = "path/to/output/json/file.json";
    Excel2Json.convertExcelToJson(excelFile, jsonFile);
} catch (IOException e) {
    e.printStackTrace();
}
```

### 配置日志级别

工具类使用 `java.util.logging` 进行日志记录，您可以根据需要配置日志级别：

```java
import java.util.logging.Level;
import java.util.logging.Logger;

// 配置日志级别
Logger logger = Logger.getLogger(Excel2Json.class.getName());
logger.setLevel(Level.INFO); // 默认级别，记录一般信息

// 如果需要更详细的日志，可以设置为：
// logger.setLevel(Level.FINE);  // 详细信息
// logger.setLevel(Level.FINEST);  // 最详细的调试信息

// 如果只需要错误日志，可以设置为：
// logger.setLevel(Level.WARNING);  // 警告和错误
// logger.setLevel(Level.SEVERE);  // 只记录严重错误
```

## 日志级别说明

工具类在以下关键节点记录日志：

- **INFO 级别**：
  - 开始和完成转换
  - 表头读取完成
  - JSON 文件写入完成

- **WARNING 级别**：
  - 公式单元格计算失败

- **SEVERE 级别**：
  - 表头缺失
  - 转换过程中的异常

- **FINE/FINEST 级别**：
  - 数据行处理
  - 合并单元格检查
  - 空单元格处理

## 异常处理

工具类可能抛出以下异常：
- `IOException`：文件读写错误
- `IllegalArgumentException`：Excel 文件格式不正确（如第一行没有表头）

## 示例代码

完整的使用示例可以参考 `ExcelJsonConverter.java`。