1、约定
- 分类存放
- X:/applications 目录存放 开发工具,比如 IDEA 、Eclipse 、Typora
- X:/Environments 目录存放开发环境,比如 JDK、MinGW-w64、cmder
- X:/IdeaProjects 目录存放 IDEA 工程
- X:/workspaces 目录存放 Eclipse 的工作空间
- X:/Repository 目录用作 apache-maven 的仓库
- X:/Repository/Synchronization 目录用作 apache-maven 从 中央仓库同步时使用的本地仓库位置
这个目录,也是在 apache-maven 的 conf/settings.xml 中所配置的 localRepository 对应的目录 - X:/Repository/ThirdParty 目录 用于存放不存在于 maven 中央仓库的 jar 文件 ( 比如 ojdbc.jar )
注意,这里的 X 盘可以是硬盘上的 C盘、D盘等。
- 编码
- Eclipse 所有的文本文件采用 UTF-8 编码 ( Text file encoding )
- 换行方式采用 Unix 方式 ( New text file line delimiter )
2、Maven
2.1、下载
从 apache-maven 官网 下载 最新版 maven ,在官网的下载页面中:
- Binary zip archive ( apache-maven-3.6.0-bin.zip ) 表示已经编译好的,可以直接使用的压缩包
- Source zip archive ( apache-maven-3.6.0-src.zip ) 表示 源码包
2.2、解压
根据 约定,应该将 apache-maven-3.6.0-bin.zip 解压到 X:/applications 目录下。
2.3、配置
根据约定,在 X:/applications/apache-maven-3.6.0 目录中找到 conf
目录,使用 EditPlus 、 EmEditor、Notepad++ 等工具打开 其中的 settings.xml 文件。
2.3.1、替换
将 conf/settings.xml 文件中的所有内容,替换为以下内容:
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ${user.home}/.m2/repository
-->
<localRepository>/path/to/local/repo</localRepository>
<pluginGroups></pluginGroups>
<proxies></proxies>
<servers></servers>
<mirrors>
</mirrors>
<profiles></profiles>
</settings>
2.3.2、修改本地仓库
建议根据约定,将 conf/settings.xml 文件中的本地仓库位置修改为如下形式:
<localRepository>D:/Repository/Synchronization</localRepository>
2.3.3、修改 mirror
<mirrors>
<!-- 由阿里云提供的Maven中央仓库镜像 -->
<mirror>
<id>nexus-aliyun</id>
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>*</mirrorOf>
</mirror>
<!-- 由 Apache 提供的仓库 -->
<mirror>
<id>apache-repo</id>
<name>apache Repository</name>
<url>https://repository.apache.org/content/groups/public/</url>
<mirrorOf>apache-repo</mirrorOf> <!-- 注意,这里必须写 apache-repo -->
</mirror>
</mirrors>
2.3.4、最后的 settings.xml
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<!-- localRepository
| The path to the local repository maven will use to store artifacts.
|
| Default: ${user.home}/.m2/repository
-->
<localRepository>D:/Repository/Synchronization</localRepository>
<pluginGroups></pluginGroups>
<proxies></proxies>
<servers></servers>
<mirrors>
<!-- 由阿里云提供的Maven中央仓库镜像 -->
<mirror>
<id>nexus-aliyun</id>
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<mirrorOf>*</mirrorOf>
</mirror>
<!-- 由 Apache 提供的仓库 -->
<mirror>
<id>apache-repo</id>
<name>apache Repository</name>
<url>https://repository.apache.org/content/groups/public/</url>
<mirrorOf>apache-repo</mirrorOf> <!-- 注意,这里必须写 apache-repo -->
</mirror>
</mirrors>
<profiles></profiles>
</settings>
3、IDEA
3.1、配置 maven
3.1.1、 打开设置界面
在 以下界面中点击右下角 “Configure” 右侧的 三角形,随后点击 “Settings” 选项即可打开设置界面。
3.1.2、 设置软件主题和字体
在 “Settings for New Projects” 窗口中选择 “Appearance & Behavior” 下面的 “Appearance”。
在右侧的 “Theme” 选项中可以通过 下拉列表来切换 主题。
勾选 "Use custom font " 后,可以设置 “字体” 和 字体尺寸
3.1.3、在 IDEA 中配置 maven
在 “Settings for New Projects” 窗口中选择 “Build , Execution , Deployment” 下方的 “Build Tools” 下方的 “Maven”,如下图所示:
在右侧 “Maven home directory” 同一行最右侧的
...
按钮上点击,并选择到 apache-maven 的主目录。所谓的 apache-maven 主目录,就是在解压 maven 时,apache-maven 的解压目录。
在右侧 "User settings file"同一行最右侧,勾选 “Override” 复选框,再在复选框之前的 输入框中点击 “文件夹” 图标,选择 apache-maven 的配置文件( 根据约定,应该是 X:\applications\apache-maven-3.6.0\conf\settings.xml )
修改后的界面如下图所示:
最后点击整个界面的右下角的 “Apply” 按钮,再点击 “OK” 按钮。
3.2、创建 maven-webapp
3.2.1、开启 “New Project” 界面
在 欢迎界面 ( 下图 ) 中点击 “Create New Project” 后即可弹出 “New Project” 界面。
“New Project” 界面:
3.2.2、选择 maven 原型
3.2.2.1、选择 maven
在 “New Project” 界面左侧列表中选择 maven
:
3.2.2.2、指定 Project SDK
因为是首次使用 IDEA 开发 Java 工程(包括 maven 工程),因此这里的 "Project SDK"是尚未配置的,因此需要配置 SDK。
在 正上方的 “Project SDK” 同一行右侧点击New...
按钮,选择 JDK 的按照目录即可。
选择之后 “Project SDK” 就是相应的 JDK 。
3.2.2.3、在 archetype 列表中选择 maven-webapp
在 “New Project” 界面中勾选 “Create from archetype” ,
然后选择 “org.apache.maven.archetypes:maven-archetype-webapp” ,如下图所示:
随后点击 “Next” 按钮,进入下一步 ( 如下图所示 )。
在这里,分别输入 GroupId 、ArtifactId
- GroupId : cn.edu.ecut
- ArtifactId : hello
直接点击 “Next” 按钮,进入下一步 ( 如下图所示 )。
继续点击 “Next”,进入下一步( 如下图所示 )
这里,根据约定,应该将 “Project location” 更改为 X:\IdeaProjects\hello ,修改的界面后如下图所示:
最后,点击 “Finish” 即可开始创建工程。
在工程构建过程中,IDEA软件界面右下角可能提示:
点选 "Enable Auto-Import"即可。
随后进入热烈的项目构建过程中,最后在软件界面下方看到 “BUILD SUCCESS” 即表示项目构建成功。
3.3、配置 maven-webapp
打开 当前工程下的 pom.xml 文件,其中:
<groupId>cn.edu.ecut</groupId>
<artifactId>hello</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>
是当前工程最基本的信息。<packaging>
用于指定项目的大包方式。
3.3.1、修改 properties 部分
替换 pom.xml 中 <properties>
中原来的内容为以下内容:
<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- 根据自己的 Project SDK 来确定版本 -->
<maven.compiler.source>12</maven.compiler.source>
<maven.compiler.target>12</maven.compiler.target>
<maven.compiler.compilerVersion>12</maven.compiler.compilerVersion>
</properties>
3.3.2、修改 dependencies 部分
替换 pom.xml 中 <dependencies>
中原来的内容为以下内容:
<dependencies>
<!-- 添加对 Servlet 的支持 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>4.0.1</version>
<scope>provided</scope>
</dependency>
<!-- MySQL 驱动 -->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.45</version>
</dependency>
</dependencies>
3.3.3、修改 build 部分
替换 pom.xml 中 <build>
中原来的内容为以下内容:
<build>
<finalName>${project.artifactId}</finalName>
<plugins>
<!-- Maven Compiler Plugin -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.8.0</version>
<configuration>
<source>${maven.compiler.source}</source>
<target>${maven.compiler.target}</target>
<compilerVersion>${maven.compiler.compilerVersion}</compilerVersion>
<encoding>${project.build.sourceEncoding}</encoding>
</configuration>
</plugin>
<!-- Tomcat Maven Plugin -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<configuration>
<port>8080</port>
<path>/</path>
<uriEncoding>UTF-8</uriEncoding>
<useBodyEncodingForURI>true</useBodyEncodingForURI>
</configuration>
</plugin>
</plugins>
</build>
3.3.4、追加 repositories 配置
在 pom.xml 文件内部的 </project>
添加以下内容:
<repositories>
<repository>
<id>nexus-aliyun</id>
<name>Nexus aliyun</name>
<url>http://maven.aliyun.com/nexus/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
<repository>
<id>apache-repo</id>
<name>apache Repository</name>
<url>https://repository.apache.org/content/groups/public/</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>