DAO
DAO(Data Access Object)是一个模式,它用于抽象和封装所有访问数据库的请求。通过DAO,可以将底层的数据访问逻辑和高层的业务逻辑分开,使得代码更加清晰、易于维护。
具体到这段代码,DAOFactory类提供了以下方法:
getIUserDAOInstance() - 创建一个用户信息操作的DAO实例。
getScoreDAOInstance() - 创建一个成绩操作的DAO实例。
getCourseDAOInstance() - 创建一个课程操作的DAO实例。
getStudentDAOInstance() - 创建一个学生操作的DAO实例。
getClassDAOInstance() - 创建一个班级操作的DAO实例。
getTeacherDAOInstance() - 创建一个老师操作的DAO实例。
getArrangeDaoInstance() - 创建一个选课信息操作的DAO实例。
每个方法都返回一个特定类型的DAO对象,这些对象是通过对应的代理(Proxy)类创建的。这些代理类可能是为了提供额外的功能,例如日志记录、事务管理等。
每一个DAO实例当中,都封装好了以下几个操作:
1.连接数据库
2.对数据库中的信息增删改查,如有异常则抛出
3.断开连接
以getIUserDAOInstance()为例:
类的定义和实例化:
private DataBaseConn dbc = null; // 声明一个私有成员变量dbc,类型为DataBaseConn,用于连接数据库
private IUserInfoDAO dao = null; // 声明一个私有成员变量dao,类型为IUserInfoDAO,用于操作数据库
public UserInfoDaoImpIProxy() { // 构造函数
dbc = new DataBaseConn(); // 创建DataBaseConn对象,并赋值给dbc
dao = new UserInfoDaoImpI(dbc.getConnection()); // 创建UserInfoDaoImpI对象,使用dbc获取的连接进行初始化,并赋值给dao
}
DataBaseConn:主要功能就是通过驱动类、数据库地址、端口、数据库名等连接数据库。代码如下:
public class DataBaseConn {
/**
* 数据库的链接类
*/
// Mysql 数据库连接类 --查看根目录下的Database_script.sql文件
// 在发布jar文件时要把mysql驱动一起打包
private static final String DBDRIVER = "com.mysql.cj.jdbc.Driver";
private static final String DBURL = "jdbc:mysql://localhost:3306/educationmanager?serverTimezone=UTC";
private static final String DBUSER = "root"; // mysql用户名
private static final String DBPASS = "nagural1"; // mysql密码
private Connection conn = null;
public DataBaseConn() {
try {
Class.forName(DBDRIVER);
} catch (ClassNotFoundException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
try {
conn = DriverManager.getConnection(DBURL, DBUSER, DBPASS);
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
// 获取连接
public Connection getConnection() {
System.out.println("连接成功!");
return this.conn;
}
// 关闭连接
public void close() {
if (this.conn != null) {
try {
this.conn.close();
} catch (SQLException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
}
}
IUserInfoDAO:定义一个公共的接口,名为IUserInfoDAO。接口是一个合同,定义了类必须实现的方法。getIUserDAOInstance()继承了这个接口,所以它需要实现接口内部的函数。
以下是IUserInfoDAO()要求实现的代码:
public interface IUserInfoDAO { // 定义一个公共的接口,名为IUserInfoDAO。接口是一个合同,定义了类必须实现的方法。
/**
* 数据库的增加
*
* @param user
* 要创建的用户信息的对象
* @return 如果创建成功,返回true;否则返回false
* @throws Exception
* 在创建过程中可能抛出的异常
*/
public boolean doCreate(UserInfo user) throws Exception; // 定义一个公共的doCreate方法,接收一个UserInfo类型的参数,返回一个boolean类型的结果,并可能抛出异常。该方法的注释描述了它是用于数据库的增加操作。
/**
* 修改用户
*
* @param user
* 要修改的用户信息的对象
* @return 如果修改成功,返回true;否则返回false
* @throws Exception
* 在修改过程中可能抛出的异常
*/
public boolean doUpdate(UserInfo user) throws Exception; // 定义一个公共的doUpdate方法,接收一个UserInfo类型的参数,返回一个boolean类型的结果,并可能抛出异常。该方法的注释描述了它是用于修改用户的信息。
/**
* 删除用户
*
* @param username
* 要删除的用户名
* @return 如果删除成功,返回true;否则返回false
* @throws Exception
* 在删除过程中可能抛出的异常
*/
public boolean doDelete(String username) throws Exception; // 定义一个公共的doDelete方法,接收一个String类型的参数,返回一个boolean类型的结果,并可能抛出异常。该方法的注释描述了它是用于删除用户的信息。
/**
* 数据库查询操作
*
* @param id
* 查询的用户ID
* @return 返回查询到的用户信息对象
* @throws Exception
* 在查询过程中可能抛出的异常
*/
public UserInfo findById(String id) throws Exception; // 定义一个公共的findById方法,接收一个String类型的参数,返回一个UserInfo类型的结果,并可能抛出异常。该方法的注释描述了它是用于根据ID查询用户的信息。
/**
* 做查询操作
*
* @param id
* 查询的用户关键字
* @return 返回查询到的用户列表
* @throws Exception
* 在查询过程中可能抛出的异常
*/ // 此处的方法名称为“findAll”,但注释中写的是“做查询操作”,这可能是一个错误或者误导。根据方法名和参数,这个方法应该是用来根据关键字查询所有匹配的用户信息。所以,这里的注释可能需要修正为类似“根据关键字查询所有匹配的用户”。
public List<UserInfo> findAll(String keyword) throws Exception;
} // 接口结束声明。`List<UserInfo>`表示返回的用户信息列表中每个元素都是UserInfo类型的对象。`throws Exception`表示这个方法可能会抛出异常。`IUserInfoDAO`接口定义了数据访问对象的基本操作。`UserInfo`可能是一个表示用户信息的类,但这个类的定义没有在代码中给出。`doCreate`, `doUpdate`, `doDelete`, `findById`, 和 `findAll`等方法分别代表了创建、更新、删除、查询单个用户和查询所有用户的基本数据库操作。每个方法都可能抛出异常,表示在执行这些操作时可能会出现的问题。这样的设计使得这个接口可以被多种不同的实现类来实现,从而可以根据不同的数据库或者数据源来定制具体的实现方式。同时,通过接口的方式也保证了所有使用这个DAO的用户都可以以一致的方式来进行操作。这种设计模式是面向对象程序设计中的常见模式,使得代码更加灵活、可维护性和可复用性都大大提高。 ```java // 以上就是为以上代码添加的详细注释 ```
以下是getIUserDAOInstance()实现的具体代码块:
@Override
public boolean doCreate(UserInfo user) throws Exception { // 实现IUserInfoDAO接口中的doCreate方法,用于增加用户信息
// 增加用户信息(代理实现)
boolean flag = true; // 定义一个布尔变量flag,并初始化为true
try {
flag = this.dao.doCreate(user); // 调用dao的doCreate方法,尝试增加用户信息,并将返回值赋值给flag
} catch (Exception e) {
throw e; // 如果调用dao.doCreate方法时抛出异常,则重新抛出该异常
} finally {
this.dbc.close(); // 最后,关闭数据库连接
}
return flag; // 返回flag,表示是否成功增加用户信息
}
@Override
public boolean doUpdate(UserInfo user) throws Exception { // 实现IUserInfoDAO接口中的doUpdate方法,用于更新用户信息
// 更新用户信息(代理实现)
boolean flag = true; // 定义一个布尔变量flag,并初始化为true
try {
flag = this.dao.doUpdate(user); // 调用dao的doUpdate方法,尝试更新用户信息,并将返回值赋值给flag
} catch (Exception e) {
throw e; // 如果调用dao.doUpdate方法时抛出异常,则重新抛出该异常
} finally {
this.dbc.close(); // 最后,关闭数据库连接
}
return flag; // 返回flag,表示是否成功更新用户信息
}
@Override
public boolean doDelete(String username) throws Exception { // 实现IUserInfoDAO接口中的doDelete方法,用于删除用户信息
// 删除用户信息(代理实现)
boolean flag = true; // 定义一个布尔变量flag,并初始化为true
try {
flag = this.dao.doDelete(username); // 调用dao的doDelete方法,尝试删除用户信息,并将返回值赋值给flag
} catch (Exception e) {
throw e; // 如果调用dao.doDelete方法时抛出异常,则重新抛出该异常
} finally {
this.dbc.close(); // 最后,关闭数据库连接
}
return flag; // 返回flag,表示是否成功删除用户信息
}
@Override
public List<UserInfo> findAll(String keyword) throws Exception { // 实现IUserInfoDAO接口中的findAll方法,用于查找用户信息-关键字查找
// 查找用户信息-关键字查找(代理实现)
List<UserInfo> all = null; // 定义一个List<UserInfo>类型的变量all,并初始化为null
try {
all = this.dao.findAll(keyword); // 调用dao的findAll方法,尝试查找用户信息,并将返回值赋值给all
} catch (Exception e) {
throw e; // 如果调用dao.findAll方法时抛出异常,则重新抛出该异常
} finally {
this.dbc.close(); // 最后,关闭数据库连接
}
return all; // 返回all,表示是否成功查找到用户信息列表
}
@Override // 注解,表示该方法覆盖了父类或接口中的方法。
public UserInfo findById(String id) throws Exception { // 定义一个公共方法,名为findById,输入参数为一个字符串类型的id,该方法可能会抛出异常。返回值类型为UserInfo。
// 查找用户信息-ID查找(代理实现) // 注释,说明这个方法是用来根据ID查找用户信息的,是代理实现。
UserInfo user = null; // 定义一个UserInfo类型的变量user,并初始化为null。
try { // 开始一个try块,用于捕获可能会抛出的异常。
user = this.dao.findById(id); // 调用dao对象的findById方法,输入参数为id,返回值为user。因为可能会抛出异常,所以被包装在try块中。
} catch (Exception e) { // 如果try块中的代码抛出异常,那么会进入catch块。
throw e; // 在catch块中重新抛出捕获到的异常。
} finally { // 无论是否发生异常,finally块的代码总是会被执行。
this.dbc.close(); // 关闭数据库连接。
}
return user; // 返回user变量,表示查找的用户信息。
}
调用DAO
定义好了以上的DAO以后,就可以在window文件下负责前端的java文件中调用。
以下是在manageAdmin文件中的代码块:
// 当名为 "btnNewButton" 的按钮被点击时,执行此方法。
protected void btnNewButtonactionPerformed(ActionEvent e) {
// 从名为 "textField_4" 的文本框获取文本内容,并将其存储在名为 "name" 的字符串中。
String name = textField_4.getText();
// 创建一个新的 UserInfo 对象,并将其引用赋值给变量 "u"。
UserInfo u = new UserInfo();
// 尝试执行以下操作:
try {
// 从 DAOFactory 中获取 IUserDAOInstance,并调用其 findById 方法,使用 "name" 作为参数,
// 然后将返回的结果赋值给 "u"。此处可能是在数据库中查找具有指定 "name" 的用户信息。
u = DAOFactory.getIUserDAOInstance().findById(name);
// 弹出一个对话框,显示与 "u" 关联的信息,并提示用户是否要删除此信息。
// 如果用户选择 "是"(对应的整数为0),则执行下一条语句。
int temp = JOptionPane.showConfirmDialog(null, u.toString(), "要删除的信息", 0);
// 如果用户在上一步中选择了 "是",则调用 DAOFactory 中 IUserDAOInstance 的 doDelete 方法,
// 并传入 "name" 作为参数。此操作可能是从数据库中删除具有指定 "name" 的用户信息。
if (temp == 0) {
DAOFactory.getIUserDAOInstance().doDelete(name);
}
// 如果在上述操作中发生异常,则捕获该异常,并打印堆栈跟踪信息。
} catch (Exception e1) {
e1.printStackTrace();
}
// 调用名为 "initTextFiled" 的方法,可能是重新初始化某些文本字段。
initTextFiled();
}
逻辑方面注释讲的很清楚啦。