mybatis

mybatis/mybatis-3

MyBatis SQL mapper framework for Java

View on GitHub Website / Demo Back to listing

20.4kstars 12.8kforks 100+contributors Java

README.md

MyBatis SQL Mapper Framework for Java
=====================================

[![build](https://github.com/mybatis/mybatis-3/actions/workflows/ci.yaml/badge.svg)](https://github.com/mybatis/mybatis-3/actions?query=workflow%3A%22Java+CI%22)
[![Coverage Status](https://coveralls.io/repos/mybatis/mybatis-3/badge.svg?branch=master&service=github)](https://coveralls.io/github/mybatis/mybatis-3?branch=master)
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=mybatis_mybatis-3&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=mybatis_mybatis-3)
[![Maven Central](https://img.shields.io/maven-central/v/org.mybatis/mybatis.svg)](https://central.sonatype.com/artifact/org.mybatis/mybatis)
[![License](https://img.shields.io/:license-apache-brightgreen.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
[![Docs](https://img.shields.io/badge/docs-mybatis.org-blue?logo=github)](https://mybatis.org/mybatis-3/)
[![Stack Overflow](https://img.shields.io/:stack%20overflow-mybatis-brightgreen.svg)](https://stackoverflow.com/questions/tagged/mybatis)
[![Project Stats](https://www.openhub.net/p/mybatis/widgets/project_thin_badge.gif)](https://www.openhub.net/p/mybatis)

![mybatis](https://mybatis.org/images/mybatis-logo.png)

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.

Contributions
-------------

See [here](CONTRIBUTING.md)

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](.github/workflows/ci.yaml) 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 21 = 1899 tests
- any OS + jdk 25 = 1899 tests

our adjustments for GH actions where platform does matter

- windows + jdk 21 = 1899 tests
- windows + jdk 25 = 1899 tests

- linux + jdk 21 = 1934 tests
- linux + jdk 25 = 1934 tests

- mac + jdk 21 = 1899 tests
- mac + jdk 25 = 1899 tests

Repository info

Default branch: master
Latest version: mybatis-3.5.19
Created: 2013-02-15
Last activity: 2026-10-11
License: Apache-2.0
Open issues: 217
Watchers: 1.1k

Topics

java mybatis sql

Contributors

hazendaz

1.6k contributions

harawata

1k contributions

emacarron

1k contributions

kazuki43zoo

539 contributions

renovate[bot]

450 contributions