Maven項目環境搭建（Maven + Spring + IBatis）步驟

時間  2019-11-06
標籤 maven 項目 環境 搭建 spring ibatis 步驟 欄目 Maven 简体版
原文   原文鏈接

準備步驟java

‍1. 安裝Maven，下載解壓便可。官網下載mysql

‍2. 修改maven_home/conf/settings.xml中的<localRepository>D:/MavenRepo</localRepository>指定本地倉庫位置，這個位置是本地計算機上用來存放全部jar包的地方。web

‍3. 修改settings.xml中的‍<mirrors></mirrors>標籤，添加經常使用的maven遠程倉庫地址。這些倉庫地址就是用來下載jar包的時候用的。因爲中央倉庫的訪問速度較慢（或者由於某些緣由致使你根本不能訪問），所以通常須要設置其餘的倉庫地址以提升訪問速度。好比：spring

<mirror>  
    <id>oschina</id>  
    <mirrorOf>central</mirrorOf>  
    <url>http://maven.oschina.net/content/groups/public/</url>  
</mirror> 
<mirror>  
    <id>repo2</id>  
    <mirrorOf>central</mirrorOf>  
    <url>http://repo2.maven.org/maven2/</url>  
</mirror>  
<mirror>  
    <id>net-cn</id>  
    <mirrorOf>central</mirrorOf>  
    <url>http://maven.net.cn/content/groups/public/</url>   
</mirror>

若是使用mvn命令行來建立、構建和運行maven項目，則須要配置環境變量，路徑指向maven_home/bin便可。配置好後，能夠查看mvn命令：
sql

因爲使用命令太麻煩並且難記，我直接使用Eclipse的maven插件來建立和運行maven項目。數據庫

4. 在Eclipse中集成Maven。
apache

  • 先安裝Eclipse的maven插件（具體過程網上一大堆，好比：安裝Eclipse Maven插件的幾種方法）
    編程

  • 在Eclipse中經過Windows->Preferences->Maven菜單下指定安裝的maven：api

並指定本身的配置文件settings.xml：瀏覽器

建立Maven項目

5. New->Maven Project->Next，選擇webapp類型的項目結構。因爲不一樣類型的項目有不一樣的項目結構，所以Maven自帶了不少套項目骨架（archetype），這裏咱們選擇webapp類型的骨架便可：


6. 輸入Group ID, Artifact ID, Version和Package, Finish.

7. 建立好後如圖，默認狀況下已經將junit3.8導入到項目中：

8. 先把默認使用的JRE環境替換成當前Eclipse中使用的JRE環境。

9. 每一個Maven項目都有一個pom.xml文件，這個文件描述了這個項目的依賴關係，以及自身的一些屬性，包括properties的定義，以及Maven Modules的版本聲明，父模塊以及子模塊的名字等。同時這個文件還包括了該項目在構建過程當中作的事情的定義。如今打開這個pom.xml文件，先在<dependencies>標籤上方添加該項目用到的屬性定義（爲了集中管理spring的版本，所以將其定義爲屬性，在依賴spring的jar包時直接使用這個屬性便可）：

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <spring.version>4.0.0.RELEASE</spring.version>
</properties>

並在<dependencies></dependencies>標籤中添加以下依賴關係，其餘的內容無需修改：

<dependencies>
    <!-- MyBatis相關 -->
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis</artifactId>
        <version>3.2.0</version>
    </dependency>
    <dependency>
        <groupId>org.mybatis</groupId>
        <artifactId>mybatis-spring</artifactId>
        <version>1.2.0</version>
    </dependency>
    
    <!-- MySQL相關 -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>5.1.36</version>
    </dependency>
    <dependency>
        <groupId>c3p0</groupId>
        <artifactId>c3p0</artifactId>
        <version>0.9.1.2</version>
    </dependency>
 
    <!-- Spring相關，這裏的spring.version就是上方聲明的版本號，這樣引用更方便修改和維護 -->
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-test</artifactId>
        <version>${spring.version}</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-ibatis</artifactId>
        <version>2.0.8</version>
    </dependency>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-jdbc</artifactId>
        <version>${spring.version}</version>
    </dependency>
 
    <!-- 測試相關 -->
    <dependency>
        <groupId>junit</groupId>
        <artifactId>junit</artifactId>
        <version>4.10</version>
        <scope>test</scope>
    </dependency>
 
    <!-- Servlet相關 -->
    <dependency>
        <groupId>tomcat</groupId>
        <artifactId>servlet-api</artifactId>
        <version>5.5.23</version>
    </dependency>
 
    <!-- Log相關 -->
    <dependency>
        <groupId>log4j</groupId>
        <artifactId>log4j</artifactId>
        <version>1.2.17</version>
    </dependency>
</dependencies>

10. 在Maven的世界中，每個jar包均可以經過Group ID, Artifact ID, Version這三個字段（通常簡寫爲GAV）來惟必定位，所以若是須要使用哪一個jar包，只須要提供這三個字段便可。

若是不知道版本號或者GroupID，能夠去公共的Maven倉庫搜索關鍵字。好比搜索：log4j，便可出現倉庫中已經收錄的關於log4j的jar包：


如圖，我在oschina提供的maven庫中搜索log4j，出現了一些可用的jar包列表（這裏須要注意：有些jar包名稱看上去很相近，所以須要注意區別，選擇正確的jar包）。選擇某一個，右下方會有該包的GAV屬性。直接將這一段拷貝到maven項目pom.xml文件中便可。

還有一個很好用的maven倉庫地址，推薦給你們：http://mvnrepository.com/

11. Jar包準備完畢後，開始項目接口的定義了。修改後的結構如圖：

12. web.xml僅僅定義了基本的DispatchServlet，用於轉發請求：

<servlet>
    <servlet-name>spring</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:spring.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>spring</servlet-name>
    <url-pattern>/*</url-pattern>
</servlet-mapping>

13.  spring.xml（xml頭有點冗餘，若是以爲用不到，能夠刪除相應的xmlns和schemaLocation聲明）

<?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">

    <context:component-scan base-package="com.abc" />

    <!-- 屬性注入器，用於讀取項目配置文件中的屬性 -->
    <bean id="PropertiesConfigurer"
        class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">
        <property name="locations">
            <list>
                <value>classpath:log4j.properties</value>
                <value>classpath:jdbc.properties</value>
            </list>
        </property>
    </bean>

    <!-- 數據源，不須要解釋 -->
    <bean id="dataSource" class="com.mchange.v2.c3p0.ComboPooledDataSource" destroy-method="close">
        <property name="driverClass" value="${jdbc.driverClassName}" />
        <property name="jdbcUrl" value="${jdbc.url}" />
        <property name="user" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />
    </bean>
    
    <!-- SqlSessionFactory -->
    <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
        <property name="dataSource" ref="dataSource" />
        <!-- <property name="mapperLocations"
            value="classpath*:com/abc/dao/*.xml" /> -->
        <property name="configLocation" value="classpath:mybatis-config.xml" />
    </bean>
    
    <!-- Mybatis sql session -->
    <bean id="sqlSession" class="org.mybatis.spring.SqlSessionTemplate">
        <constructor-arg index="0" ref="sqlSessionFactory" />
    </bean>
    
    <!-- Mybatis mapper scanner, scans for java mapper -->
    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
        <property name="basePackage" value="com.abc.dao" />
        <property name="sqlSessionTemplateBeanName" value="sqlSession" />
    </bean>

</beans>

14. log4j.properties，用於定義Log4j的日誌輸出內容及格式，我這裏就不湊字數了。

jdbc.properties，上方的配置中引用到的關於數據庫的配置，請在這個文件中配置。

jdbc.driverClassName=com.mysql.jdbc.Driver
jdbc.url=jdbc\:mysql\://192.168.12.1\:3306/abc?useUnicode\=true&amp;characterEncoding\=UTF-8
jdbc.username=abc
jdbc.password=abc123_

15. mybatis-config.xml文件，這裏面指定了哪些xml文件能夠做爲DAO接口的映射文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE configuration PUBLIC  
    "-//mybatis.org//DTD Config 3.0//EN"  
    "http://mybatis.org/dtd/mybatis-3-config.dtd">  

<configuration>  
    <mappers>  
        <mapper resource="com/abc/entity/UserMap.xml"/>  
    </mappers>
</configuration>

16. UserMap.xml文件定義了對於User對象的操做的sql語句：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"   
" 

<mapper namespace="com.abc.dao.TestDao">
    <resultMap id="UserResultMap" type="com.abc.entity.User">
        <id column="id" jdbcType="INTEGER" property="id" />
        <result column="userName" jdbcType="VARCHAR" property="name" />
        <result column="userAge" jdbcType="INTEGER" property="age" />
        <result column="userAddress" jdbcType="VARCHAR" property="address" />
    </resultMap>
 
    <select id="testQuery" resultMap="UserResultMap">
        SELECT * FROM user
    </select>
</mapper>

17. Controller, Service和DAO的聲明，都是很標準很簡單的Controller調用Service，Service再調用DAO接口的過程。

TestDao（完成數據讀寫）:

package com.abc.dao;

import java.util.List;
import com.abc.entity.User;

public interface TestDao {
    public List<User> testQuery() throws Exception;
}

TestService（接口編程，在面向多實現的時候很是有用）:

package com.abc.service;

public interface TestService {
    public String testQuery() throws Exception;
}

TestServiceImpl（完成主要的業務邏輯）:

package com.abc.service.impl;

import java.util.List;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.abc.dao.TestDao;
import com.abc.entity.User;
import com.abc.service.TestService;

@Service
public class TestServiceImpl implements TestService {
    
    @Autowired
    private TestDao dao;
    
    public String testQuery() throws Exception {
        List<User> users = dao.testQuery();
        String res = "";
        if (users != null && users.size() > 0) {
            for (User user : users) {
                res += user.toString() + "|";
            }
        } else {
            res = "Not found.";
        }
        return res;
    }
}

TestController（完成請求轉發，響應封裝）:

package com.abc.controller;

import java.io.IOException;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.log4j.Logger;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

import com.abc.service.TestService;

@Controller
@RequestMapping("/testController")
public class TestController {
    
    public static final Logger LOGGER = Logger.getLogger(TestController.class);
    
    @Autowired
    private TestService testService;
    
    @RequestMapping("/test")
    public void test(HttpServletRequest request, HttpServletResponse response) {
        try {
            String result = testService.testQuery();
            response.getWriter().print(result);
        } catch (IOException e) {
            e.printStackTrace();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

代碼部分到此就結束了。

構建和運行

18. 編寫好之後，在項目上右鍵->Run As->Maven Build…準備構建這個maven項目。


19. 在BaseDirectory中指定須要構建的項目（點擊圖中的Brose Workspace或Browse File System按鈕能夠選擇），並在Goals框中指定構建的目標（Maven有本身的構建的階段，有的地方又叫生命週期，若是不清楚的同窗，能夠參看Maven生命週期詳解）。並能夠選擇一些附加的屬性（綠色框中），如圖：

20. 若是構建成功，則會出現相似於下面的輸出：

21.  當構建成功後，能夠像普通的Web Project同樣來運行這個項目。這裏將其添加到Tomcat中，並啓動之。

22. 先看看數據庫的內容：


23. 在瀏覽器中訪問指定的接口，查看結果（在個人實現類TestServiceImpl中，僅僅是打印了查詢到的結果）：


附：例子下載：AbcDemo.zip

連接: http://pan.baidu.com/s/1pJ3pSBT 密碼: 3gpt

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程