2. 程式人生 > >從頭開始基於Maven搭建SpringMVC+Mybatis專案(1)

從頭開始基於Maven搭建SpringMVC+Mybatis專案(1)

阿新 • • 發佈：2019-02-04

技術發展日新月異，許多曾經擁有霸主地位的流行技術短短几年間已被新興技術所取代。

在Java的世界中，框架之爭可能比語言本身的改變更讓人關注。近幾年，SpringMVC憑藉簡單輕便、開發效率高、與Spring框架無縫整合等特點，逐漸擊敗前輩Struts/Struts2，成為最常用的Web框架。而Mybatis相對於Hibernate，同樣具有開發簡單、效率高的優勢，而且對SQL的可控性更好，有利於效能調優，逐漸也積累了挑戰Hibernate的實力和人氣。

當前SpringMVC+Mybatis已經成為最流行的框架組合之一。

好的框架可以幫我們簡化開發，但實際的工作中還有大量的時間是花在編譯、測試、打包、部署等構建工作上，即使IDE變得越來越強大，但這些工作仍然需要我們一步一步去操作，而不能變成自動化的流水線作業。每天、每個專案重複這些步驟是毫無意義的，所以我們需要構建工具的幫助。構建工具的可選擇性並不是很多，Maven是目前是主流的選擇，它可以幫助開發者自動化構建、標準化結構、管理依賴等，極大的提高程式碼以外的工作效率。

Maven、SpringMVC、Mybatis的組合優雅而強大，但對於初學者來說，把三者整合在一起並不是一件簡單的事。本文對這一複雜過程做拆解，從最基礎的步驟開始，一步步搭建起一個支援增、刪、改、分頁查詢的Web專案。

本文以Eclipse為開發工具，並需要安裝好Maven及Maven Integration for Eclipse外掛，資料庫使用MySQL。

如果沒有安裝過Maven可以參考：

下面正式開始。

開啟Eclipse，依次點選 File -> New -> Maven Project


這一步不做任何修改，直接下一步


接下來是選擇Archetype。Maven提倡約定優於配置，對於原始碼目錄結構、配置檔案位置、測試使用者目錄等內容都有既定的規則。遵循這些規則的好處就是不同開發者建立的專案結構是一致的，減少了在加入新專案時額外的熟悉和學習成本。

Maven內建的多種archetype可以針對不同型別的專案幫助開發者迅速勾勒出專案的骨架，例如Web專案可以選擇maven-archetype-webapp，自動建立的目錄中包括webapp等。這裡從最基礎的開始，選擇maven-archetype-quickstart，其他選項保持不變，點選下一步。


這一步中填寫專案的基本資訊。Group Id和Artifact Id用於標註專案或模組的座標，Maven的一大功能是管理依賴(jar包)，Maven的中央倉庫中有成千上萬的的開源專案，在倉庫中找到所需的專案檔案就需要給每個專案分配一個唯一的標識。Group Id用於定義當前的專案，每個專案下按功能可能劃分多個模組，Artifact Id定義具體的模組。例如Spring專案的Group Id是org.springframework，其下面劃分了Artifact Id為spring-core、spring-context、spring-jdbc等多個模組。

輸入Group Id和Artifact Id後點擊完成。完成後生成的專案結構如下：


預設生成了src/main和src/test兩個資料夾，根據約定，main放置專案原始碼，test目錄放置測試用例。預設還生成了兩個演示檔案（App.java和AppTest.java）可以直接刪除。

本例中我們使用Mybatis操作MySQL資料庫，並使用Spring整合，這些都需要新增依賴，即jar包。藉助Maven，開發者不再需要去各個網站下載檔案，而只需要配置pom.xml即可。開啟pom.xml，預設程式碼如下：

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>

	<groupId>com.example</groupId>
	<artifactId>petstore</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

	<name>petstore</name>
	<url>http://maven.apache.org</url>

	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
	</properties>

	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>3.8.1</version>
			<scope>test</scope>
		</dependency>
	</dependencies>
</project>
其中，<dependencies>節點中的內容即依賴，Archetype預設添加了junit-3.8.1，我們按需要補充Spring、Mybatis、MySQL驅動等，完成後程式碼如下 
...
	
	<properties>
		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
		<springframework.version>4.2.6.RELEASE</springframework.version>
	</properties>

	<dependencies>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>4.12</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-test</artifactId>
			<version>${springframework.version}</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-core</artifactId>
			<version>${springframework.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-context</artifactId>
			<version>${springframework.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-beans</artifactId>
			<version>${springframework.version}</version>
		</dependency>
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jdbc</artifactId>
			<version>${springframework.version}</version>
		</dependency>
		<dependency>
			<groupId>c3p0</groupId>
			<artifactId>c3p0</artifactId>
			<version>0.9.1.2</version>
		</dependency>
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis</artifactId>
			<version>3.4.1</version>
		</dependency>
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis-spring</artifactId>
			<version>1.3.0</version>
		</dependency>
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>5.1.18</version>
		</dependency>
	</dependencies>
</project>

注意這裡使用了一個小技巧，spring有多個模組且使用相同的版本號，所以設定了一個<springframework.version>屬性常量，如果需要修改版本只需要修改此處常量值即可。

至此Maven配置完成，下面開始Mybatis部分。

本例中要實現的功能很簡單，基於關係型資料庫對某種商品做插入和查詢的管理，商品僅有名稱和價格兩個屬性。首先準備好資料庫。

建庫：

CREATE SCHEMA `petstore` DEFAULT CHARACTER SET utf8 COLLATE utf8_bin ;
建表： 
CREATE TABLE `petstore`.`t_product` (
  `p_id` INT NOT NULL AUTO_INCREMENT,
  `p_name` VARCHAR(45) NOT NULL,
  `p_price` FLOAT NOT NULL,
  PRIMARY KEY (`p_id`))
ENGINE = InnoDB
DEFAULT CHARACTER SET = utf8;
Mybatis作為ORM框架，在這裡的作用是把對t_product表的操作對映成對Java類的操作，依據約定，我們需要編碼三個檔案：

Product.java - 對映實體類

ProductMapper.java - 介面，定義可呼叫的方法

Product.xml - 實際執行的SQL對映檔案

新增程式碼檔案後的目錄結構如下：


三個檔案的程式碼如下：

Product.java

package com.example.petstore.model;

public class Product {

	private int id;
	private String name;
	private float price;

	public int getId() {
		return id;
	}
	public void setId(int id) {
		this.id = id;
	}
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
	public float getPrice() {
		return price;
	}
	public void setPrice(float price) {
		this.price = price;
	}
}
ProductMapper.java 
package com.example.petstore.model;

public interface ProductMapper {

	void addProduct(Product product);
	
	Product selectById(int id);
}
Product.xml 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.example.petstore.model.ProductMapper">

	<resultMap type="com.example.petstore.model.Product" id="productMap">
		<id column="p_id" property="id" />
		<result column="p_name" property="name" />
		<result column="p_price" property="price" />
	</resultMap>
	
	<insert id="addProduct" parameterType="com.example.petstore.model.Product" useGeneratedKeys="true" keyProperty="id">
		insert into t_product(p_name,p_price) values(#{name},#{price})
	</insert>

	<select id="selectById" parameterType="int" resultType="com.example.petstore.model.Product" resultMap="productMap">
		select * from t_product where p_id=#{id}
	</select>
</mapper>
可以看出，Product.java和ProductMapper.java非常普通，沒有任何與資料庫操作有關聯的內容。關鍵程式碼在Product.xml中，其中，insert元素的id指明其匹配的方法是ProductMapper.java中的addProduct方法，引數型別是Product的例項，使用了資料庫自增欄位，並且把自增的值繫結到id屬性上。select元素匹配的方法是selectById，resultMap元素定義了欄位和Product類的屬性的對應關係。

程式碼中並沒有生成ProductMapper的實現類，而是在執行期間動態建立代理類來完成例項化。

到這裡Mybatis程式碼就開發完成了，但是我們還想知道這些程式碼是否可以正常工作，需要編寫一些測試用例。

如果僅使用Mybatis（而不使用Spring），那麼還要新增Mybatis配置檔案設定資料庫連線等，但這裡不打算這麼做，而是用Spring接管，所以接下來的程式碼是Spring核心配置檔案applicationContext.xml。注意這裡是用於測試，所以檔案將新增在src/test/java目錄。

applicationContext.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"  
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop"  
    xmlns:tx="http://www.springframework.org/schema/tx" xmlns:jdbc="http://www.springframework.org/schema/jdbc"  
    xmlns:context="http://www.springframework.org/schema/context"  
    xsi:schemaLocation="  
     http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd  
     http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd  
     http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.0.xsd  
     http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd  
     http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd">

	<bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource"
		destroy-method="close">
		<property name="driverClass" value="com.mysql.jdbc.Driver" />
		<property name="jdbcUrl" value="jdbc:mysql://localhost:3306/petstore?useUnicode=true&characterEncoding=UTF8" />
		<property name="user" value="root" />
		<property name="password" value="root123456" />
		<property name="minPoolSize" value="2" />
		<property name="maxPoolSize" value="10" />
	</bean>

	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource" />
		<property name="mapperLocations" value="classpath*:com/example/petstore/model/*.xml" />
	</bean>

	<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
		<property name="basePackage" value="com.example.petstore.model" />
	</bean>
</beans>

其中，資料庫的連線串及使用者名稱、密碼是我的測試機的設定，你需要按你的環境進行修改。

然後是測試用例，在src/test/java下新增類com.example.petstore.test.ProductTest.java 
package com.example.petstore.test;

import static org.junit.Assert.*;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.context.junit4.SpringJUnit4ClassRunner;

import com.example.petstore.model.Product;
import com.example.petstore.model.ProductMapper;

@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations = "classpath:applicationContext.xml")
public class ProductTest {

	@Autowired
	private ProductMapper productMapper;
	
	@Test
	public void insertAndSelect() {
		Product product1 = new Product();
		product1.setName("tom");
		product1.setPrice(99.9f);
		productMapper.addProduct(product1);
		assertTrue(product1.getId() > 0);
		
		Product product2 = productMapper.selectById(product1.getId());
		assertTrue(product2.getId() == product1.getId());
		assertTrue(product2.getName().equals(product1.getName()));
	}
}
大功告成，本節中的所有程式碼都寫完了，完成後的目錄結構如下：


執行一下看看，在ProductTest.java上點右鍵 -> Run As -> Junit Test


測試通過，來看一下資料庫裡的內容：


總結

上述示例中完成了通過Maven建立簡單專案、對資料庫表的插入和讀取操作，儘管沒什麼實用性，但也能夠了解到了Mybatis的基本用法及與Spring的整合方式。

專案以jar包形式打包釋出，這樣做有利於程式碼複用，但是顯然無法再增加Web部分的內容。傳統的做法是另建一個Web專案並引用此專案，但我們接下來將使用Maven的聚合和繼承功能構建包括一個數據庫持久層模組和一個基於SpringMVC的Web模組的聚合專案，這些內容在下一節中介紹。

相關推薦

從頭開始基於Maven搭建SpringMVC+Mybatis專案(1)

技術發展日新月異，許多曾經擁有霸主地位的流行技術短短几年間已被新興技術所取代。 在Java的世界中，框架之爭可能比語言本身的改變更讓人關注。近幾年，SpringMVC憑藉簡單輕便、開發效率高、與Spring框架無縫整合等特點，逐漸擊敗前輩Struts/Struts2，成為最

從頭開始基於Maven搭建SpringMVC+Mybatis專案(3)

接上文內容，本節介紹基於Mybatis的查詢和分頁功能，並展示一個自定義的分頁標籤，可重複使用以簡化JSP頁面的開發。 在上一節中，我們已經使用Maven搭建好了專案的基礎結構，包括一個父專案petstore-parent和資料庫持久層模組petstore-persist

從頭開始基於Maven搭建SpringMVC+Mybatis專案(4)

接上文內容，上一節中的示例中完成了支援分頁的商品列表查詢功能，不過我們的目標是打造一個商品管理後臺，本節中還需要補充新增、修改、刪除商品的功能，這些功能依靠Mybatis操作資料庫，並通過SpringMVC的資料驗證功能檢查資料合法性。既然是後臺，那麼肯定還需要驗證和登入，

Maven搭建SpringMVC+Mybatis專案詳解

前言          最近比較閒，複習搭建一下專案，這次主要使用Spring+SpringMVC+Mybatis。專案持久層使用Mybatis3，控制層使用SpringMVC4.1，使用Spring4.1管理控制器，資料庫連線池使用druid資料來源，該項資料庫暫使用My

Intellij Idea建立基於Maven的SpringMVC+MyBatis專案

前言：SpringMVC是一款輕量級的Web開發框架，非常有利於新手上手，對於持久化層，目前可選擇的是Hibernate和Mybatis，而Mybatis的學習曲線較為平整，因此本文介紹了利用Intellij Idea建立基於Maven的SpringMVC／My

Maven搭建SpringMVC+Hibernate專案詳解

前言      今天覆習一下SpringMVC+Hibernate的搭建，本來想著將Spring-Security許可權控制框架也映入其中的，但是發現內容太多了，Spring-Security的就留在下一篇吧，這篇主要搭建SpringMVC4.1.4和Hibernate4.

基於maven搭建spring+springMVC+mybatis（SSM）框架專案

一.簡介 這篇文章是記錄我自己手動搭建基於maven的SSM（spring+springMVC+mybatis）框架專案的整個過程，目的是為了加深印象和方便以後查閱以及整理思路。 二.開發環境準備 （1）系統：Windows10（專業版） （2）eclispe版本：Eclipse J

使用IDEA基於Maven搭建多模塊聚合工程（springmvc+spring+mybatis整合）

utf-8 組件 json處理 con mon 博客 quick 作者 處理工具 文章有不當之處，歡迎指正，如果喜歡微信閱讀，你也可以關註我的微信公眾號：好好學java，獲取優質學習資源。 終於有時間搞java了，今天使用IDEA基於maven搭建了多模塊聚合工程，經過了

使用IDEA基於Maven搭建多模組聚合工程（springmvc+spring+mybatis整合）

文章有不當之處，歡迎指正，如果喜歡微信閱讀，你也可以關注我的微信公眾號：好好學java，獲取優質學習資源。 終於有時間搞java了，今天使用IDEA基於maven搭建了多模組聚合工程，經過了多番嘗試，終於成功啦！ 注意：這裡是在原作者的基礎上改進的版

solr測試專案（上）--基於maven的springmvc環境搭建

從去年9月21開始寫部落格，今天整一年了。 從開始寫文章到現在，寫過spring的，springmvc的，spring與其他框架整合的（包括hibernate，ehcache，shiro），寫過一些工具類，寫過微信公眾號開發，寫過前端的一些小demo，雖然一直

idea 搭建 springMVC+mybatis+maven 專案（二）

空的maven專案搭建完成之後，可以為自己的專案新增內容了，下面是我設定的檔案結構： 如果你發現在建立java檔案之後，無法建立package屬性的檔案，那麼你需要下面的配置了——–配置每一個資料夾的屬性。 點選File->Project Stru

使用idea搭建基於maven的ssm聚合專案

版本統一               關於專案搭建，版本間的相互依賴很重要，所以一般情況下需要固定版本。 jd

搭建eclipse+tomcat+maven+shiro+springmvc+jpa專案（二）：基本框架搭建

1、pom.xml配置 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://m

搭建eclipse+tomcat+maven+shiro+springmvc+jpa專案（一）：技術選型及架構文件

一、Java語言 Java是一門面向物件程式語言，不僅吸收了C++語言的各種優點，還摒棄了C++裡難以理解的多繼承、指標等概念，因此Java語言具有功能強大和簡單易用兩個特徵。Java語言作為靜態面向物件程式語言的代表，極好地實現了面向物件理論，允許程式設計師以優雅的思維方式進行復雜的程式設計。

Spring+Spring MVC+Mybatis+Maven搭建多模組專案

maven多模組專案SpringMVC簡單例項：劃分多模組，也就是方便多人開發，自己開發自己的那塊沒有多大沖突。 專案結構 整個專案目錄是這樣的： GitHub地址 ：https://github.com/thecattle/maven_model —-

搭建Maven+Spring+SpringMVC+Mybatis後臺環境之在IDEA中整合Maven

搭建Maven+Spring+SpringMVC+Mybatis後臺環境之在IDEA中整合Maven 開啟IDEA，插一句閒話：沒事就更新最新版吧，之前用的2018.1差點把自己坑死，同樣的裝備換成最新版，啥問題都沒有。 1、開啟 File → Settings 如圖配置

搭建Maven+Spring+SpringMVC+Mybatis後臺環境之Maven的安裝與配置

搭建Maven+Spring+SpringMVC+Mybatis後臺環境之Maven的安裝與配置 最近沉迷於小程式開發，前端學習的差不多了，後臺想用Maven+Spring+SpringMVC+Mybati體系結構來開發，用MySQL作為資料庫。本文先介紹Maven的安裝。 下載

Maven搭建SpringMVC專案詳解

前言         上一次複習搭建了SpringMVC+Mybatis，這次搭建一下SpringMVC，採用的是SpringJDBC，沒有采用任何其他的ORM框架，SpringMVC提供了一整套的WEB框架，所以如果想搭建純的SpringMVC的話，而且不必映入別的任何框

Spring+Spring MVC+Mybatis+Maven搭建多模組專案(二)

基於第一篇文章《Spring+Spring MVC+Mybatis+Maven搭建多模組專案(一)》的基礎上，寫一個完整的示例，從頁面到Dao層的整個過程 1、先在bug.model模組下建立com.bug.model.user包，在包中建立UserVO物件

Spring+Spring MVC+Mybatis+Maven搭建多模組專案(一)

最近在研究Spring MVC和Maven，工作中也是使用Spring MVC、Mybatis及Maven整合，出於好奇，自己也搭建了一個Spring+Spring MVC+Mybatis+Maven的多模組框架，先介紹一下我的工程結構 bug.root：根模