手把手教你用 IDEA 2023 搭建 SpringMVC + FreeMarker + JDBC
2023-10-20 19:51:34
使用 IDEA 搭建 SpringMVC + FreeMarker + JDBC 项目的完整指南
简介
对于想要踏入 Java Web 开发领域的初学者来说，搭建开发环境可能是一项艰巨的任务。本指南将逐步指导您使用 IntelliJ IDEA 2023 创建一个完整的 SpringMVC + FreeMarker + JDBC 项目，让您轻松开启您的 Java Web 开发之旅。
准备工作
在开始之前，您需要准备好以下工具：
- IDEA 2023 旗舰版： 从 JetBrains 官网下载并安装。
- Maven： 从 Maven 官网下载并安装。
- JDK 21.0.1+： 从 Oracle 官网下载并安装。
- Tomcat 11.0.0+： 从 Apache Tomcat 官网下载并安装。
- JDBC 12.4： 从 Oracle 官网下载并安装。
配置 Maven
- 打开 IDEA，选择 "Settings"（设置）> "Maven"。
- 设置 Maven 的安装路径、用户设置文件和本地仓库路径。
- 添加淘宝镜像以加速下载速度。
创建新项目
- 选择 "File"（文件）> "New"（新建）> "Project"（项目）。
- 选择 "Spring Boot"，输入项目名称和位置。
添加依赖
在 pom.xml 文件中添加以下依赖：
<dependencies>
<!-- Spring Web MVC -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- Spring Data JDBC -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jdbc</artifactId>
</dependency>
<!-- HikariCP -->
<dependency>
<groupId>com.zaxxer</groupId>
<artifactId>HikariCP</artifactId>
</dependency>
<!-- PostgreSQL -->
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
</dependency>
<!-- FreeMarker -->
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
</dependency>
</dependencies>
配置数据库
在 application.properties 文件中添加数据库连接配置：
spring.datasource.url=jdbc:postgresql://localhost:5432/test
spring.datasource.username=postgres
spring.datasource.password=my-password
spring.jpa.generate-ddl=true
创建实体类
创建一个 User.java 实体类来表示数据库中的用户：
@Entity
@Table(name = "user")
public class User {
// 省略属性和方法
}
创建仓库类
创建一个 UserRepository.java 仓库类来操作数据库中的用户：
public interface UserRepository extends JpaRepository<User, Long> {
// 省略方法
}
创建控制器类
创建一个 UserController.java 控制器类来处理 HTTP 请求：
@RestController
@RequestMapping("/api/users")
public class UserController {
// 省略属性和方法
}
创建视图模板
创建一个 index.ftl FreeMarker 模板文件来呈现用户列表：
<!DOCTYPE html>
<html>
<!-- 省略 HTML 代码 -->
</html>
运行项目
在 IDEA 中点击 "Run"（运行），选择 "Spring Boot App"。项目启动后，访问 http://localhost:8080/api/users 查看用户列表。
常见问题解答
1. 如何连接到其他数据库？
- 在
application.properties文件中修改数据库连接配置。
2. 如何添加更多控制器？
- 在项目目录下创建新的控制器类，并使用
@RestController和@RequestMapping注解进行注解。
3. 如何自定义错误处理？
- 创建一个
@ControllerAdvice类来处理异常。
4. 如何部署到生产环境？
- 使用 Maven 命令
mvn package创建 WAR 文件，然后部署到 Web 服务器。
5. 如何进行单元测试？
- 使用 Spring Test 框架编写单元测试。
结论
通过遵循本指南，您已经成功创建了一个功能齐全的 SpringMVC + FreeMarker + JDBC 项目。通过使用这些技术，您可以轻松构建复杂而强大的 Web 应用程序。欢迎您在评论区提出任何问题或分享您的经验。
