在 Spring Boot 项目中连接 IBM AS/400 数据库——详细案例教程

在 Spring Boot 项目中连接 IBM AS/400 数据库（又称 IBM i）需要使用 jt400 驱动。下面是一个完整的步骤和案例，包含包的获取、下载、导入和使用等过程。

1. 添加 jt400 依赖

在 pom.xml 中添加 jt400 的 Maven 依赖。jt400 是一个 JDBC 驱动程序，用于连接 IBM i（AS/400）的数据库。

<dependencies>
    <!-- Spring Boot Starter JDBC -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>

    <!-- jt400 JDBC Driver -->
    <dependency>
        <groupId>net.sf.jt400</groupId>
        <artifactId>jt400</artifactId>
        <version>10.5</version> <!-- 推荐最新版本 -->
    </dependency>
</dependencies>

2. 下载 jt400 驱动包

依赖下载

添加依赖后，使用 Maven 的 mvn install 命令，Maven 会自动下载并引入 jt400 驱动包到你的项目中。

mvn install

手动下载

Maven 会根据 pom.xml 自动从 Maven Central 仓库下载 jt400 的 JAR 包。如果需要手动下载，可以从以下网站进行下载：

下载地址：

1. Maven Central Repository:

   • 访问 Maven Central
   • 在页面中可以找到各个版本的 jt400 JAR 文件，并下载所需的版本。

2. JT400 GitHub 仓库：

   • 官方的项目源代码托管在 GitHub 上: JT400 GitHub

手动下载 JAR 的步骤：

1. 访问 Maven Central jt400。
2. 点击 Download 按钮，下载对应版本的 JAR 文件。
3. 如果不使用 Maven 进行管理，可以将下载的 JAR 文件手动添加到项目的库路径中。

3. 配置 application.properties 或 application.yml

（1）application.properties

在 src/main/resources/application.properties 文件中配置数据库连接信息。

# AS/400 数据库配置
spring.datasource.url=jdbc:as400://<AS400_HOST>/<DATABASE>
spring.datasource.username=<USERNAME>
spring.datasource.password=<PASSWORD>
spring.datasource.driver-class-name=com.ibm.as400.access.AS400JDBCDriver

# HikariCP Connection Pool 配置 (可选)
spring.datasource.hikari.maximum-pool-size=10
spring.datasource.hikari.minimum-idle=5
spring.datasource.hikari.idle-timeout=60000
spring.datasource.hikari.connection-timeout=30000
spring.datasource.hikari.max-lifetime=1800000

• <AS400_HOST>：IBM AS/400 服务器的 IP 或域名。
• <DATABASE>：AS/400 数据库的名称。
• <USERNAME>：连接数据库的用户名。
• <PASSWORD>：连接数据库的密码。

（2）application.yml

spring:
  datasource:
    url: jdbc:as400://<AS400_HOST>;databaseName=<DATABASE_NAME>
    username: <YOUR_USERNAME>
    password: <YOUR_PASSWORD>
    driver-class-name: com.ibm.as400.access.AS400JDBCDriver
    hikari:
      maximum-pool-size: 10
  jpa:
    hibernate:
      ddl-auto: none
    show-sql: true

• 替换 <AS400_HOST> 为 AS/400 服务器的 IP 或主机名，
• <DATABASE_NAME> 为你要连接的数据库名称
• <YOUR_USERNAME> 和 <YOUR_PASSWORD> 为你的登录凭证。

4. 数据源配置类（可选）

如果你需要自定义配置数据源，可以在项目中创建一个 DataSourceConfig 类。

import com.zaxxer.hikari.HikariDataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.jdbc.DataSourceBuilder;
import javax.sql.DataSource;

@Configuration
public class DataSourceConfig {

    @Bean
    @ConfigurationProperties("spring.datasource")
    public DataSource dataSource() {
        return DataSourceBuilder.create()
                .type(HikariDataSource.class)
                .build();
    }
}

5. 创建 JDBC 访问层

Spring Boot 支持使用 JdbcTemplate 来简化对数据库的操作。你可以创建一个服务类来访问 AS/400 数据库。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;

import java.util.List;
import java.util.Map;

@Service
public class AS400Service {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    public List<Map<String, Object>> getUsers() {
        String sql = "SELECT * FROM USERS";  // 假设 USERS 是 AS/400 中的一个表
        return jdbcTemplate.queryForList(sql);
    }
}

6. 测试连接

创建一个测试接口来验证数据库连接是否成功。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;
import java.util.Map;

@RestController
public class AS400Controller {

    @Autowired
    private AS400Service as400Service;

    @GetMapping("/users")
    public List<Map<String, Object>> getUsers() {
        return as400Service.getUsers();
    }
}

7. 启动项目

使用以下命令启动 Spring Boot 项目：

mvn spring-boot:run

然后访问 http://localhost:8080/users，如果一切配置正确，你将看到从 AS/400 数据库中检索到的数据。

---

总结

1. 添加依赖：通过 Maven 添加 jt400 依赖。
2. 配置文件：在 application.properties 中配置 AS/400 数据库的连接信息。
3. 数据源配置（可选）：使用自定义数据源配置类进行高级数据源配置。
4. 业务逻辑：使用 JdbcTemplate 访问数据库。
5. 测试：创建 REST API 以验证数据库连接。

这是一个完整的 Spring Boot 连接 AS/400 数据库的案例，可以根据你的实际需求进行扩展和修改。

希望对你有所帮助，若有问题欢迎指正~😊