jleopard

orm（bug提交：jleopard@126.com）

声明：目前jleopard仅支持MySQL数据库

前言：代码写的很乱，只是实现了各种功能，没有去做优化，后续会有大量的修改优化。

jleopard优势

真正轻量级，小到仅100kb左右。
极易上手，不再需要手写sql。
功能强大，自动生成sql，除了常用的增删改查还支持逆向工程，自动建表，多表外键关联，分页查询。

JLEOPARD

jleopard快速上手：

一基本配置

引入核心jar包 jleopard-xx.jar。
引入所依赖的jar包，如数据库驱动包，数据库连接池包等。
创建配置文件，配置详情如下：（1）数据源配置id固定为dataSource ， class为插件的完整类名。（2）实体对象包一定要配，不然扫描不到对象。（3）逆向工程只用一次用的时候配就行。

<!DOCTYPE jleopard-configuration  PUBLIC "-// jleopard.org//DTD Config 1.0//EN"
	"http://www.jleopard.org/dtd/jleopard.dtd">
<jleopard-configuration>
	<config>
		<!--实体对象所在包 如：org.jleopard.demo.entity-->
		<entityScan value="org.jleopard.demo.entity"></entityScan>
		<dev value="true"></dev>
	</config>
	<!--逆向工程配置  包要配置为完整的路径 maven工程和web工程项目路径不同-->
	<generator>
       		<target package="org.jleopard.demo.entity" project="/src/main/java/"/>
	</generator>
	<!--数据源配置 id固定为dataSource-->
	<dataSource class="org.jleopard.jdbc.BaseDataSource" id="dataSource">
		<property name="driver" value="com.mysql.jdbc.Driver"/>
		<property name="url" value="jdbc:mysql://127.0.0.1:3306/jleopardDemo?characterEncoding=UTF-8"/>
		<property name="username" value="root"/>
		<property name="password" value="123"/>
	</dataSource>
</jleopard-configuration>

二 Java注解配置

@Table 标志该类对应数据库的一张表 - value值为表名，不写则默认取类名作为表名。

@Column 对应表中的字段名 - value值为表中的字段名，不写则默认取变量名。 IsPrimary 是否为主键，有三种类型：

NO(不是主键，也是默认的属性)
YES(是主键)
AUTOINCREMENT(是主键，且自增)
AllowNull ( 是否允许为空，默认为false)

relation （外键联系默认为空则不是外键如：relation="address_id" --> 表示数据库的address_id字段为外键，关联该字段类的对应表）

@Table("user")
public class User{

@Column(isPrimary = Primary.YSE)
private long id;

@Column(value = "name",allowNull = true)
private String name;

@Column
private String phone;

@Column(value="address_id", relation="address_id")
private Address address;
// 表示user表的address_id字段为外键，关联着Address这个实体类对应表的主键。

//省略getset方法 构造方法
}

三方法介绍，极速开发模式

1 获取SessionFactory

SessionFactory factory=Factory.getSessionFactory("classpath:config.xml"); //获取sessionFactory  传入我们的配置文件路径

2 获取sqlSession

    SqlSession session=factory.openSession();

3 封装的方法使用

     User user=new User();
     user.setId(10086);
     user.setName("JLeopard");
     user.setPhone("10010");
     user.setAddress("China");
     List list=new ArrayList();
     list.add(user);
     
    try {  //所有操作均有SqlSessionException异常
        session.Save(user);  //传一个具体的实例对象
        
        session.SaveMore(list);  //多个实例对象放入list 批量操作存入数据库
        
        session.Delete(user); //删除条件即为实例对象的数据 如 ：上述user对象 删除的条件即为: delete from user表 where id = 10086 and name= 'jLeopard' and phone = ‘10010’ and address = 'China'
        
        session.Delete(User.class, 10086, 10010, 10000); //根据唯一主键删除数据 ,传一个或多个主键值 如：delete from user表 where id in (10086,10010,10000)
        
        session.Update(user,10086);//根据主键修改数据  目标数据是该对象里的数据 如： update user表 set name = xx（user对象的数据，该字段为空则跳过，不修改数据）where id = 10086
        
        session.Get(User.class); // 查询所有user表中的数据 return List<T>
        
        session.Get(user);   //查询单条数据 查询条件即为对象的数据  如果匹配到多条数据，则只返回第一条.。上述user对象 查询的条件即为: select 所有字段名  from user表 where id = 10086 and name= 'jLeopard' and phone = ‘10010’ and address = 'China'

        session.Get(User.class,10000,10086);// 按主键查找 select xx from user表 where id in ( 10000,10086)
        
        session.Get(User.class,"where id=? order by id desc",10086);  //自定义条件查询 动态参数
        
        session.Get(User.class,1,5);  //分页查询  查询第一页数据  每页显示5 条数据 PageInfo来接收（下问文详细介绍）
        
        session.Get("select * from user where id = ? and name =?",10010,"jLeopard");  //自定义动态sql 返回的是ResultSet结果集。 


        session.Commit();  //每一次对更新数据库操作都要提交事物  不然数据不会写入数据库
        
        session.Stop();  //每执行完一次都要将其暂停
        
        session.Close();  //关闭此次sqlSession 下次要用时要重新获取
        
    } catch (SqlSessionException e) {
        e.printStackTrace();
    }

4 逆向工程生成JavaBean 简单两行代码解决

        GeneratorFactory factory=Factory.getGeneratorFactory("classpath:config.xml");  // 开启Generator工厂
        try {
           factory.openGenerator();    //执行逆向工程
        } catch (Exception e) {
            e.printStackTrace();
        }

四方法介绍，分页查询

public void PageTest(){
    /*目前仅封装了我们开发中常用的一些数据信息。
    获取分页信息 ：getPage();  // 获取当前查询的页数
    getTotalPages(); //获取总页数
    getPageSize();   //获取每页显示的数据数量
    getTotalRows();  //获取总记录数
    getList();       //获取目标数据，也就是我们要查询的数据*/
    SessionFactory factory=Factory.getSessionFactory("classpath:config.xml");  //获取session工厂
    SqlSession session=factory.openSession();  //打开session连接 开始操作
    try {
        PageInfo temp=session.Get(User.class,3,10);  //分页查询开始 用封装好的pageInfo接收查询结果。 查询user表 第三页 每页显示10条数据
        session.Stop();
        session.Close();
    } catch (SqlSessionException e) {
        e.printStackTrace();
    }
}

五与Spring整合配置（只需要配置数据源和sqlSessionFactoryBean）

1.配置文件详情：

<bean id="dataSource" class="org.jleopard.jdbc.BaseDataSource"> <!--数据源配置 这里我配置的是我自己写的数据源，这里可以配置所有spring支持的数据源-->
	<property name="driver" value="com.mysql.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://127.0.0.1:3306/jleopardDemo?characterEncoding=UTF-8"/>
    <property name="username" value="root"/>
    <property name="password" value="123"/>
    </bean>
    <!--配置sqlSessionFactoryBean 引入数据源，配置实体类扫描包等-->
    <bean id="sqlSessionFactoryBean" class="org.jleopard.spring.SqlSessionFactoryBean">
    <property name="dataSource" ref="dataSource"/>
	<property name="entityPackage" value="org.jleopard。demo.entity"></property>
	<property name="useColumnLabel" value="false"></property>
	<property name="useGeneratedKeys" value="false"></property>
	<property name="dev" value="true"></property>
</bean>

2.注入SqlSessionFactoryBean

@Autowired
private SqlSessionFactoryBean sqlSessionFactoryBean;

3.获取SqlSession

SqlSession session =sqlSessionFactoryBean.getSessionFactory().openSession();

4.极速开发

User user = new User();
user.setName("测试spring");
user.setId(9441);
user.setAddress("江西南昌");
user.setPhone("10086");

int temp = session.Save(user);
	session.Commit();
	session.Stop();
	session.Close();

jovebirdy/jleopard

jleopard

声明： 目前jleopard仅支持MySQL数据库

声明：目前jleopard仅支持MySQL数据库