py-ecology/py-base

POYEE BASE - 基础插件

📋 项目简介

POYEE BASE 是一个提供基础功能和工具的核心插件库，为上层应用提供统一的底层支持。

🌟 核心功能

自定义注解 annotation

• 数据库相关注解说明：DB.md

基础抽象方法 base

说明：base.md

• 控制层：controller 抽象类
• 业务层：service 抽象类
• 数据层：mapper 抽象类
  • mapper 接口
  • provider 动态SQL工具
  • provider.md - 详细说明文档
  • 根据实体类注解动态生成查询SQL，无需使用 mapper.xml 文件
  • 工具内集成基础查询功能，复杂查询可自定义手写SQL
  • 使用方式：mapper.java 继承 IBaseProvider
  • 自定义SQL：业务模块在mapper包下创建provider包，创建*Provider类，编写自定义SQL逻辑
  • 参考文档：MyBatis Provider使用指南
• 数据模型：entity、dto 实体类

通用工具 common

• 常量定义
• 数据库生成工具插件
• 业务异常处理工具 (exception)
• JSON处理工具 (JsonMapperUtil)
• API文档工具 (knife4j swagger2)

配置模块 config

• 自定义SQL注入器 (JoinSqlInjector)
• Redis配置

多数据源配置 dataSource

Excel处理工具 easy

说明：easy.md

枚举定义 enums

事件处理 handler

• Excel处理：
  • 数据格式处理器 (EasyDataFormatHandler)
  • 分页查询监听器 (PageReadListenerHandler)
• 消息队列：mq
• 缓存工具：redis
• 通用工具类：util

国际化支持 i18n

说明：i18n.md

• 多语言枚举 (I18nMessageEnums)
• 多语言工具类 (I18nUtils)
• 多语言配置 (MessageProperties)
• 多语言配置文件 (message.yml)

🛠️ 开发环境

🔧 技术架构

📚 使用指南

🔄 版本历史