# JMini

**Repository Path**: machangsheng/JMini

## Basic Information

- **Project Name**: JMini
- **Description**: 基于spring框架的简单易用的ORM开发框架
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 13
- **Forks**: 4
- **Created**: 2015-12-11
- **Last Updated**: 2021-09-19

## Categories & Tags

**Categories**: database-dev

**Tags**: None

## README

# JMini：一个是使用基于Spring框架开发的ORM简易框架
## 主要特点
 1、以Module为核心，基于注释的方式灵活的将Module属性与数据库字段进行绑定；
 2、通过MiniService和MiniDAO实现了对Module的增、删、改、查、分页等基本操作；
 3、基于Spring框架的JdbcTemple数据访问层开发，支持各种主流关系型数据(在Myslq5.5上进行测试)。


----------


##模块注释简介

 - @AP_MODEL
    @AP_MODEL 用于Module对象注释, 例如： @AP_MODEL(tableName="PEOPLE")
     tableName 指明模型对应表名称
     
 - @AP_FIELD 字段注释 ，用户属性与数据库字段对应关系设置
     fieldName 数据库字段名 
     update      是否在update时对该字段进行更新 默认值true (例如自增长字段，可以配置为false)
     create       是否在create是插入该字段  默认值true (例如自增长字段，可以配置为false)
     
 - @AP_ONE2MANY 配置字段与其他表的关联关系，用于进行级联查询
    modelType 关联查询后用来接收数据的Module实现类
    fieldName  用来关联的数据库字段名称
    isOne2One 是否为一对一关系，默认值false (true 表示是一对多关系，仅查询时进行级联查询)
    sqlWhere    在级联查询时使用的where条件，可限制级联查询结果
    sqlOrderBy 在级联查询时使用的order by条件，可限制级联查询结果的排序
	 *注意，本框架只进行单层级联查询，不进行深层次的级联查询，以避免循环管理。*
   
##代码示例

[ORM 使用代码示例](http://git.oschina.net/machangsheng/JMini/blob/master/src/test/java/jmini/examples/orm/SimpleExample.java/?dir=0&filepath=src/test/java/jmini/examples/orm/SimpleExample.java&oid=6595e38936d27204b3cbca3cc582d4f4a112c70b&sha=b209f6b3a92e980d47bcaab69f86ed202dcdfc22)

[Module代码示例](http://git.oschina.net/machangsheng/JMini/tree/master/src/test/java/jmini/examples/modules/?dir=1&filepath=src/test/java/jmini/examples/modules&oid=cef593dba10de151c9e6988bf206845c0a347440&sha=b209f6b3a92e980d47bcaab69f86ed202dcdfc22)

代码示例运行说明
导入jmini_example.sql脚本，数据库名称jmini_example
修改conf/jmini_example.conf文件

    db.mysql.url=jdbc:mysql://{host:port}/jmini_example
    db.mysql.username={db_username}
    db.mysql.password={db_password}
*注意:{}内容需要自行修改*
运行 src/test /java/jmini/examples/orm/SimpleExample.java类（保证conf 目录必须在启动路径下）

[Spring配置参考](http://git.oschina.net/machangsheng/JMini/blob/master/src/test/resources/spring-jmini-fw.xml/?dir=0&filepath=src/test/resources/spring-jmini-fw.xml&oid=51ded0ff446adbb1288c0134c1933a9a548e1163&sha=b209f6b3a92e980d47bcaab69f86ed202dcdfc22)


----------


##### 感谢大家的支持，踊跃贡献，如果使用中遇到什么问题，请留言，谢谢！