增加导出数据到Excel的方法
This commit is contained in:
@@ -11,6 +11,7 @@
|
||||
- [存储工具](./storage.md) - 文件上传和查看（OSS、MinIO）
|
||||
- [邮件工具](./email.md) - SMTP邮件发送
|
||||
- [短信工具](./sms.md) - 阿里云短信发送
|
||||
- [Excel导出工具](./excel.md) - 数据导出到Excel文件
|
||||
- [工厂工具](./factory.md) - 从配置直接创建已初始化客户端对象
|
||||
- [日志工具](./logger.md) - 统一的日志记录功能
|
||||
- [国际化工具](./i18n.md) - 多语言内容管理和国际化支持
|
||||
|
||||
426
docs/excel.md
Normal file
426
docs/excel.md
Normal file
@@ -0,0 +1,426 @@
|
||||
# Excel导出工具文档
|
||||
|
||||
## 概述
|
||||
|
||||
Excel导出工具提供了将数据导出到Excel文件的功能，支持结构体切片、自定义格式化、多工作表等特性。通过工厂模式，外部项目可以方便地使用Excel导出功能。
|
||||
|
||||
## 功能特性
|
||||
|
||||
- **黑盒模式**：提供直接调用的方法，无需获取Excel对象
|
||||
- **延迟初始化**：Excel导出器在首次使用时才创建
|
||||
- **支持结构体切片**：自动将结构体切片转换为Excel行数据
|
||||
- **支持嵌套字段**：支持访问嵌套结构体字段（如 "User.Name"）
|
||||
- **自定义格式化**：支持自定义字段值的格式化函数
|
||||
- **自动列宽**：自动调整列宽以适应内容
|
||||
- **表头样式**：自动应用表头样式（加粗、背景色等）
|
||||
- **ExportData接口**：支持实现ExportData接口进行高级定制
|
||||
|
||||
## 使用方法
|
||||
|
||||
### 1. 创建工厂（推荐）
|
||||
|
||||
```go
|
||||
import "git.toowon.com/jimmy/go-common/factory"
|
||||
|
||||
// 方式1：从配置文件创建（推荐）
|
||||
fac, err := factory.NewFactoryFromFile("./config.json")
|
||||
if err != nil {
|
||||
log.Fatal(err)
|
||||
}
|
||||
|
||||
// 方式2：从配置对象创建
|
||||
cfg, _ := config.LoadFromFile("./config.json")
|
||||
fac := factory.NewFactory(cfg)
|
||||
|
||||
// 方式3：Excel导出不需要配置，可以传nil
|
||||
fac := factory.NewFactory(nil)
|
||||
```
|
||||
|
||||
### 2. 导出结构体切片到文件（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
// 定义结构体
|
||||
type User struct {
|
||||
ID int `json:"id"`
|
||||
Name string `json:"name"`
|
||||
Email string `json:"email"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
Status int `json:"status"`
|
||||
}
|
||||
|
||||
// 准备数据
|
||||
users := []User{
|
||||
{ID: 1, Name: "Alice", Email: "alice@example.com", CreatedAt: time.Now(), Status: 1},
|
||||
{ID: 2, Name: "Bob", Email: "bob@example.com", CreatedAt: time.Now(), Status: 1},
|
||||
}
|
||||
|
||||
// 定义导出列
|
||||
columns := []factory.ExportColumn{
|
||||
{Header: "ID", Field: "ID", Width: 10},
|
||||
{Header: "姓名", Field: "Name", Width: 20},
|
||||
{Header: "邮箱", Field: "Email", Width: 30},
|
||||
{Header: "创建时间", Field: "CreatedAt", Width: 20},
|
||||
{Header: "状态", Field: "Status", Width: 10},
|
||||
}
|
||||
|
||||
// 导出到文件
|
||||
err := fac.ExportToExcelFile("users.xlsx", "用户列表", columns, users)
|
||||
if err != nil {
|
||||
log.Fatal(err)
|
||||
}
|
||||
```
|
||||
|
||||
### 3. 导出到HTTP响应（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
import "net/http"
|
||||
|
||||
func exportUsersHandler(w http.ResponseWriter, r *http.Request) {
|
||||
fac, _ := factory.NewFactoryFromFile("./config.json")
|
||||
|
||||
users := []User{
|
||||
{ID: 1, Name: "Alice", Email: "alice@example.com", CreatedAt: time.Now(), Status: 1},
|
||||
{ID: 2, Name: "Bob", Email: "bob@example.com", CreatedAt: time.Now(), Status: 1},
|
||||
}
|
||||
|
||||
columns := []factory.ExportColumn{
|
||||
{Header: "ID", Field: "ID"},
|
||||
{Header: "姓名", Field: "Name"},
|
||||
{Header: "邮箱", Field: "Email"},
|
||||
}
|
||||
|
||||
// 设置HTTP响应头
|
||||
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
|
||||
w.Header().Set("Content-Disposition", "attachment; filename=users.xlsx")
|
||||
|
||||
// 导出到响应
|
||||
err := fac.ExportToExcel(w, "用户列表", columns, users)
|
||||
if err != nil {
|
||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
||||
return
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### 4. 使用格式化函数（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
import "git.toowon.com/jimmy/go-common/excel"
|
||||
|
||||
columns := []factory.ExportColumn{
|
||||
{Header: "ID", Field: "ID", Width: 10},
|
||||
{Header: "姓名", Field: "Name", Width: 20},
|
||||
{
|
||||
Header: "创建时间",
|
||||
Field: "CreatedAt",
|
||||
Width: 20,
|
||||
Format: excel.FormatDateTimeDefault, // 使用便捷的格式化函数
|
||||
},
|
||||
{
|
||||
Header: "状态",
|
||||
Field: "Status",
|
||||
Width: 10,
|
||||
Format: func(value interface{}) string {
|
||||
// 自定义格式化函数
|
||||
if status, ok := value.(int); ok {
|
||||
if status == 1 {
|
||||
return "启用"
|
||||
}
|
||||
return "禁用"
|
||||
}
|
||||
return ""
|
||||
},
|
||||
},
|
||||
}
|
||||
|
||||
err := fac.ExportToExcelFile("users.xlsx", "用户列表", columns, users)
|
||||
```
|
||||
|
||||
### 5. 使用ExportData接口（高级功能）
|
||||
|
||||
```go
|
||||
// 实现ExportData接口
|
||||
type UserExportData struct {
|
||||
users []User
|
||||
}
|
||||
|
||||
// GetExportColumns 获取导出列定义
|
||||
func (d *UserExportData) GetExportColumns() []excel.ExportColumn {
|
||||
return []excel.ExportColumn{
|
||||
{Header: "ID", Field: "ID", Width: 10},
|
||||
{Header: "姓名", Field: "Name", Width: 20},
|
||||
{Header: "邮箱", Field: "Email", Width: 30},
|
||||
}
|
||||
}
|
||||
|
||||
// GetExportRows 获取导出数据行
|
||||
func (d *UserExportData) GetExportRows() [][]interface{} {
|
||||
rows := make([][]interface{}, 0, len(d.users))
|
||||
for _, user := range d.users {
|
||||
row := []interface{}{
|
||||
user.ID,
|
||||
user.Name,
|
||||
user.Email,
|
||||
}
|
||||
rows = append(rows, row)
|
||||
}
|
||||
return rows
|
||||
}
|
||||
|
||||
// 使用
|
||||
exportData := &UserExportData{users: users}
|
||||
columns := exportData.GetExportColumns()
|
||||
err := fac.ExportToExcelFile("users.xlsx", "用户列表", columns, exportData)
|
||||
```
|
||||
|
||||
### 6. 获取Excel对象（高级功能）
|
||||
|
||||
```go
|
||||
// 获取Excel导出器对象（仅在需要高级功能时使用）
|
||||
excel, err := fac.GetExcel()
|
||||
if err != nil {
|
||||
log.Fatal(err)
|
||||
}
|
||||
|
||||
// 获取excelize.File对象，用于高级操作
|
||||
file := excel.GetFile()
|
||||
|
||||
// 创建多个工作表
|
||||
file.NewSheet("Sheet2")
|
||||
file.SetCellValue("Sheet2", "A1", "数据")
|
||||
|
||||
// 自定义样式
|
||||
style, _ := file.NewStyle(&excelize.Style{
|
||||
Font: &excelize.Font{
|
||||
Bold: true,
|
||||
Size: 14,
|
||||
},
|
||||
})
|
||||
file.SetCellStyle("Sheet2", "A1", "A1", style)
|
||||
```
|
||||
|
||||
## API 参考
|
||||
|
||||
### 工厂方法（黑盒模式，推荐使用）
|
||||
|
||||
#### ExportToExcel(w io.Writer, sheetName string, columns []ExportColumn, data interface{}) error
|
||||
|
||||
导出数据到Writer。
|
||||
|
||||
**参数：**
|
||||
- `w`: Writer对象（如http.ResponseWriter）
|
||||
- `sheetName`: 工作表名称（可选，默认为"Sheet1"）
|
||||
- `columns`: 列定义
|
||||
- `data`: 数据列表（可以是结构体切片或实现了ExportData接口的对象）
|
||||
|
||||
**返回：** 错误信息
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
fac.ExportToExcel(w, "用户列表", columns, users)
|
||||
```
|
||||
|
||||
#### ExportToExcelFile(filePath string, sheetName string, columns []ExportColumn, data interface{}) error
|
||||
|
||||
导出数据到文件。
|
||||
|
||||
**参数：**
|
||||
- `filePath`: 文件路径
|
||||
- `sheetName`: 工作表名称（可选，默认为"Sheet1"）
|
||||
- `columns`: 列定义
|
||||
- `data`: 数据列表
|
||||
|
||||
**返回：** 错误信息
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
fac.ExportToExcelFile("users.xlsx", "用户列表", columns, users)
|
||||
```
|
||||
|
||||
### 高级方法
|
||||
|
||||
#### GetExcel() (*excel.Excel, error)
|
||||
|
||||
获取Excel导出器对象。
|
||||
|
||||
**返回：** Excel导出器对象和错误信息
|
||||
|
||||
**说明：**
|
||||
- 仅在需要使用高级功能时使用
|
||||
- 推荐使用黑盒方法：`ExportToExcel()`、`ExportToExcelFile()`
|
||||
|
||||
### 结构体类型
|
||||
|
||||
#### ExportColumn
|
||||
|
||||
导出列定义。
|
||||
|
||||
```go
|
||||
type ExportColumn struct {
|
||||
Header string // 表头名称
|
||||
Field string // 数据字段名（支持嵌套字段，如 "User.Name"）
|
||||
Width float64 // 列宽（可选，0表示自动）
|
||||
Format func(interface{}) string // 格式化函数（可选）
|
||||
}
|
||||
```
|
||||
|
||||
**字段说明：**
|
||||
- `Header`: 表头显示的名称
|
||||
- `Field`: 数据字段名，支持嵌套字段（如 "User.Name"）
|
||||
- `Width`: 列宽，0表示自动调整
|
||||
- `Format`: 格式化函数，用于自定义字段值的显示格式
|
||||
|
||||
### 便捷函数
|
||||
|
||||
#### excel.FormatDateTime(layout string) func(interface{}) string
|
||||
|
||||
创建日期时间格式化函数。
|
||||
|
||||
**参数：**
|
||||
- `layout`: 时间格式，如 "2006-01-02 15:04:05"
|
||||
|
||||
**返回：** 格式化函数
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
Format: excel.FormatDateTime("2006-01-02 15:04:05")
|
||||
```
|
||||
|
||||
#### excel.FormatDate(value interface{}) string
|
||||
|
||||
格式化日期（格式：2006-01-02）。
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
Format: excel.FormatDate
|
||||
```
|
||||
|
||||
#### excel.FormatDateTimeDefault(value interface{}) string
|
||||
|
||||
格式化日期时间（格式：2006-01-02 15:04:05）。
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
Format: excel.FormatDateTimeDefault
|
||||
```
|
||||
|
||||
### ExportData接口
|
||||
|
||||
实现此接口的结构体可以直接导出。
|
||||
|
||||
```go
|
||||
type ExportData interface {
|
||||
// GetExportColumns 获取导出列定义
|
||||
GetExportColumns() []ExportColumn
|
||||
// GetExportRows 获取导出数据行
|
||||
GetExportRows() [][]interface{}
|
||||
}
|
||||
```
|
||||
|
||||
## 完整示例
|
||||
|
||||
```go
|
||||
package main
|
||||
|
||||
import (
|
||||
"net/http"
|
||||
"time"
|
||||
|
||||
"git.toowon.com/jimmy/go-common/excel"
|
||||
"git.toowon.com/jimmy/go-common/factory"
|
||||
)
|
||||
|
||||
type User struct {
|
||||
ID int `json:"id"`
|
||||
Name string `json:"name"`
|
||||
Email string `json:"email"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
Status int `json:"status"`
|
||||
}
|
||||
|
||||
func exportUsersHandler(w http.ResponseWriter, r *http.Request) {
|
||||
fac, _ := factory.NewFactoryFromFile("./config.json")
|
||||
|
||||
// 从数据库或其他数据源获取数据
|
||||
users := []User{
|
||||
{ID: 1, Name: "Alice", Email: "alice@example.com", CreatedAt: time.Now(), Status: 1},
|
||||
{ID: 2, Name: "Bob", Email: "bob@example.com", CreatedAt: time.Now(), Status: 1},
|
||||
}
|
||||
|
||||
// 定义导出列
|
||||
columns := []factory.ExportColumn{
|
||||
{Header: "ID", Field: "ID", Width: 10},
|
||||
{Header: "姓名", Field: "Name", Width: 20},
|
||||
{Header: "邮箱", Field: "Email", Width: 30},
|
||||
{
|
||||
Header: "创建时间",
|
||||
Field: "CreatedAt",
|
||||
Width: 20,
|
||||
Format: excel.FormatDateTimeDefault,
|
||||
},
|
||||
{
|
||||
Header: "状态",
|
||||
Field: "Status",
|
||||
Width: 10,
|
||||
Format: func(value interface{}) string {
|
||||
if status, ok := value.(int); ok {
|
||||
if status == 1 {
|
||||
return "启用"
|
||||
}
|
||||
return "禁用"
|
||||
}
|
||||
return ""
|
||||
},
|
||||
},
|
||||
}
|
||||
|
||||
// 设置HTTP响应头
|
||||
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
|
||||
w.Header().Set("Content-Disposition", "attachment; filename=users.xlsx")
|
||||
|
||||
// 导出到响应
|
||||
err := fac.ExportToExcel(w, "用户列表", columns, users)
|
||||
if err != nil {
|
||||
http.Error(w, err.Error(), http.StatusInternalServerError)
|
||||
return
|
||||
}
|
||||
}
|
||||
|
||||
func main() {
|
||||
http.HandleFunc("/export/users", exportUsersHandler)
|
||||
http.ListenAndServe(":8080", nil)
|
||||
}
|
||||
```
|
||||
|
||||
## 设计优势
|
||||
|
||||
### 优势总结
|
||||
|
||||
1. **降低复杂度**：调用方无需关心Excel文件对象的创建和管理
|
||||
2. **延迟初始化**：Excel导出器在首次使用时才创建，提高性能
|
||||
3. **统一接口**：所有操作通过工厂方法调用，接口统一
|
||||
4. **灵活扩展**：支持结构体切片、自定义格式化、ExportData接口等多种方式
|
||||
5. **自动优化**：自动调整列宽、应用表头样式等
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. **配置检查**：Excel导出不需要配置，可以传nil创建工厂
|
||||
2. **错误处理**：所有方法都可能返回错误，需要正确处理
|
||||
3. **延迟初始化**：Excel导出器在首次使用时才创建，首次调用可能稍慢
|
||||
4. **字段名匹配**：Field字段名必须与结构体字段名匹配（区分大小写）
|
||||
5. **嵌套字段**：支持嵌套字段访问（如 "User.Name"），但需要确保字段路径正确
|
||||
6. **格式化函数**：格式化函数返回的字符串会直接写入Excel单元格
|
||||
7. **列宽设置**：Width为0时会自动调整列宽，但可能影响性能（大数据量时建议设置固定宽度）
|
||||
|
||||
## 最佳实践
|
||||
|
||||
1. **使用黑盒方法**：推荐使用 `ExportToExcel()` 和 `ExportToExcelFile()`，无需获取Excel对象
|
||||
2. **设置列宽**：对于大数据量，建议设置固定列宽以提高性能
|
||||
3. **使用格式化函数**：对于日期时间、状态等字段，使用格式化函数提高可读性
|
||||
4. **错误处理**：始终检查导出方法的返回值
|
||||
5. **HTTP响应**：导出到HTTP响应时，记得设置正确的Content-Type和Content-Disposition头
|
||||
|
||||
## 示例
|
||||
|
||||
完整示例请参考 `examples/excel_example.go`
|
||||
|
||||
113
docs/factory.md
113
docs/factory.md
@@ -26,6 +26,7 @@
|
||||
| **邮件** | `SendEmail()` | `fac.SendEmail(to, subject, body)` |
|
||||
| **短信** | `SendSMS()` | `fac.SendSMS(phones, params)` |
|
||||
| **存储** | `UploadFile()`, `GetFileURL()` | `fac.UploadFile(ctx, key, file)` |
|
||||
| **Excel导出** | `ExportToExcel()`, `ExportToExcelFile()` | `fac.ExportToExcelFile("users.xlsx", "用户列表", columns, users)` |
|
||||
| **日期时间** | `Now()`, `ParseDateTime()`, `FormatDateTime()` 等 | `fac.Now("Asia/Shanghai")` |
|
||||
| **时间工具** | `GetTimestamp()`, `IsToday()`, `GetBeginOfWeek()` 等 | `fac.GetTimestamp()` |
|
||||
| **加密工具** | `HashPassword()`, `MD5()`, `SHA256()`, `GenerateSMSCode()` 等 | `fac.HashPassword("password")` |
|
||||
@@ -42,6 +43,7 @@
|
||||
|------|----------|----------|
|
||||
| `GetDatabase()` | `*gorm.DB` | 数据库复杂查询、事务、关联查询等 |
|
||||
| `GetRedisClient()` | `*redis.Client` | Hash、List、Set、ZSet、Pub/Sub等高级操作 |
|
||||
| `GetExcel()` | `*excel.Excel` | 多工作表、自定义样式、图表等高级操作 |
|
||||
| `GetLogger()` | `*logger.Logger` | Close()、设置全局logger等 |
|
||||
|
||||
## 使用方法
|
||||
@@ -145,7 +147,54 @@ url, _ := fac.GetFileURL("images/test.jpg", 0)
|
||||
url, _ := fac.GetFileURL("images/test.jpg", 3600)
|
||||
```
|
||||
|
||||
### 6. Redis操作（黑盒模式，推荐）
|
||||
### 6. Excel导出（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
import (
|
||||
"net/http"
|
||||
"time"
|
||||
"git.toowon.com/jimmy/go-common/excel"
|
||||
)
|
||||
|
||||
// 定义结构体
|
||||
type User struct {
|
||||
ID int `json:"id"`
|
||||
Name string `json:"name"`
|
||||
Email string `json:"email"`
|
||||
CreatedAt time.Time `json:"created_at"`
|
||||
}
|
||||
|
||||
// 准备数据
|
||||
users := []User{
|
||||
{ID: 1, Name: "Alice", Email: "alice@example.com", CreatedAt: time.Now()},
|
||||
{ID: 2, Name: "Bob", Email: "bob@example.com", CreatedAt: time.Now()},
|
||||
}
|
||||
|
||||
// 定义导出列
|
||||
columns := []factory.ExportColumn{
|
||||
{Header: "ID", Field: "ID", Width: 10},
|
||||
{Header: "姓名", Field: "Name", Width: 20},
|
||||
{Header: "邮箱", Field: "Email", Width: 30},
|
||||
{
|
||||
Header: "创建时间",
|
||||
Field: "CreatedAt",
|
||||
Width: 20,
|
||||
Format: excel.FormatDateTimeDefault,
|
||||
},
|
||||
}
|
||||
|
||||
// 导出到文件
|
||||
err := fac.ExportToExcelFile("users.xlsx", "用户列表", columns, users)
|
||||
|
||||
// 导出到HTTP响应
|
||||
func exportUsersHandler(w http.ResponseWriter, r *http.Request) {
|
||||
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
|
||||
w.Header().Set("Content-Disposition", "attachment; filename=users.xlsx")
|
||||
fac.ExportToExcel(w, "用户列表", columns, users)
|
||||
}
|
||||
```
|
||||
|
||||
### 7. Redis操作（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
import "context"
|
||||
@@ -168,7 +217,7 @@ err := fac.RedisDelete(ctx, "user:123", "user:456")
|
||||
exists, err := fac.RedisExists(ctx, "user:123")
|
||||
```
|
||||
|
||||
### 7. 数据库操作（黑盒模式）
|
||||
### 8. 数据库操作（黑盒模式）
|
||||
|
||||
```go
|
||||
// 获取数据库对象（已初始化，黑盒模式）
|
||||
@@ -183,7 +232,7 @@ db.Find(&users)
|
||||
db.Create(&user)
|
||||
```
|
||||
|
||||
### 8. 日期时间操作（黑盒模式）
|
||||
### 9. 日期时间操作（黑盒模式）
|
||||
|
||||
```go
|
||||
// 获取当前时间
|
||||
@@ -205,7 +254,7 @@ unix := fac.ToUnix(now)
|
||||
t2 := fac.FromUnix(unix, "Asia/Shanghai")
|
||||
```
|
||||
|
||||
### 9. 时间操作（黑盒模式）
|
||||
### 10. 时间操作（黑盒模式）
|
||||
|
||||
```go
|
||||
// 时间戳
|
||||
@@ -240,7 +289,7 @@ timeInfo := fac.GenerateTimeInfoWithTimezone(now, "Asia/Shanghai")
|
||||
fmt.Printf("UTC: %s, Local: %s, Unix: %d\n", timeInfo.UTC, timeInfo.Local, timeInfo.Unix)
|
||||
```
|
||||
|
||||
### 10. 金额计算（黑盒模式）
|
||||
### 11. 金额计算（黑盒模式）
|
||||
|
||||
```go
|
||||
// 元转分
|
||||
@@ -260,7 +309,7 @@ version := fac.GetVersion()
|
||||
fmt.Println("当前版本:", version)
|
||||
```
|
||||
|
||||
### 13. HTTP响应（黑盒模式）
|
||||
### 13. HTTP响应（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
import "net/http"
|
||||
@@ -277,7 +326,7 @@ fac.Error(w, 1001, "用户不存在")
|
||||
fac.SystemError(w, "系统错误")
|
||||
```
|
||||
|
||||
### 14. HTTP请求解析（黑盒模式）
|
||||
### 14. HTTP请求解析（黑盒模式，推荐）
|
||||
|
||||
```go
|
||||
import "net/http"
|
||||
@@ -300,7 +349,7 @@ isActive := fac.ConvertBool(r.FormValue("is_active"), false)
|
||||
timezone := fac.GetTimezone(r)
|
||||
```
|
||||
|
||||
### 15. Redis操作（获取客户端对象）
|
||||
### 15. Redis操作（获取客户端对象，高级功能）
|
||||
|
||||
```go
|
||||
import (
|
||||
@@ -525,6 +574,54 @@ func main() {
|
||||
|
||||
**返回：** 文件访问URL和错误信息
|
||||
|
||||
### Excel导出方法（黑盒模式）
|
||||
|
||||
#### ExportToExcel(w io.Writer, sheetName string, columns []ExportColumn, data interface{}) error
|
||||
|
||||
导出数据到Writer。
|
||||
|
||||
**参数：**
|
||||
- `w`: Writer对象（如http.ResponseWriter）
|
||||
- `sheetName`: 工作表名称（可选，默认为"Sheet1"）
|
||||
- `columns`: 列定义
|
||||
- `data`: 数据列表（可以是结构体切片或实现了ExportData接口的对象）
|
||||
|
||||
**返回：** 错误信息
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
fac.ExportToExcel(w, "用户列表", columns, users)
|
||||
```
|
||||
|
||||
#### ExportToExcelFile(filePath string, sheetName string, columns []ExportColumn, data interface{}) error
|
||||
|
||||
导出数据到文件。
|
||||
|
||||
**参数：**
|
||||
- `filePath`: 文件路径
|
||||
- `sheetName`: 工作表名称（可选，默认为"Sheet1"）
|
||||
- `columns`: 列定义
|
||||
- `data`: 数据列表
|
||||
|
||||
**返回：** 错误信息
|
||||
|
||||
**示例：**
|
||||
```go
|
||||
fac.ExportToExcelFile("users.xlsx", "用户列表", columns, users)
|
||||
```
|
||||
|
||||
#### GetExcel() (*excel.Excel, error)
|
||||
|
||||
获取Excel导出器对象（高级功能时使用）。
|
||||
|
||||
**返回：** Excel导出器对象和错误信息
|
||||
|
||||
**说明：**
|
||||
- 仅在需要使用高级功能时使用
|
||||
- 推荐使用黑盒方法：`ExportToExcel()`、`ExportToExcelFile()`
|
||||
|
||||
**详细说明请参考：[Excel导出工具文档](./excel.md)**
|
||||
|
||||
### Redis方法（黑盒模式）
|
||||
|
||||
#### RedisGet(ctx context.Context, key string) (string, error)
|
||||
|
||||
Reference in New Issue
Block a user