# jpa

**Repository Path**: jone023/jpa

## Basic Information

- **Project Name**: jpa
- **Description**: 封装hibernate统一操作接口
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2022-05-17
- **Last Updated**: 2022-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 介绍
jpa: 封装hibernate

## 安装教程
```xml
<dependency>
    <groupId>cn.xnatural</groupId>
    <artifactId>jpa</artifactId>
    <version>1.1.0</version>
</dependency>
```

## 用法
### 创建一个Repo
```java
//1. 根据jdbcUrl 创建
Repo repo = new Repo("jdbc:mysql://localhost:3306/test?user=root&password=root").init();
```
```java
//2. 自定义添加属性
Repo repo = new Repo("jdbc:mysql://localhost:3306/test", "root", "root", 0, 5)
        .setAttr("hibernate.hbm2ddl.auto", "update")
        .entities(Db.class).init();
```
```java
//3. 根据属性集创建
Map<String, Object> attrs = new HashMap<>();
attrs.put("jdbcUrl", "jdbc:mysql://localhost:3306/test?user=root&password=root");
attrs.put("hibernate.hbm2ddl.auto", "update"); //update: 自动根据实体更新表结构, none: 不更新
Repo repo = new Repo(attrs).entities(Db.class).init();
```
### 实体查询
```java
/**
 * 自定义 实体
 */
@Entity
@Table(name = "Db")
public class Db implements IEntity {
    @Id
    public String Db;
    public String Host;
}
```

```java
import cn.xnatural.jpa.UUIDEntity;
/**
 * 无符号 '-' uuid实体 
 */
@Entity
public class Test1 extends UUIDEntity {
    public String name;
}
```

```java
import cn.xnatural.jpa.LongIdEntity;

/**
 * 自增长 long id 实体
 */
@Entity
public class Test2 extends LongIdEntity {
    public String name;
}
```
#### 查询一个实体
```java
Db db = repo.row(Db.class, (root, query, cb) -> cb.equal(root.get("Db"), "sys"));
```

#### 分页查询实体
```java
Page<Db> pageData = repo.paging(Db.class, 1, 10, (root, query, cb) -> cb.equal(root.get("Db"), "sys"));
```

#### 其它实体方法
```java
// 保存或更新实体
repo.saveOrUpdate(实体对象)
// 根据id查询实体
repo.byId(实体Class, id值)
// 根据某个属性查询实体
repo.byAttr(实体Class, 属性名, 属性值)
// 删除一个实体
repo.delete(实体对象)
// 查询多个实体
List<实体Class> ls = repo.rows(实体Class, 条件)
// 统计实体个数
repo.count(实体Class, 条件(可选))
// 实体是否存在
repo.exist(实体Class, 条件(可选))
```

### 原生sql操作
#### 查询一条数据
```java
// 1. 无参
repo.row("select count(1) as total from db").get("total")
// 2. 传参
Map<String, Object> result = repo.row("select * from db where Db=?", "sys");
// 3. 包装结果
Db result = repo.row("select * from db where Db=?", Db.class, "sys");
```

#### 分页查询
```java
// 1. 分页查询(List<Map>)
Page<Db> pageData = repo.paging("select * from db where Db=?", 1, 10, "sys");
// 2. 分页查询: 指定类型
Page<Db> pageData = repo.paging("select * from db where Db=?", 1, 10, Db.class, "sys");
```

#### 查询多条数据
```java
// 1. 默认返回List<Map>
List<Map<String, Object>> results = repo.rows("select * from db limit ?", 10);
// 2. 指定返回结果
List<Db> results = repo.rows("select * from db where Db=?", Db.class, "sys");
// 3. 命名参数(in条件查询)
List<Map<String, Object>> results = repo.rows("select * from db where Db = :db and Db in (:ids)", "sys", Arrays.asList("sys"));
```

#### 更新,插入,删除
```java
// 1. 更新
repo.execute("update test set age=? where id=?", 11, "4028b881766f3e5801766f3e87ba0000")
// 2. 插入
repo.execute("insert into test values(?,?,?,?,?)", UUID.randomUUID().toString().replace("-", ""), new Date(), new Date(), 22, "name")
// 3. 删除
repo.execute("delete from test where id=?", "ad3e4ff8f3fd4171aeeb9dd2c0aa6f0c")
```

### hql查询
#### 查询单个值
```java
Long count = repo.hqlRow("select count(1) as total from Db", Long.class);
```
#### 查询一条记录
```java
Map record = repo.hqlRow("select new map(Host as host,User as user) from User where User=:user", Map.class, "root");
```
#### 查询一个实体
```java
User record = repo.hqlRow("select new entity.User(Host,User) from User where User=:user", User.class, "root");
```

#### 查询多个单值
```java
List<Long> ls = repo.hqlRows("select count(1) as total from Db", Long.class);
```
#### 查询多条记录
```java
List<Map> records = repo.hqlRows("select new map(Host as host,User as user) from User where User=:user", Map.class, "root");
```
#### 查询多个实体
```java
List<User> users = repo.hqlRows("select new entity.User(Host,User) from User where User=:user", User.class, "root");
```

### 自定义操作
```java
// 1. 其它自定义查询
repo.trans(session -> {
    // TODO
    // session.createQuery(hql);// hql查询
    return null;
})
// 2. 事务成功/失败回调
repo.trans(session -> {
    // TODO
    // session.createQuery(hql);// hql查询
    return null;
}, () -> {
    // TODO 成功执行
}, (ex) -> {
    // TODO 失败执行
})
```

### 其它实用方法
```java
// 查询实体映射的表名
repo.tbName(实体Class);
// 得到当前的连接jdbcUrl
repo.getJdbcUrl();
// 得到当前连接的数据库名(mysql)
repo.getDbName();
// 得到当前数据库的版本信息
repo.getDBVersion();
```

## 参与贡献
xnatural@msn.cn