如何使用IntelliJ IDEA将普通项目转换为Maven项目

女爷i 2024-05-25 17:36 221阅读 0赞

普通项目与Maven项目差异

直接先上图，使用IDEA创建的普通JAVA项目结构如下：
在这里插入图片描述
可以看到普通java项目除了一个src及配置信息外，空空如也。通过IDEA工具创建Maven项目

在这里插入图片描述
创建的项目结构如下：

在这里插入图片描述
多了一个pom.xml文件，并且src文件夹中自动创建了main/java、main/resources等文件夹，方便管理。很明显使用maven来管理项目更加方便管理。同样各种开发环境都有各种的包管理工具，如PHP中会使用Composer，nodejs使用npm，android开发常用Gradle方式来进行包依赖管理。

如何在IDEA中转换普通项目

由于之前项目是普通项目，所以需要将其转换为Maven项目，在IDEA实现转换很简单，主要有以下方法：

添加Maven支持：

右键选项 “Add Framework Support”，如下：

在这里插入图片描述
然后设置maven相关信息：

在这里插入图片描述
最后编辑下pom.xml文件：

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0"
  3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.     <modelVersion>4.0.0</modelVersion>
  7.     <groupId>jstudy.mybatis</groupId>
  8.     <artifactId>java-mybatis-tiny</artifactId>
  9.     <version>1.0-SNAPSHOT</version>
  11.     <properties>
  12.         <maven.compiler.source>14</maven.compiler.source>
  13.         <maven.compiler.target>14</maven.compiler.target>
  14.     </properties>
  16. </project>

至此，转换完毕。

添加pom.xml文件转换

在项目根目录下添加pom.xml，并将上面内容粘贴，IDE工具将会自动识别maven项目，然后点击同步下项目：

在这里插入图片描述
转换完毕。

pom.xml文件说明

由于使用maven管理项目，顺便将pom.xml文件配置详解记录一下：

  1. <!-- project 根描述符 -->
  2. <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
  3.                       http://maven.apache.org/xsd/maven-4.0.0.xsd">
  4.     <!-- 指定maven版本，一般为4.0.0 -->
  5.     <modelVersion>4.0.0</modelVersion>
  8.     <!-- 基本配置 -->
  9.     <!-- 继承功能，可以指定父POM -->
  10.     <parent>
  11.         <groupId>org.springframework.boot</groupId>
  12.         <artifactId>spring-boot-starter-parent</artifactId>
  13.         <version>2.7.4</version>
  14.         <!-- 指定父项目搜索路径，一般远程项目或者仓库无需配置 -->
  15.         <relativePath /> <!-- lookup parent from repository -->
  16.     </parent>
  17.     <!-- 一般jar包为: groupId:artifactId:version -->
  18.     <!-- 团体、组织标书符，项目的命名空间 -->
  19.     <groupId>org.example</groupId>
  20.     <!-- 项目唯一标识符，不能含有点号(.) -->
  21.     <artifactId>learn-pom</artifactId>
  22.     <!-- 版本号，可以实用特殊字符串 SNAPSHOT、LATEST、RELEASE -->
  23.     <!-- SNAPSHOT: 用于开发过程中，表示不稳定版本 -->
  24.     <!-- LATEST: 表示特定构建的最新发布版本 -->
  25.     <!-- RELEASE: 最有一个稳定的发布版本 -->
  26.     <version>1.0-SNAPSHOT</version>
  27.     <!-- 项目打包类型，默认jar，常见类型：pom, jar, maven-plugin, ejb, war, ear, rar, par -->
  28.     <packaging>jar</packaging>
  29.     <!-- 项目依赖 -->
  30.     <dependencies>
  31.         <!-- 依赖节点 -->
  32.         <dependency>
  33.             <!-- 与方面解释一样 -->
  34.             <groupId>io.springfox</groupId>
  35.             <artifactId>springfox-boot-starter</artifactId>
  36.             <version>3.0.0</version>
  37.             <!-- 对应使用的打包类型，默认为jar -->
  38.             <type>jar</type>
  39.             <!-- 指任务的类路径及依赖关系传递性，包括 compile（默认）、provided、runtime、test、system -->
  40.             <!-- compile: 默认范围，在所有classpath级依赖项目都可使用 -->
  41.             <!-- provided: 编译和测试可用，但不可传递 -->
  42.             <!-- runtime: 字面意，只在运行和测试时有效 -->
  43.             <!-- test: 测试和执行阶段有效，不是传递的 -->
  44.             <!-- system: 除特殊指定，始终可用，与systemPath结合使用 -->
  45.             <scope>test</scope>
  46.             <!-- scope为system时有效 -->
  47.             <systemPath></systemPath>
  48.             <!-- 可选项，无需此依赖运行 -->
  49.             <optional>true</optional>
  50.             <!-- 排除一个或多个元素 -->
  51.             <exclusions>
  52.                 <exclusion>
  53.                     <groupId>io.springfox</groupId>
  54.                     <artifactId>springfox-boot-teseter</artifactId>
  55.                 </exclusion>
  56.             </exclusions>
  57.         </dependency>
  58.     </dependencies>
  59.     <!-- 多项目（子父项目）中方便依赖管理，保证版本一致，父项目中使用，声明依赖，但不引用，子项目中可以不加版本，使用父项目中配置 -->
  60.     <dependencyManagement></dependencyManagement>
  61.     <!-- 声明变量，如果后面用到可使用${变量名}来替代 -->
  62.     <properties>
  63.         <sf.version>2.0.0</sf.version>
  64.     </properties>
  65.     <!-- 多模块管理 -->
  66.     <modules>
  67.         <module>project-1</module>
  68.         <module>project-2</module>
  69.         <module>project-3</module>
  70.     </modules>
  72.     <!-- 构建设置 -->
  73.     <!-- 包括project build、profile build -->
  74.     <build>
  75.         <!-- 执行目标 -->
  76.         <defaultGoal>install</defaultGoal>
  77.         <!-- 构建目标目录 -->
  78.         <directory>${basedir}/target</directory>
  79.         <!-- 各种默认路径及默认值 -->
  80.         <sourceDirectory>${basedir}/src/main/java</sourceDirectory>
  81.         <scriptSourceDirectory>${basedir}/src/main/scripts</scriptSourceDirectory>
  82.         <outputDirectory>${basedir}/target/classes</outputDirectory>
  83.         <testOutputDirectory>${basedir}/target/test-classes</testOutputDirectory>
  84.         <testSourceDirectory>${basedir}/src/test/java</testSourceDirectory>
  85.         <!-- 项目最终构建名称 -->
  86.         <finalName>myproject-SNAPSHOT</finalName>
  87.         <!-- 过滤资源信息 -->
  88.         <filters>
  89.             <filter>myproject.properties</filter>
  90.         </filters>
  91.         <!-- 扩展插件 -->
  92.         <extensions>
  93.             <extension>
  94.                 <groupId>mysql</groupId>
  95.                 <artifactId>mysql-connector-java</artifactId>
  96.                 <version>8.0.30</version>
  97.             </extension>
  98.         </extensions>
  99.         <!-- 使用插件 -->
  100.         <plugins>
  101.             <plugin>
  102.                 <groupId>org.springframework.boot</groupId>
  103.                 <artifactId>spring-boot-maven-plugin</artifactId>
  104.                 <!-- 是否加载插件扩展名 -->
  105.                 <extensions>false</extensions>
  106.                 <!-- 是否可继承 -->
  107.                 <inherited>true</inherited>
  108.                 <!-- 插件本身需要的依赖 -->
  109.                 <dependencies></dependencies>
  110.                 <!-- 插件配置 -->
  111.                 <configuration>
  112.                     <excludes>
  113.                         <exclude>
  114.                             <groupId>org.projectlombok</groupId>
  115.                             <artifactId>lombok</artifactId>
  116.                         </exclude>
  117.                     </excludes>
  118.                 </configuration>
  119.                 <!-- 指定插件不同的目标 -->
  120.                 <executions>
  121.                     <execution>
  122.                         <!-- 目标标识 -->
  123.                         <id>tester</id>
  124.                         <!-- 目标列表 -->
  125.                         <goals>
  126.                             <goal>run</goal>
  127.                         </goals>
  128.                         <!-- 是否继承 -->
  129.                         <inherited>false</inherited>
  130.                         <!-- 特定配置 -->
  131.                         <configuration></configuration>
  132.                     </execution>
  133.                 </executions>
  134.             </plugin>
  135.         </plugins>
  136.         <!-- 与dependencyManagement类似，为了统一版本 -->
  137.         <pluginManagement></pluginManagement>
  138.     </build>
  139.     <!-- 针对site生成报告插件，与build内插件类似 -->
  140.     <reporting>
  141.         <plugins></plugins>
  142.     </reporting>
  144.     <!-- 项目信息，一般不用填写 -->
  145.     <!-- 项目名称 -->
  146.     <name>learn pom</name>
  147.     <!-- 描述 -->
  148.     <description>just learn pom project</description>
  149.     <!-- 开始年份 -->
  150.     <inceptionYear>2020</inceptionYear>
  151.     <!-- 项目地址 -->
  152.     <url>https://github.com/</url>
  153.     <!-- 使用协议 -->
  154.     <licenses>
  155.         <license>
  156.             <!-- 使用协议 -->
  157.             <name>My License</name>
  158.             <!-- 分发方式 -->
  159.             <distribution>github</distribution>
  160.             <!-- 协议地址 -->
  161.             <url>https://github.com/</url>
  162.             <!-- 注释 -->
  163.             <comments>Just my License</comments>
  164.         </license>
  165.     </licenses>
  166.     <!-- 组织信息 -->
  167.     <organization>
  168.         <!-- 组织名称 -->
  169.         <name>My Cor</name>
  170.         <!-- 组织链接 -->
  171.         <url>https://github.com/</url>
  172.     </organization>
  173.     <!-- 开发者列表 -->
  174.     <developers>
  175.         <developer>
  176.             <id>master</id>
  177.             <name>hunkxia</name>
  178.             <email>hunk.xia@gmail.com</email>
  179.             <organization>My Cor</organization>
  180.             <organizationUrl>https://github.com/</organizationUrl>
  181.             <!-- 开发者角色列表 -->
  182.             <roles>
  183.                 <role>master</role>
  184.             </roles>
  185.             <!-- 开发者其它信息 -->
  186.             <properties></properties>
  187.         </developer>
  188.     </developers>
  189.     <!-- 贡献者列表 -->
  190.     <contributors></contributors>
  192.     <!-- 环境设置 -->
  193.     <!-- 缺陷提交讨论地址 -->
  194.     <issueManagement>
  195.         <!-- 缺陷跟踪系统 -->
  196.         <system>iss</system>
  197.         <url>https://github.com/</url>
  198.     </issueManagement>
  199.     <!-- 构建系统配置 -->
  200.     <ciManagement>
  201.         <!-- 构建系统类型 -->
  202.         <system>cis</system>
  203.         <!-- 构建地址 -->
  204.         <url>https://github.com/</url>
  205.         <!-- 通知人列表 -->
  206.         <notifiers>
  207.             <notifier>
  208.                 <type>mail</type>
  209.                 <sendOnError>true</sendOnError>
  210.                 <sendOnFailure>true</sendOnFailure>
  211.                 <sendOnSuccess>true</sendOnSuccess>
  212.                 <sendOnWarning>true</sendOnWarning>
  213.                 <address>hunk.xia@gmail.com</address>
  214.                 <!-- 通知配置 -->
  215.                 <configuration></configuration>
  216.             </notifier>
  217.         </notifiers>
  218.     </ciManagement>
  219.     <!-- 邮件列表 -->
  220.     <mailingLists>
  221.         <!-- 列表信息 -->
  222.         <mailingList>
  223.             <name>list-1</name>
  224.             <subscribe></subscribe>
  225.             <unsubscribe></unsubscribe>
  226.             <post></post>
  227.             <archive></archive>
  228.             <otherArchives></otherArchives>
  229.         </mailingList>
  230.     </mailingLists>
  231.     <!-- 源代码版本控制 -->
  232.     <scm>
  233.         <connection></connection>
  234.         <developerConnection></developerConnection>
  235.         <tag>HEAD</tag>
  236.         <url></url>
  237.     </scm>
  238.     <!-- 预处理操作 -->
  239.     <prerequisites></prerequisites>
  240.     <!-- 仓库库配置，可以用来设置远程仓库 -->
  241.     <repositories>
  242.         <repository>
  243.             <id>my repos</id>
  244.             <name>My Repository</name>
  245.             <url>http://repo.myrepos.cn/content/groups/public/</url>
  246.             <releases>
  247.                 <enabled>true</enabled>
  248.                 <updatePolicy>daily</updatePolicy>
  249.             </releases>
  250.             <snapshots>
  251.                 <enabled>true</enabled>
  252.                 <checksumPolicy>warn</checksumPolicy>
  253.             </snapshots>
  254.             <layout>default</layout>
  255.         </repository>
  256.     </repositories>
  257.     <!-- 插件仓库 -->
  258.     <pluginRepositories></pluginRepositories>
  259.     <!-- 发布管理，管理整个构建 -->
  260.     <distributionManagement>
  261.         <repository></repository>
  262.         <site></site>
  263.         <downloadUrl></downloadUrl>
  264.         <status></status>
  265.     </distributionManagement>
  266.     <!-- 配置不同环境，不同包 -->
  267.     <profiles>
  268.         <profile>
  269.             <id>release</id>
  270.             <build>
  271.                 <resources>
  272.                     <resource>
  273.                         <directory>src/main/resources</directory>
  274.                         <includes>
  275.                             <include>**/*</include>
  276.                         </includes>
  277.                     </resource>
  278.                 </resources>
  279.             </build>
  280.         </profile>
  282.         <profile>
  283.             <id>test</id>
  284.             <build>
  285.                 <resources>
  286.                     <resource>
  287.                         <directory>src/test/resources</directory>
  288.                         <includes>
  289.                             <include>config/*.properties</include>
  290.                             <include>log4j.xml</include>
  291.                         </includes>
  292.                     </resource>
  293.                     <resource>
  294.                         <directory>src/main/resources</directory>
  295.                         <includes>
  296.                             <include>**/*.xml</include>
  297.                         </includes>
  298.                         <excludes>
  299.                             <exclude>log4j.xml</exclude>
  300.                         </excludes>
  301.                     </resource>
  302.                 </resources>
  303.             </build>
  304.             <activation>
  305.                 <activeByDefault>true</activeByDefault>
  306.             </activation>
  307.         </profile>
  308.     </profiles>
  309. </project>

本篇完，下次再深入讲解和研究下多项目（父子项目、依赖项目）如何规范配置。

发表评论

表情：
评论列表 （有 0 条评论，221人围观）

还没有评论，来说两句吧...

相关阅读