【MyBatis】Mapperアノテーションを付けなても実行できる？

Question

わからないこと

Mybatis generator(https://mybatis.org/generator/) で作成したMapperインターフェースに@Mapperアノテーションが付与されていませんでした。
ですが、接続確認してみるとエラーにはならず実行できました

@Mapperアノテーションを付けないと、Mapperインターフェースを認識してくれないと考えていましたが
なぜ、つけなくても実行できているのでしょうか。

@Mapperは、どういうときにつけなくてはいけないのでしょうか？
よろしくお願いいたします。

やったこと(自動生成)

下記のような設定で、自動生成を実行しました。

<?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>
  <context id="sadDbTables" targetRuntime="MyBatis3">
    <!-- DB接続設定 -->
    <jdbcConnection driverClass="com.mysql.cj.jdbc.Driver"
      connectionURL="jdbc:mysql://127.0.0.1/hogedb"
      userId="hoge"
      password="passw0rd">
      <property name="nullCatalogMeansCurrent" value="true" />
    </jdbcConnection>
      
    <!-- Select結果がマッピングされる、Javaモデルの作成設定 -->
    <javaModelGenerator targetPackage="com.eui.sad.db.model.generator" targetProject="sad/src/main/java">
      <property name="enableSubPackages" value="true" />
      <property name="trimStrings" value="true" />
    </javaModelGenerator>
      
    <!-- SQLを定義したXMLファイルの作成設定 -->
    <sqlMapGenerator targetPackage="com.eui.sad.db.mapper"  targetProject="sad/src/main/resources">
      <property name="enableSubPackages" value="true" />
    </sqlMapGenerator>
    
    <!-- Mapperクラスの作成設定 -->
    <javaClientGenerator type="XMLMAPPER" targetPackage="com.eui.sad.db.mapper"  targetProject="sad/src/main/java">
      <property name="enableSubPackages" value="true" />
    </javaClientGenerator>
    
    <!-- 自動生成するテーブルの設定 -->
    <table tableName="%"
      enableInsert="true"
      enableSelectByPrimaryKey="true"
      enableUpdateByPrimaryKey="true"
      enableDeleteByPrimaryKey="true"
      enableSelectByExample="false"
      enableUpdateByExample="false"
      enableDeleteByExample="false"
      enableCountByExample="false"
      selectByPrimaryKeyQueryId="false"
      selectByExampleQueryId="false"
      modelType="flat">
    </table>
  </context>
</generatorConfiguration>

やったこと(接続確認)

とりあえず、Controllerで直接実行させてみました。
参考までに、依存関係と設定ファイルも載せます。

dependencies {
	implementation 'org.springframework.boot:spring-boot-starter-thymeleaf'
	implementation 'org.springframework.boot:spring-boot-starter-web'
	runtimeOnly 'mysql:mysql-connector-java'
	implementation 'org.mybatis.spring.boot:mybatis-spring-boot-starter:2.2.2'
	compileOnly 'org.projectlombok:lombok'
	developmentOnly 'org.springframework.boot:spring-boot-devtools'
	annotationProcessor 'org.projectlombok:lombok'
	testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

spring.datasource.url=jdbc:mysql://localhost/hogedb
spring.datasource.username=hoge
spring.datasource.password=passw0rd
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
mybatis.configuration.map-underscore-to-camel-case=true

package com.eui.sad.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;

import com.eui.sad.db.mapper.Sample1Mapper;
import com.eui.sad.db.model.generator.Sample1;

@Controller
public class SampleController {

    @Autowired
    Sample1Mapper mapper;

    @GetMapping("/sample")
    @ResponseBody
    public String sample() {
        Sample1 sample = mapper.selectByPrimaryKey(1);
        return "Hello World!" + sample.getCol1();
    }
}

package com.eui.sad.db.mapper;

import com.eui.sad.db.model.generator.Sample1;

public interface Sample1Mapper {

    /**
     * This method was generated by MyBatis Generator. This method corresponds to the database table sample1
     * @mbg.generated  Sun Apr 10 19:15:19 JST 2022
     */
    int deleteByPrimaryKey(Integer id);

    /**
     * This method was generated by MyBatis Generator. This method corresponds to the database table sample1
     * @mbg.generated  Sun Apr 10 19:15:19 JST 2022
     */
    int insert(Sample1 row);

    /**
     * This method was generated by MyBatis Generator. This method corresponds to the database table sample1
     * @mbg.generated  Sun Apr 10 19:15:19 JST 2022
     */
    int insertSelective(Sample1 row);

    /**
     * This method was generated by MyBatis Generator. This method corresponds to the database table sample1
     * @mbg.generated  Sun Apr 10 19:15:19 JST 2022
     */
    Sample1 selectByPrimaryKey(Integer id);

    /**
     * This method was generated by MyBatis Generator. This method corresponds to the database table sample1
     * @mbg.generated  Sun Apr 10 19:15:19 JST 2022
     */
    int updateByPrimaryKeySelective(Sample1 row);

    /**
     * This method was generated by MyBatis Generator. This method corresponds to the database table sample1
     * @mbg.generated  Sun Apr 10 19:15:19 JST 2022
     */
    int updateByPrimaryKeyWithBLOBs(Sample1 row);
}

Answer 1

自己解決しました

package com.eui.sad;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@MapperScan("com.eui.sad.db.mapper")
public class SadApplication {

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

}

試行錯誤しているときに、起動時のアノテーションで@MapperScanで指定していたのが残っていたから出来ていたようです。
@MapperScanで指定したパス以下をMapperとして読み込んでいるようです。
これがない場合、@Mapperが必要になるのも確認できました。

mybatis-spring-boot-starterを利用しているときは、基本的には@MapperScanは不要になるが
自動生成したソースの出力パッケージだけは、@MapperScanで指定してあげなければいけないという理解になりました。