普通web项目转为maven项目整理

最新推荐文章于 2025-07-05 13:30:49 发布

原创最新推荐文章于 2025-07-05 13:30:49 发布 · 1.6w 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#maven #web #java #pom.xml

java开发同时被 2 个专栏收录

15 篇文章

订阅专栏

基础知识

3 篇文章

订阅专栏

本文介绍如何将一个普通的Web项目转换成Maven项目，包括Maven项目的目录结构、pom.xml配置详解，以及在转换过程中遇到的问题及解决办法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

现在越来越多的公司和团队开始使用maven来管理项目。对个人而言，之前一直不太喜欢maven结构的项目，需要配置pom.xml，每次打开IDE之后都需要加载maven，电脑配置低的话就卡半天，balabala。后来用得多了也就习惯了，就跟用Myeclipse用习惯了，再用IDEA时一样，估计是大多数人的通病，习惯于一个模式，没有外力就不想再更换（还不是因为懒，哈哈）。

好了，言归正传，之前的时候接到个任务，需要把一个普通的web项目改成maven的，花了点时间就研究了研究。

1.maven结构

maven结构的web项目目录如下：

根据maven项目“约定优于配置”的原则，其中./src/main/用于存放源代码，./src/test用于存放单元测试代码，./target用于存放编译、打包后的输出文件。按理说src/main/作为Source Folder就可以了，不过为了方便开发，通常会在main下面加上java和resources两个目录，其中java放置java代码，而resources文件夹存放相关配置文件）。

2.maven的配置都在pom.xml里面

2.1.pom.xml在改的时候我主要用到三个配置<dependencies>、<profiles>、<build>。

2.1.1.<dependencies>是项目引入插件所需要的额外依赖，主要是依赖的jar包。

<dependency>
			<!-- 项目或者组织的唯一标志，并且配置时生成路径也是由此生成 -->
			<groupId>junit</groupId>
			<!-- 项目的通用名称 -->
			<artifactId>junit</artifactId>
			<!-- 项目的版本 -->
			<version>4.11</version>
			<!-- 表示开发的时候引入，发布的时候不会加载此包，其他的还有compile(缺省值)、provided、runtime、system -->
			<scope>test</scope>
		</dependency>

2.1.2.因为改造前的项目的jar好多是框架私有包，在maven仓库没有，这时就需要将jar包install到本地maven仓库，

mvn install:intall-file -Dfile=myprivatejar.jar -DgroupId=com.cn.wddqz -DartifactId=non-maven-proj -Dversion=1 -Dpackaging=jar

2.1.3.dependency的version里还可以用${junit.version}表示，然后再<properties>中加入<junit.version>4.11</junit.version>

2.2.profiles：在列的项目构建profile，用来激活不同的profile

因为项目有多个测试环境，所以根据不同的环境要有若干套配置文件，次时就需要多个profile，用来放置不同的配置文件。此时maven结构中的resouces就需
要有若干个文件夹了ceshi1_resouces、ceshi2_resouces、ceshi3_resouces等.
配置文件如下：

               <profile>
			<id>ceshi1</id>
			<properties>
				<package.environment>ceshi1_resouces</package.environment>
			</properties>
			<activation>
				<activeByDefault>true</activeByDefault> <!-- 设置默认打包那个环境下的配置文件 -->
			</activation>
			<build>
				<plugins>
					<plugin>
						<groupId>org.apache.maven.plugins</groupId>
						<artifactId>maven-war-plugin</artifactId>
						<version>2.4</version>
						<configuration>
							<!-- 包含空文件夹，指的是maven编译打包的时候会将空文件夹也编译打包进去，该参数2.4版本后才能使用 -->
							<includeEmptyDirectories>true</includeEmptyDirectories>
						</configuration>
					</plugin>
				</plugins>
			</build>
		</profile>

注：进行maven编译的时候需要加上" -P ceshi1 "

2.3.build构建项目需要的配置信息：

示例如下：

<build>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<!-- maven-compiler-plugin用来指定JDK版本和编码 -->
				<artifactId>maven-compiler-plugin</artifactId>
				<version>2.4</version>
				<configuration>
					<!-- 编译器的版本设定为1.6,应该指的是jdk，默认是用的1.3，版本太老 -->
					<source>1.6</source><!-- 源代码使用的开发版本 -->
					<target>1.6</target><!-- 需要生成的目标class文件的编译版本 -->
					 <!-- 一般而言，target与source是保持一致的，但是，有时候为了让程序能在其他版本的jdk中运行(对于低版本目标jdk，源代码中需要没有使用低版本jdk中不支持的语法)，会存在target不同于source的情况 -->
					<encoding>UTF-8</encoding>
				</configuration>
			</plugin>
			<plugin>
				<!-- maven-war-plugin进行打包 -->
				<artifactId>maven-war-plugin</artifactId>
				<version>2.4</version>
				<configuration>
					<includeEmptyDirectories>true</includeEmptyDirectories>
					<!-- war包的名字 -->
					<warName>MavenDemo</warName>
					<webResources>
						<resource>
							<!-- package.environment就是profile中的配置文件路径 -->
							<directory>${project.basedir}/src/main/${package.environment}</directory>
							<targetPath>WEB-INF/classes</targetPath>
							<filtering>true</filtering>
						</resource>
					</webResources>
				</configuration>
			</plugin>
		</plugins>
	</build>