wood/random-api-go
1
0
Fork 0
mirror of https://github.com/woodchen-ink/random-api-go.git synced 2025-07-18 05:42:01 +08:00
Code Issues Packages Projects Releases Wiki Activity
random-api-go/services/README.md

2.5 KiB
Raw Blame History

Services 架构说明

文件结构

核心服务

  • endpoint_service.go - 主要的端点服务，提供API端点的CRUD操作和随机URL获取
  • cache_manager.go - 缓存管理器，负责内存缓存和数据库缓存的管理
  • preloader.go - 预加载管理器，负责主动预加载和定时刷新数据

数据获取器

  • data_source_fetcher.go - 数据源获取器，统一管理不同类型数据源的获取逻辑
  • lankong_fetcher.go - 兰空图床专用获取器，处理兰空图床API的分页获取
  • api_fetcher.go - API接口获取器，支持GET/POST接口的批量预获取

其他

  • url_counter.go - URL计数器（原有功能）

主要改进

1. 主动预加载机制

  • 保存时预加载: 创建或更新数据源时，立即在后台预加载数据
  • 定时刷新: 每30分钟检查一次，自动刷新过期或需要更新的数据源
  • 智能刷新策略:
    • 兰空图床: 每2小时刷新一次
    • API接口: 每1小时刷新一次
    • 手动数据: 不自动刷新

2. 优化的缓存策略

  • 双层缓存: 内存缓存(5分钟) + 数据库缓存(可配置)
  • 智能更新: 只有当上游数据变化时才更新数据库缓存
  • 自动清理: 定期清理过期的内存和数据库缓存

3. API接口预获取优化

  • 批量获取: GET接口预获取100次，POST接口预获取200次
  • 去重处理: 自动去除重复的URL
  • 智能停止: GET接口如果效率太低会提前停止预获取

4. 错误处理和日志

  • 详细日志: 记录每个步骤的执行情况
  • 错误恢复: 单个数据源失败不影响其他数据源
  • 进度显示: 大批量操作时显示进度信息

使用方式

基本操作

// 获取服务实例
service := GetEndpointService()

// 创建端点（会自动预加载）
endpoint := &models.APIEndpoint{...}
service.CreateEndpoint(endpoint)

// 获取随机URL（优先使用缓存）
url, err := service.GetRandomURL("/api/random")

手动刷新

// 刷新单个数据源
service.RefreshDataSource(dataSourceID)

// 刷新整个端点
service.RefreshEndpoint(endpointID)

控制预加载器

preloader := service.GetPreloader()
preloader.Stop()  // 停止自动刷新
preloader.Start() // 重新启动

性能优化

  1. 并发处理: 多个数据源并行获取数据
  2. 请求限制: 添加延迟避免请求过快
  3. 缓存优先: 优先使用缓存数据，减少API调用
  4. 智能刷新: 根据数据源类型设置不同的刷新策略