MyBatis 어노테이션 매퍼로 쿼리 연동

Configuration          설정 한 덩어리. Environment(DataSource + TransactionFactory), 매퍼 목록, TypeHandler, 옵션
   │ build
SqlSessionFactory      애플리케이션에 하나. 스레드 안전. 커넥션 풀을 안고 있다
   │ openSession()
SqlSession             요청/작업 하나에 하나. 스레드 불안전. 커넥션 하나 = 트랜잭션 하나. 반드시 close()
   │ getMapper(MemberMapper.class)
MemberMapper (프록시)  인터페이스 구현체를 MyBatis 가 런타임에 생성. 메서드 호출 → 어노테이션의 SQL 실행

Environment env = new Environment("dev", new JdbcTransactionFactory(), ds);   // 트랜잭션은 JDBC conn.commit()/rollback() 직접
Configuration conf = new Configuration(env);
conf.setMapUnderscoreToCamelCase(true);                                      // joined_at → joinedAt
conf.getTypeHandlerRegistry().register(Boolean.class, YesNoTypeHandler.class);
conf.addMapper(MemberMapper.class);                                          // 어노테이션 매퍼 등록
SqlSessionFactory factory = new SqlSessionFactoryBuilder().build(conf);

@Select("SELECT COUNT(*) FROM member WHERE name = '${name}'")   // ❌ 입력 "' OR '1'='1" → 전원 반환
long countByNameUnsafe(@Param("name") String name);

@Select("SELECT COUNT(*) FROM member WHERE name = #{name}")      // ✅ 입력이 통째로 문자열 값
long countByNameSafe(@Param("name") String name);

int insert(Member m);                                        // 파라미터 1개 객체 → #{name}, #{email} 은 m 의 getter
Member findById(long id);                                    // 파라미터 1개 원시값 → #{id} (이름은 아무거나 가능)
int updateGrade(@Param("id") long id, @Param("grade") Member.Grade grade);   // 2개 이상 → @Param 필수
int insertOrder(Map<String, Object> order);                  // Map → #{memberId} 는 order.get("memberId")

@Select("SELECT * FROM member WHERE id = #{id}")
@Results(id = "memberMap", value = {
    @Result(property = "id", column = "id", id = true),
    @Result(property = "active", column = "active_yn")        // 이것만 명시. 나머지는 자동 매핑이 채운다
})
Member findById(long id);

@Select("SELECT * FROM member ORDER BY id")
@ResultMap("memberMap")                                        // 같은 매핑 재사용
List<Member> findAll();

public class YesNoTypeHandler extends BaseTypeHandler<Boolean> {
    @Override public void setNonNullParameter(PreparedStatement ps, int i, Boolean v, JdbcType t) throws SQLException { ps.setString(i, v ? "Y" : "N"); }
    @Override public Boolean getNullableResult(ResultSet rs, String col) throws SQLException { return "Y".equals(rs.getString(col)); }
    @Override public Boolean getNullableResult(ResultSet rs, int col) throws SQLException { return "Y".equals(rs.getString(col)); }
    @Override public Boolean getNullableResult(CallableStatement cs, int col) throws SQLException { return "Y".equals(cs.getString(col)); }
}
conf.getTypeHandlerRegistry().register(Boolean.class, YesNoTypeHandler.class);   // 전역 등록. 또는 @Result(typeHandler=) 로 컬럼별

factory.openSession()          autoCommit=false. 커넥션을 풀에서 하나 꺼낸다 (실제로는 첫 SQL 때)
  mapper.insert(...)           SQL 실행. DB 에는 갔지만 커밋 안 됨. 다른 세션에서 안 보임
  mapper.update(...)
  session.commit()             conn.commit(). 이 시점에 확정
session.close()                커넥션 반납. commit 안 했으면 rollback

factory.openSession(true)      autoCommit=true. 문장마다 커밋. 단건 조회·단건 변경에만
factory.openSession(ExecutorType.BATCH)   insert/update 를 addBatch 로 쌓고 flushStatements()/commit() 때 executeBatch

// 방법 1: 어노테이션 안에 XML 동적 태그를 <script> 로 인라인. XML 매퍼와 같은 문법
@Select("""
    <script>
    SELECT * FROM member
    <where>
        <if test="name != null">AND name LIKE '%' || #{name} || '%'</if>
        <if test="grades != null and !grades.isEmpty()">
            AND grade IN <foreach collection="grades" item="g" open="(" separator="," close=")">#{g}</foreach>
        </if>
    </where>
    ORDER BY id
    </script>
    """)
List<Member> searchScript(@Param("name") String name, @Param("grades") List<Member.Grade> grades, ...);

// 방법 2: Provider 클래스의 메서드가 자바 코드로 SQL 문자열을 만들어 반환
@SelectProvider(type = MemberSqlProvider.class, method = "search")
List<Member> search(MemberSqlProvider.Search cond);