MyBatis SQL Mapper Framework for Java

The MyBatis SQL mapper framework makes it easier to use a relational database with object-oriented applications. MyBatis couples objects with stored procedures or SQL statements using an XML descriptor or annotations. Simplicity is the biggest advantage of the MyBatis data mapper over object relational mapping tools.

Essentials

• See the docs
• Download Latest
• Download Snapshot

Contributions

Mybatis-core is now being auto formatted. Given nature of some code logic with mybatis, it is more appropriate to force a formatting structure manually for snippets such as sql statements. To do so, add following blocks around code.

• // @formatter:off to start the block of unformatted code
• // @formatter:on to end the block of unformatted code

If comment sections need same behaviour such as javadocs, note that the entire block must be around entire comment as direct usage does not properly indicate that formatter treats it all as one comment block regardless.

Tests

Mybatis-3 code runs more expressive testing depending on jdk usage and platform.

By default, we set <excludedGroups>TestcontainersTests,RequireIllegalAccess</excludedGroups> which will exclude a subset of tests with @Tag('TestcontainersTests') and @Tag('RequireIllegalAccess').

When we run on ci platform, we further make adjustments as needed. See here for details.

As of 12/28/2024, using combined system + jdk will result in given number of tests ran. This will change as tests are added or removed over time.

without adjusting settings (ie use as is, platform does not matter)

• any OS + jdk 17 = 1899 tests
• any OS + jdk 21 = 1899 tests
• any OS + jdk 23 = 1899 tests
• any OS + jdk 24 = 1899 tests
• any OS + jdk 25 = 1899 tests

our adjustments for GH actions where platform does matter

• windows + jdk 17 = 1899 tests

• windows + jdk 21 = 1899 tests

• windows + jdk 23 = 1899 tests

• windows + jdk 24 = 1899 tests

• windows + jdk 25 = 1899 tests

• linux + jdk 17 = 1934 tests

• linux + jdk 21 = 1934 tests

• linux + jdk 23 = 1934 tests

• linux + jdk 24 = 1934 tests

• linux + jdk 25 = 1934 tests

• mac + jdk 17 = 1899 tests

• mac + jdk 21 = 1899 tests

• mac + jdk 23 = 1899 tests

• mac + jdk 24 = 1899 tests

• mac + jdk 25 = 1899 tests