mybatis动态生成sql语句
Java 程序中使用 Map实现动态传参
在 Java 编程中,我们常常需要将数据传递给 SQL 查询,特别是在动态生成 SQL 语句时,通常会用到 Map 这种集合类。Map 可以将多个键值对传递给 SQL 语句的占位符,完成动态参数绑定的功能。我们下面详细讲解图中的知识点。
1. Map 的基本用法
Map 是 Java 集合框架中的一种数据结构,它以键值对 (key-value) 的形式存储数据。Map 中的键唯一且不能重复,而值可以重复。常用的实现类包括 HashMap、TreeMap 等。
示例代码:
Map<String, Object> map = new HashMap<>();
map.put("k1", "1111");
map.put("k2", "比亚迪汉");
map.put("k3", 10.0);
map.put("k4", "2020-11-11");
map.put("k5", "电车");
这里我们创建了一个 HashMap,并通过 put 方法将一些数据存入 Map。键是 String 类型,值是 Object 类型,意味着可以存放不同类型的数据(如字符串、数字、日期等)。
2. 占位符 #{} 的使用
在执行 SQL 语句时,为了防止 SQL 注入和简化代码,我们经常使用占位符将 SQL 参数动态地传入。( ? 是 JDBC 中的占位符,用于预编译 SQL 语句中的参数。在使用 JDBC 时,SQL 语句通常是预编译的,? 用于表示一个位置,在执行时由具体的参数替换。)占位符 #{} 这一语法主要用于一些持久化框架,如 MyBatis。
SQL 语句示例:
insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)
values(null, #{k1}, #{k2}, #{k3}, #{k4}, #{k5});
在这个 SQL 语句中,#{k1}、#{k2} 等占位符将会在运行时被替换为 Map 中对应的值。框架会根据占位符的键来查找 Map 中的值并动态替换。如果键不存在,则返回 null。这个语句通常配置在通常用于 MyBatis 的 SQL 映射的XML文件中
注意:
- 如果
Map中没有提供某个占位符对应的值,查询执行时可能会插入null,这可能导致意外的行为。 - 使用占位符
#{}可以防止 SQL 注入,因为框架在执行时会自动进行预处理。
3. Map 键名与数据库字段名的对应关系
为了使代码更加易读、维护更加方便,我们通常建议将 Map 中的键名与数据库字段名保持一致。这样一来,不仅能够直观地映射参数,还能避免因键名不统一而导致的问题。
map.put("carNum", "1111");
map.put("brand", "比亚迪汉2");
map.put("guidePrice", 10.0);
map.put("produceTime", "2020-11-11");
map.put("carType", "电车");
在这个例子中,我们将 Map 的键名改为 carNum、brand 等,和数据库表的列名一致。这样一来,代码就更容易理解和维护。
SQL 语句:
insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)
values(null, #{carNum}, #{brand}, #{guidePrice}, #{produceTime}, #{carType});
POJO 类实现动态传参
1. POJO 类与 SQL 占位符传递
POJO(Plain Old Java Object) 是指普通的 Java 对象,通常用作数据传输对象。在 Java 应用中,我们可以通过 POJO 类的属性来传递 SQL 语句中的参数。
Car car = new Car(null, "3333", "比亚迪秦", 30.0, "2020-11-11", "新能源");
在这个例子中,Car 是一个 POJO 类,包含一些车辆信息的属性。通过实例化这个类,我们可以将具体的值传入到 SQL 语句中的占位符。
2. 占位符 #{} 的使用
在 MyBatis 等持久化框架中,使用占位符 #{} 来表示将 POJO 的属性值注入到 SQL 语句中。大括号 {} 里面填写的内容是 POJO 类的属性名(严格意义上来说:如果使用P0J0对象传递值的话,这个{}里面写的是get方法的方法名去掉get,然后将剩下的单词首字母小写,然后放进去。)
SQL 语句示例:
insert into t_car(id,car_num,brand,guide_price,produce_time,car_type)
values(null, #{carNum}, #{brand}, #{guidePrice}, #{produceTime}, #{carType});
3. 占位符与属性对应的规则
MyBatis 会自动根据 POJO 类中的属性名来查找对应的 getter 方法。如果 POJO 类中没有提供对应的 getter 方法,则会报错。
错误示例:
There is no getter for property named 'xyz' in 'class com.powernode.mybatis.pojo.Car'
这是因为 MyBatis 尝试通过 getXyz() 方法来获取 xyz 属性的值,但 POJO 类中没有定义这个方法。为了避免这种错误,我们需要在 POJO 类中提供每个属性的 getter 和 setter 方法。
4. 如何解决没有 getter 方法的问题?
如果遇到没有对应 getter 方法的情况,可以通过在 POJO 类中手动添加相应的 getter 方法来解决。比如:
public String getXyz() {return xyz;
}
5. 占位符 #{} 的使用规则
通过这个错误示例,我们可以总结出占位符的使用规则:MyBatis 是通过反射机制来调用 getter 方法。也就是说,在 #{} 占位符中写的内容(如 #{carNum})并不直接对应 POJO 的属性名,而是对应属性的 getter 方法。
规则:
- 占位符
#{}中的内容是首字母小写形式。 - 占位符内部自动调用属性的
getter方法,因此命名应符合 Java 的命名规范。例如:getUsername()对应的占位符为#{username}getEmail()对应的占位符为#{email}
占位符 #{} 中的内容确实是与 POJO 类的属性相关,但 MyBatis 实际上是通过 调用 POJO 类的 getter 方法 来获取这些值的,而不是直接访问属性本身。因此,为了确保 MyBatis 能正确地映射 SQL 参数,POJO 类中的 getter 方法必须与占位符中的名字相匹配。
删除DELETE操作:
1. 删除操作的实现
int count = sqlSession.delete("deleteById", 59);
这行代码展示了通过 sqlSession.delete() 方法来执行删除操作,其中:
sqlSession:MyBatis中的会话对象,允许我们与数据库进行交互。"deleteById":这是Mapper XML文件中定义的SQL语句的唯一标识符,用来指定删除操作。59:这是要传递给SQL语句的参数,即要删除的记录的ID
2. MyBatis Mapper 文件中的SQL语句
<delete id="deleteById">delete from t_car where id = #{fdsfd}
</delete>
这是在MyBatis的Mapper XML文件中定义的删除操作,具体解释如下:
<delete id="deleteById">:这是定义一个删除操作的方法,id是这个方法的唯一标识符,名称为deleteById,与Java代码中调用的deleteById相对应。delete from t_car where id = #{fdsfd}:这是一个标准的SQL删除语句,意思是从表t_car中删除id为#{fdsfd}的记录。#{fdsfd}:这是MyBatis的参数占位符,表示将传递的参数(在Java代码中传递的59)注入到这个位置。fdsfd是参数名,可以根据需要定义。
3. 占位符的说明
注意:如果占位符只有一个,那么 #{} 的大括号里可以随意。但是最好见名知意。
这里说明了 #{} 是MyBatis的占位符,用于绑定参数。虽然在某些情况下可以随意使用参数名(如 fdsfd),但是为了代码的可读性和维护性,建议使用有意义的名称,比如 id。
例如,改为:
<delete id="deleteById">delete from t_car where id = #{id}
</delete>
这样更直观,容易理解。
4. 整体流程总结
- 在Java代码中,我们通过
sqlSession.delete("deleteById", 59)来调用Mapper文件中定义的deleteById删除方法,并传递id = 59。 - MyBatis会将
59替换到delete from t_car where id = #{id}的SQL语句中,生成最终的SQL语句delete from t_car where id = 59并执行,最终删除t_car表中id为59的记录。
更新操作:
1. 更新操作的SQL语句
<update id="updateById">update t_car setcar_num=#{carNum},brand=#{brand},guide_price=#{guidePrice},produce_time=#{produceTime},car_type=#{carType}whereid = #{id}
</update>
这是在MyBatis的Mapper XML文件中定义的更新操作。解释如下:
<update id="updateById">:定义一个更新操作,id是唯一标识符,这里使用updateById,与Java代码中的方法名一致。update t_car set ... where id = #{id}:这是SQL的更新语句,意图是将t_car表中的某条记录进行更新,具体是通过id来定位记录,然后对表中的多个字段进行更新。
这里使用 #{} 作为MyBatis的占位符,类似于之前的删除操作。它会在执行时将参数替换为实际值。具体字段说明:
#{carNum}:汽车编号#{brand}:品牌#{guidePrice}:指导价格#{produceTime}:生产日期#{carType}:汽车类型#{id}:记录的唯一标识符,即要更新的汽车记录的id
2. Java代码中的更新操作
Car car = new Car(4L, "9999", "凯美瑞", 30.3, "1999-11-10", "燃油车");
int count = sqlSession.update("updateById", car);
-
这里通过
new Car()创建了一辆Car对象,包含了所有要更新的属性。各个属性与Mapper XML中的占位符对应。4L:表示汽车的id,也就是SQL语句中id字段要更新的记录。(null不能赋值给基本类型long,但可以赋值给Long这样的包装类,所以使用)"9999":对应carNum,汽车编号。"凯美瑞":对应brand,汽车品牌。30.3:对应guidePrice,指导价格。"1999-11-10":对应produceTime,生产日期。"燃油车":对应carType,汽车类型。
-
然后调用
sqlSession.update("updateById", car);进行更新操作。MyBatis会将car对象的属性传递给对应的SQL语句中的占位符,生成最终的SQL语句并执行更新。
3. 详细流程说明
- MyBatis会根据Java代码中的
car对象的属性,替换Mapper XML中的占位符,生成最终的SQL语句。 - 假设
car对象的id是4,那么生成的SQL语句大致如下update t_car setcar_num='9999',brand='凯美瑞',guide_price=30.3,produce_time='1999-11-10',car_type='燃油车' whereid = 4; - 执行这条SQL语句后,
t_car表中id为4的记录就会被更新成新值。 - 更新后,
sqlSession.update()方法会返回受影响的行数,即count。
select查找操作
1. MyBatis 中的 select 标签
-
作用:MyBatis 使用
select标签来编写 SQL 查询语句,定义如何从数据库中获取数据。在这个例子中,它用于根据id字段查询t_car表中的记录。 -
SQL 语句解释:
<select id="selectById" resultType="com.powernode.mybatis.pojo.Car">select * from t_car where id = #{id} </select> - id 属性:
id="selectById"是一个唯一标识符,表示这条 SQL 语句在 MyBatis 配置中的 ID。当你在代码中调用sqlSession.selectOne("selectById", 参数)时,MyBatis 会根据这个 ID 找到对应的 SQL 语句。 - SQL 查询:
select * from t_car where id = #{id}是实际的 SQL 语句。#{id}是 MyBatis 的动态 SQL 占位符,它会在运行时将你传入的参数(比如1)替换为实际的查询条件。#{}是 MyBatis 语法,用于从传递的参数中获取值,防止 SQL 注入。select *是查询所有列,你可以根据需要替换为具体的列名(例如:select id, name, brand)。
2. resultType 属性
-
作用:
resultType属性告诉 MyBatis 查询结果应该映射成什么样的 Java 对象。也就是说,当从数据库中获取到数据后,MyBatis 会根据resultType中指定的类型来创建该类型的对象,并将查询结果封装到这个对象中。 -
在此例子中的使用:
resultType="com.powernode.mybatis.pojo.Car" - 这里
resultType="com.powernode.mybatis.pojo.Car"指定了Car类为查询结果的映射对象类型。即查询到的t_car表中的记录会被封装成Car类的实例。 - 全限定类名:
com.powernode.mybatis.pojo.Car是Car类的全限定类名,即包括了包名和类名。这是 MyBatis 推荐的写法,因为这样可以确保避免类名冲突,并确保 MyBatis 能找到正确的类。
-
resultType 的作用机制:
- 查询结果(即数据库中的一条记录)会被转换为 Java 对象。MyBatis 会根据数据库表中的列名与
Car类的属性名进行匹配,如果列名与属性名相同,MyBatis 就会自动将查询结果中的列值赋给对应的属性。 - 例如:假设
t_car表有以下列:id,name,brand- 对应
Car类的属性为:id,name,brand,MyBatis 会自动将数据库中的id列的值赋给Car类中的id属性,依此类推。
- 查询结果(即数据库中的一条记录)会被转换为 Java 对象。MyBatis 会根据数据库表中的列名与
-
注意事项:
- 如果数据库中的列名和 Java 类中的属性名不一致,你需要使用别名(
AS)或者resultMap进行手动映射。- 1. 假设的数据库表
t_carCREATE TABLE t_car (car_id INT PRIMARY KEY,car_name VARCHAR(50),car_brand VARCHAR(50) ); - 在这个表中,列名是
car_id,car_name, 和car_brand。 -
Java 类
Carpublic class Car {private int id;private String name;private String brand;// Getters and setterspublic int getId() {return id;}public void setId(int id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public String getBrand() {return brand;}public void setBrand(String brand) {this.brand = brand;} }在 Java 类
Car中,属性名分别是id,name, 和brand,显然与数据库表t_car的列名不一致。解决办法:使用
resultMap进行手动映射由于列名和属性名不一致,直接使用
resultType是无法自动映射的,这时我们可以使用resultMap进行手动映射。
- 1. 假设的数据库表
-
3. MyBatis 映射配置:起别名
<select id="selectById" resultType="com.powernode.mybatis.pojo.Car">select car_id as id, car_name as name, car_brand as brandfrom t_carwhere car_id = #{id} </select>在这个配置中:
car_id as id:把car_id列的查询结果映射为id,从而与 Java 类Car的id属性对应。car_name as name:把car_name列的查询结果映射为name,与Car类中的name属性对应。car_brand as brand:把car_brand列的查询结果映射为brand,与Car类中的brand属性对应。-
SQL 查询:
select * from t_car where car_id = #{id},通过#{id}来传递 Java 方法中的参数。
-
这样,通过使用
AS设置别名,可以直接在 SQL 语句中将数据库的列名与 Java 类的属性名进行对应,而无需修改数据库或 Java 类。
- 如果数据库中的列名和 Java 类中的属性名不一致,你需要使用别名(
3. selectOne 方法
-
作用:
selectOne是 MyBatis 提供的一个方法,用于执行返回单条记录的查询。当我们确定查询的结果是唯一的(例如,查询主键),可以使用这个方法。如果查询结果返回多条记录,MyBatis 会抛出异常(TooManyResultsException)。 -
用法解释:
Car car = sqlSession.selectOne("selectById", 1);
sqlSession是 MyBatis 中操作数据库的会话对象,类似于 JDBC 中的Connection对象。selectOne("selectById", 1):调用了selectById这个 SQL 查询,并传递了参数1。这个1会替换 SQL 中的#{id}占位符,最终执行的 SQL 会是:select * from t_car where id = 1;返回的结果会是一个
Car对象,存储在变量car中。
select查所有的数据
sql语句
<select id="selectAll" resultType="com.powernode.mybatis.pojo.Car">selectid,car_num as carNum,brand,guide_price as guidePrice,produce_time as produceTime,car_type as carTypefrom t_car
</select>
在这个查询中,使用了别名将数据库表中的列名映射到 Java 类 Car 中的属性名:
car_num as carNum:将数据库中的car_num列映射到Car类中的carNum属性。guide_price as guidePrice:将数据库中的guide_price列映射到Car类中的guidePrice属性。produce_time as produceTime:将数据库中的produce_time列映射到Car类中的produceTime属性。car_type as carType:将数据库中的car_type列映射到Car类中的carType属性。
Java 代码中的 selectList 调用
List<Car> cars = sqlSession.selectList("selectAll");
-
selectList方法:MyBatis 中的selectList方法用于返回一个List集合,集合中的每个元素是从数据库查询到的每一条记录的 Java 对象。在这个例子中,查询结果将会封装为一个Car对象的列表。 -
resultType属性:在 SQL 配置中,resultType依然用于指定封装查询结果的 Java 类类型,这里是com.powernode.mybatis.pojo.Car,表示查询结果会封装成Car类的对象。
注意事项
-
resultType指定的类型:需要注意的是,resultType并不是指定集合的类型,而是指定集合中的每个元素类型。在这个例子resultType="com.powernode.mybatis.pojo.Car",意味着 MyBatis 会将查询结果的每一条记录封装为Car对象。 -
selectList返回的结果:调用selectList("selectAll")会返回一个List集合,集合中的每个元素对应于查询结果中的一条记录,并会封装为指定的Car对象。
