{"id":3839,"date":"2024-03-13T07:34:16","date_gmt":"2024-03-13T07:34:16","guid":{"rendered":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/"},"modified":"2025-07-30T21:50:18","modified_gmt":"2025-07-30T21:50:18","slug":"how-to-implement-unit-testing-in-mybatis","status":"publish","type":"post","link":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/","title":{"rendered":"MyBatis Unit Testing with H2 Database"},"content":{"rendered":"

In MyBatis, unit testing can be achieved by using the in-memory database H2 provided by MyBatis to simulate the database environment for testing. Below are the steps for implementing a simple MyBatis unit test.<\/p>\n

    \n
  1. Add H2 dependency: Include the H2 database dependency in the pom.xml file as shown below:<\/li>\n<\/ol>\n
    <dependency<\/span>><\/span>\r\n    <groupId<\/span>><\/span>com.h2database<\/groupId<\/span>><\/span>\r\n    <artifactId<\/span>><\/span>h2<\/artifactId<\/span>><\/span>\r\n    <version<\/span>><\/span>1.4.200<\/version<\/span>><\/span>\r\n    <scope<\/span>><\/span>test<\/scope<\/span>><\/span>\r\n<\/dependency<\/span>><\/span>\r\n<\/code><\/pre>\n
      \n
    1. Write a test class: Create a test class that extends from JUnit and add the @Test annotation to mark it as a test method, as shown below:<\/li>\n<\/ol>\n
      @RunWith(SpringJUnit4ClassRunner.class)<\/span>\r\n@ContextConfiguration(locations = \"classpath:applicationContext.xml\")<\/span>\r\npublic<\/span> class<\/span> MyBatisTest<\/span> {\r\n\r\n    @Autowired<\/span>\r\n    private<\/span> SqlSessionFactory sqlSessionFactory;\r\n\r\n    @Test<\/span>\r\n    public<\/span> void<\/span> testSelect<\/span>()<\/span> {\r\n        SqlSession<\/span> sqlSession<\/span> =<\/span> sqlSessionFactory.openSession();\r\n        try<\/span> {\r\n            \/\/ \u83b7\u53d6Mapper\u63a5\u53e3<\/span>\r\n            MyMapper<\/span> mapper<\/span> =<\/span> sqlSession.getMapper(MyMapper.class);\r\n            \/\/ \u8c03\u7528Mapper\u65b9\u6cd5<\/span>\r\n            MyEntity<\/span> result<\/span> =<\/span> mapper.selectById(1<\/span>);\r\n            \/\/ \u65ad\u8a00\u5224\u65ad\u7ed3\u679c<\/span>\r\n            assertNotNull(result);\r\n            assertEquals(\"test\"<\/span>, result.getName());\r\n        } finally<\/span> {\r\n            sqlSession.close();\r\n        }\r\n    }\r\n\r\n}\r\n<\/code><\/pre>\n
        \n
      1. Create a Mapper interface and corresponding Mapper.xml file: Develop a Mapper interface along with its corresponding Mapper.xml file, which will define database operation methods and SQL queries.<\/li>\n
      2. Write MyBatis configuration file: Write the MyBatis configuration file to configure the data source and scan path of Mapper interfaces.<\/li>\n
      3. Run test: right-click on the test class and select “Run As” -> “JUnit Test” to run the test.<\/li>\n<\/ol>\n
        By following the above steps, a simple MyBatis unit test can be implemented. In a real project, tools like Mockito can be used to mock objects, and Spring Test can be utilized for more complex testing scenarios such as integration testing.<\/p>\n","protected":false},"excerpt":{"rendered":"
        In MyBatis, unit testing can be achieved by using the in-memory database H2 provided by MyBatis to simulate the database environment for testing. Below are the steps for implementing a simple MyBatis unit test. Add H2 dependency: Include the H2 database dependency in the pom.xml file as shown below: <dependency> <groupId>com.h2database<\/groupId> <artifactId>h2<\/artifactId> <version>1.4.200<\/version> <scope>test<\/scope> <\/dependency> […]<\/p>\n","protected":false},"author":14,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_import_markdown_pro_load_document_selector":0,"_import_markdown_pro_submit_text_textarea":"","footnotes":""},"categories":[1],"tags":[2744,2745,2688,2743,134],"class_list":["post-3839","post","type-post","status-publish","format-standard","hentry","category-uncategorized","tag-h2-database","tag-in-memory-db","tag-java-persistence","tag-mybatis-testing","tag-unit-testing"],"yoast_head":"\nMyBatis Unit Testing with H2 Database - Blog - Silicon Cloud<\/title>\n<meta name=\"description\" content=\"Learn to implement MyBatis unit tests using H2 in-memory database with complete dependency setup guide.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MyBatis Unit Testing with H2 Database\" \/>\n<meta property=\"og:description\" content=\"Learn to implement MyBatis unit tests using H2 in-memory database with complete dependency setup guide.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\" \/>\n<meta property=\"og:site_name\" content=\"Blog - Silicon Cloud\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\" \/>\n<meta property=\"article:published_time\" content=\"2024-03-13T07:34:16+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-07-30T21:50:18+00:00\" \/>\n<meta name=\"author\" content=\"Noah Thompson\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:site\" content=\"@SiliCloudGlobal\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Noah Thompson\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\"},\"author\":{\"name\":\"Noah Thompson\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/2e83cc6ab9f60d36921c2d0f9f280f4a\"},\"headline\":\"MyBatis Unit Testing with H2 Database\",\"datePublished\":\"2024-03-13T07:34:16+00:00\",\"dateModified\":\"2025-07-30T21:50:18+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\"},\"wordCount\":191,\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"keywords\":[\"H2 database\",\"in-memory DB\",\"Java persistence\",\"MyBatis testing\",\"unit testing\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\",\"name\":\"MyBatis Unit Testing with H2 Database - Blog - Silicon Cloud\",\"isPartOf\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\"},\"datePublished\":\"2024-03-13T07:34:16+00:00\",\"dateModified\":\"2025-07-30T21:50:18+00:00\",\"description\":\"Learn to implement MyBatis unit tests using H2 in-memory database with complete dependency setup guide.\",\"breadcrumb\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.silicloud.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"MyBatis Unit Testing with H2 Database\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#website\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"name\":\"Silicon Cloud Blog\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\"},\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#organization\",\"name\":\"Silicon Cloud Blog\",\"url\":\"https:\/\/www.silicloud.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"contentUrl\":\"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png\",\"width\":1024,\"height\":1024,\"caption\":\"Silicon Cloud Blog\"},\"image\":{\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/\"},\"sameAs\":[\"https:\/\/www.facebook.com\/SiliCloudGlobal\/\",\"https:\/\/twitter.com\/SiliCloudGlobal\"]},{\"@type\":\"Person\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/2e83cc6ab9f60d36921c2d0f9f280f4a\",\"name\":\"Noah Thompson\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/350e537e1530ede2762ee0237e877d6693f4f7163ab4f303202cc9a6b27b6cb4?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/350e537e1530ede2762ee0237e877d6693f4f7163ab4f303202cc9a6b27b6cb4?s=96&d=mm&r=g\",\"caption\":\"Noah Thompson\"},\"url\":\"https:\/\/www.silicloud.com\/blog\/author\/noahthompson\/\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"MyBatis Unit Testing with H2 Database - Blog - Silicon Cloud","description":"Learn to implement MyBatis unit tests using H2 in-memory database with complete dependency setup guide.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/","og_locale":"en_US","og_type":"article","og_title":"MyBatis Unit Testing with H2 Database","og_description":"Learn to implement MyBatis unit tests using H2 in-memory database with complete dependency setup guide.","og_url":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/","og_site_name":"Blog - Silicon Cloud","article_publisher":"https:\/\/www.facebook.com\/SiliCloudGlobal\/","article_published_time":"2024-03-13T07:34:16+00:00","article_modified_time":"2025-07-30T21:50:18+00:00","author":"Noah Thompson","twitter_card":"summary_large_image","twitter_creator":"@SiliCloudGlobal","twitter_site":"@SiliCloudGlobal","twitter_misc":{"Written by":"Noah Thompson","Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/#article","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/"},"author":{"name":"Noah Thompson","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/2e83cc6ab9f60d36921c2d0f9f280f4a"},"headline":"MyBatis Unit Testing with H2 Database","datePublished":"2024-03-13T07:34:16+00:00","dateModified":"2025-07-30T21:50:18+00:00","mainEntityOfPage":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/"},"wordCount":191,"publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"keywords":["H2 database","in-memory DB","Java persistence","MyBatis testing","unit testing"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/","url":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/","name":"MyBatis Unit Testing with H2 Database - Blog - Silicon Cloud","isPartOf":{"@id":"https:\/\/www.silicloud.com\/blog\/#website"},"datePublished":"2024-03-13T07:34:16+00:00","dateModified":"2025-07-30T21:50:18+00:00","description":"Learn to implement MyBatis unit tests using H2 in-memory database with complete dependency setup guide.","breadcrumb":{"@id":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.silicloud.com\/blog\/how-to-implement-unit-testing-in-mybatis\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.silicloud.com\/blog\/"},{"@type":"ListItem","position":2,"name":"MyBatis Unit Testing with H2 Database"}]},{"@type":"WebSite","@id":"https:\/\/www.silicloud.com\/blog\/#website","url":"https:\/\/www.silicloud.com\/blog\/","name":"Silicon Cloud Blog","description":"","publisher":{"@id":"https:\/\/www.silicloud.com\/blog\/#organization"},"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.silicloud.com\/blog\/#organization","name":"Silicon Cloud Blog","url":"https:\/\/www.silicloud.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","contentUrl":"https:\/\/www.silicloud.com\/blog\/wp-content\/uploads\/2023\/11\/EN-SILICON-Full.png","width":1024,"height":1024,"caption":"Silicon Cloud Blog"},"image":{"@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/SiliCloudGlobal\/","https:\/\/twitter.com\/SiliCloudGlobal"]},{"@type":"Person","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/2e83cc6ab9f60d36921c2d0f9f280f4a","name":"Noah Thompson","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.silicloud.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/350e537e1530ede2762ee0237e877d6693f4f7163ab4f303202cc9a6b27b6cb4?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/350e537e1530ede2762ee0237e877d6693f4f7163ab4f303202cc9a6b27b6cb4?s=96&d=mm&r=g","caption":"Noah Thompson"},"url":"https:\/\/www.silicloud.com\/blog\/author\/noahthompson\/"}]}},"_links":{"self":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/3839","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/users\/14"}],"replies":[{"embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/comments?post=3839"}],"version-history":[{"count":2,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/3839\/revisions"}],"predecessor-version":[{"id":148503,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/posts\/3839\/revisions\/148503"}],"wp:attachment":[{"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/media?parent=3839"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/categories?post=3839"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.silicloud.com\/blog\/wp-json\/wp\/v2\/tags?post=3839"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}