Introduction to MyBatis: Architecture, Workflow, and Configuration Parsing

MyBatis is a powerful persistence framework that supports custom SQL, stored procedures, and advanced mappings, reducing most JDBC boilerplate by allowing XML or annotations to map Java POJOs to database records.

It operates in a semi‑automatic manner: developers supply SQL statements while MyBatis handles object‑to‑SQL parameter filling and result‑set extraction, offering flexibility compared to fully automatic ORM tools like Hibernate.

Typical usage includes downloading the source from https://github.com/mybatis/mybatis-3, importing it into an IDE, and building with mvn clean install.

The MyBatis workflow starts with parsing global and mapper configuration files into a Configuration object, creating a SqlSessionFactory, obtaining a SqlSession, and using the session to execute SQL via mapper interfaces.

Internally, SqlSession holds an Executor that delegates to a StatementHandler for parameter mapping, SQL execution, and result processing, while plugins extend core functionality.

The framework is organized into three layers: the Interface layer (exposes SqlSession methods), the Core Processing layer (handles parameter conversion, SQL parsing, execution, and result mapping), and the Basic Support layer (provides data source, cache, logging, reflection, I/O, and transaction support).

Configuration parsing involves classes such as XMLConfigBuilder, XMLMapperBuilder, and various element‑handling methods (e.g., propertiesElement(), typeAliasesElement(), pluginElement(), environmentsElement()), which populate the Configuration object with settings, type aliases, plugins, data sources, and mapper registrations.

Both XML mapper files and annotated mapper interfaces are ultimately transformed into MappedStatement objects, enabling consistent execution regardless of configuration style.

In summary, MyBatis provides a flexible, semi‑automatic approach to database access, with a clear architecture and extensible configuration system that developers can explore by examining its source code.