admin/mybatis-flex
1
0
Fork 0
mirror of https://gitee.com/mybatis-flex/mybatis-flex.git synced 2025-12-07 00:58:24 +08:00
Code Issues Packages Projects Releases Wiki Activity

v1.0.0 rc1 release

Browse Source
This commit is contained in:
开源海哥 2023-03-06 10:48:54 +08:00
parent d6f435e961
commit 91f935dd4a
2 changed files with 63 additions and 81 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

111
readme.md
View File

@ -68,76 +68,44 @@ class HelloWorld {
e.g.2: query list e.g.2: query list
```java ```java
class HelloWorld { //use QueryWrapper to build query conditions
public static void main(String... args) { QueryWrapper query = QueryWrapper.create()
.select()
.from(ACCOUNT)
.where(ACCOUNT.ID.ge(100))
.and(ACCOUNT.USER_NAME.like("zhang").or(ACCOUNT.USER_NAME.like("li")));
HikariDataSource dataSource = new HikariDataSource(); // execute SQL：
dataSource.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/mybatis-flex"); // ELECT * FROM `tb_account`
dataSource.setUsername("username"); // WHERE `tb_account`.`id` >= 100
dataSource.setPassword("password"); // AND (`tb_account`.`user_name` LIKE '%zhang%' OR `tb_account`.`user_name` LIKE '%li%' )
List<Account> accounts = MybatisFlexBootstrap.getInstance()
MybatisFlexBootstrap.getInstance() .execute(AccountMapper.class, mapper ->
.setDatasource(dataSource) mapper.selectListByQuery(query)
.addMapper(AccountMapper.class) );
.start();
//use QueryWrapper to build query conditions
QueryWrapper query = QueryWrapper.create()
.select()
.from(ACCOUNT)
.where(ACCOUNT.ID.ge(100))
.and(ACCOUNT.USER_NAME.like("zhang").or(ACCOUNT.USER_NAME.like("li")));
// execute SQL：
// ELECT * FROM `tb_account`
// WHERE `tb_account`.`id` >= 100
// AND (`tb_account`.`user_name` LIKE '%zhang%' OR `tb_account`.`user_name` LIKE '%li%' )
List<Account> accounts = MybatisFlexBootstrap.getInstance()
.execute(AccountMapper.class, mapper ->
mapper.selectListByQuery(query)
);
}
}
``` ```
e.g.3: paging query e.g.3: paging query
```java ```java
class HelloWorld { //use QueryWrapper to build query conditions
public static void main(String... args) { QueryWrapper query = QueryWrapper.create()
.select()
.from(ACCOUNT)
.where(ACCOUNT.ID.ge(100))
.and(ACCOUNT.USER_NAME.like("zhang").or(ACCOUNT.USER_NAME.like("li")))
.orderBy(ACCOUNT.ID.desc());
HikariDataSource dataSource = new HikariDataSource(); // execute SQL：
dataSource.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/mybatis-flex"); // ELECT * FROM `tb_account`
dataSource.setUsername("username"); // WHERE `tb_account`.`id` >= 100
dataSource.setPassword("password"); // AND (`tb_account`.`user_name` LIKE '%zhang%' OR `tb_account`.`user_name` LIKE '%li%' )
// ORDER BY `tb_account`.`id` DESC
MybatisFlexBootstrap.getInstance() // LIMIT 40,10
.setDatasource(dataSource) Page<Account> accountPage = MybatisFlexBootstrap.getInstance()
.addMapper(AccountMapper.class) .execute(AccountMapper.class, mapper ->
.start(); mapper.paginate(5, 10, query)
);
//use QueryWrapper to build query conditions
QueryWrapper query = QueryWrapper.create()
.select()
.from(ACCOUNT)
.where(ACCOUNT.ID.ge(100))
.and(ACCOUNT.USER_NAME.like("zhang").or(ACCOUNT.USER_NAME.like("li")))
.orderBy(ACCOUNT.ID.desc());
// execute SQL：
// ELECT * FROM `tb_account`
// WHERE `tb_account`.`id` >= 100
// AND (`tb_account`.`user_name` LIKE '%zhang%' OR `tb_account`.`user_name` LIKE '%li%' )
// ORDER BY `tb_account`.`id` DESC
// LIMIT 40,10
Page<Account> accountPage = MybatisFlexBootstrap.getInstance()
.execute(AccountMapper.class, mapper ->
mapper.paginate(5, 10, query)
);
}
}
``` ```
## QueryWrapper Samples ## QueryWrapper Samples
@ -223,7 +191,7 @@ QueryWrapper queryWrapper=QueryWrapper.create()
// SELECT * FROM tb_account // SELECT * FROM tb_account
// WHERE tb_account.id >= ? // WHERE tb_account.id >= ?
// AND EXIST ( // AND EXIST (
// SELECT 1 FROM tb_article WHERE tb_article.id >= ? // SELECT 1 FROM tb_article WHERE tb_article.id >= ?
// ) // )
``` ```
@ -272,6 +240,21 @@ QueryWrapper queryWrapper=QueryWrapper.create()
// HAVING tb_account.age BETWEEN ? AND ? // HAVING tb_account.age BETWEEN ? AND ?
``` ```
### orderBy
```java
QueryWrapper queryWrapper=QueryWrapper.create()
.select()
.from(ACCOUNT)
.orderBy(ACCOUNT.AGE.asc(), ACCOUNT.USER_NAME.desc().nullsLast());
// SQL:
// SELECT * FROM `tb_account`
// ORDER BY `age` ASC, `user_name` DESC NULLS LAST
```
### join ### join
```java ```java
QueryWrapper queryWrapper = QueryWrapper.create() QueryWrapper queryWrapper = QueryWrapper.create()

33
readme_zh.md
View File

@ -306,31 +306,31 @@ Db + Row 工具类，提供了在 Entity 实体类之外的数据库操作能力
```java ```java
//使用原生 SQL 插入数据 //使用原生 SQL 插入数据
String sql="insert into tb_account(id,name) value (?, ?)"; String sql="insert into tb_account(id,name) value (?, ?)";
Db.insertBySql(sql,1,"michael"); Db.insertBySql(sql,1,"michael");
//使用 Row 插入数据 //使用 Row 插入数据
Row account=new Row(); Row account=new Row();
account.set("id",100); account.set("id",100);
account.set("name","Michael"); account.set("name","Michael");
Db.insertRow("tb_account",account); Db.insertRow("tb_account",account);
//根据主键查询数据 //根据主键查询数据
Row row=Db.selectOneById("tb_account","id",1); Row row=Db.selectOneById("tb_account","id",1);
//Row 可以直接转换为 Entity 实体类，且性能极高 //Row 可以直接转换为 Entity 实体类，且性能极高
Account account=row.toEntity(Account.class); Account account=row.toEntity(Account.class);
//查询所有大于 18 岁的用户 //查询所有大于 18 岁的用户
String listsql="select * from tb_account where age > ?" String listsql="select * from tb_account where age > ?"
List<Row> rows=Db.selectListBySql(sql,18); List<Row> rows=Db.selectListBySql(sql,18);
//分页查询：每页 10 条数据，查询第 3 页的年龄大于 18 的用户 //分页查询：每页 10 条数据，查询第 3 页的年龄大于 18 的用户
QueryWrapper query=QueryWrapper.create() QueryWrapper query=QueryWrapper.create()
.where(ACCOUNT.AGE.ge(18)); .where(ACCOUNT.AGE.ge(18));
Page<Row> rowPage=Db.paginate("tb_account",3,10,query); Page<Row> rowPage=Db.paginate("tb_account",3,10,query);
``` ```
> Db 工具类还提供了更多 增、删、改、查和分页查询等方法。 > Db 工具类还提供了更多 增、删、改、查和分页查询等方法。
@ -354,23 +354,22 @@ update(T entity,boolean ignoreNulls)
```java ```java
Account account=UpdateEntity.of(Account.class); Account account=UpdateEntity.of(Account.class);
account.setId(1); account.setId(100);
account.setUserName(null); account.setUserName(null);
account.setSex(1); account.setSex(1);
accountMapper.update(account,false); accountMapper.update(account,false);
``` ```
以上的示例中，会把 id 为 1 这条数据中的 user_name 字段更新为 null，sex 字段更新为 1，其他字段不会被更新。也就是说，通过 `UpdateEntity` 以上的示例中，会把 id 为 100 这条数据中的 user_name 字段更新为 null，sex 字段更新为 1，其他字段不会被更新。也就是说，通过 `UpdateEntity`
创建的对象，只会更新调用了 setter 方法的字段，若不调用 setter 方法，不管这个对象里的属性的值是什么，都不会更新到数据库。 创建的对象，只会更新调用了 setter 方法的字段，若不调用 setter 方法，不管这个对象里的属性的值是什么，都不会更新到数据库。
其生成的 sql 内容如下： 其生成的 sql 内容如下：
```sql ```sql
update tb_account update tb_account
set user_name = ?, set user_name = ?, sex = ? where id = ?
sex = ? #params: null,1,100
where id = ? #params: null,1,1
``` ```
## 多主键 ## 多主键