# rose-core

**Repository Path**: fgg047/rose-core

## Basic Information

- **Project Name**: rose-core
- **Description**: 一个数据库ORM框架，基于Mysql，目标支持Mysql、Oracle、SQL Server三种数据库。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2019-04-29
- **Last Updated**: 2025-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# rose-core 

## 简介

rose-core是一个数据库ORM框架，它基于Mysql，同时支持Oracle和SQL Server数据库。
设计初衷是因为我们不认可在XML中写SQL语句，理由如下：
- 在XML文件中写SQL语句不利于调试。
- 用代码的复杂度替代SQL语句拼写的复杂度不过是左手换右手，没有质的改善，反而徒增了学习曲线。

因此我们设计了此框架，主要设计思想如下：
- 与Mybitis类似，保留了Hibernate的数据库实体对象的映射关系。
- 应用了视图这个提高性能与编程效率的功能。
- 在框架中引入了数据库查询语句拼接与执行分工的原则。
- 简化了简洁SQL语句的执行，复杂的SQL语句交给外部SQL语句引用或原始的代码编写。给开发人员最大的自由度。

另外，本框架还提供了一些非常有用的实用类，如字符串处理、日期处理、Word、Excel文件操作等。

## Maven 坐标
```java
<dependency>
    <groupId>com.jfinal</groupId>
    <artifactId>jfinal</artifactId>
    <version>4.9.17</version>
</dependency>
```

## 数据库操作相关类关系图
![db类图](help/db类图.png)
在net.sf.rose.jdbc包负责数据库操作，包含三个基本功能，分别是数据库连接管理、数据库操作SQL拼接、数据库执行。本包因此主要包括service、query、dao这三个子包。功能分别如下：
- service包负责数据库数据库连接和表结构与实体类映射关系的元数据管理。
- query包负责数据库执行的SQL语句拼接。
- dao包负责数据库操作SQL语句的执行。
- jdbc包用于表结构变更操作。


## 数据库元数据定义类关系图
本框架将数据库表结构的定义都存储在数据库表中了。另外实体类与表结构的映射关系重新定义了。具体说明如下图所示：
![实体类和元数据定义](help/db元数据类图.png)

# 使用方法
在你的项目启用代码的第一行前加上BootStrap.initial(args);即可。

# 开发指南
- [框架详细说明](help/框架详细说明.md)
- [数据库操作示例](help/数据库操作示例.md)