本文将指导您使用JDBC构建一个简单的Java TODO应用程序，并连接到PostgreSQL数据库，同时实现一个基本的ORM，类似于Laravel的Eloquent。
什么是JDBC？
JDBC (Java Database Connectivity) 是一个Java API，允许Java应用程序连接到各种数据库管理系统。它由java.sql和javax.sql两个包组成，通常在Java SE 8及以上版本中预装。
如何使用JDBC？
要将JDBC API与特定数据库系统一起使用，您需要一个JDBC驱动程序。驱动程序充当JDBC API和数据库系统之间的桥梁，可以使用纯Java或Java和JNI（Java Native Interface）的混合方式编写。本教程将使用PostgreSQL JDBC驱动程序。
项目需求
- Maven
- Java
- PostgreSQL (可以使用Docker)
项目创建
使用以下Maven命令创建一个新项目：
<code class="bash">mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.5 -DinteractiveMode=false</code>
更多Maven信息，请参考Maven文档。
数据库创建
如果您已安装PostgreSQL，请创建一个数据库并执行以下SQL语句创建表：
<code class="sql">CREATE TABLE tbl_jd_todos (
id SERIAL PRIMARY KEY,
name VARCHAR(255) NOT NULL,
completed SMALLINT DEFAULT 0 NOT NULL,
created_at TIMESTAMP DEFAULT NOW()
);</code>
使用Docker
如果您使用Docker，请使用以下docker-compose.yml文件：
<code class="yaml">services:
jodos_db:
image: postgres:15
container_name: jodos_db
env_file:
- .env
ports:
- "${db_port}:5432"
volumes:
- jodo-data:/var/lib/postgresql/data
volumes:
jodo-data:
name: jodo-data</code>
创建一个.env文件，包含以下变量：
<code>db_port= postgres_user= postgres_password= postgres_db=</code>
运行docker-compose up -d启动数据库。您可以使用DBeaver等工具连接到数据库进行测试。
依赖项安装
将以下依赖项添加到您的pom.xml文件：
<code class="xml"><dependencies>
<!-- PostgreSQL JDBC Driver -->
<dependency>
<groupId>org.postgresql</groupId>
<artifactId>postgresql</artifactId>
<version>42.6.0</version> <!-- 使用最新版本 -->
</dependency>
<!-- Dotenv Java -->
<dependency>
<groupId>io.github.cdimascio</groupId>
<artifactId>dotenv-java</artifactId>
<version>5.3.0</version> <!-- 使用最新版本 -->
</dependency>
</dependencies></code>
数据库连接和ORM实现
以下代码展示了Db.java和Model.java的实现，用于数据库连接和ORM操作：
(Db.java)
<code class="java">package com.caresle.jodos;
import java.sql.*;
import io.github.cdimascio.dotenv.Dotenv;
public class Db {
static String url;
static {
Dotenv dotenv = Dotenv.load();
String port = dotenv.get("db_port");
String database = dotenv.get("postgres_db");
String username = dotenv.get("postgres_user");
String password = dotenv.get("postgres_password");
url = "jdbc:postgresql://localhost:" + port + "/" + database + "?user=" + username + "&password=" + password;
}
private static Connection connection;
private Db() {}
public static Connection getConnection() throws SQLException {
if (connection == null || connection.isClosed()) {
connection = DriverManager.getConnection(url);
}
return connection;
}
}</code>
(Model.java)
<code class="java">package com.caresle.jodos;
import java.sql.*;
import java.util.*;
public abstract class Model {
protected static String table;
protected Map<String, Object> attributes = new HashMap<>();
public void set(String key, Object value) {
attributes.put(key, value);
}
public Object get(String key) {
return attributes.get(key);
}
public boolean delete() throws SQLException {
// ... (删除方法实现) ...
}
private void setParameters(PreparedStatement statement) throws SQLException {
// ... (设置参数方法实现) ...
}
private boolean insert() throws SQLException {
// ... (插入方法实现) ...
}
private boolean update() throws SQLException {
// ... (更新方法实现) ...
}
public boolean save() throws SQLException {
// ... (保存方法实现) ...
}
public static <T extends Model> T findById(Class<T> modelClass, long id) {
// ... (findById方法实现) ...
}
public static <T extends Model> ArrayList<T> all(Class<T> modelClass) {
// ... (all方法实现) ...
}
}</code>
(Todo.java)
<code class="java">package com.caresle.jodos;
import java.util.ArrayList;
public class Todo extends Model {
static {
table = "tbl_jd_todos";
}
public Todo() {}
public static Todo findById(long id) {
return (Todo) Model.findById(Todo.class, id);
}
public static ArrayList<Todo> all() {
return (ArrayList<Todo>) Model.all(Todo.class);
}
}</code>
(Ui.java)
<code class="java">package com.caresle.jodos;
import java.util.ArrayList;
import java.util.Scanner;
public class Ui {
// ... (UI方法实现) ...
}</code>
(App.java)
<code class="java">package com.caresle.jodos;
import java.util.Scanner;
public class App {
public static void main(String[] args) {
// ... (主方法实现) ...
}
}</code>
请注意，Model.java，Todo.java 和 Ui.java 中的 // ... (方法实现) ... 部分需要根据之前的描述补充完整代码。 由于篇幅限制，这里省略了这些方法的具体实现，但它们应该基于之前的描述很容易完成。
总结
本文演示了如何使用JDBC构建一个简单的Java TODO应用程序，并介绍了一个基本的ORM实现。 完整的代码需要您根据本文提供的代码片段和说明进行填充和完善。 请确保您理解每个代码片段的作用，并根据您的环境调整配置。
