jleopard

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

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

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

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

JLEOPARD

jleopard快速上手：

一 基本配置 1. 引入核心jar包 jleopard-xx.jar。 2. 引入所依赖的jar包 ，如数据库驱动包，数据库连接池包等。 3. 创建配置文件，配置详情如下： （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>

        <entityScan value="org.jleopard.demo.entity"></entityScan>
        <dev value="true"></dev>
    </config>

    <generator>
            <target package="org.jleopard.demo.entity" project="/src/main/java/"/>
    </generator>

    <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"> 
    <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>

    <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();