Spring 與 Mybatis 中的 @Repository 與 @Mapper

@Repository、@Service、@Controller，它們分別對應存儲層Bean，業務層Bean，和展示層Bean。
如果使用@Repository則需要使用@MapperScan("xxx.xxx.xxx.mapper")進行掃描，然后生成Dao層的Bean才能被注入到Service層中。
 

@Mapper通過xml里面的namespace里面的接口地址，生成了Bean后注入到Service層中。相當於@Mapper=@Repository+@MapperScane

 

使用注解的方式開發Dao層的時候，常常會混淆這兩個注解，不知道怎么添加，這里做個記錄。

 

1 - @Mapper
@Mapper 是 Mybatis 的注解，和 Spring 沒有關系，@Repository 是 Spring 的注解，用於聲明一個 Bean。（重要）

使用 Mybatis 有 XML 文件或者注解的兩種使用方式，如果是使用 XML 文件的方式，我們需要在配置文件中指定 XML 的位置，這里只研究注解開發的方式。

在 Spring 程序中，Mybatis 需要找到對應的 mapper，在編譯的時候動態生成代理類，實現數據庫查詢功能，所以我們需要在接口上添加 @Mapper 注解。

@Mapper
public interface UserDao {
    ...
}

但是，僅僅使用@Mapper注解，我們會發現，在其他變量中依賴注入，IDEA 會提示錯誤，但是不影響運行（親測～）。因為我們沒有顯式標注這是一個 Bean，IDEA 認為運行的時候會找不到實例注入，所以提示我們錯誤。如下圖，會有紅色波浪線。

 

 

 

 

 

 

 

盡管這個錯誤提示並不影響運行，但是看起來很不舒服，所以我們可以在對應的接口上添加 bean 的聲明，如下：

@Repository // 也可以使用@Component，效果都是一樣的，只是為了聲明為bean
@Mapper
public interface UserDao {
    

}

2 - @Repository

 

正如上面說的，@Repository 用於聲明 dao 層的 bean，如果我們要真正地使用 @Repository 來進行開發，那是基於代碼的開發，簡單來說就是手寫 JDBC。

和 @Service、@Controller 一樣，我們將 @Repository 添加到對應的實現類上，如下：

@Repository
public class UserDaoImpl implements UserDao{
    
    @Override
    public int insertUser(){
        JdbcTemplate template = new JdbcTemplate();
        ...
    }
}

 

3 - 其他掃描手段

基於注解的開發也有其他手段幫助 Mybatis 找到 mapper，那就是 @MapperScan 注解，可以在啟動類上添加該注解，自動掃描包路徑下的所有接口。使用這種方法，接口上不用添加任何注解。

@SpringBootApplication
@MapperScan("com.scut.thunderlearn.dao")
public class UserEurekaClientApplication {

    public static void main(String[] args) {
        SpringApplication.run(UserEurekaClientApplication.class, args);
    }
}

4 - 總結

1. @Mapper 一定要有，否則 Mybatis 找不到 mapper。
2. @Repository 可有可無，可以消去依賴注入的報錯信息。
3. @MapperScan 可以替代 @Mapper。但是依然解決不了，IDE注入紅線的問題。
4. 最終得出答案：@Mapper和@Repository 同時使用，完美解決所有問題。

---

正文結束 ，歡迎留言討論。