# TimeSeries-ORM 

**Repository Path**: together-space/ts-orm

## Basic Information

- **Project Name**: TimeSeries-ORM 
- **Description**: TS-ORM 是一个轻量级、扩展性强的Java时序数据库ORM框架，核心目标是：
数据库无关：通过可插拔的Dialect（方言）适配各种时序数据库
习惯统一：API设计、注解风格与MyBatis-Plus高度一致，降低学习成本
连接池友好：完全兼容Spring Boot及主流连接池
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TimeSeries-ORM 

#### 介绍
TS-ORM 是一个轻量级、扩展性强的Java时序数据库ORM框架，核心目标是：

- 数据库无关：通过可插拔的Dialect（方言）适配各种时序数据库

- 习惯统一：API设计、注解风格与MyBatis-Plus高度一致，降低学习成本

- 连接池友好：完全兼容Spring Boot及主流连接池

#### 软件架构设计
```java
┌─────────────────────────────────────────┐
│           应用层 (Application)           │
├─────────────────────────────────────────┤
│  TS-ORM 核心模块                        │
│  • 注解系统 (@TSTable, @TSColumn)       │
│  • 通用Mapper接口 (BaseTimeSeriesMapper)│
│  • SQL构建器 (TimeSeriesQueryWrapper)   │
│  • 元数据处理器 (TableInfoHelper)       │
└─────────────────────────────────────────┘
                            │
┌─────────────────────────────────────────┐
│          适配层 (Adapter Layer)          │
│  • 方言接口 (TimeSeriesDialect)          │
│  • SQL翻译器 (SQLTranslator)             │
│  • 执行器抽象 (TimeSeriesExecutor)       │
└─────────────────────────────────────────┘
                            │
     ┌─────────┬──────────┬──────────┐
     │         │          │          │
┌────┴───┐┌────┴────┐┌────┴────┐┌────┴────┐
│TDengine││InfluxDB ││Timescale││ 自定义  │
│方言实现 ││方言实现  ││DB方言实现││方言实现  │
└────────┘└─────────┘└─────────┘└─────────┘
```

#### 安装教程

1.  xxxx
2.  xxxx
3.  xxxx

#### 使用说明

1.  xxxx
2.  xxxx
3.  xxxx

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request


#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)