这篇很长!
maven多模块开发是基于网上一篇文章介绍学习而来的,为了防止他的链接以后挂了,所以现在复制其内容过来,原文地址:
http://blog.csdn.net/williamhappy/article/details/54376855
下面内容我会在原文基础上进行修改
一. 项目工程目录
首先展示一下,最终整个项目的工程目录:
简单介绍一下目录结构:
common-parent
为所有项目的父项目,主要用来管理所有项目使用的jar包及其版本。
common-utils
为公共的工具类项目,继承父项目,它会被打成jar包供其它项目使用。
taotao-manager
为我们自己的项目,继承与我们的父项目。
taotao-manager-pojo
为我们自己项目的一个子模块,依赖与taotao-manager,打成jar包
taotao-manager-mapper
为我们自己项目的一个子模块,依赖与taotao-manager-pojo,打成jar包
taotao-manager-service
为我们自己项目的一个子模块,依赖与taotao-manager-mapper,打成jar包
taotao-manager-web
为我们自己项目的一个子模块,依赖与taotao-manager-service,打成war包
二. 创建父工程
下面为具体操作:
1. 首先打开IntelliJ IDEA,按下面步骤来:
或者第一次打开IDEA,
2. 来到创建目录,选择Empty project,next
3. 来到New Project页面,填写project name,选择Project location,点Finish
等待IDEA加载完成,进行下一步
4. 选择File–>New–>Module,进入New Module页面:
5. 在New Module页面,按如下步骤操作:
对于我自己来说,我只在创建web模块的时候使用了web模板,其他均未使用模板,其它模板暂未尝试
6. 填写组织名称和项目名称,以及版本号
7. 配置本地maven目录及maven仓库配置文件
8. 创建父工程最后一步,给Module取名,及选择工作目录,选择完成
等待生成pom文件,注意修改打包方式为pom,修改pom文件如下:(由于pom文件较长,只给出部分,获取所有,请关注github)
<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>cn.william</groupId>
<artifactId>common-parent</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>pom</packaging><!--修改打包方式-->
<name>common-parent</name>
<url>http://maven.apache.org</url>
<!--集中定义依赖版本号-->
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<junit.version>4.12</junit.version>
...(省略)
</properties>
<dependencyManagement>
<dependencies>
<!-- 时间操作组件 -->
<dependency>
<groupId>joda-time</groupId>
<artifactId>joda-time</artifactId>
<version>${joda-time.version}</version>
</dependency>
...(省略)
</dependencyManagement>
<build>
<finalName>${project.artifactId}</finalName>
<plugins>
<!-- 资源文件拷贝插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-resources-plugin</artifactId>
<version>2.7</version>
<configuration>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
<!-- java编译插件 -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.5.1</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>UTF-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
</project>
三. 创建公共工具类
首先,公共工具类是继承自父项目common-parent的。
需要注意的一点是一点,为了项目看起来为分模块的形式(类似在eclipse中开发),在创建common-utils中有一步需要注意:
下一步特别注意,这一步会影响目录结构,
同样注意项目的打包方式为jar,和父项目有所不同。
<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">
<parent>
<artifactId>common-parent</artifactId>
<groupId>cn.william</groupId>
<version>1.0-SNAPSHOT</version>
<relativePath>../common-parent/pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>common-utils</artifactId>
<packaging>jar</packaging><!-- 打成jar包 -->
<name>common-utils</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<!-- jar包的依赖 -->
<dependencies>
<!-- 时间操作组件 -->
<dependency>
<groupId>joda-time</groupId>
<artifactId>joda-time</artifactId>
</dependency>
...(省略)
</dependencies>
</project>
三. 创建开发项目
创建开发项目taotao-manager,其创建步骤同上,同样是继承common-parent,同样修改其pom文件,详细如下:
<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">
<parent>
<artifactId>common-parent</artifactId>
<groupId>cn.william</groupId>
<version>1.0-SNAPSHOT</version>
<relativePath>../common-parent/pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>taotao-manager</artifactId>
<packaging>pom</packaging>
<name>taotao-manager</name>
<url>http://maven.apache.org</url>
<modules>
<module>taotao-manager-pojo</module>
<module>taotao-manager-mapper</module>
<module>taotao-manager-service</module>
<module>taotao-manager-web</module>
</modules>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<!-- 依赖管理 -->
<dependencies>
<dependency>
<groupId>cn.william</groupId>
<artifactId>common-utils</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
</dependencies>
<build>
<!-- 配置插件 -->
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<configuration>
<port>8080</port>
<path>/</path>
</configuration>
</plugin>
</plugins>
</build>
</project>
四. 创建开发项目子模块
创建taotao-manager-pojo,mapper,service,web等子模块,详细如下:
-
右键点击taotao-manager,选择New,Module,
这一步注意,与创建common-utils时不同,是将其子模块添加到taotao-manager目录下的:
maven的相关配置,保持默认:
注意子模块所在目录就好:
-
创建taotao-manager下其它子模块
上面说的时创建taotao-manager-pojo子模块,另外三个子模块的创建方式与其类似,有一点不同时,在创建taotao-manager-web子模块时,maven项目的类型选择如下:
修改子模块的pom文件
子模块pojo,mapper,service的打包方式全为jar,只有web子模块打包为war包。
pojo子模块,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">
<parent>
<artifactId>taotao-manager</artifactId>
<groupId>cn.william</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>taotao-manager-pojo</artifactId>
<packaging>jar</packaging>
<name>taotao-manager-pojo</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
</project>
mapper子模块依赖与pojo子模块,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">
<parent>
<artifactId>taotao-manager</artifactId>
<groupId>cn.william</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>taotao-manager-mapper</artifactId>
<packaging>jar</packaging>
<name>taotao-manager-mapper</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<!-- 依赖与pojo子模块 -->
<dependency>
<groupId>cn.william</groupId>
<artifactId>taotao-manager-pojo</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<!-- Mybatis -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
</dependency>
<dependency>
<groupId>com.github.miemiedev</groupId>
<artifactId>mybatis-paginator</artifactId>
</dependency>
<dependency>
<groupId>com.github.pagehelper</groupId>
<artifactId>pagehelper</artifactId>
</dependency>
<!-- MySql -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
</dependency>
<!-- 连接池 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
</dependency>
</dependencies>
</project>
service子模块依赖与mapper子模块,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">
<parent>
<artifactId>taotao-manager</artifactId>
<groupId>cn.william</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>taotao-manager-service</artifactId>
<packaging>jar</packaging>
<name>taotao-manager-service</name>
<url>http://maven.apache.org</url>
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<!-- 依赖与mapper子模块 -->
<dependency>
<groupId>cn.william</groupId>
<artifactId>taotao-manager-mapper</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
<!-- Spring -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-beans</artifactId>
</dependency>
...(省略)
</dependencies>
</project>
web子模块依赖与service子模块,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/maven-v4_0_0.xsd">
<parent>
<artifactId>taotao-manager</artifactId>
<groupId>cn.william</groupId>
<version>1.0-SNAPSHOT</version>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>taotao-manager-web</artifactId>
<packaging>war</packaging><!--打成war包-->
<name>taotao-manager-web Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<!-- 依赖于service -->
<dependency>
<groupId>cn.william</groupId>
<artifactId>taotao-manager-service</artifactId>
<version>1.0-SNAPSHOT</version>
</dependency>
...(省略)
</dependencies>
<build>
<finalName>taotao-manager-web</finalName>
</build>
</project>
五. 运行项目
-
创建index.jsp
至此,项目创建已经完成,我们可以在taotao-manager-web的webapp目录下创建index.jsp,详情如下:
使用tomcat插件
我们使用maven的tomcat插件来运行项目,在此之前,确保在taotao-manager的pom文件中配置了tomcat的插件:
...(省略)
<build>
<!-- 配置插件 -->
<plugins>
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<configuration>
<port>8080</port>
<path>/</path>
</configuration>
</plugin>
</plugins>
</build>
...(省略)
- 配置Maven Tomcat Plugin运行web项目
(1) 添加新配置
注意这里运行项目的目录是manager目录, tomcat命令是clean tomcat7:run 必须要在配置了tomcat插件后才能使用
(2) 点击运行,或者点击旁边的debug
(3) 出项错误
出现错误,可能是common-parent和common-utils没有安装到本地仓库,出现的错误是找不到common-utils的jar包,那就需要我们安装一下。
等待将jar包安装到本地仓库,稍微有点慢可能,耐心等。。。
安装完成之后,再次运行,出现下面的信息,证明运行成功:
通过浏览器访问:
至此,我们的项目环境搭建成功,接下来就是实际的项目开发了。
这只是完成了第一步,接下来我们开始搭建ssm框架
ssm框架搭建pom源码过多,我只在此讲几个我遇到的问题
1.common依赖的是脱离于业务框架的三方jar包,controller在return 对象时如果报了
HTTP Status 500 - Request processing failed; nested exception is java.lang.IllegalArgumentException: No converter found for return value of type: class cn.e3mall.pojo.TbItem问题时:
注意将三方依赖导入
而且!注意将common的jar包重新安装到本地仓库!
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
</dependency>
2.mapper层配置的是包扫描,如果遇到引用报红,没关系!,大胆用就是了
但是,使用完之后可能会报一个错误,就是
HTTP Status 500 - Request processing failed; nested exception is org.apache.ibatis.binding.BindingException: Invalid bound statement (not found): cn.e3mall.mapper.TbItemMapper.selectByPrimaryKey
这是因为在打包的时候,maven会忽略掉mapper.xml文件,只打包接口,导致找不到映射,解决方法是在dao层的pom里添加
<!--如果不添加此节点mybatis的mapper.xml文件都会被漏掉。 -->
<build>
<resources>
<resource>
<directory>src/main/java</directory>
<includes>
<include>**/*.properties</include>
<include>**/*.xml</include>
</includes>
<filtering>false</filtering>
</resource>
</resources>
</build>
然后重新编译一下即可
3.找不到DataSource的bean
由于我dao层和trans层是两个spring配置文件的
导致,我之前在配置的时候,事物层引用不到dao层注入的DataSource,我当时用了个import引进来
但是后来莫名其妙又好了的,不知道什么原因
如果有时间,我会慢慢写一下ssm的导入步骤
最后,展示一下成功的例子,嘿嘿