Maven项目环境搭建（Maven + Spring + IBatis）步骤

标签：

准备步骤

?1. 安装Maven，下载解压即可。

?2. 修改maven_home/conf/settings.xml中的<localRepository>D:/MavenRepo</localRepository>指定本地仓库位置。

?3. 修改settings.xml中的?<mirrors></mirrors>标签，添加常用的maven远程仓库地址。这些仓库地址就是用来下载jar包的时候用的。比如：

<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命令：

由于使用命令太麻烦，我直接使用Eclipse的maven插件来创建和运行maven项目。

4. 在Eclipse中集成Maven。

• 先安装Eclipse的maven插件
  

• 在Eclipse中通过WindowàPreferencesàMaven菜单下指定安装的maven：

并指定自己的配置文件settings.xml：

创建Maven项目

5. NewàMaven ProjectàNext，选择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>标签上方添加该项目用到的属性定义：

<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相关 -->
    <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包列表，选择某一个，右下方会有该包的GAV属性。直接将这一段拷贝到maven项目pom.xml文件中即可。

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>/m/*</url-pattern>
</servlet-mapping>

13.  spring.xml

<context:component-scan base-package="com.xxx" />
 
<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/xxx/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 -->
<!—有了这个类，定义的DAO接口就不需要实现了-->
<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
    <property name="basePackage" value="com.xxx.dao" />
    <property name="sqlSessionTemplateBeanName" value="sqlSession" />
</bean>

14. log4j.properties和jdbc.properties，略。

15. mybatis-config.xml文件，这里面指定了哪些xml文件可以作为DAO接口的映射文件：

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

16. UserMap.xml文件定义了对于User对象的操作的sql语句：

<mapper namespace="com.xxx.dao.TestDao">
    <resultMap id="UserResultMap" type="com.xxx.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的声明：略。

构建和运行

18. 编写好以后，在项目上右键àRun AsàMaven Build…准备构建这个maven项目。

19. 在BaseDirectory中指定需要构建的项目，并在Goals框中指定构建的目标。并可以选择一些附加的属性（绿色框中），如图：

20. 如果构建成功，则会出现类似于下面的输出：

21.  当构建成功后，可以像普通的Web Project一样来运行这个项目。这里将其添加到Tomcat中，并启动之。

22. 先看看数据库的内容：

23. 在浏览器中访问指定的接口，查看结果：

Maven项目环境搭建（Maven + Spring + IBatis）步骤

标签：

原文地址：http://my.oschina.net/itblog/blog/531078