基于Spring的高级Web实验环境搭建及常见错误
Windows 环境下开发 Spring Web 程序所需要的 JDK、Maven、Tomcat、MySQL、IDEA的版本搭配推荐如下:
- JDK 1.8:下载地址 https://www.oracle.com/java/technologies/javase-downloads.html
- Maven 3.6.3:下载地址 http://maven.apache.org/download.cgi
- Tomcat 9.0:下载地址 https://tomcat.apache.org/download-90.cgi
- MySQL 8.0:下载地址 https://dev.mysql.com/downloads/mysql/
- IDEA Ultimate 2020.2.3:下载地址 https://www.jetbrains.com/idea/download/
- Spring 5.2.9:下载地址 https://repo.spring.io/release/org/springframework/spring/
软件独立配置
1. JDK 的配置
a. 下载 JDK 安装包并完成安装
b. 配置环境变量 JAVA_HOME 和 PATH,新手推荐使用环境编辑器软件如:Rapid Environment Editor
i. 新建一个JAVA_HOME环境变量,值为 JDK 的安装路径,如C:\Program Files\Java\jdk1.8.0
ii. 将 %JAVA_HOME%\bin 添加到 PATH 系统环境变量中,以便在命令行中可以直接使用 javac 和 java 命令验证是否安装成功
iii. 执行 java -version 命令进行验证
2. Maven 的配置
a. 下载 Maven 安装包并完成安装 (https://dlcdn.apache.org/maven/)
b. 配置环境变量 MAVEN_HOME 和 PATH
i. 新建一个 MAVEN_HOME 环境变量,值为 Maven 的安装路径,如 C:\Program Files\apache-maven-3.6.3
ii. 将 %MAVEN_HOME%\bin 添加到 PATH 系统环境变量中,以便在命令行中可以直接使用 mvn 命令验证是否安装成功
iii. 执行 mvn -version 命令进行验证
针对大陆用户尽量配置一下 setting.xml 中的 mirror 属性:
-
打开 Maven 的配置文件 settings.xml。配置文件通常位于 Maven 安装目录下的 conf 目录中。
-
在 settings.xml文件中添加 mirror 元素。在 标签中添加 元素,如下所示:
<mirrors> <mirror> <id>aliyun</id> <name>Aliyun central</name> <url>https://repo1.maven.org/maven2/</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors>
3. Tomcat的配置
a. 下载 Tomcat 压缩包并解压到本地目录,并将 Tomcat 的 bin 目录加入 PATH 环境变量,如 C:\Program Files\Apache Software Foundation\Tomcat 9.0\bin
b. 配置 Tomcat 的运行环境
i. 打开 Tomcat 安装目录下的 conf 目录,修改 server.xml 文件,将 Tomcat 服务器默认的 8080 端口修改为其他未被占用的端口,如 9090
ii. 执行 bin/startup.bat 命令启动 Tomcat 服务器
iii. 访问 http://localhost:9090/ 能够看到 Tomcat 默认页面则表示 Tomcat 服务器安装成功。
ℹ️ 请同学们不要把Tomcat安装成Windows系统服务的方式,在实际开发项目的时候容易造成端口被占用,完全没有必要杀鸡用牛刀。
4. MySQL的配置
a. 下载 MySQL 安装包并完成安装
b. 新建一个环境变量 MYSQL_HOME,设置为 MySQL 的安装路径,如 C:\Program Files\MySQL\MySQL Server 8.0
c. 将 MySQL 的 bin 目录加入 PATH 系统环境变量中,如 C:\Program Files\MySQL\MySQL Server 8.0\bin
d. 使用管理员身份登录 MySQL,并新建一个 SpringMVC 所需要的数据库,如 springmvcdb,字符集选择:utf8mb4generalci
i. 打开命令行,输入 mysql -u root -p 命令,回车后输入管理员账号密码,进入 MySQL 程序。
ii. 输入 create database springmvcdb default character set utf8mb4 collate utf8mb4generalci; 命令,回车创建一个名为springmvcdb的数据库。
iii. 执行 show databases;命令,可以验证数据库创建是否成功
5. IDEA的安装
a. 下载 IDEA Ultimate 安装包并完成安装
b. 启动 IDEA,开始使用。
6. Spring的下载与配置
ℹ️ 注意:这一步不是必须的,如果是 Maven项目管理的,只需要在 pom中加入依赖即可
a. 下载 Spring 压缩包并解压到本地目录,如 C:\spring-framework-5.2.9.RELEASE
b. 在 IDEA 中配置 Spring 的 classpath 路径
i. 打开 IDEA 中的 Project Structure,选择 Dependencies 标签页
ii. 点击“+”按钮,选择 JARs or directories选项,将向导的浏览器指向 Spring 的 lib 目录,选中需要导入的jar包,如 spring-core-5.2.9.RELEASE.jar,添加到项目中
iii. 依次添加 Spring 的其他依赖包,如 spring-beans-5.2.9.RELEASE.jar、spring-webmvc-5.2.9.RELEASE.jar 等
软件融合
在 IDEA中配置独立安装的 Maven和 Tomcat的方法如下:
- 配置独立安装的 Maven
a. 打开 IDEA,选择 File -> Settings -> Build,Execution,Deployment -> Build Tools -> Maven。
b. 在 “Maven home directory"选项框中,指向独立安装的 Maven的文件夹目录。
c. 在 “User settings file"选项框中,指向 settings.xml 的文件路径,如果没有更改过 Maven 的配置,该文件应该在 Maven的安装路径下的 conf 目录中。
d. 点击 “OK”按钮保存配置。
为了后续开发的方便,IDEA中还提供了“新建项目配置”,这个里面也需要把上面的配置再做一遍。
- 配置独立安装的 Tomcat
a. 打开 IDEA,选择 File -> Settings -> Build,Execution,Deployment -> Application Servers -> + -> Tomcat Server -> Local。
b. 在 “Tomcat Home"选项框中,指向独立安装的 Tomcat 的顶级目录。
c. 在 “Tomcat Base directory” 选项框中,指向 Tomcat 的实例目录,如该 Tomcat 实例的目录为 /Users/user/tomcat,则该选项应该指向 /Users/user/tomcat。
d. 如果 Tomcat 配置了 SSL,则将 “HTTP/SSL port” 选项框的数值设置为 Tomcat 的 SSL 端口。
e. 点击 “OK” 按钮保存配置。
答疑
在 IDEA 里面打开 maven 项目后,pom.xml 各种飘红,大概率是 maven 导入的依赖没拉下来,项目上单击右键 maven->reimports。
如果没有使用代理,请保证 maven 的 mirror 已经配置正确,特别要注意的是 mirror 配置是放在 mirrors标签里面的。
报错:mybatis-config.xml 找不到 (not found)
(ℹ️ 如果图看不到,请使用科学上网)
解决办法:
1,最简单,IDEA 中 resources 文件夹右键单击 marked as -> resources root ;
2, 推荐做法,不依赖于任何 IDE ,在 pom.xml 补全下面的配置:
<build>
<sourceDirectory>src/main/java</sourceDirectory>
<resources>
<resource>
<directory>src/main/resources</directory>
<targetPath>your/target/path</targetPath>
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
</resource>
</resources>
<testResources>
<testResource>
<directory>src/test/resources</directory>
<targetPath>your/test/target/path</targetPath>
<includes>
<include>**/*.xml</include>
<include>**/*.properties</include>
</includes>
</testResource>
</testResources>
</build>
IDEA 中 Java web 项目以Tomcat的local server运行时,Java web项目的部署路径在哪里?
在 IDEA 中,当你以 Tomcat Server 的 local 方式运行 Java Web 项目时,项目的实际部署路径通常位于 Tomcat Server 的工作目录下。具体地说,Tomcat Server 的工作目录是通过 Tomcat Server 中的 catalina.base
属性来指定的。在 IDEA 中,你可以在 Tomcat Server 的 Run/Debug Configuration 中找到该属性的值。假设 catalina.base
的值为 /Users/user/.IntelliJIdea2019.3/system/tomcat/Tomcat_9_0_30
,那么该 Java Web 项目的部署路径就是 /Users/user/.IntelliJIdea2019.3/system/tomcat/Tomcat_9_0_30/webapps/your-web-app
,其中 your-web-app
是你的 Java Web 项目的名称。
清理 Maven 仓库下载失败包
因为网络问题可能导致maven包下载失败,在本地仓库repository中.lastUpdated结尾的文件即是下载失败jar包,清理Maven 仓库下载失败包使用:
💻Windows:for /r %i in (*.lastUpdated) do del %i ,使用cmd到 repository 目录下 ,注意不要使用powshell。
🍎Mac:find ~/.m2/repository -type f -name “*.lastUpdated” -exec rm -vrf {} ;
🕒最后更新:2024年4月23日