MyBatis 註解開發+逆向(Generator)
註解開發
最初設計時,MyBatis 是一個 XML 驅動的框架。配置資訊是基於 XML 的,而且對映語句也是定義在 XML 中的。隨著技術的更新發展,對於開發效率要求也原來越高,特別是一些小型專案;越來越多的框架開始支援註解,
到MyBatis3時,MyBatis對註解有了完善的支援,利用註解可以在一些情況下提高開發效率
但不幸的是,Java 註解的的表達力和靈活性十分有限。儘管很多時間都花在調查、設計和試驗上, 最強大的 MyBatis 對映並不能用註解來構建
1. select
介面方法宣告:
import com.kkb.pojo.User; import org.apache.ibatis.annotations.Select; public interface UserMapper2 { @Select("select * from kuser where id = #{id}") public User selectUserByID(int id); }
測試方法:
@Test
public void selectTest(){
SqlSession session = factory.openSession();
UserMapper2 mapper = session.getMapper(UserMapper2.class);
User user = mapper.selectUserByID(2);
System.out.println(user);
session.close();
}
不要忘記註冊這個介面到全域性配置中
<mappers> <mapper class="com.kkb.mapper.UserMapper2"/> </mappers>
2. sql語句多個引數
介面方法宣告:
@Select("select * from kuser where sex = #{sex} and name like '%${name}%'")
public List<User> selectUserBySexAndName(@Param("sex") String sex, @Param("name") String name);
測試方法:
@Test public void selectTest2(){ SqlSession session = factory.openSession(); UserMapper2 mapper = session.getMapper(UserMapper2.class); List<User> users = mapper.selectUserBySexAndName("1","張"); System.out.println(users); session.close(); }
一定要記住MyBatis的sql接受的引數只有一個無論實際傳了幾個
當sql語句需要多個引數時則必須將多個引數打包到一個物件中,通常是POJO或Map,上面的案例中使用了@Param註解本質就是告訴MyBatis有多個引數MyBatis會自動建立一個Map,然後將@Param的值作為Key,然後將Map傳給sql,所以你也可以手動傳一個Map
介面方法宣告:
@Select("select * from kuser where sex = #{sex} and name like '%${name}%'")
public List<User> selectUserBySexAndName(Map<String,Object> params);
測試方法:
@Test
public void selectTest2(){
SqlSession session = factory.openSession();
UserMapper2 mapper = session.getMapper(UserMapper2.class);
Map<String,Object> params = new HashMap<>(); //儲存引數的Map
params.put("sex","1");
params.put("name","張");
List<User> users = mapper.selectUserBySexAndName(params);
System.out.println(users);
session.close();
}
3. insert
介面方法宣告:
@Insert("insert into kuser values(null,#{name},#{birthday},#{sex},#{address})")
public int insertUser(User user);
測試方法:
@Test
public void insertTest() {
SqlSession session = factory.openSession();
UserMapper2 mapper = session.getMapper(UserMapper2.class);
User user = new User();
user.setName("jerry");
user.setSex("1");
user.setAddress("亞洲中國");
user.setBirthday(new Date());
mapper.insertUser(user);
session.commit();
session.close();
}
獲取自增主鍵
在@select註解的下方新增@selectKey註解來完成對自增主鍵的獲取
@Insert("insert into kuser values(null,#{name},#{birthday},#{sex},#{address})")
@SelectKey(statement = "select last_insert_id()",keyProperty = "id",resultType = Integer.class,before = false)
public int insertUser(User user);
在執行insert之後執行last_insert_id()函式獲取自增值,然後放入物件的某個屬性中;
4. update
介面方法宣告:
@Update("update kuser set name = #{name}, birthday = #{birthday}, sex = #{sex}, address = #{address} where id = #{id}")
public int updateUser(User u);
// 如果一行太長可以換行些 但是要注意sql語法
測試方法:
@Test
public void updateTest() {
SqlSession session = factory.openSession();
UserMapper2 mapper = session.getMapper(UserMapper2.class);
User user = mapper.selectUserByID(1);
user.setName("王六子");
mapper.updateUser(user);
session.commit();
session.close();
}
5.delete
介面方法宣告:
@Delete("delete from kuser where id = #{id}")
public int deleteUserByID(int id);
測試方法:
@Test
public void deleteTest() {
SqlSession session = factory.openSession();
UserMapper2 mapper = session.getMapper(UserMapper2.class);
mapper.deleteUserByID(12);
session.commit();
session.close();
}
6. 動態sql
動態sql指語句中包含邏輯程式碼,需要先執行邏輯程式碼,最後產生sql語句,所以需要在註解中告訴MyBatis這是一個動態sql,通過<script>sql....</script>
語法來指定;
若想要在sql中使用各種標籤則必須新增上述根標籤,否則MyBatis會將整體作為sql語句
介面方法宣告:
@Select("<script>" +
"select * from kuser" +
"<where>" +
"<if test='name != null'>" +
"and name like '%${name}%'" +
"</if>" +
"<if test='sex != null'>" +
"and sex = #{sex}" +
"</if>" +
"</where>" +
"</script>")
public List<User> searchUserByNameAndSex(@Param("name") String name,@Param("sex") String sex);
測試程式碼:
@Test
public void dynamicSqlTest(){
SqlSession session = factory.openSession();
UserMapper2 mapper = session.getMapper(UserMapper2.class);
List<User> users = mapper.searchUserByNameAndSex(null,null);
// List<User> users = mapper.searchUserByNameAndSex("張",null);
// List<User> users = mapper.searchUserByNameAndSex("張", "2");
System.out.println(users);
session.close();
}
7.結果對映(ResultMap)
1.自定義欄位與屬性對應關係
準備工作:將資料庫中的name欄位修改為username,然後我們通過ResultMap來手動對映name欄位
介面方法宣告:
@Select("select *from kuser where username = #{name}")
@Results({
@Result(id = true,column = "id",property = "id"),
@Result(column = "username",property = "name"),
})
public User selectUserByName(String name);
測試程式碼省略..
重複使用Results
可以發現,MyBatis預設會自動對映所有欄位和屬性匹配的資料,另外id表示是否為主鍵欄位,預設為false
強調:Results可以位於對應方法的上面或下面,但是無法跨域其他方法,預設只對當前方法有效,如果需要重複使用則需要為其指定id
介面方法宣告:
//定義
@Results(id="map1",value = {
@Result(id = true,column = "id",property = "id"),
@Result(column = "username",property = "name"),
})
//.....中間必須間隔其他方法不能立即應用到某個ResultMap
使用:
@Select("select *from kuser where username = #{name}")
//通過@ResultMap註解 並傳入id來使用
@ResultMap("map1")
public User selectUserByName(String name);
注意:@Results的定義不能不能和使用它的@ResultMap一起出現,既然是重複使用的那我建議統一介面的最上面
2.關聯查詢
一對多關聯
//實現根據使用者姓名查詢使用者資訊和訂單資訊
@Select("select *from kuser where username = #{name}")
@Results(value = {
@Result(id = true,column = "id",property = "id"),
@Result(column = "username",property = "name"),
//一對多關聯,指定子查詢語句的方法名稱(全限定名稱)column指定傳給子查詢的引數
@Result(column = "id",property = "orders",many = @Many(select = "com.kkb.mapper.UserMapper2.selectOrdersByID")),
})
public User selectUserAdnOrdersByUserName(String name);
//注意這裡的條件欄位時order表中的欄位
@Select("select *from Orders where user_id = #{id}")
public List<Order> selectOrdersByID(int id);
一對一關聯 只需要修改屬性名稱和註解名稱即可:
@Select("select *from orders where id = #{id}")
@Results(value = {
@Result(id = true,column = "id",property = "id"),
@Result(column = "user_id",property = "user" ,one = @One(select = "com.kkb.mapper.UserMapper2.selectUserByID")),
})
public Order selectOrderByID(int id);
逆向工程(generator)
generator翻譯為生成器,是MyBatis開源的一個外掛,可以從資料庫獲取表資訊,自動生成Mapper.xml
,POJO
,以及Mapper
介面
但問題是,MyBatis不可能完全清楚我們的業務需求,所以其自動生成的sql只能滿足基本的CRUD操作,而無法幫助我們進行連表操作,(當然包括帶有條件的CRUD)
使用步驟
1.使用Maven新增generator外掛
<build>
<plugins>
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.7</version>
<configuration>
<!-- 是否覆蓋已存在的介面和POJO-->
<overwrite>true</overwrite>
</configuration>
</plugin>
</plugins>
</build>
2.建立配置檔案,位於resource下名為generatorConfig.xml
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE generatorConfiguration
PUBLIC "-//mybatis.org//DTD MyBatis Generator Configuration 1.0//EN"
"http://mybatis.org/dtd/mybatis-generator-config_1_0.dtd">
<generatorConfiguration>
<!--匯入屬性配置-->
<properties resource="jdbc.properties"></properties>
<!--指定特定資料庫的jdbc驅動jar包的位置-->
<classPathEntry location="${location}"/>
<context id="default" targetRuntime="MyBatis3">
<!-- optional,旨在建立class時,對註釋進行控制 -->
<commentGenerator>
<property name="suppressDate" value="true"/>
<property name="suppressAllComments" value="true"/>
</commentGenerator>
<!--jdbc的資料庫連線 -->
<jdbcConnection
driverClass="${driver}" connectionURL="${url}" userId="${user}" password="${password}">
</jdbcConnection>
<!-- 非必需,型別處理器,在資料庫型別和java型別之間的轉換控制-->
<javaTypeResolver>
<property name="forceBigDecimals" value="false"/>
</javaTypeResolver>
<!--Model模型生成器,用來生成含有主鍵key的類,記錄類 以及查詢Example類
targetPackage 指定生成的model生成所在的包名
targetProject 指定在該專案下所在的路徑 -->
<javaModelGenerator targetPackage="com.kaikeba.pojo" targetProject="src/main/java">
<!-- 是否允許子包,即targetPackage.schemaName.tableName -->
<property name="enableSubPackages" value="false"/>
<!-- 是否對model新增 建構函式 -->
<property name="constructorBased" value="true"/>
<!-- 是否對類CHAR型別的列的資料進行trim操作 -->
<property name="trimStrings" value="true"/>
<!-- 建立的Model物件是否 不可改變 即生成的Model物件不會有 setter方法,只有構造方法 -->
<property name="immutable" value="false"/>
</javaModelGenerator>
<!--mapper對映檔案生成所在的目錄 為每一個數據庫的表生成對應的SqlMap檔案 -->
<sqlMapGenerator targetPackage="com.kaikeba.dao"
targetProject="src/main/resources">
<property name="enableSubPackages" value="false"/>
</sqlMapGenerator>
<!--mapper介面檔案生成所在的目錄 為每一個數據庫的表生成對應的介面檔案 -->
<javaClientGenerator type="XMLMAPPER" targetPackage="com.kaikeba.dao" targetProject="src/main/java">
<!-- enableSubPackages:是否讓schema(資料庫名稱)作為包的字尾 -->
<property name="enableSubPackages" value="false"/>
</javaClientGenerator>
<!--指定需要生成的表-->
<table tableName="category"></table>
<table tableName="orders"></table>
<table tableName="products"></table>
<table tableName="kuser"></table>
</context>
</generatorConfiguration>
上述配置是一個較為通用的配置,實際開發中要根據需求進行修改
若自定義配置檔名稱則需要在pom中指定
<build>
<plugins>
<plugin>
<groupId>org.mybatis.generator</groupId>
<artifactId>mybatis-generator-maven-plugin</artifactId>
<version>1.3.7</version>
<configuration>
<!-- 自定義配置檔案 相對於專案根目錄-->
<configurationFile>src/main/resources/aaaa.xml</configurationFile>
<overwrite>true</overwrite>
</configuration>
</plugin>
</plugins>
</build>
3.執行generator
可在idea右側的maven選單中雙擊執行mybatis-generator:generate
也可利用maven命令執行:mybatis-generator:generate
4.條件查詢的使用檢視POJO包,會發現每個POJO對應了一個Example,這是什麼呢?
generator的目標是儘可能的幫我們減少sql的編寫,如果只能進行簡單的CRUD那意義不大,於是generator使用了一套Example來幫助我們用OOP(面向物件)的方式來完成SQL中的條件拼接
其設計思想是將條件看做是一個物件,該物件包含了SQL中常見的比較,邏輯運算等......開啟檔案你會發現其本質就是幫我們拼接響應的sql符號和關鍵字
5.CRUD案例
import com.kaikeba.dao.KuserMapper;
import com.kaikeba.pojo.Kuser;
import com.kaikeba.pojo.KuserExample;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Before;
import org.junit.Test;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
public class GeneratorTest {
private SqlSessionFactory factory;
@Before
public void init() throws IOException {
//獲取的工廠構造器
SqlSessionFactoryBuilder builder = new SqlSessionFactoryBuilder();
//載入配置檔案
InputStream stream = Resources.getResourceAsStream("mybatis-config.xml");
//獲得會話工廠
factory = builder.build(stream);
}
//查詢
@Test
public void test(){
SqlSession session = factory.openSession();
KuserMapper mapper = session.getMapper(KuserMapper.class);
Kuser kuser = mapper.selectByPrimaryKey(1);
System.out.println(kuser.getSex());
System.out.println(kuser.getAddress());
System.out.println(kuser.getBirthday());
System.out.println(kuser.getUsername());
}
//修改
@Test
public void test2(){
SqlSession session = factory.openSession();
KuserMapper mapper = session.getMapper(KuserMapper.class);
Kuser kuser = mapper.selectByPrimaryKey(1);
kuser.setUsername("XXXXXXXXX");
mapper.updateByPrimaryKey(kuser);
session.commit();
}
//新增
@Test
public void test3(){
SqlSession session = factory.openSession();
KuserMapper mapper = session.getMapper(KuserMapper.class);
Kuser auser = new Kuser();
auser.setUsername("jack");
auser.setAddress("北京東城");
mapper.insert(auser);
session.commit();
}
//刪除
@Test
public void test4() {
SqlSession session = factory.openSession();
KuserMapper mapper = session.getMapper(KuserMapper.class);
mapper.deleteByPrimaryKey(13);
session.commit();
}
//and條件
@Test
public void test5() {
SqlSession session = factory.openSession();
KuserMapper mapper = session.getMapper(KuserMapper.class);
KuserExample kuserExample = new KuserExample();
KuserExample.Criteria criteria = kuserExample.createCriteria();
criteria.andBirthdayIsNotNull();
criteria.andUsernameLike("%張%");
List<Kuser> kusers = mapper.selectByExample(kuserExample);
System.out.println(kusers);
}
// or條件
@Test
public void test6() {
SqlSession session = factory.openSession();
KuserMapper mapper = session.getMapper(KuserMapper.class);
KuserExample kuserExample = new KuserExample();
//建立一個條件物件,可以包含n個and
KuserExample.Criteria criteria1 = kuserExample.createCriteria();
criteria1.andUsernameLike("%張%");
//建立一個條件物件可以包含n個and,且前面新增or關鍵字
KuserExample.Criteria criteria2 = kuserExample.or();
criteria2.andBirthdayIsNull();
//最終的意思是 名字帶有張的 或者生日為空的; 具體邏輯可根據生產的sql進行分析
List<Kuser> kusers = mapper.selectByExample(kuserExample);
System.out.println(kusers);
}
}