EmptyResultDataAccessException介绍

一、EmptyResultDataAccessException定义

在Java应用程序中，可能会发生没有返回预期结果的情况。在Spring框架中，如果一个查询方法返回的结果集为空，并且工作在一个非强制性的模式下，将引发一个EmptyResultDataAccessException错误。

EmptyResultDataAccessException被定义为Spring框架中一种没有返回结果集的异常。这个异常通常发生在查询数据库结果集为空的时候。它是org.springframework.dao包下的一个类，该异常是RuntimeException的子类。

public class EmptyResultDataAccessException extends IncorrectResultSizeDataAccessException {
    public EmptyResultDataAccessException(int expectedSize) {
        super(expectedSize, 0);
    }
    ......
}

二、EmptyResultDataAccessException使用场景

EmptyResultDataAccessException用于Spring框架中对数据访问的支持，在以下方面会被使用：

1）对单个结果集的查询

当我们在应用程序中使用单个查询结果集时，如果这个查询结果集是空的，就会抛出EmptyResultDataAccessException异常。

public class UserDaoImpl implements UserDao {
    private JdbcTemplate jdbcTemplate;
    @Override
    public User queryUserById(Integer userId) {
        String sql = "select * from user where user_id=?";
        User user = null;
        try {
            user = jdbcTemplate.queryForObject(sql, new Object[]{userId}, BeanPropertyRowMapper.newInstance(User.class));
        } catch (EmptyResultDataAccessException e) {
            System.out.println("查询结果集为空。");
        }
        return user;
    }
}

当查询结果集为空时，程序会执行catch语句块中的代码打印出“查询结果集为空”的相关信息。

2）对多个结果集的查询

当我们在应用程序中使用多个查询结果集时，如果其中一个结果集是空的，就会抛出EmptyResultDataAccessException异常。

public class OrderDaoImpl implements OrderDao {
    private JdbcTemplate jdbcTemplate;
    @Override
    public List<Order> queryOrdersByUserId(Integer userId) {
        String sql = "select * from orders where user_id=?";
        List<Order> orders = null;
        try {
            orders = jdbcTemplate.query(sql, new Object[]{userId}, BeanPropertyRowMapper.newInstance(Order.class));
        } catch (EmptyResultDataAccessException e) {
            System.out.println("查询结果集为空。");
        }
        return orders;
    }
}

当查询结果集为空时，程序会执行catch语句块中的代码打印出“查询结果集为空”的相关信息。

三、EmptyResultDataAccessException异常处理

Spring框架中关于EmptyResultDataAccessException的异常处理是提供了多种方案的，包括如下几种方式：

1）在控制台上给出提示

在程序中使用try-catch代码块捕获EmptyResultDataAccessException异常，在catch语句块中给出相关提示，以便及时发现异常并予以处理。

public class UserDaoImpl implements UserDao {
    private JdbcTemplate jdbcTemplate;
    @Override
    public User queryUserById(Integer userId) {
        String sql = "select * from user where user_id=?";
        User user = null;
        try {
            user = jdbcTemplate.queryForObject(sql, new Object[]{userId}, BeanPropertyRowMapper.newInstance(User.class));
        } catch (EmptyResultDataAccessException e) {
            System.out.println("查询结果集为空。");
        }
        return user;
    }
}

2）在日志文件中进行记录

在程序中，我们通常会使用日志记录来跟踪和排查问题。通过在程序代码中使用日志框架，我们可以记录EmptyResultDataAccessException异常信息并分析异常原因。

public class UserDaoImpl implements UserDao {
    private static final Logger log = LoggerFactory.getLogger(UserDaoImpl.class);
    private JdbcTemplate jdbcTemplate;
    @Override
    public User queryUserById(Integer userId) {
        String sql = "select * from user where user_id=?";
        User user = null;
        try {
            user = jdbcTemplate.queryForObject(sql, new Object[]{userId}, BeanPropertyRowMapper.newInstance(User.class));
        } catch (EmptyResultDataAccessException e) {
            log.error("查询结果集为空。");
        }
        return user;
    }
}

3）在页面上输出提示信息

将EmptyResultDataAccessException异常信息输出到页面上，方便用户对问题的快速识别和处理。

@RequestMapping("/user/getUserInfoById")
@ResponseBody
public Map getUserInfoById(Integer userId) {
    Map result = new HashMap();
    try {
        User user = userDao.queryUserById(userId);
        if (user != null) {
            result.put("code", 0);
            result.put("msg", "查询成功！");
            result.put("data", user);
        } else {
            result.put("code", -1);
            result.put("msg", "没有找到用户信息！");
        }
    } catch (EmptyResultDataAccessException e) {
        result.put("code", -2);
        result.put("msg", "查询结果集为空！");
        e.printStackTrace();
    }
    return result;
}

四、EmptyResultDataAccessException的作用

EmptyResultDataAccessException的作用在于，在应用程序中可以使用它来捕获查询结果集为空的异常，从而有效避免程序出错。

五、总结

EmptyResultDataAccessException是Spring框架中的一种异常类型，当查询结果集为空时会抛出此异常。我们可以使用多种方式对EmptyResultDataAccessException异常进行处理，如在控制台上给出提示、在日志文件中进行记录、在页面上输出提示信息等。使用EmptyResultDataAccessException能够有效地捕获查询结果集为空的异常，让应用程序更加健壮和可靠。