当前位置：首页 > article >正文

如何实现Spring Boot与Oracle数据库的完美对接？

article 2026/3/8 18:03:39

想要在Spring Boot项目中使用Oracle数据库？这可不是一件难事！接下来，我将带你一步步走过这个过程，从环境准备到配置，再到实际操作，确保你能够轻松对接Oracle数据库。

环境准备

首先，确保你已经安装好Java开发环境。Spring Boot需要Java 8或更高版本。你可以在命令行中输入java -version来检查你当前的Java版本。如果还没有安装，去Oracle官网或者OpenJDK下载并安装最新版本的Java。

接下来，要确保你的机器上有Maven或者Gradle。Maven是管理项目依赖和构建的工具，而Gradle也是类似的，只是语法和用法上有些不同。我们以Maven为例。可以在命令行中输入mvn -v来检查是否安装成功。

如果你还没有安装Oracle数据库，那就需要下载并安装一个。你可以去Oracle官网找到适合你操作系统的版本。安装完成后，记得创建一个数据库用户，并记录下用户名和密码，后面需要用到。

创建Spring Boot项目

现在我们开始创建一个新的Spring Boot项目。在命令行中，你可以使用Spring Initializr（https://start.spring.io/）来生成一个基础项目。选择Maven项目，Java版本选择与你当前安装的Java版本一致，接着填写Group和Artifact的名称，比如：com.example和demo。

在依赖中，找到并添加以下几个常用的依赖：

Spring Web
Spring Data JPA
Oracle JDBC Driver

生成项目后，将压缩包下载并解压缩到你想要的工作目录中。用你喜欢的IDE（如IntelliJ IDEA或Eclipse）打开这个项目。

配置application.properties

在项目结构中，找到src/main/resources/application.properties文件。在这里，你需要配置Oracle数据库的连接信息。添加以下内容：

spring.datasource.url=jdbc:oracle:thin:@localhost:1521:xe
spring.datasource.username=你的数据库用户名
spring.datasource.password=你的数据库密码
spring.datasource.driver-class-name=oracle.jdbc.OracleDriverspring.jpa.database-platform=org.hibernate.dialect.Oracle12cDialect
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

spring.datasource.url是数据库的连接URL，localhost是数据库地址，1521是Oracle数据库的默认端口，xe是数据库的实例名。
spring.jpa.hibernate.ddl-auto设置为update，可以自动更新数据库表结构，这在开发时比较方便。
spring.jpa.show-sql设置为true，可以在控制台输出SQL语句，方便调试。

确保将用户名和密码替换为你在Oracle数据库中设置的实际值。

添加Oracle JDBC依赖

在pom.xml文件中，添加Oracle JDBC Driver的依赖。可以在Oracle的Maven仓库中找到最新的依赖信息，通常是这样的：

<dependency><groupId>com.oracle.database.jdbc</groupId><artifactId>ojdbc8</artifactId><version>19.8.0.0</version>
</dependency>

记得在<dependencies>标签内添加这个依赖。保存文件后，IDE会自动下载相关的依赖包。

创建实体类

在项目中创建一个简单的实体类，比如User，并在src/main/java/com/example/demo目录下创建一个model包，添加User类：

package com.example.demo.model;import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;@Entity
public class User {@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String name;private String email;// getters and setters
}

这个User类有三个属性：id、name和email，并且使用了JPA的注解来标识它是一个实体类。

创建Repository接口

接下来，创建一个Repository接口，方便进行数据库操作。在src/main/java/com/example/demo/repository目录下创建一个UserRepository接口：

package com.example.demo.repository;import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;public interface UserRepository extends JpaRepository<User, Long> {
}

通过继承JpaRepository，你可以轻松地使用Spring Data JPA提供的各种数据库操作方法。

创建Controller类

接下来，我们要创建一个Controller类来处理HTTP请求。在src/main/java/com/example/demo/controller目录下创建一个UserController类：

package com.example.demo.controller;import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/users")
public class UserController {@Autowiredprivate UserRepository userRepository;@GetMappingpublic List<User> getAllUsers() {return userRepository.findAll();}@PostMappingpublic User createUser(@RequestBody User user) {return userRepository.save(user);}
}

在这个控制器中，我们定义了两个端点：一个用于获取所有用户，另一个用于创建新用户。

启动应用程序

一切准备就绪后，现在可以启动你的Spring Boot应用程序。在IDE中找到主类（通常是DemoApplication），点击运行，你的应用程序就会启动。

如果一切正常，你可以在浏览器中访问http://localhost:8080/users，查看是否能成功返回用户列表。你也可以使用Postman等工具发送POST请求，来测试创建用户的功能。

结语

以上就是Spring Boot与Oracle数据库对接的具体流程！从环境准备到项目创建，再到实际操作，整个过程并不复杂。只要按照步骤走，基本上都能顺利实现对接。希望这篇文章能帮助到你，快来试试吧！