基于Spring的高级Web实验环境搭建及常见错误

Windows 环境下开发 Spring Web 程序所需要的 JDK、Maven、Tomcat、MySQL、IDEA的版本搭配推荐如下:

  1. JDK 1.8:下载地址 https://www.oracle.com/java/technologies/javase-downloads.html
  2. Maven 3.6.3:下载地址 http://maven.apache.org/download.cgi
  3. Tomcat 9.0:下载地址 https://tomcat.apache.org/download-90.cgi
  4. MySQL 8.0:下载地址 https://dev.mysql.com/downloads/mysql/
  5. IDEA Ultimate 2020.2.3:下载地址 https://www.jetbrains.com/idea/download/
  6. 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 属性:

  1. 打开 Maven 的配置文件 settings.xml。配置文件通常位于 Maven 安装目录下的 conf 目录中。

  2. 在 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的方法如下:

  1. 配置独立安装的 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中还提供了“新建项目配置”,这个里面也需要把上面的配置再做一遍。image-20240421185031365

  1. 配置独立安装的 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标签里面的。

pom.xml各种飘红

报错:mybatis-config.xml 找不到 (not found)

(ℹ️ 如果图看不到,请使用科学上网)mybatis-config.xml 找不到

解决办法:

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日