
本文将指导您使用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命令创建一个新项目:
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.5 -DinteractiveMode=false
更多Maven信息,请参考Maven文档。
数据库创建
如果您已安装PostgreSQL,请创建一个数据库并执行以下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()
);
使用Docker
如果您使用Docker,请使用以下docker-compose.yml文件:
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
创建一个.env文件,包含以下变量:
db_port= postgres_user= postgres_password= postgres_db=
运行docker-compose up -d启动数据库。您可以使用DBeaver等工具连接到数据库进行测试。
依赖项安装
将以下依赖项添加到您的pom.xml文件:
org.postgresql postgresql 42.6.0 io.github.cdimascio dotenv-java 5.3.0
数据库连接和ORM实现
以下代码展示了Db.java和Model.java的实现,用于数据库连接和ORM操作:
(Db.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;
}
}
(Model.java)
package com.caresle.jodos;
import java.sql.*;
import java.util.*;
public abstract class Model {
protected static String table;
protected Map 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 findById(Class modelClass, long id) {
// ... (findById方法实现) ...
}
public static ArrayList all(Class modelClass) {
// ... (all方法实现) ...
}
}
(Todo.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 all() {
return (ArrayList) Model.all(Todo.class);
}
}
(Ui.java)
package com.caresle.jodos;
import java.util.ArrayList;
import java.util.Scanner;
public class Ui {
// ... (UI方法实现) ...
}
(App.java)
package com.caresle.jodos;
import java.util.Scanner;
public class App {
public static void main(String[] args) {
// ... (主方法实现) ...
}
}
请注意,Model.java,Todo.java 和 Ui.java 中的 // ... (方法实现) ... 部分需要根据之前的描述补充完整代码。 由于篇幅限制,这里省略了这些方法的具体实现,但它们应该基于之前的描述很容易完成。
总结
本文演示了如何使用JDBC构建一个简单的Java TODO应用程序,并介绍了一个基本的ORM实现。 完整的代码需要您根据本文提供的代码片段和说明进行填充和完善。 请确保您理解每个代码片段的作用,并根据您的环境调整配置。










